1. 项目概述：PHP项目中的极简CI/CD实践
对于PHP开发者而言，持续集成与持续交付（CI/CD）早已不是可选项而是必选项。但传统CI/CD方案如Jenkins往往伴随着沉重的学习成本和复杂的配置流程。本文将演示如何用最精简的工具链（GitHub Actions + 纯PHP脚本）实现一个开箱即用的CI/CD流程，整个过程无需额外服务器资源，特别适合个人项目和小型团队。
这个方案的核心优势在于：
- 零额外基础设施依赖（仅需GitHub账号）
- 配置代码不超过50行
- 完整覆盖测试→构建→部署全流程
- 原生支持PHP 7.4+环境（兼容8.0+）
2. 环境准备与工具选型
2.1 基础环境要求
确保本地开发环境满足：
bash复制php -v # 需≥7.4（推荐8.0+）
git --version
composer --version
2.2 为什么选择GitHub Actions？
对比常见CI工具：
| 工具 | 配置复杂度 | 维护成本 | 适合场景 |
|---|---|---|---|
| Jenkins | 高 | 高 | 企业级复杂流水线 |
| GitLab CI | 中 | 中 | 已有GitLab生态 |
| GitHub Actions | 低 | 低 | 开源/个人项目 |
GitHub Actions提供：
- 每月2000分钟的免费额度
- 原生支持PHP多版本矩阵测试
- 内置Secrets安全管理
- 丰富的第三方Action市场
3. 最小化CI/CD实现步骤
3.1 项目结构初始化
典型目录结构：
code复制.
├── .github/
│ └── workflows/
│ └── ci-cd.yml # 流水线定义文件
├── src/ # 业务代码
├── tests/ # 单元测试
├── build/ # 构建产物
├── composer.json # 依赖定义
└── deploy.php # 部署脚本
3.2 核心配置文件示例
.github/workflows/ci-cd.yml：
yaml复制name: PHP CI/CD Pipeline
on: [push]
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Setup PHP
uses: shivammathur/setup-php@v2
with:
php-version: '8.1'
extensions: mbstring, xml, curl
coverage: xdebug
- run: composer install
- run: ./vendor/bin/phpunit tests/
deploy:
needs: test
runs-on: ubuntu-latest
if: github.ref == 'refs/heads/main'
steps:
- uses: actions/checkout@v3
- run: php deploy.php production
3.3 部署脚本实现
deploy.php基础逻辑：
php复制<?php
$environment = $argv[1] ?? 'staging';
// 环境检查
if (!in_array($environment, ['staging', 'production'])) {
die("Invalid environment\n");
}
// 构建过程
system('composer install --no-dev --optimize-autoloader');
system('php -d phar.readonly=0 box.phar compile');
// 部署逻辑
$remote = [
'staging' => 'user@staging-server:/var/www/staging',
'production' => 'user@prod-server:/var/www/app'
];
$cmd = sprintf(
'rsync -azP --delete build/ %s',
escapeshellarg($remote[$environment])
);
echo shell_exec($cmd);
4. 关键环节深度解析
4.1 测试阶段优化技巧
通过矩阵测试支持多PHP版本：
yaml复制strategy:
matrix:
php: [7.4, 8.0, 8.1]
os: [ubuntu-latest]
重要提示：PHP 7.4已在2022年底停止维护，建议新项目至少从8.0起步
4.2 构建阶段安全实践
- 依赖安全扫描：
yaml复制- name: Security Check
run: composer audit
- 敏感信息处理：
- 永远不要在代码中硬编码凭证
- 使用GitHub Secrets管理：
yaml复制env:
DB_PASSWORD: ${{ secrets.PROD_DB_PASSWORD }}
4.3 部署策略选择
| 策略 | 适用场景 | 实现方式 |
|---|---|---|
| 全量同步 | 小型项目 | rsync --delete |
| 蓝绿部署 | 关键业务系统 | 切换负载均衡指向 |
| 滚动更新 | 微服务架构 | Kubernetes原生支持 |
| 热更新 | 无状态服务 | OPcache重置+文件监控 |
对于大多数PHP项目，推荐使用全量同步+OPcache重置的组合方案：
php复制// deploy.php追加
$opcacheReset = <<<CMD
ssh %s 'sudo sh -c \"echo opcache_reset() > /dev/null\"'
CMD;
shell_exec(sprintf($opcacheReset, $remote[$environment]));
5. 实战问题排查指南
5.1 常见错误与解决方案
| 错误现象 | 可能原因 | 解决方案 |
|---|---|---|
| 测试通过但部署失败 | 文件权限问题 | 添加chmod -R 755 build步骤 |
| Composer安装超时 | 国内网络环境 | 配置中国镜像源 |
| 部署后OPcache未更新 | 缓存未重置 | 增加opcache_reset()调用 |
| 生产环境缺少扩展 | 环境差异 | 在setup-php中显式声明扩展 |
5.2 性能优化建议
- 构建缓存：
yaml复制- name: Cache Composer
uses: actions/cache@v3
with:
path: vendor
key: ${{ runner.os }}-php-${{ hashFiles('composer.lock') }}
- 并行执行：
yaml复制jobs:
test:
strategy:
matrix:
test_suite: [unit, functional, integration]
steps:
- run: ./vendor/bin/phpunit tests/${{ matrix.test_suite }}
- 部署前置检查：
php复制// 在deploy.php中添加
$requiredExtensions = ['pdo_mysql', 'mbstring'];
foreach ($requiredExtensions as $ext) {
if (!extension_loaded($ext)) {
die("Missing required extension: $ext\n");
}
}
6. 进阶扩展方向
6.1 数据库迁移集成
在composer.json中添加：
json复制"scripts": {
"deploy": [
"php artisan migrate --force",
"php artisan cache:clear"
]
}
6.2 多环境配置管理
使用环境变量区分配置：
php复制// config.php
return [
'db_host' => getenv('APP_ENV') === 'production'
? 'prod-db.example.com'
: 'dev-db.example.com'
];
6.3 监控集成
部署后自动触发健康检查：
yaml复制- name: Health Check
run: |
STATUS=$(curl -s -o /dev/null -w "%{http_code}" https://api.example.com/health)
[ $STATUS -eq 200 ] || exit 1
这套方案经过多个中小型项目的实战检验，在保持极简架构的同时提供了完整的CI/CD能力。对于需要更复杂流程的场景，可以考虑引入Deployer等专业工具，但核心思路仍然保持一致——通过版本控制触发自动化流程，确保每次交付都经过标准化检验。