Composer Scripts 可定义 deploy 等自定义命令,通过 composer run deploy(或 composer deploy)按序执行测试、安装依赖、配置复制、缓存清理、权限设置等部署操作,支持 Git 钩子与 CI/CD 集成,实现轻量级标准化部署。

Composer Scripts 可以在项目中定义自定义命令,配合部署流程(比如 Git 钩子或 CI/CD)自动执行构建、清理、权限设置等操作,无需额外工具就能实现轻量级部署钩子。
在 composer.json 中定义部署脚本
编辑项目的 composer.json,在 "scripts" 字段下添加一个名为 "deploy" 的脚本(名称可自定义),例如:
- 运行测试(可选):
"phpunit --no-coverage" - 安装依赖(确保 vendor 一致):
"composer install --no-dev --optimize-autoloader" - 生成生产配置(如复制 .env.production 到 .env):
"cp .env.production .env" - 清空缓存(Laravel 示例):
"php artisan config:clear && php artisan cache:clear" - 设置目录权限(Linux/macOS):
"chmod -R 755 storage bootstrap/cache"
完整示例片段:
"scripts": {
"deploy": [
"@phpunit",
"composer install --no-dev --optimize-autoloader",
"cp .env.production .env",
"php artisan config:clear && php artisan cache:clear",
"chmod -R 755 storage bootstrap/cache"
],
"phpunit": "phpunit --no-coverage"
}
通过 Composer 命令触发部署
在服务器或部署环境中进入项目根目录后,直接运行:
composer run deploy(Composer 2.2+) 或 composer deploy(旧版)
Composer 会按顺序执行所有定义的命令。如果某步失败(如文件不存在、权限不足),后续步骤将中止,便于快速定位问题。
与 Git 钩子或部署脚本集成
在服务器上配置 post-receive 钩子或使用简单 shell 脚本时,可把 Composer 部署命令作为关键环节:
- 拉取代码后切换到项目目录
- 执行
git checkout main && git pull - 运行
composer run deploy - 可选:重启 PHP-FPM 或通知服务已更新
这样就把部署逻辑集中维护在 composer.json 中,团队成员或新服务器只需执行一条命令即可完成标准流程。
注意事项和小技巧
- 脚本中尽量用相对路径,避免硬编码绝对路径
- 敏感操作(如 rm -rf)建议先加 echo 测试,再替换为真实命令
- 跨平台兼容性差的命令(如 chmod、cp)可在 Windows 环境下用条件判断跳过,或改用 PHP 脚本封装
- 想调试脚本执行过程,加
-v参数:composer run deploy -v
基本上就这些。不复杂但容易忽略的是:脚本顺序很重要,且必须保证每一步的退出码正确(非零即失败),Composer 才能真正起到“钩子”的作用。










