dcycle/phpunit

Dcycle PHPUnit 镜像文档

镜像概述

Dcycle PHPUnit 是一个用于通过 PHPUnit 对 PHP 代码进行单元测试的 Docker 镜像。该镜像提供了预配置的 PHPUnit 环境，可直接用于执行 PHP 项目的单元测试，无需在本地系统手动安装 PHPUnit 及相关依赖。

完整文档请参考 https://github.com/dcycle/docker-phpunit%E3%80%82

核心功能与特性

• 集成 PHPUnit 测试框架，支持标准 PHP 单元测试流程
• 无需本地配置 PHPUnit 环境，简化测试准备步骤
• 保持跨环境测试一致性，适用于开发环境与 CI/CD 流程

使用场景

• PHP 项目开发阶段的单元测试验证
• 持续集成/持续部署 (CI/CD) 流程中的自动化测试环节
• 需要快速搭建临时 PHPUnit 测试环境的场景

使用方法与配置说明

基本使用命令

在 PHP 项目根目录下执行以下命令，运行单元测试：

bash
docker run --rm -v $(pwd):/app dcycle/phpunit phpunit

参数说明：

• --rm：测试完成后自动清理容器
• -v $(pwd):/app：将当前目录（项目根目录）挂载至容器内 /app 路径
• dcycle/phpunit：使用 Dcycle PHPUnit 镜像
• phpunit：执行 PHPUnit 命令（可添加标准 PHPUnit 参数，如测试文件路径、配置文件等）

自定义测试配置

若项目中存在 phpunit.xml 或 phpunit.xml.dist 配置文件，PHPUnit 将自动读取并应用配置。如需指定自定义配置文件或参数，可按以下方式执行：

bash
docker run --rm -v $(pwd):/app dcycle/phpunit phpunit --configuration /app/custom-phpunit.xml

相关链接

• PHPUnit 官方文档
• https://github.com/dcycle/docker-phpunit