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：
东盟商机最新AC版As2007 SP1
下载
AS系统本次的主要更新和新开发的功能如下（暂不详述）： 1、修复了普及版的一些大大小小的BUG 2、重新规划整个后台，使后台更加个性化、智能化、更加易用 3、重写了广告部分模块，使其更加专业化 4、重写了文章采集模块，添加了定时自动采集功能 5、添加了供求信息采集功能 6、重写了友情连接功能（原来的太简单了） 8、重写了生成HTML模块。（几个主要模块首页不用原来的生成方式，不再会被卡巴斯机杀毒软
#!/usr/bin/env php
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_HOST\n";
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脚本适合中小型项目的部署串联，关键是把逻辑拆解、保持可读性，并做好错误处理。
