如何使用 Composer Scripts 实现一个简单的项目部署钩子？

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（旧版）

iSlide PPT

DeepSeek AI加持，输入主题生成专业PPT，支持Word/PDF等45种文档导入，职场汇报、教学提案轻松搞定

375

查看详情

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 才能真正起到“钩子”的作用。

以上就是如何使用 Composer Scripts 实现一个简单的项目部署钩子？的详细内容，更多请关注php中文网其它相关文章！