Docker中PHP 8.2-fpm安装OCI8扩展失败求助

核心问题 #

OCI8扩展运行时依赖系统级的libaio库，你使用的PHP 8.2-fpm基础镜像默认未预装该库，导致PHP加载oci8.so时找不到依赖的动态链接库，最终扩展加载失败。

具体修复步骤 #

1. 在Dockerfile中补充libaio安装步骤
   官方PHP 8.2-fpm镜像基于Debian系统，直接在OCI8安装流程前添加系统依赖安装命令即可：

   FROM php:8.2-fpm
   
   # 先安装系统依赖，包含libaio
   RUN apt-get update && apt-get install -y --no-install-recommends \
       libaio1 \
       # 可在此添加编译OCI8所需的其他依赖，如gcc等
       && rm -rf /var/lib/apt/lists/*
   
   # 执行你原有的OCI8安装步骤，比如通过pecl安装
   RUN pecl install oci8-3.2.1 \
       && docker-php-ext-enable oci8
   

   若你使用了Oracle Instant Client，还需将其库路径添加到系统动态链接配置中，避免后续依赖问题：

   # 假设Instant Client已解压至/usr/local/instantclient目录
   RUN echo "/usr/local/instantclient" >> /etc/ld.so.conf.d/oracle-instantclient.conf \
       && ldconfig
   

2. 重新构建并验证
   重新构建镜像：

   docker build . -t mytest
   

   运行容器检查扩展状态：

   docker run mytest:latest php -m
   

   此时oci8应出现在扩展列表中，且不会再出现找不到libaio.so.1的警告。

额外提醒 #

• 若你使用的是Alpine版本的PHP镜像（如php:8.2-fpm-alpine），对应依赖包名为libaio，安装命令需改为apk add libaio。
• 若你通过源码编译OCI8，只要提前安装了libaio1，编译过程会自动识别该依赖，无需额外配置。

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