roadiz/php80-runner

Gitlab/Travis CI PHP 8.0 运行器镜像文档

1. 镜像概述与主要用途

1.1 基本信息

本镜像为适用于 Gitlab CI/Travis CI 环境的 PHP 8.0 运行器，设计用于 PHP 项目的镜像构建与自动化测试任务。

1.2 主要用途

• 在 Gitlab CI 或 Travis CI 流水线中作为执行环境，提供 PHP 8.0 运行时支持
• 支持 PHP 项目的构建流程（如依赖安装、代码检查、打包等）
• 执行 PHP 项目的自动化测试任务（如单元测试、集成测试等）

1.3 弃用声明

重要提示：该镜像已被官方弃用（deprecated），建议所有用户迁移至替代镜像 roadiz/php-runner:8.0.30-bullseye 以获取持续支持和稳定性保障。

2. 核心功能与特性

2.1 基础功能

• 基于 PHP 8.0 版本构建，适配 CI/CD 环境（Gitlab CI、Travis CI）
• 提供 PHP 项目构建与测试所需的基础运行环境

2.2 已知限制

由于 PHP 8.0 兼容性问题，以下扩展暂不支持安装（编译失败）：

• amqp
• igbinary
• mongodb
• redis
• enchant

3. 使用场景与适用范围

3.1 适用场景

• Gitlab CI 流水线中 PHP 8.0 项目的构建与测试任务
• Travis CI 环境下 PHP 8.0 项目的自动化构建流程

3.2 适用范围

• PHP 8.0 版本的后端项目、库或应用程序
• 需要在 CI 环境中执行构建（如生成 Docker 镜像）和测试（如 PHPUnit 测试）的场景

4. 使用方法与配置说明

4.1 注意事项

由于本镜像已被弃用，强烈建议优先使用替代镜像 roadiz/php-runner:8.0.30-bullseye。以下使用方法仅针对历史遗留场景参考。

4.2 本地构建（不推荐）

若需本地构建该镜像，可执行以下命令（基于项目 hooks 脚本）：

bash
# 设置 Docker 仓库名称并执行构建脚本
DOCKER_REPO="roadiz/php80-runner" bash ./hooks/build

4.3 CI 环境配置（不推荐）

在 Gitlab CI 或 Travis CI 配置文件中使用本镜像的示例（仅作历史参考，实际应迁移至替代镜像）：

Gitlab CI 配置示例（.gitlab-ci.yml）

yaml
build-and-test:
  image: roadiz/php80-runner  # 已弃用，建议替换为 roadiz/php-runner:8.0.30-bullseye
  script:
    - composer install  # 安装 PHP 依赖
    - phpunit  # 执行单元测试
    - docker build -t my-php-project .  # 构建项目镜像

5. 替代方案推荐

为确保构建稳定性和持续支持，请迁移至官方推荐的替代镜像：
roadiz/php-runner:8.0.30-bullseye

该替代镜像修复了原镜像的兼容性问题，支持更多扩展，并提供长期维护支持。

6. 参考信息

• 本镜像设计灵感来源于：https://github.com/TetraWeb/docker