personifycare/phpunit

PHPUnit测试Docker镜像

概述

该Docker镜像旨在提供便捷的PHPUnit测试环境，用于PHP项目的单元测试。PHPUnit是PHP领域广泛使用的单元测试框架，此镜像集成了PHPUnit及其依赖组件，帮助开发者快速搭建测试环境，无需手动配置PHP和测试工具。

核心功能与特性

• 预装PHPUnit：包含稳定版PHPUnit，开箱即可使用
• 轻量级设计：基于官方PHP镜像构建，体积小巧，启动快速
• 兼容性强：支持多种PHP版本（具体版本可通过标签选择）
• 易于集成：可无缝接入CI/CD流程（如Jenkins、GitHub Actions等）

使用场景

• 本地开发环境：开发者在本地快速运行PHP单元测试
• 持续集成：在CI/CD管道中自动化执行测试用例，确保代码质量
• 测试环境一致性：统一团队成员的测试环境，避免因环境差异导致的测试结果不一致

使用方法

基本使用

通过以下命令运行PHPUnit测试：

bash
docker run --rm -v $(pwd):/app -w /app docker.xuanyuan.run/phpunit-testing phpunit tests/

参数说明：

• --rm：测试完成后自动删除容器
• -v $(pwd):/app：将当前目录挂载到容器内的/app目录
• -w /app：设置工作目录为/app
• phpunit-testing：镜像名称（请替换为实际镜像标签）
• phpunit tests/：执行PHPUnit测试，测试目录为tests/

指定PHP版本

若需要特定PHP版本，可通过镜像标签选择（例如PHP 8.1版本）：

bash
docker run --rm -v $(pwd):/app -w /app docker.xuanyuan.run/phpunit-testing:8.1 phpunit tests/

自定义配置

如需使用自定义phpunit.xml配置文件，确保配置文件位于项目根目录，容器会自动识别并使用该配置：

bash
docker run --rm -v $(pwd):/app -w /app docker.xuanyuan.run/phpunit-testing phpunit --configuration phpunit.xml

Docker Compose配置

在docker-compose.yml中集成：

yaml
version: '3'
services:
  phpunit:
    image: docker.xuanyuan.run/phpunit-testing
    volumes:
      - ./:/app
    working_dir: /app
    command: phpunit tests/

运行测试：

bash
docker-compose run --rm phpunit

注意事项

• 确保项目目录中包含测试文件（通常位于tests/目录）
• 如需安装额外PHP扩展，可基于此镜像构建自定义Dockerfile
• 镜像标签通常对应PHP版本，具体版本支持请参考镜像仓库文档