symfonywithswoole/swoole-bundle-ci

镜像概述

本镜像专为Swoole Bundle项目设计，是用于持续集成（CI）流水线的专用环境镜像。旨在简化Swoole Bundle项目在CI流程中的环境配置工作，通过预配置必要的依赖和工具，确保CI流程中构建、测试等自动化任务可稳定执行，减少因环境差异导致的CI失败问题。

核心功能与特性

• 预配置CI环境：集成Swoole Bundle项目所需的运行时依赖、构建工具及测试框架，无需手动配置基础环境。
• Swoole Bundle适配：针对Swoole Bundle的特性优化，确保与项目依赖（如Swoole扩展、相关组件）的兼容性。
• 自动化任务支持：支持执行Composer依赖安装、代码静态分析、单元测试、集成测试等CI常见任务。
• 轻量级设计：基于精简基础镜像构建，减少镜像体积，提升CI流程中的拉取和启动速度。

使用场景和适用范围

• Swoole Bundle项目的持续集成流程：适用于基于Swoole Bundle开发的PHP项目，在GitHub Actions、GitLab CI/CD、Jenkins等CI平台中使用。
• 自动化测试与构建：用于在代码提交、合并请求等触发条件下，自动执行测试用例、构建项目资产或生成部署包。
• 多环境一致性保障：确保开发、测试、CI环境中工具版本及配置一致，降低"本地可运行，CI失败"的环境差异问题。

使用方法和配置说明

基本使用命令

通过docker run命令启动容器，挂载项目目录并执行CI任务：

bash
# 示例：安装依赖并运行单元测试
docker run --rm -v $(pwd):/app swoole-bundle-ci-image:latest \
  sh -c "composer install --no-dev && vendor/bin/phpunit tests/"

CI配置文件集成示例

GitHub Actions配置（.github/workflows/ci.yml）

yaml
name: CI

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run tests with Swoole Bundle CI image
        uses: docker://swoole-bundle-ci-image:latest
        with:
          args: sh -c "composer install && vendor/bin/phpunit"

GitLab CI配置（.gitlab-ci.yml）

yaml
test:
  image: swoole-bundle-ci-image:latest
  script:
    - composer install
    - vendor/bin/phpcs --standard=PSR12 src/
    - vendor/bin/phpunit --coverage-text
  only:
    - main
    - merge_requests

环境变量配置

自定义任务执行

可通过传递自定义命令参数覆盖默认行为，例如执行代码静态分析：

bash
docker run --rm -v $(pwd):/app swoole-bundle-ci-image:latest vendor/bin/phpstan analyze src/