Docker容器中CI运行单元测试且不引入开发依赖至生产的方案

默认情况下phpunit/phpunit被放在composer.json的require-dev字段下，开发和CI环境需要这些依赖，但网上推荐为开发、预发布、生产环境构建单一镜像，这就产生了核心矛盾：

• 若构建时执行composer install，所有环境的镜像都会携带开发依赖，不符合预发布/生产环境的安全规范；
• 若使用composer install --no-dev，CI环境会缺失PHPUnit等工具，无法运行单元测试。

试过两种欠妥当的临时方案：

1. 将PHPUnit移至require字段，但Laravel、CakePHP等主流框架均将其放在require-dev，违背社区规范；
2. 先全量安装依赖→执行测试→删除vendor后重新安装生产依赖，但该流程可能引入代码不一致性，无法保证应用运行稳定性。

当前使用的Dockerfile如下：

FROM harbor.dev/php:8.2-fpm
USER www-data

# First install dependencies, could be cached
COPY --chown=www-data:www-data PHP/composer.json PHP/composer.lock /var/www/html/
RUN composer install --no-interaction && composer dumpautoload -o

# Then copy files
COPY --chown=www-data:www-data PHP /var/www/html/

1. Docker多阶段构建（推荐） #

这是解决此类问题的行业标准方案，通过多阶段镜像分别处理测试与生产环境需求，既保证CI能正常跑测试，又能生成无冗余依赖的生产镜像，同时复用构建缓存提升效率。

示例优化后的Dockerfile：

# 第一阶段：测试环境，安装全量依赖并执行验证
FROM harbor.dev/php:8.2-fpm AS test-stage
USER www-data

COPY --chown=www-data:www-data PHP/composer.json PHP/composer.lock /var/www/html/
RUN composer install --no-interaction && composer dumpautoload -o

COPY --chown=www-data:www-data PHP /var/www/html/
# 在此处执行单元测试、QA检查（如PHPStan、PHPCS等）
RUN phpunit --configuration phpunit.xml

# 第二阶段：生产/预发布环境，仅安装生产依赖
FROM harbor.dev/php:8.2-fpm AS production-stage
USER www-data

COPY --chown=www-data:www-data PHP/composer.json PHP/composer.lock /var/www/html/
RUN composer install --no-interaction --no-dev && composer dumpautoload -o --no-dev

# 从测试阶段复制已验证的代码，避免本地代码与测试代码不一致
COPY --chown=www-data:www-data --from=test-stage /var/www/html /var/www/html

核心优势： #

• 生产镜像完全不含开发依赖，符合安全合规要求；
• CI直接复用test-stage镜像运行测试，无需额外配置；
• 仅将通过测试的代码复制到生产镜像，保障镜像内代码的可靠性；
• 依赖安装层可被缓存，大幅提升后续构建速度。

2. 拆分CI流程与镜像构建 #

若坚持使用单一镜像，可调整CI流水线逻辑：

• CI阶段单独拉取代码，执行composer install安装全量依赖，完成测试与QA检查；
• 测试通过后，再触发镜像构建流程，此时使用composer install --no-dev生成纯净镜像。

注意事项： #

• 必须通过Git哈希等方式锁定代码版本，保证CI测试的代码与构建镜像的代码完全一致；
• 适合已有成熟CI流水线的场景，无需修改Dockerfile结构。

3. 通过构建参数实现差异化镜像 #

使用Docker构建参数（--build-arg）控制依赖安装逻辑，用单一Dockerfile适配不同环境：

修改后的Dockerfile：

FROM harbor.dev/php:8.2-fpm
USER www-data

# 默认设为生产环境
ARG APP_ENV=production

COPY --chown=www-data:www-data PHP/composer.json PHP/composer.lock /var/www/html/
# 根据环境参数决定是否安装开发依赖
RUN if [ "$APP_ENV" = "development" ] || [ "$APP_ENV" = "ci" ]; then \
        composer install --no-interaction && composer dumpautoload -o; \
    else \
        composer install --no-interaction --no-dev && composer dumpautoload -o --no-dev; \
    fi

COPY --chown=www-data:www-data PHP /var/www/html/

构建命令示例： #

• CI/开发环境：docker build --build-arg APP_ENV=ci -t my-app:ci .
• 生产/预发布环境：docker build -t my-app:prod .

优势： #

• 维护单一Dockerfile，减少重复配置；
• 每个环境的镜像按需安装依赖，避免冗余。

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