securelogin/php-ci

PHP持续集成环境镜像

镜像概述

该Docker镜像专为PHP项目的持续集成(CI)流程设计，集成了Yarn、Composer、Chrome Headless和NGINX等核心工具，提供一站式的PHP项目构建、依赖管理、浏览器测试及Web服务支持，简化CI/CD管道配置。

核心功能与特性

• PHP环境：提供稳定的PHP运行环境，支持PHP项目的代码执行与依赖解析
• 依赖管理：集成Composer（PHP依赖管理工具）和Yarn（前端依赖管理工具），可一键安装项目依赖
• 浏览器测试：内置Chrome Headless，支持自动化浏览器测试（如PHPUnit、Selenium等测试框架）
• Web服务：包含NGINX服务器，可用于项目部署预览或测试环境搭建
• CI友好：轻量级设计，适配主流CI平台（Jenkins、GitLab CI、GitHub Actions等）

使用场景与适用范围

• PHP项目的自动化构建与测试流程
• 需要前端资源构建（如React、Vue项目）的PHP应用
• 基于浏览器的功能测试与UI测试
• 快速搭建临时测试环境或演示环境
• 集成到CI/CD管道，实现代码提交后的自动验证与部署

使用方法与配置说明

基本使用（docker run）

bash
docker run -d \
  -v /path/to/your/php/project:/app \
  -p 8080:80 \
  --name php-ci-env \
  [镜像名称]

关键参数说明

• -v /path/to/your/php/project:/app：挂载本地PHP项目目录到容器内/app路径
• -p 8080:80：将容器内NGINX的80端口映射到主机8080端口，用于访问项目
• --name php-ci-env：指定容器名称，便于管理

常用命令示例

1. 安装PHP依赖：

bash
docker exec php-ci-env composer install --working-dir=/app

2. 安装前端依赖并构建：

bash
docker exec php-ci-env yarn --cwd /app install
docker exec php-ci-env yarn --cwd /app build

3. 运行PHP单元测试：

bash
docker exec php-ci-env php /app/vendor/bin/phpunit /app/tests

4. 执行浏览器测试（Chrome Headless）：

bash
docker exec php-ci-env google-chrome --headless=new --no-sandbox --disable-gpu /app/tests/browser-test.js

环境变量配置

docker-compose配置示例

yaml
version: '3'
services:
  php-ci:
    image: [镜像名称]
    volumes:
      - ./php-project:/app
      - composer-cache:/root/.composer
      - yarn-cache:/root/.yarn/cache
    ports:
      - "8080:80"
    environment:
      - PHP_MEMORY_LIMIT=1G
      - NGINX_ROOT=/app/public

volumes:
  composer-cache:
  yarn-cache:

注意事项

• 确保挂载的项目目录具有适当的读写权限
• 对于大型项目，建议挂载Composer和Yarn缓存卷以加速依赖安装
• Chrome Headless运行时可能需要--no-sandbox参数（容器环境下）
• 根据项目需求调整PHP版本和扩展（可通过Dockerfile自定义构建）