stayallive/php

Hera PHP CI Docker镜像

镜像概述和主要用途

Hera是专为持续集成（CI）场景设计的完整PHP Docker镜像，整合了PHP运行环境、常用扩展及CI流程所需工具链。该镜像旨在简化PHP项目在CI/CD管道中的配置与执行，支持主流CI平台（如GitHub Actions、GitLab CI、Jenkins等），可直接用于代码测试、静态分析、构建验证等自动化任务。

核心功能和特性

• 多PHP版本支持：提供多个标签对应PHP 7.4+版本（如8.1、8.2、latest），满足不同项目兼容性需求
• 预装核心扩展：包含mysqli、pdo_mysql、json、mbstring、curl等基础扩展，以及xdebug（调试）、phpstan（静态分析）等CI常用工具
• CI优化设计：针对CI流程精简镜像体积，同时保留必要依赖，确保测试/构建效率
• 跨平台兼容：适配主流CI/CD工具，支持Linux/amd64架构，可直接集成到自动化管道
• 灵活配置：支持通过环境变量调整PHP.ini参数（如内存限制、错误级别），满足个性化需求

使用场景和适用范围

• PHP项目单元测试：在CI流程中自动运行PHPUnit、Codeception等测试框架
• 代码质量检查：集成PHP_CodeSniffer、PHPMD等工具，执行代码规范与质量验证
• 构建前预验证：部署前执行依赖检查、语法校验、静态分析等前置任务
• 多环境一致性：确保开发、测试、CI环境的PHP配置统一，避免环境差异导致的问题
• 开源/企业项目CI流程：适合开发团队在GitHub、GitLab等平台的自动化流程中使用

使用方法和配置说明

基本使用示例

通过docker run命令直接启动容器并运行CI任务：

bash
# 运行PHPUnit测试（假设项目根目录有vendor/test目录）
docker run --rm \
  -v $(pwd):/app \  # 挂载本地项目目录到容器内/app
  stayallive/hera:8.2 \  # 使用PHP 8.2版本镜像
  php /app/vendor/bin/phpunit /app/tests  # 执行测试命令

指定PHP版本

通过镜像标签选择PHP版本，格式为stayallive/hera:<php-version>，例如：

• stayallive/hera:7.4（PHP 7.4）
• stayallive/hera:8.1（PHP 8.1）
• stayallive/hera:latest（最新稳定版，默认8.2+）

环境变量配置

支持通过-e参数设置环境变量调整PHP配置，常用参数如下：

示例：启用Xdebug并调整内存限制

bash
docker run --rm \
  -e PHP_INI_MEMORY_LIMIT=1G \
  -e XDEBUG_ENABLE=1 \
  -v $(pwd):/app \
  stayallive/hera:8.2 \
  php /app/vendor/bin/phpunit --coverage-html /app/coverage

CI平台集成示例

GitHub Actions配置

在.github/workflows/ci.yml中集成：

yaml
name: PHP CI
on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Run PHP tests
        run: |
          docker run --rm \
            -v $(pwd):/app \
            stayallive/hera:8.2 \
            sh -c "composer install && php vendor/bin/phpunit"

GitLab CI配置

在.gitlab-ci.yml中配置：

yaml
test:
  image: stayallive/hera:8.2
  script:
    - composer install
    - php vendor/bin/phpunit
  only:
    - main
    - merge_requests

进阶自定义

如需添加项目专属扩展或工具，可基于Hera镜像构建新镜像：

dockerfile
# 自定义镜像示例（添加redis扩展）
FROM stayallive/hera:8.2
RUN docker-php-ext-install redis  # 安装额外扩展

注意事项

• 权限问题：挂载本地目录时，确保容器内用户（默认www-data）对挂载目录有读写权限，可通过-u $(id -u):$(id -g)参数指定用户ID
• 版本兼容性：不同PHP版本标签的扩展支持可能存在差异，具体扩展列表请参考https://github.com/stayallive/hera
• 资源限制：CI环境中建议根据任务需求调整CPU/内存分配，避免因资源不足导致任务失败

更多配置细节与版本更新，请访问https://github.com/stayallive/hera%E3%80%82