如何在gitlab-ci.yml中获取代码覆盖率值，实现达标触发任务

步骤1：确保PHPUnit生成可解析的覆盖率输出 #

Laravel默认用PHPUnit做测试，你需要让它输出可提取的覆盖率数据，两种常用方式：

• 文本格式输出：在测试命令中添加--coverage-text --no-progress参数，禁止进度条，输出纯文本的覆盖率统计
• XML格式输出：用--coverage-clover coverage.xml生成结构化的XML报告，适合更精确的解析

步骤2：从输出中提取覆盖率数值 #

方法一：从文本输出提取 #

先运行测试捕获输出，再用grep+awk+sed提取百分比：

# 运行测试并捕获覆盖率输出
COVERAGE_OUTPUT=$(phpunit --coverage-text --no-progress)
# 提取行覆盖率数值（适配默认的PHPUnit文本输出格式）
COVERAGE_PERCENT=$(echo "$COVERAGE_OUTPUT" | grep -E '^  Lines:' | awk '{print $3}' | sed 's/%//')

方法二：从XML报告提取 #

如果用XML格式，需要安装xmllint工具（GitLab CI镜像可能需要手动安装），然后解析XML节点：

# 生成XML覆盖率报告
phpunit --coverage-clover coverage.xml
# 提取行覆盖率并转换为百分比（line-rate是0-1的小数）
COVERAGE_PERCENT=$(xmllint --xpath 'string(//coverage/project/metrics/@line-rate)' coverage.xml | awk '{print $1 * 100}' | awk '{printf "%.2f", $0}')

步骤3：判断覆盖率并执行指定任务 #

用bc工具做浮点数比较，判断是否超过80%，然后执行任务：

# 比较覆盖率数值，超过80%则执行任务
if (( $(echo "$COVERAGE_PERCENT > 80" | bc -l) )); then
    echo "代码覆盖率达到 $COVERAGE_PERCENT%，执行指定任务..."
    # 替换为你的实际任务命令，比如：
    # php artisan deploy:notify
    # npm run build
fi

GitLab CI完整示例 #

在.gitlab-ci.yml中配置对应的job，确保依赖工具存在：

coverage-check:
  stage: post-test
  image: php:8.2-cli
  before_script:
    # 安装所需工具：bc用于浮点数计算，libxml2-utils包含xmllint
    - apt-get update && apt-get install -y --no-install-recommends bc libxml2-utils
    - composer install --no-dev --optimize-autoloader
  script:
    # 运行测试并提取覆盖率
    - COVERAGE_OUTPUT=$(phpunit --coverage-text --no-progress)
    - COVERAGE_PERCENT=$(echo "$COVERAGE_OUTPUT" | grep -E '^  Lines:' | awk '{print $3}' | sed 's/%//')
    - echo "当前代码覆盖率: $COVERAGE_PERCENT%"
    # 执行条件任务
    - if (( $(echo "$COVERAGE_PERCENT > 80" | bc -l) )); then
        echo "触发自定义任务";
        php artisan your:custom-task;
      fi

注意事项 #

• 若你的PHPUnit文本输出格式不同（比如行前缀、字段位置变化），需要调整grep和awk的匹配规则，先通过phpunit --coverage-text查看实际输出再修改
• 确保GitLab CI使用的镜像包含所需工具，若用Alpine镜像，安装命令改为apk add bc libxml2-utils
• 若需要更复杂的覆盖率判断（比如分支覆盖率），只需调整提取的目标字段即可

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