Composer如何运行自定义脚本_在composer.json配置scripts【开发利器】
自定义脚本不会自动运行，必须通过 composer run 或生命周期钩子（如 post-install-cmd）触发；写进 composer.json 的 scripts 字段只是声明，不是注册命令。
免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈
这里有个核心结论需要先明确： 在 composer.json 里写好脚本，并不意味着它就会自己跑起来。这些脚本声明，必须通过 composer run 命令手动调用，或者绑定到特定的生命周期事件（比如 post-install-cmd）上，才会被触发执行。
脚本名怎么写、怎么调用才有效
脚本的命名和调用，其实是个“对暗号”的过程。你定义的键名就是命令名，它大小写敏感，不能包含空格，而且必须和 composer run 后面跟的名字完全一致。举个例子：
"scripts": {
"dev:setup": "php scripts/setup.php",
"post-update-cmd": ["My\Script::clearCache"]
}
那么，对应的调用方式就是：
composer run "dev:setup"（注意双引号，在 Windows 环境下是必须加的）- 或者用
composer run-script "post-update-cmd"（不过更推荐统一的composer run） - 当然，直接执行
composer update也会自动触发绑定的post-update-cmd钩子
脚本“失效”的常见原因，往往就出在这些细节上：
- 脚本名拼写不一致，比如定义的是
dev-setup，调用时却用了composer run dev_setup。 - 在 Windows 系统下调用带冒号的脚本时，忘了加引号，导致命令报错或者静默失败。
scripts字段的缩进位置放错了，比如不小心嵌套到了require或其他配置块里，导致 Composer 根本读取不到。
PHP 回调脚本为什么报 Class not found
当你使用 MyScript::method 这种 PHP 回调写法时，可能会遇到“类找不到”的错误。这通常不是因为配置漏了，而是因为 Composer 在执行这类脚本时，并不会自动加载项目的 autoloader。
要解决这个问题，必须确保两点：
- 首先，这个类确实已经声明在
autoload或autoload-dev配置中，并且执行过composer dump-autoload来生成最新的加载映射。 - 其次，被调用的方法必须是
public static的，并且参数签名要兼容（可以接收一个可选的$event对象）。
最稳妥的做法，是在 PHP 脚本的开头就显式引入 Composer 的自动加载文件：
require __DIR__ . '/vendor/autoload.php';
记住，不要依赖 __autoload 函数或者手动去 include 单个文件——那样很容易遗漏依赖，也绕不开 Composer 自身的自动加载机制。
传参和跨平台执行要注意什么
如果想给脚本传递参数，比如把 --filter=TestFoo 传给 PHPUnit，就必须用 -- 进行显式分隔：
- ✅ 正确写法：
composer run test -- --filter=TestFoo - ❌ 错误写法：
composer run test --filter=TestFoo（这样参数会被 Composer 自身拦截掉）
脚本内容本身也需要考虑跨平台的兼容性：
- 对于 Shell 命令，建议使用数组格式来写，比如
["vendor/bin/phpunit", "--testsuite=unit"]。这样可以避免因空格和引号解析带来的各种奇怪问题。 - 在 Windows 下，不要硬编码
php.exe这样的路径，直接用@php或者简单的php，Composer 会帮你处理好。 - 路径一律使用相对路径，比如
./vendor/bin/phpcs，不要只写phpcs（依赖系统的 PATH 环境变量并不可靠）。
另外需要注意，父进程的环境变量（如 $PATH）默认不会被继承，项目根目录下的 .env 文件也不会自动加载，这些都需要在脚本内部手动处理。
钩子脚本该放哪、什么时候跑
post-install-cmd 和 post-update-cmd 这两个钩子，并不是“安装完”或“更新完”就一定会跑。它们严格绑定在具体的命令上：
- 执行
composer install时，会触发post-install-cmd。 - 执行
composer update或者composer require xxx时，只会触发post-update-cmd，而不会触发post-install-cmd。 - 如果是与自动加载相关的操作，比如刷新缓存、生成类映射文件，优先考虑使用
post-autoload-dump钩子。它触发得更精准，行为也更稳定。
当多个脚本需要共用一个钩子时，使用数组写法：
"post-autoload-dump": [ "My\Cache::clear", "php artisan config:clear" ]
这里有个容易被忽略的细节：如果数组中的某个脚本执行后返回了非零的退出码，那么同在这个钩子里的后续脚本都会被跳过。调试时，可以加上 -v 参数来查看实际的退出码。
相关攻略
Composer如何配置项目的描述信息_完善composer json元数据【开源标准】 这里有个关键点需要先明确：description字段只影响Packagist页面的展示效果和搜索匹配度，它完全不参与依赖解析或安装逻辑。虽然它不是必填项，但空着的话，你的包在搜索结果里就会显得缺乏上下文，像个“
Composer默认只读取当前工作目录的composer json，子目录中同名文件被忽略；需用--working-dir指定路径执行安装，且子包类要手动在根目录autoload中映射并dump-autoload。 如果你在项目里搞了子包，并且每个子包都有自己的composer json，那可得留神
自定义脚本不会自动运行，必须通过 composer run 或生命周期钩子（如 post-install-cmd）触发；写进 composer json 的 scripts 字段只是声明，不是注册命令。 这里有个核心结论需要先明确： 在 composer json 里写好脚本，并不意味着它就会自己跑
Composer怎么恢复误改的composer json_Composer如何用git checkout恢复配置文件再重新安装【避坑】 composer json 被误改后，直接 git checkout 就行 只要项目在用Git管理，并且composer json文件之前已经提交过，事情就简单多了
什么是Compose AI？ 你是否曾面对空白的文档感到无从下笔，或者在写作时反复修改、效率低下？Compose AI正是为解决这些痛点而生的智能写作工具。作为一款专为Chrome浏览器打造的AI写作插件，它能在你输入时实时分析意图，提供智能建议，让写作过程变得更加流畅、快速，彻底告别写作卡顿的困扰
热门专题
热门推荐
Ctrl+C失灵主因是程序拦截SIGINT信号或终端子进程未清理；需检查脚本是否空捕获异常、启用VSCode自动杀进程设置、用jobs ps排查挂起任务，并避免macOS下shell hook干扰。 Ctrl+C 没反应？先确认是不是信号被吞了 在VSCode终端里按下Ctrl + C却毫无动静，这
先查真实值：运行php -r "echo ini_get( memory_limit ); "和php --ini确认CLI模式下的实际memory_limit及配置路径；php -d memory_limit=2G是PHP内核级硬限制，COMPOSER_MEMORY_LIMIT=2G是Compose
composer install必须读composer lock，因为它只按锁文件中写死的版本号、哈希值和URL安装，确保本地、CI、线上环境vendor目录完全一致；删锁文件或Git忽略它会导致隐式update、依赖不一致及运行时错误。 composer install 为什么必须读 compos
如何在VSCode中解决TypeScript路径映射及智能提示失效问题 tsconfig json里baseUrl和paths配错，路径跳转和补全就断了 VSCode的TypeScript智能体验，比如路径跳转和代码补全，其底层引擎完全依赖于tsconfig json中的baseUrl和paths配
Sublime Text窗口透明需通过Transparency插件调用系统API实现，非原生支持；Windows Linux用户须先卸载SublimeTextTrans残留、配置Package Control源后安装，macOS因SIP限制基本不可靠。 先明确一个核心概念：Sublime Text本