Composer run-script命令利用 pre-autoload-dump 钩子动态修改代码-composer-PHP中文网

pre-autoload-dump在vendor/autoload.php写入前一刻触发，此时composer.json已解析、依赖已解包但自动加载器未生成，适合做动态代码生成、stub注入或autoload配置修补等预处理操作。

composer run-script命令利用 pre-autoload-dump 钩子动态修改代码

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

下载

pre-autoload-dump 钩子到底在什么时候触发？ `pre-autoload-dump` 不是安装或更新完成才跑，而是在 Composer 写入 `vendor/autoload.php` 和生成类映射前一刻执行。这意味着：此时 `composer.json` 已解析完毕、依赖已下载解压、但自动加载器还没生成——你有机会在类被注册前动态改代码、补文件、甚至重写 `autoload` 配置。常见错误是把它当成“安装后钩子”用，结果发现改完的文件没被 autoload 识别，因为类映射已经固化了。它不是 post-install-cmd 的替代品，而是更早、更底层的一次干预机会。

使用场景集中在：

根据当前环境/版本号生成常量定义文件（如 build/version.php）
将 stub 文件注入到 vendor 包的特定路径（绕过包自身 autoload 限制）
修补第三方包中硬编码的路径或配置（不 fork 也能临时生效）

如何让 run-script 正确绑定 pre-autoload-dump？必须在 composer.json 的 scripts 段显式声明钩子名，不能靠别名或间接调用：

"scripts": {
    "pre-autoload-dump": [
        "@php build/generate-version.php",
        "MyVendor\BuildScript::injectStub"
    ]
}

注意两点：

pre-autoload-dump 是固定钩子名，拼错（如 pre-autoloader-dump）就完全不触发
数组内每项都会执行，但顺序很重要：前面脚本若失败（exit code ≠ 0），后续条目会被跳过
类方法调用要求该类已能被当前 autoloader 加载——通常得放在 autoload-dev 下，且不能依赖尚未生成的映射

动态修改代码时为什么 vendor/autoload.php 还是旧的？因为 `pre-autoload-dump` 执行时，Composer 尚未写入任何 autoload 文件。你看到的“旧”文件其实是上一次运行留下的缓存。真正要改的是即将生成的内容，而不是去 patch 已存在的 `vendor/autoload.php`。常见踩坑：

在钩子里直接 `file_put_contents('vendor/autoload.php', ...)` —— 下一步 Composer 会覆盖掉

试图 require 当前项目里未声明 autoload 的新文件 —— 类找不到，报 `Class not found`

往 `vendor/` 下写新 PHP 文件，但没同步更新 `composer.json` 的 `autoload` 或 `autoload-dev` —— 新文件不会进映射

正确做法是：只改那些 Composer 生成阶段会读取的输入源，比如：

修改 `composer.json` 中的 `autoload.files` 数组（需重新 dump）

生成一个被 `autoload.files` 引用的 PHP 文件（如 `generated/constants.php`）

用 `ComposerAutoloadAutoloadGenerator` API 注入自定义 loader（高级用法，需小心破坏默认行为）

PHP 版本和 Composer 版本对钩子支持有影响吗？有。低于 Composer 2.2 的版本不支持在 `scripts` 数组里写类方法调用（即 `MyVendor\Script::run` 形式），会报 `ScriptNotFoundException`。2.2+ 才正式支持 callable 格式。 PHP 方面，钩子脚本本身受当前 CLI PHP 版本约束，但要注意：

如果钩子生成的代码含 PHP 8.1+ 语法（如枚举），而目标部署环境是 PHP 7.4，就会在 autoload 阶段 fatal error

`pre-autoload-dump` 不走 composer install 的 `--ignore-platform-reqs`，所以平台检查仍生效

最易忽略的是钩子脚本的退出码：返回非零值会导致整个 `composer install` 中断，连 vendor 目录都可能不完整。调试时建议先加 `echo` + `exit(0)` 确认流程可达，再逐步放开逻辑。