composer脚本可用于中小型 php 项目部署 自动化，通过定义 scripts 将代码检查、测试、构建、同步等任务串联，结合独立 PHP 脚本与环境变量管理，实现清晰、可维护的本地或轻量级部署流程。
部署自动化是现代 PHP 项目开发中的关键环节，而 Composer 脚本可以成为轻量级、可复用的自动化 工具 。虽然它不是替代 CI/CD 工具（如gitHub Actions 或jenkins）的方案，但在本地部署、简单环境同步或作为部署流程的一部分时非常实用。
定义composer script 的目标
在编写复杂脚本前，先明确你想自动化的步骤。常见任务包括：
- 检查 代码规范（例如使用 PHP CS Fixer 或 PHPLint）
- 运行测试（PHPUnit）
- 清除缓存（symfony、laravel等框架）
- 构建 前端 资源（调用 npm 或yarn）
- 同步文件到远程服务器（rsync 或 scp）
- 执行 数据库 迁移
- 发送部署通知（如 Slack webhook）
目标清晰后，就可以把这些命令组织成一个串行流程。
在 composer.json 中定义脚本
使用 scripts 字段注册自定义命令。对于复杂逻辑，建议调用外部 PHP 脚本而不是写长串 shell 命令。
{"scripts": { "deploy:precheck": [ "@php ./scripts/deploy/precheck.php"], "deploy:build": ["npm run build --cwd=assets", "@php ./scripts/deploy/build.php" ], "deploy:sync": "@php ./scripts/deploy/sync.php", "deploy:migrate": "@php ./scripts/deploy/migrate.php", "deploy:notify": "@php ./scripts/deploy/notify.php", "deploy": ["composer run deploy:precheck", "composer run deploy:build", "composer run deploy:sync", "composer run deploy:migrate", "composer run deploy:notify"] } }这样你就可以通过 composer run deploy 一键触发整个流程。
编写独立的 PHP 部署脚本
将每个步骤写成独立的 PHP 文件，便于调试和复用。例如precheck.php：
#!/usr/bin/env php <?php // scripts/deploy/precheck.php $checks = ['Git 干净' => function() {exec('git diff --quiet HEAD'); return $? }, 'PHP 语法正确' => function() { exec('find . -name "*.php" -not -path "./vendor/*" | xargs php -l', $output, $code); return $code === 0; }, '单元测试通过' => function() { exec('phpunit --stop-on-failure', $output, $code); return $code === 0; } ]; foreach ($checks as $name => $check) {echo "✅ 正在检查：$name……"; if ($check()) {echo " 通过 n ";} else {echo "❌ 失败 n "; exit(1); } }确保脚本有可执行权限：chmod +x scripts/deploy/*.php
处理环境配置与安全
避免在脚本中硬 编码 敏感信息。使用环境变量或配置文件：
// scripts/deploy/sync.php $host = $_ENV['DEPLOY_HOST'] ?? null; $key = $_ENV['DEPLOY_SSH_KEY'] ?? '/id_rsa'; if (!$host) {echo " 错误：未设置 DEPLOY_HOSTn"; exit(1); } exec("rsync -avz -e 'ssh -i $key' ./public/ user@$host:/var/www/html/", $output, $code); if ($code !== 0) {echo " 同步失败 n "; exit(1); }运行前导出变量：DEPLOY_HOST=prod.example.com composer run deploy
也可以使用 .env 文件配合 dotenv 库加载配置。
基本上就这些。Composer 脚本适合中小型项目的部署串联，关键是把逻辑拆解、保持可读性，并做好错误处理。
以上就是如何编写一个复杂的 composer script 来自动化部署？的详细内容，更多请关注php 中文网其它相关文章！
