Docker部署PHP8+OCI8环境报错：无法加载pdo_oci.so动态库

一、检查容器内文件的方法 #

1. 进入容器环境 #

• 如果容器处于运行状态：

  docker exec -it <容器ID或名称> sh
  

• 如果容器启动失败，临时启动镜像进入：

  docker run --rm -it <你的镜像ID或名称> sh
  

2. 关键文件检查步骤 #

• 确认PHP扩展目录：执行以下命令获取PHP默认扩展路径

  php -i | grep extension_dir
  

  然后查看该目录下是否存在pdo_oci.so：

  ls $(php -i | grep -oP 'extension_dir => \K.*')
  

• 验证Oracle Instant Client文件：检查解压后的客户端文件是否完整

  ls /opt/oci/instantclient_19_17/
  

  需确保存在libclntsh.so.19.1、libocci.so.19.1以及对应的软链接。

• 检查PHP配置：确认pdo_oci的扩展配置是否正确

  cat /etc/php8/conf.d/pdo_oci.ini
  

  同时执行php -m查看是否成功加载pdo_oci模块（如果加载失败会直接输出警告）。

二、Dockerfile的问题分析与修复 #

核心问题 #

你使用的php:8.0-fpm-alpine3.13官方镜像已经自带PHP环境，但又通过apk安装了php8包，导致两套PHP环境冲突：官方镜像的扩展目录与apk安装的php8扩展目录不一致，编译生成的pdo_oci.so可能被安装到了官方PHP的扩展目录，但配置文件指向的是apk php8的目录，最终导致找不到文件。

修复后的Dockerfile示例 #

FROM composer:2.0 as vendor

COPY composer.json /app/composer.json
COPY docker/config/nginx.conf /app/nginx.conf

RUN composer install \
    --ignore-platform-reqs \
    --no-interaction \
    --no-plugins \
    --no-scripts \
    --no-ansi \
    --prefer-dist

FROM php:8.0-fpm-alpine3.13
LABEL Maintainer="Christian Jay Bayno"

# 安装依赖包（去掉重复的php8相关包）
RUN apk --no-cache add \
    nginx \
    supervisor \
    curl \
    git \
    tzdata \
    g++ \
    gcc \
    make \
    libaio-dev \
    libnsl \
    gcompat

RUN ln -s /usr/lib/libnsl.so.2 /usr/lib/libnsl.so.1

# 安装Oracle Instant Client和PDO OCI
RUN mkdir -p /opt/oci

COPY ./docker/oracle/instantclient-basic-19.17.0.0.0.zip /opt/oci
COPY ./docker/oracle/instantclient-sdk-19.17.0.0.0.zip /opt/oci
COPY ./docker/oracle/pdo_oci.zip /opt/oci

RUN cd /opt/oci \
    && unzip instantclient-basic-19.17.0.0.0.zip \
    && unzip instantclient-sdk-19.17.0.0.0.zip \
    && cd instantclient_19_17/ \
    && ln -s libclntsh.so.19.1 libclntsh.so \
    && ln -s libocci.so.19.1 libocci.so \
    # 设置Oracle库的环境变量，让PHP能找到依赖
    && echo "/opt/oci/instantclient_19_17" >> /etc/ld.so.conf.d/oracle.conf \
    && ldconfig \
    && cd ../ \
    && unzip pdo_oci.zip \
    && cd pdo_oci \
    # 使用官方镜像的phpize和php-config
    && phpize \
    && ./configure --with-pdo-oci=shared,instantclient,/opt/oci/instantclient_19_17 \
    && make \
    && make install \
    # 将扩展配置添加到官方PHP的配置目录
    && echo "extension=pdo_oci.so" >> /usr/local/etc/php/conf.d/pdo_oci.ini \
    && cd /opt/oci \
    && rm *.zip

# 配置时区
ENV TZ Asia/Manila

# 配置nginx
COPY docker/config/nginx.conf /etc/nginx/nginx.conf

# 配置PHP-FPM（注意官方镜像的PHP-FPM配置路径）
COPY docker/config/fpm-pool.conf /usr/local/etc/php-fpm.d/www.conf
COPY docker/config/php.ini /usr/local/etc/php/conf.d/app.ini

# 配置supervisord
COPY docker/config/supervisord.conf /etc/supervisor/conf.d/supervisord.conf

# 设置目录权限
RUN chown -R nobody.nobody /run && \
    chown -R nobody.nobody /var/lib/nginx && \
    chown -R nobody.nobody /var/log/nginx

# 创建文档根目录
RUN mkdir -p /var/www/html

# 切换到非root用户
USER nobody

# 复制应用代码
WORKDIR /var/www/html
COPY --chown=nobody . /var/www/html/
COPY --chown=nobody --from=vendor /app/vendor/ /var/www/html/vendor/

# 暴露端口
EXPOSE 8085

# 启动服务
CMD ["/usr/bin/supervisord", "-c", "/etc/supervisor/conf.d/supervisord.conf"]

# 健康检查
HEALTHCHECK --timeout=10s CMD curl --silent --fail http://127.0.0.1:8085/fpm-ping

修复要点说明 #

1. 移除了apk安装的php8相关包，仅保留官方镜像自带的PHP环境
2. 将PHP扩展配置文件写入官方镜像的配置目录/usr/local/etc/php/conf.d/
3. 添加了ld.so.conf配置并执行ldconfig，确保系统能找到Oracle的依赖库
4. 调整了PHP-FPM配置文件的路径，适配官方镜像的结构

内容的提问来源于stack exchange，提问作者Vincent Dapiton