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脚本适合中小型项目的部署串联，关键是把逻辑拆解、保持可读性，并做好错误处理。