symfonywithswoole/swoole-bundle-coverage-pcov

Swoole组件PCOV覆盖率镜像

镜像概述

本镜像为Swoole组件开发提供PCOV代码覆盖率分析能力，集成PHP PCOV扩展与Swoole运行环境，可快速生成代码覆盖率报告，帮助开发者评估测试完整性和代码质量。

核心功能和特性

• PCOV扩展集成：内置PHP PCOV代码覆盖率扩展，支持高效的代码执行路径追踪
• Swoole环境兼容：针对Swoole协程和多进程特性优化，确保覆盖率数据准确采集
• 多格式报告生成：支持HTML、XML、文本等多种覆盖率报告格式，满足不同场景需求
• 轻量级设计：基于Alpine Linux构建，镜像体积小，启动速度快
• 灵活配置：通过环境变量和命令参数自定义报告输出路径、格式及分析范围

使用场景和适用范围

• Swoole应用测试：单元测试、集成测试后的代码覆盖率分析
• 组件开发质量监控：Swoole扩展或组件开发过程中的测试覆盖率跟踪
• CI/CD流程集成：作为自动化测试流程的一部分，生成覆盖率报告并进行质量门禁检查
• 本地开发调试：开发环境中快速生成覆盖率报告，辅助优化测试用例

使用方法和配置说明

基本使用示例

bash
docker run -v /path/to/your/swoole-project:/app \
  -e REPORT_PATH=/app/coverage \
  -e REPORT_FORMAT=html \
  swoole-pcov-coverage

环境变量配置

生成多格式报告

同时生成HTML和XML格式报告：

bash
docker run -v /path/to/project:/app \
  -e REPORT_PATH=/app/coverage \
  -e REPORT_FORMAT=html,xml \
  swoole-pcov-coverage

集成到CI/CD流程（GitLab CI示例）

在.gitlab-ci.yml中添加覆盖率分析步骤：

yaml
stages:
  - test
  - coverage

coverage-analysis:
  stage: coverage
  image: swoole-pcov-coverage
  script:
    - docker run -v $CI_PROJECT_DIR:/app \
        -e REPORT_PATH=$CI_PROJECT_DIR/coverage \
        -e REPORT_FORMAT=xml \
        -e EXCLUDE_PATHS=vendor,tests \
        swoole-pcov-coverage
  artifacts:
    paths:
      - coverage/
    expire_in: 7 days

自定义PHP配置

通过PHP_INI_OVERRIDE调整PHP运行参数：

bash
docker run -v /path/to/project:/app \
  -e REPORT_PATH=/app/coverage \
  -e PHP_INI_OVERRIDE="memory_limit=1G;max_execution_time=300" \
  swoole-pcov-coverage