Dockerfile为php:8.1-fpm安装启用OCI8扩展报错修复方法

报错核心原因是缺少Oracle Instant Client运行必需的libaio.so.1系统依赖，同时原有配置仅通过环境变量指定动态库路径，未写入系统链接器配置，导致PHP CLI/FPM运行时无法正确加载依赖库，最终OCI8、PDO_OCI扩展加载失败。

• 安装系统级依赖：基于Debian的php:8.1-fpm镜像需要先通过apt安装libaio1，同时提前安装wget、unzip等构建时用到的工具，安装后清理apt缓存减小镜像体积。
• 修正动态链接库配置：将Oracle Instant Client的路径写入系统链接器配置文件，执行ldconfig刷新缓存，避免仅靠环境变量导致的路径不生效问题。
• 调整扩展安装逻辑：扩展编译安装时明确指定Instant Client路径，安装完成后统一启用两个扩展。

# 安装系统依赖
RUN apt update && apt install -y --no-install-recommends \
    libaio1 \
    wget \
    unzip \
    && rm -rf /var/lib/apt/lists/*

RUN mkdir /opt/oracle
# 安装Oracle Instant Client
RUN wget https://download.oracle.com/otn_software/linux/instantclient/216000/instantclient-basic-linux.x64-21.6.0.0.0dbru.zip \
&& wget https://download.oracle.com/otn_software/linux/instantclient/216000/instantclient-sdk-linux.x64-21.6.0.0.0dbru.zip \
&& wget https://download.oracle.com/otn_software/linux/instantclient/216000/instantclient-sqlplus-linux.x64-21.6.0.0.0dbru.zip \
&& unzip instantclient-basic-linux.x64-21.6.0.0.0dbru.zip -d /opt/oracle \
&& unzip instantclient-sdk-linux.x64-21.6.0.0.0dbru.zip -d /opt/oracle \
&& unzip instantclient-sqlplus-linux.x64-21.6.0.0.0dbru.zip -d /opt/oracle \
&& rm -rf *.zip \
&& mv /opt/oracle/instantclient_21_6 /opt/oracle/instantclient

# 配置系统动态链接库
RUN echo "/opt/oracle/instantclient" > /etc/ld.so.conf.d/oracle-instantclient.conf \
    && ldconfig

# 配置环境变量（供sqlplus等命令行工具使用）
ENV LD_LIBRARY_PATH /opt/oracle/instantclient/
ENV PATH /opt/oracle/instantclient:$PATH

# 编译安装OCI8相关扩展
RUN docker-php-ext-configure pdo_oci --with-pdo-oci=instantclient,/opt/oracle/instantclient,21.1 \
    && echo 'instantclient,/opt/oracle/instantclient' | pecl install oci8 \
    && docker-php-ext-install pdo_oci \
    && docker-php-ext-enable oci8 pdo_oci

镜像构建完成后，执行以下命令检查扩展是否加载成功：
docker run --rm 你的镜像标签 php -m | grep -E 'oci8|pdo_oci'
命令返回oci8、pdo_oci两个模块名即为安装成功，不会再出现libaio.so.1缺失的警告。

内容的提问来源于stack exchange，提问作者Albaraa Alshahhoud