PHP项目CI/CD应拆解构建、测试、部署三环节，用Git钩子+GitHub Actions/GitLab CI串联；测试需指定PHP版本及扩展，调用vendor/bin/phpunit；生产部署推荐rsync+SSH，密钥存Secrets并base64编码；禁用git push打Tag，须用PAT和HTTPS地址；环境变量必须隔离，密钥严禁硬编码。
PHP 项目做 CI/CD 不需要魔改框架或强耦合特定平台，关键在于把构建、测试、部署三个环节拆清楚，再用轻量工具串起来。Git 钩子 + GitHub Actions / GitLab CI 是目前最稳、最易调试的组合。
GitHub Actions 中怎么触发 PHP 单元测试
PHP 的测试执行依赖环境一致性，直接在默认 Ubuntu runner 上跑 phpunit 很可能因 PHP 版本、扩展缺失失败。
- 必须显式指定 PHP 版本，用
shivammathur/setup-php动作，比如php-version: '8.2'并启用extensions: ['mbstring', 'xml', 'pdo_sqlite'] -
phpunit命令要从vendor/bin/phpunit调用（Composer 安装），别依赖全局命令 - 若用 Laravel，需提前运行
cp .env.example .env && php artisan key:generate，否则phpunit会报错找不到 APP_KEY - 测试失败时默认中断流程，不用额外配置 —— 但建议加
continue-on-error: false显式声明，避免误读
如何安全地把 PHP 代码推到生产服务器
“rsync + SSH” 是最可控的方式，比 FTP 或直接 git pull 更可靠，也比 Docker 在小项目里更轻量。
- 用 GitHub Secrets 存
DEPLOY_HOST、DEPLOY_USER、DEPLOY_PATH和私钥SSH_PRIVATE_KEY，私钥要 base64 编码后存，运行时再 decode - rsync 命令务必加
--delete（删掉目标端多余文件）和--exclude='.git'（排除版本库元数据），否则可能残留旧配置或敏感文件 - 上线前建议加个简单健康检查：用
curl -f http://your-site.com/health.php，返回非 2xx 就让 workflow 失败 - 不要在生产机上直接
composer install—— 应该在 CI 环境中composer install --no-dev --optimize-autoloader后同步vendor/
为什么不能在 GitLab CI 里用 git push 自动打 Tag
GitLab 默认只给 CI job 提供 read-only 的 clone 权限，git push 会卡在权限拒绝，错误信息是：remote: You are not allowed to upload code.
立即学习“PHP免费学习笔记（深入）”；
- 必须用 Personal Access Token（PAT）代替 SSH 密钥或默认凭证，且 PAT 需勾选
api和write_repository - 推送地址要改成 HTTPS 格式：
https://oauth2:<token>@gitlab.com/username/project.git</token>，否则 Git 不识别 token - 打 tag 后立刻
git push origin <tag_name></tag_name>，别漏掉origin参数，否则 push 无效 - 这个操作建议只在
main或release/*分支上做，避免开发分支污染 release 流水线
CI/CD 最容易被忽略的是「环境变量隔离」—— 开发用的 .env 绝对不能进仓库，也不能靠 CI 覆盖写入；生产密钥必须走 secrets 注入，并在部署脚本里用 sed 或 envsubst 替换模板文件。一旦密钥硬编码或泄露，补救成本远高于搭流水线本身。
