PHP Apache Docker容器中MySQLi扩展安装未生效问题排查

你的Dockerfile存在两个核心问题，导致mysqli扩展没有在构建阶段正确安装：

1. 缺少编译mysqli扩展的必需系统依赖
   docker-php-ext-install是PHP官方镜像提供的扩展编译脚本，安装mysqli时需要依赖MySQL客户端开发库头文件，你没有提前安装default-libmysqlclient-dev包，会导致编译过程失败，扩展根本没有被正确编译安装到PHP扩展目录中。你手动进入容器安装时，操作过程会自动补全对应依赖，所以可以安装成功。
2. 无效命令与构建顺序不合理
   • 构建过程中多次执行service apache2 restart完全无效：Docker每个RUN指令运行在独立的临时容器中，进程状态不会跨层保留，apache只会在容器正式启动时自动运行，构建阶段重启没有任何意义。
   • 把项目代码复制(COPY . /var/www)放在扩展安装步骤之前，只要本地项目代码有任何改动，后续所有层的构建缓存都会直接失效，很容易触发偶发构建异常，也会大幅增加镜像构建时间。
   • 把apt-get clean放在apt-get update之前没有实际意义，基础镜像默认没有apt缓存包，不需要提前清理。

FROM php:8.1-apache

# 配置Apache
RUN a2enmod rewrite
COPY docker/web/apache.conf /etc/apache2/sites-enabled/000-default.conf

# 设置工作目录
WORKDIR /var/www

# 先安装系统依赖，再安装PHP扩展，最后清理apt缓存减小镜像体积
RUN apt-get update \
    && apt-get install -y --no-install-recommends default-libmysqlclient-dev \
    && docker-php-ext-install mysqli pdo_mysql \
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/*

# 安装Composer
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

# 最后复制项目代码，最大化利用构建缓存
COPY . /var/www

# 给项目目录设置正确权限，避免Apache权限问题
RUN chown -R www-data:www-data /var/www

构建完成后进入容器，执行php -m | grep mysqli，如果能输出mysqli就说明扩展安装成功，不需要额外重启服务，PHP的Apache SAPI会自动加载已安装的扩展。

建议同时安装pdo_mysql扩展，Symfony的Doctrine ORM默认优先使用PDO连接数据库，避免后续出现PDO相关类不存在的错误。

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