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 install、composer update、手动触发等)。
哪些事件名对应真实执行阶段?
Composer 官方定义了固定事件名,但只有部分在标准流程中自动触发。常见被误认为“总能执行”的事件,其实有明确前置条件:
-
pre-install-cmd和post-install-cmd:仅在运行composer install时触发(不含--no-scripts) -
pre-update-cmd和post-update-cmd:仅在composer update时触发,install不会触发它们 -
pre-autoload-dump和post-autoload-dump:只要 autoload
er 被重建就会触发(包括
install、update、dump-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-cmd或post-update-cmd - 脚本类未被 autoload 加载 → 报
Class 'MyScript' not found,需确认类已声明在autoload或autoload-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的作用与实践


