Docker部署PHP Symfony(Mercure)时MySQL与GD扩展安装报错

错误根源 #

PHP 8.1版本中，GD扩展的编译参数已更新：--with-png-dir、--with-jpeg-dir这类参数已被废弃，无需手动指定。同时你未安装GD依赖的系统库（libpng-dev、libjpeg-dev），导致扩展编译失败。

修正后的Dockerfile #

# 使用PHP 8.1 Apache基础镜像
FROM php:8.1-apache

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

# 先安装系统依赖（包含GD所需库）
RUN apt-get update && apt-get install -y \
    libicu-dev \
    libzip-dev \
    libpng-dev \
    libjpeg-dev \
    zip \
    unzip \
    curl \
    gnupg2 \
    && rm -rf /var/lib/apt/lists/*

# 编译安装PHP扩展
RUN docker-php-ext-install -j$(nproc) intl pdo_mysql zip gd

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

# 安装Node.js 14
RUN curl -sL https://deb.nodesource.com/setup_14.x | bash - \
    && apt-get install -y nodejs \
    && rm -rf /var/lib/apt/lists/*

# 复制项目文件到容器
COPY . /var/www/

# 调整文件权限，确保Apache用户（www-data）可访问
RUN chown -R www-data:www-data /var/www/ \
    && chmod -R 755 /var/www/

# 安装Composer依赖（移除--ignore-platform-req=ext-gd，因为已安装）
RUN composer install --no-interaction --optimize-autoloader

# 启用Apache重写模块
RUN a2enmod rewrite

# 暴露端口
EXPOSE 80

# 启动Apache
CMD ["apache2-foreground"]

关键修改点 #

• 新增libpng-dev、libjpeg-dev：GD扩展编译必需的系统库
• 移除GD扩展的--with-png-dir、--with-jpeg-dir参数：PHP 8.1已自动检测依赖路径
• 合并重复的系统依赖安装命令：减少镜像构建层数，优化构建速度
• 添加文件权限调整：避免Apache运行时因权限不足无法读取项目文件
• 移除--ignore-platform-req=ext-gd：已正确安装GD扩展，无需忽略依赖检查

额外排查点（针对PDO问题） #

1. 确保Docker Compose中MySQL服务的配置正确：
   • 数据库容器的端口映射、环境变量（如MYSQL_ROOT_PASSWORD、MYSQL_DATABASE）配置无误
   • Symfony的DATABASE_URL需指向容器内的MySQL服务，格式为：mysql://root:密码@mysql容器名称:3306/数据库名?serverVersion=8.0
2. 检查容器内是否正确安装PDO_MySQL：进入容器执行php -m | grep pdo_mysql，确认输出存在该扩展

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