PHP测试Docker镜像

概述

本Docker镜像专为PHP应用测试设计，提供标准化的测试环境，集成常用PHP测试工具与依赖，旨在简化PHP项目的测试流程，确保测试环境一致性，支持本地开发测试及CI/CD流程中的自动化测试。

核心功能与特性

• 预装测试工具集成：内置PHPUnit、PHP CodeSniffer等主流PHP测试工具，无需额外安装配置
• 多PHP版本支持：提供不同标签对应多种PHP版本（如7.4、8.0、8.1等），满足不同项目需求
• 测试框架兼容：支持PHPUnit、Behat、PHPSpec等主流PHP测试框架
• 环境一致性：标准化测试环境，避免因本地环境差异导致的测试结果不一致问题
• 轻量级设计：基于官方PHP镜像优化，体积小巧，启动快速

使用场景与适用范围

• PHP项目的单元测试执行
• PHP应用的集成测试验证
• 代码质量检测与静态分析
• CI/CD流程中的自动化测试环节（如Jenkins、GitHub Actions等）
• 本地开发环境中的快速测试验证

使用方法与配置说明

基本使用（docker run）

执行PHP项目单元测试：

docker run --rm -v $(pwd):/app -w /app php-test-image:8.1 phpunit tests/

• --rm：测试完成后自动删除容器
• -v $(pwd):/app：将本地PHP项目目录挂载到容器内/app目录
• -w /app：设置工作目录为/app（项目根目录）
• php-test-image:8.1：指定使用PHP 8.1版本的镜像（根据项目需求替换版本标签）
• phpunit tests/：执行PHPUnit测试，测试目录为tests/

支持的PHP版本标签

镜像通过标签区分PHP版本，常用标签包括：

• 7.4：PHP 7.4版本测试环境
• 8.0：PHP 8.0版本测试环境
• 8.1：PHP 8.1版本测试环境
• latest：默认使用最新稳定PHP版本

环境变量配置

可通过环境变量自定义测试行为：

示例：指定自定义PHPUnit配置文件并输出测试报告：

docker run --rm -v $(pwd):/app -w /app -e PHPUNIT_CONFIG=phpunit.custom.xml -e TEST_REPORT_DIR=/app/test-reports php-test-image:8.1 phpunit --configuration $PHPUNIT_CONFIG --log-junit $TEST_REPORT_DIR/junit.xml tests/

卷挂载说明

为确保测试数据持久化及项目文件访问，建议挂载以下目录：

• 项目根目录：-v $(pwd):/app（必填，用于访问项目测试代码）
• 测试报告目录：-v $(pwd)/reports:/app/reports（可选，用于保存测试报告）

适用环境

• Docker Engine 19.03+
• 支持Linux、macOS、Windows（WSL2或Docker Desktop）操作系统