lahautesociete/php-ci

PHP CI Docker镜像文档

镜像概述

PHP CI是一款专为CI（持续集成）环境设计的Docker镜像，基于https://github.com/bitnami/bitnami-docker-php-fpm%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%8F%90%E4%BE%9B%E4%BA%86PHP%E9%A1%B9%E7%9B%AE%E5%9C%A8CI%E6%B5%81%E7%A8%8B%E4%B8%AD%E6%89%80%E9%9C%80%E7%9A%84%E6%A0%B8%E5%BF%83%E4%BE%9D%E8%B5%96%E5%92%8C%E5%B7%A5%E5%85%B7%EF%BC%8C%E7%AE%80%E5%8C%96PHP%E5%BA%94%E7%94%A8%E7%9A%84%E8%87%AA%E5%8A%A8%E5%8C%96%E6%9E%84%E5%BB%BA%E3%80%81%E6%B5%8B%E8%AF%95%E4%B8%8E%E9%83%A8%E7%BD%B2%E6%B5%81%E7%A8%8B%E3%80%82

核心功能与特性

包含的核心依赖与工具

• Composer：PHP依赖管理工具，已预装hirak/prestissimo扩展，加速PHP依赖包下载
• MySQL Client 5.6：用于与MySQL数据库交互，支持数据库相关的CI任务
• 基础工具：
  • unzip：用于解压压缩文件
  • wget：用于下载网络资源
  • git：用于代码拉取与版本控制
  • rsync：用于文件同步与传输
  • sshpass：支持非交互式SSH密码认证

使用场景与适用范围

• PHP项目的持续集成流程，包括依赖安装、代码检查、单元测试、集成测试等环节
• 需要与MySQL数据库交互的CI任务（如数据库迁移、数据初始化）
• 需要通过SSH远程操作的CI场景（如部署文件传输）
• 适用于GitLab CI/CD、GitHub Actions、Jenkins等主流CI/CD平台

使用方法与配置说明

基本使用（Docker Run）

拉取并运行镜像：

bash
docker run --rm -v $(pwd):/app php-ci-image:latest [command]

示例：在CI中安装PHP依赖

bash
docker run --rm -v $(pwd):/app php-ci-image:latest composer install --no-dev

示例：执行MySQL命令（需配置数据库连接信息）

bash
docker run --rm -e MYSQL_HOST=db -e MYSQL_USER=root -e MYSQL_PASSWORD=password php-ci-image:latest mysql -h $MYSQL_HOST -u $MYSQL_USER -p$MYSQL_PASSWORD -e "SHOW DATABASES;"

在CI配置文件中使用（以GitLab CI为例）

yaml
stages:
  - dependencies
  - test

install_dependencies:
  stage: dependencies
  image: php-ci-image:latest
  script:
    - composer install --prefer-dist --no-ansi --no-interaction --no-progress

run_tests:
  stage: test
  image: php-ci-image:latest
  script:
    - vendor/bin/phpunit
  dependencies:
    - install_dependencies

环境变量说明

可通过环境变量配置常用参数，如数据库连接信息：

• MYSQL_HOST：MySQL服务器地址
• MYSQL_USER：MySQL用户名
• MYSQL_PASSWORD：MySQL密码
• MYSQL_DATABASE：目标数据库名

注意事项

• 镜像基于bitnami/bitnami-docker-php-fpm，可参考其官方文档获取PHP版本及基础配置信息
• hirak/prestissimo扩展默认启用，无需额外配置即可加速Composer依赖下载
• 如需持久化依赖缓存，可在CI配置中挂载Composer缓存目录（如-v $HOME/.composer/cache:/root/.composer/cache）