Docker环境下通过Composer安装PHPSpreadsheet失败，求原因排查

问题描述 #

使用以下Dockerfile构建镜像时，执行composer require phpoffice/phpspreadsheet:1.18.0 --ignore-platform-reqs步骤返回exit code 1，构建失败：

FROM php:7.2-apache
RUN a2enmod rewrite

RUN docker-php-ext-install mysqli pdo pdo_mysql

COPY --from=composer/composer:latest-bin /composer /usr/bin/composer

# Create a working directory
WORKDIR /var/www/html

RUN composer require "ext-gd:*" --ignore-platform-reqs
RUN composer require "ext-fileinfo:*" --ignore-platform-reqs
RUN composer require phpoffice/phpspreadsheet:1.18.0 --ignore-platform-reqs

RUN service apache2 restart

核心原因分析 #

1. 依赖扩展未实际安装：你通过composer require "ext-gd:*" --ignore-platform-reqs仅安装了Composer虚拟包，并未在PHP环境中真正编译安装gd和fileinfo扩展。PHPSpreadsheet依赖这两个扩展，即使跳过平台检查，安装过程中仍会因实际缺失扩展触发错误。
2. 多次Composer命令导致依赖冲突：分三次执行composer require会重复触发依赖解析，容易出现版本冲突或缓存异常。
3. 无效的Apache重启命令：构建阶段执行service apache2 restart毫无意义，Docker容器启动时会自动启动Apache服务，该命令反而可能引发不必要的错误。
4. 潜在的网络/权限问题：容器内网络不通导致无法拉取Composer包，或/var/www/html目录无写入权限，都会导致安装失败。

修复方案与优化后的Dockerfile #

关键修复点 #

• 先安装系统依赖，再编译安装gd、fileinfo等PHP扩展
• 合并Composer命令，减少依赖解析冲突
• 配置Composer国内镜像加速包拉取
• 修正目录权限，确保Composer可正常写入文件
• 移除无效的Apache重启命令

完整Dockerfile #

FROM php:7.2-apache
RUN a2enmod rewrite

# 安装系统依赖并编译PHP所需扩展
RUN apt-get update && apt-get install -y \
    libfreetype6-dev \
    libjpeg62-turbo-dev \
    libpng-dev \
    && docker-php-ext-configure gd --with-freetype-dir=/usr/include/ --with-jpeg-dir=/usr/include/ \
    && docker-php-ext-install -j$(nproc) mysqli pdo pdo_mysql gd fileinfo \
    && apt-get clean && rm -rf /var/lib/apt/lists/*

# 安装Composer并配置国内镜像
COPY --from=composer/composer:latest-bin /composer /usr/bin/composer
RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

# 设置工作目录并修正权限
WORKDIR /var/www/html
RUN chown -R www-data:www-data /var/www/html

# 安装PHPSpreadsheet
RUN composer require phpoffice/phpspreadsheet:1.18.0

额外验证建议 #

如果仍失败，可在构建时添加参数查看详细错误日志：

docker build --build-arg COMPOSER_VERBOSE=2 -t your-image-name .

通过 verbose 日志可定位具体是网络问题、依赖冲突还是扩展缺失导致的失败。

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