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 在小项目里更轻量。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 用 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.

• 必须用 Personal Access Token（PAT）代替 SSH 密钥或默认凭证，且 PAT 需勾选 api 和 write_repository
• 推送地址要改成 HTTPS 格式：https://oauth2:@gitlab.com/username/project.git，否则 Git 不识别 token
• 打 tag 后立刻 git push origin ，别漏掉 origin 参数，否则 push 无效
• 这个操作建议只在 main 或 release/* 分支上做，避免开发分支污染 release 流水线

CI/CD 最容易被忽略的是「环境变量隔离」—— 开发用的 .env 绝对不能进仓库，也不能靠 CI 覆盖写入；生产密钥必须走 secrets 注入，并在部署脚本里用 sed 或 envsubst 替换模板文件。一旦密钥硬编码或泄露，补救成本远高于搭流水线本身。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！