roadiz/php74-runner

Gitlab/Travis CI PHP 7.4 Runner

镜像概述

Gitlab/Travis CI PHP 7.4 Runner是一个专为持续集成/持续部署(CI/CD)设计的Docker镜像，主要用于在Gitlab CI或Travis CI环境中执行PHP 7.4项目的自动化测试任务和构建项目镜像。该镜像灵感来源于https://github.com/TetraWeb/docker%E9%A1%B9%E7%9B%AE%EF%BC%8C%E6%97%A8%E5%9C%A8%E6%8F%90%E4%BE%9B%E8%BD%BB%E9%87%8F%E3%80%81%E9%AB%98%E6%95%88%E7%9A%84PHP 7.4 CI运行环境。

核心功能与特性

• PHP 7.4环境支持：内置完整的PHP 7.4运行环境，包含常用扩展与依赖，满足PHP 7.4项目的执行需求
• CI/CD集成：无缝适配Gitlab CI和Travis CI流程，支持通过配置文件触发自动化测试与构建
• 镜像构建能力：支持将测试通过的PHP应用打包为Docker镜像，完成从代码验证到制品生成的全流程
• 轻量级设计：优化镜像体积，减少CI环境资源占用，缩短任务执行周期

使用场景

• PHP 7.4项目在Gitlab CI中的自动化单元测试、集成测试及镜像构建
• Travis CI环境下PHP 7.4应用的持续集成流程，包括代码检查、测试执行与制品输出
• 需要在CI环境中快速验证PHP 7.4代码兼容性并生成可部署镜像的开发场景

使用方法

基础运行示例

在本地或CI环境中直接运行镜像执行PHP脚本：

bash
docker run --rm -v $(pwd):/app gitlab-travis-ci-php74-runner:latest php /app/run-tests.php

• -v $(pwd):/app：将宿主项目目录挂载至容器内/app路径，实现代码共享
• php /app/run-tests.php：执行项目测试脚本（根据实际测试入口文件调整）

Gitlab CI配置示例

在项目根目录的.gitlab-ci.yml中配置使用该镜像：

yaml
stages:
  - test
  - build

test:
  stage: test
  image: gitlab-travis-ci-php74-runner:latest
  script:
    - composer install --no-dev
    - vendor/bin/phpunit tests/ --coverage-text

build-image:
  stage: build
  image: gitlab-travis-ci-php74-runner:latest
  script:
    - docker build -t $CI_REGISTRY_IMAGE:latest .
    - docker push $CI_REGISTRY_IMAGE:latest
  only:
    - main  # 仅在主分支触发构建

Travis CI配置示例

在项目根目录的.travis.yml中配置：

yaml
language: php
php:
  - 7.4
services:
  - docker
before_script:
  - composer install
script:
  - vendor/bin/phpunit
  - docker build -t my-php-app:${TRAVIS_BUILD_NUMBER} .

注意事项

• 该镜像主要面向CI环境设计，建议通过Gitlab CI/Travis CI配置文件引用，而非直接作为生产环境运行时
• 如需扩展PHP扩展或调整环境配置，可基于此镜像创建自定义Dockerfile，通过FROM指令继承并修改
• 更多高级配置可参考https://github.com/TetraWeb/docker%E9%A1%B9%E7%9B%AE%E6%96%87%E6%A1%A3%E8%8E%B7%E5%8F%96%E7%81%B5%E6%84%9F