Composer scripts事件钩子大全 生命周期脚本执行时机【文档】

发布时间 - 2026-01-26 00:00:00    点击率:
Composer官方定义的事件中,pre-install-cmd和post-install-cmd仅在composer install时触发;pre-update-cmd和post-update-cmd仅在composer update时触发;pre-autoload-dump和post-autoload-dump在autoloader重建时(如install、update、dump-autoload)均触发;pre-root-package-install等仅限root包安装时触发。

Composer scripts 不是“钩子”,而是生命周期中可配置的命令执行点;事件名不等于触发时机,实际执行依赖于调用方式(composer installcomposer update、手动触发等)。

哪些事件名对应真实执行阶段?

Composer 官方定义了固定事件名,但只有部分在标准流程中自动触发。常见被误认为“总能执行”的事件,其实有明确前置条件:

  • pre-install-cmdpost-install-cmd:仅在运行 composer install 时触发(不含 --no-scripts
  • pre-update-cmdpost-update-cmd:仅在 composer update 时触发,install 不会触发它们
  • pre-autoload-dumppost-autoload-dump:只要 autoload

    er 被重建就会触发(包括 installupdatedump-autoload
  • pre-root-package-install 等内部事件:只在 root 包安装时触发,插件或子依赖不触发

scripts 配置写法影响执行逻辑

同一事件名下多个脚本默认串行执行,但行为受写法细节控制:

  • 数组形式:"post-install-cmd": ["MyScript::doSomething", "php build.php"] —— 每个元素独立执行,任一失败即中断
  • 字符串形式:"post-install-cmd": "MyScript::doSomething && php build.php" —— shell 合并执行,错误可能被忽略
  • 使用 @php 前缀(如 @php -r \"file_put_contents('log', date('c'))\")可绕过 PATH 查找,避免环境差异导致命令找不到
  • 含空格的路径必须用引号包裹:"php \"./scripts/deploy.php\" --env=prod"

常见失效场景和调试方法

脚本“没运行”往往不是配置错,而是没走到那个阶段:

  • 运行 composer install --no-scripts → 所有 scripts 全部跳过(包括 post-autoload-dump
  • 本地 composer.lock 已存在且无变更 → install 不触发 pre-update-cmdpost-update-cmd
  • 脚本类未被 autoload 加载 → 报 Class 'MyScript' not found,需确认类已声明在 autoloadautoload-dev
  • 调试建议:在脚本开头加 file_put_contents('debug.log', "post-install triggered\n", FILE_APPEND);,比 echo 更可靠(避免被静默丢弃)

真正容易被忽略的是:Composer 的事件机制不保证顺序一致性——比如多个包都注册了 post-autoload-dump,执行顺序取决于包加载顺序,而非 composer.json 中声明顺序。


# php  # js  # json  # composer  # app  # red  # echo  # date  # 字符串  # class  # 事件  # 多个  # 的是  # 加载  # 就会  # 走到  # 找不到  # 不含  # 只在  # 而非  # 仅限 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: Linux网络带宽限制_tc配置实践解析【教程】  如何挑选最适合建站的高性能VPS主机?  Laravel如何实现数据库事务?(DB Facade示例)  logo在线制作免费网站在线制作好吗,DW网页制作时,如何在网页标题前加上logo?  php中::能调用final静态方法吗_final修饰静态方法调用规则【解答】  高防服务器租用如何选择配置与防御等级?  Laravel如何清理系统缓存命令_Laravel清除路由配置及视图缓存的方法【总结】  Android自定义listview布局实现上拉加载下拉刷新功能  Laravel如何将应用部署到生产服务器_Laravel生产环境部署流程  php结合redis实现高并发下的抢购、秒杀功能的实例  html5audio标签播放结束怎么触发事件_onended回调方法【教程】  Laravel怎么连接多个数据库_Laravel多数据库连接配置  如何生成腾讯云建站专用兑换码?  Win11怎么修改DNS服务器 Win11设置DNS加速网络【指南】  Mybatis 中的insertOrUpdate操作  DeepSeek是免费使用的吗 DeepSeek收费模式与Pro版本功能详解  Laravel中间件如何使用_Laravel自定义中间件实现权限控制  Laravel如何配置Horizon来管理队列?(安装和使用)  如何快速搭建个人网站并优化SEO?  阿里云高弹*务器配置方案|支持分布式架构与多节点部署  香港服务器租用费用高吗?如何避免常见误区?  Laravel模型事件有哪些_Laravel Model Event生命周期详解  javascript中的try catch异常捕获机制用法分析  网站制作大概要多少钱一个,做一个平台网站大概多少钱?  香港服务器网站卡顿?如何解决网络延迟与负载问题?  如何用AWS免费套餐快速搭建高效网站?  详解阿里云nginx服务器多站点的配置  浏览器如何快速切换搜索引擎_在地址栏使用不同搜索引擎【搜索】  Laravel安装步骤详细教程_Laravel环境搭建指南  大连网站制作公司哪家好一点,大连买房网站哪个好?  如何在 Telegram Web View(iOS)中防止键盘遮挡底部输入框  如何用好域名打造高点击率的自主建站?  Laravel如何创建和注册中间件_Laravel中间件编写与应用流程  详解Nginx + Tomcat 反向代理 负载均衡 集群 部署指南  重庆市网站制作公司,重庆招聘网站哪个好?  ChatGPT怎么生成Excel公式_ChatGPT公式生成方法【指南】  Angular 表单中正确绑定输入值以确保提交与验证正常工作  Windows驱动无法加载错误解决方法_驱动签名验证失败处理步骤  Laravel如何获取当前用户信息_Laravel Auth门面获取用户ID  ,南京靠谱的征婚网站?  米侠浏览器网页背景异常怎么办 米侠显示修复  再谈Python中的字符串与字符编码(推荐)  php在windows下怎么调试_phpwindows环境调试操作说明【操作】  如何在服务器上三步完成建站并提升流量?  Laravel如何使用Sanctum进行API认证?(SPA实战)  Laravel怎么防止CSRF攻击_Laravel CSRF保护中间件原理与实践  零基础网站服务器架设实战:轻量应用与域名解析配置指南  瓜子二手车官方网站在线入口 瓜子二手车网页版官网通道入口  java中使用zxing批量生成二维码立牌  Laravel控制器是什么_Laravel MVC架构中Controller的作用与实践