Composer包管理器怎么执行脚本钩子-composer-PHP中文网

scripts字段必须定义在composer.json根对象顶层，值为字符串或字符串数组，仅内置钩子名（如post-install-cmd）可自动触发，自定义脚本需composer run显式调用。

composer包管理器怎么执行脚本钩子

composer.json 里 scripts 字段怎么写

Composer 脚本钩子本质就是 scripts 字段中定义的命令，它不依赖外部工具，直接由 Composer 解析执行。关键不是“怎么挂”，而是“写在哪、怎么写、哪些能用”。

必须放在 composer.json 根对象下，不能嵌套在 config 或其他字段里。常见错误是误写成 "scripts": { "post-install-cmd": { "MyClass::myMethod" } } —— 这会直接报错，因为值必须是字符串或字符串数组。

单条命令："post-autoload-dump": "php build/generate-api.php"
多条顺序执行："pre-install-cmd": ["@php -v", "echo 'starting...']
调用 PHP 类方法（需自动加载已就绪）："post-update-cmd": "App\Scripts\Deploy::cleanup"
引用其他脚本（用 @xxx）："post-install-cmd": ["@clear-cache", "@build-assets"]

哪些钩子名是有效的、什么时候触发

钩子名不是随便起的，只有 Composer 内置识别的名称才真正生效。比如 post-install-cmd 只在 composer install 成功后运行；而 post-autoload-dump 在每次生成或更新 vendor/autoload.php 后触发（install、update、dump-autoload 都算）。

容易混淆的是 -cmd 后缀：带后缀的（如 post-install-cmd）只响应 CLI 命令；不带后缀的（如 post-install）还会在 API 调用时触发 —— 但绝大多数项目只走 CLI，所以优先用带 -cmd 的版本，行为更可预期。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

安装依赖后：post-install-cmd
更新依赖后：post-update-cmd
自动加载器重建后：post-autoload-dump（最常用，适合跑代码生成、类型声明补全等）
包安装/卸载时：pre-package-install、post-package-uninstall（注意：只对当前包生效，不是全局）

PHP 方法作为脚本执行时的限制

用 "MyClass::method" 形式调用时，Composer 会尝试通过已有的自动加载机制加载该类。这意味着：类必须已在 autoload 或 autoload-dev 中声明，且命名空间路径正确；方法必须是 public static；参数固定为空 —— 不支持传参，也不支持返回值控制流程。

另一个坑是工作目录：脚本执行时的 getcwd() 是项目根目录（即 composer.json 所在处），不是 vendor/bin 或脚本所在目录。如果方法里用了相对路径，比如 file_get_contents('config/app.php')，得确认它真在项目根下。

不要在静态方法里依赖 $argv 或期望接收命令行参数
异常不会被静默吞掉：抛出未捕获异常会导致整个 Composer 命令失败（这是对的，别试图 try/catch 掩盖）
若需访问 Composer 实例（如读取配置、获取已安装包列表），可通过 ComposerScriptEvent 参数拿到：public static function myHook(Event $event) { ... }

调试脚本为什么没运行

最常遇到的是“写了钩子，但命令执行完一点反应都没有”。先确认三件事：钩子名拼写是否完全匹配（大小写敏感）、是否在正确的 composer.json（子模块？根项目？）、命令是否真的触发了该钩子（比如改了 scripts 但执行的是 composer dump-autoload，那 post-install-cmd 就不会动）。

加 --verbose 是最快验证方式：composer install --verbose 会打印每一步执行的脚本及其输出。如果连日志都没出现，说明钩子根本没注册上 —— 此时回去检查 JSON 格式（尤其逗号、引号）、字段位置、是否被其他配置覆盖（例如某些插件会劫持 scripts）。