tjamps/php-ci Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

tjamps/php-ci

镜像概述

tjamps/php-ci是专为Gitlab CI设计的PHP项目Docker镜像，主要基于Alpine Linux构建，旨在为PHP项目提供轻量且功能丰富的CI/CD环境。该镜像包含几乎所有常用PHP扩展，并提供启用Xdebug的变体（*-xdebug），可直接用于Gitlab CI流水线中的应用构建和测试流程。

核心功能与特性

• 轻量基础：基于Alpine Linux，确保镜像体积小、资源占用低
• 扩展丰富：预安装几乎所有常用PHP扩展，满足大多数PHP项目需求
• Xdebug支持：提供*-xdebug标签变体，预启用Xdebug扩展，支持调试和测试覆盖率分析
• CI优化：针对Gitlab CI流水线场景设计，可直接集成到构建和测试环节

使用场景

• Gitlab CI流水线中的PHP应用自动化构建
• PHP项目单元测试、集成测试等测试套件执行
• 需要Xdebug支持的代码调试和测试覆盖率报告生成

使用方法

Gitlab CI配置示例

在项目的.gitlab-ci.yml文件中引用镜像：

基础构建与测试（无Xdebug）

yaml
build-and-test:
  image: tjamps/php-ci:latest
  script:
    - composer install --no-dev
    - php artisan migrate --force  # 如Laravel项目
    - php -v  # 验证PHP环境

带Xdebug的测试覆盖率分析

yaml
test-coverage:
  image: tjamps/php-ci:latest-xdebug
  script:
    - composer install
    - ./vendor/bin/phpunit --coverage-clover=coverage.xml  # 生成覆盖率报告
  artifacts:
    paths:
      - coverage.xml

本地验证

通过docker run命令本地检查镜像功能：

bash
# 查看已安装PHP扩展
docker run --rm tjamps/php-ci:latest php -m

# 验证Xdebug是否启用
docker run --rm tjamps/php-ci:latest-xdebug php -m | grep xdebug