Composer如何开发代码生成插件_Composer代码生成插件开发思路-composer-PHP中文网

必须监听post-autoload-dump事件，因为此时vendor/autoload.php已生成、psr映射已解析合并，调用$composer->getpackage()->getautoload()才能获取完整准确的自动加载配置，避免生成错位或无法加载的代码。

composer如何开发代码生成插件_composer代码生成插件开发思路

Composer 代码生成插件不是“生成 PHP 类文件”那么简单——它必须在 post-autoload-dump 事件中触发，且生成逻辑需基于已解析的依赖图和自动加载配置，否则生成的文件会错位、重复或无法被加载。

为什么必须监听 `post-autoload-dump` 而不是 `post-install-cmd`

因为只有 post-autoload-dump 触发时，Composer 才已完成：vendor/autoload.php 的生成、PSR-4/PSR-0 映射的解析、所有包的 autoload 配置合并。此时调用 $composer->getPackage()->getAutoload() 才能拿到完整准确的映射规则。

常见错误是监听 post-install-cmd 后直接遍历 vendor/ 目录生成代理类——这时 autoload 文件还没写入磁盘，你读到的是旧缓存或空结构，生成的类可能引用不存在的命名空间。

post-install-cmd 在命令开始后立即触发，vendor/ 可能刚解压，autoload 还没构建
post-autoload-dump 是唯一保证 vendor/autoload.php 已就绪、且所有包 autoload 配置已归并完成的事件
若插件需跳过 dev-only 包（如 phpunit），应在监听器中检查 $event->isDevMode()，避免生产环境误生成

`activate()` 中如何安全读取项目 autoload 配置

不能用 file_get_contents('composer.json') 或 getcwd() 拼路径——项目根目录不一定是当前工作目录，且 composer.json 未经过 Composer 内部 normalize 校验。

正确方式是通过 $composer 实例获取已解析对象：

$autoload = $composer->getPackage()->getAutoload();
$psr4 = $autoload['psr-4'] ?? [];
$psr0 = $autoload['psr-0'] ?? [];

注意：getAutoload() 返回的是 Composer 解析后的数组，键为命名空间前缀，值为路径数组（支持多个源目录）。路径值已是相对于项目根目录的相对路径，无需再拼 getcwd()。

Discussion Composer

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

下载

路径值如 ["src/"]，不是 "/full/path/to/src/"
若要拼出绝对路径，用 $composer->getConfig()->get('vendor-dir') 获取 vendor 目录，再结合 getPackage()->getExtra() 中用户自定义的生成目录
不要在 activate() 阶段就调用 file_put_contents() —— 此时 autoload 还未生成，路径不可靠

生成类时如何避免命名冲突和重复写入

代码生成插件最容易被投诉的问题是：多次运行 composer install 导致同一代理类被反复覆盖，或与用户手写类冲突。

解决方案是加守卫逻辑：

生成前先检查目标文件是否存在且内容哈希匹配（避免无意义重写）
生成类名应带唯一标识，比如以 Generated_ 开头，并加注释说明“DO NOT EDIT — generated by my-plugin”
若用户已在 extra 中配置 "skip-generation": ["MyVendor\Helper"]，需提前过滤掉这些命名空间
生成失败时用 $io->writeError() 输出错误，不要抛出未捕获异常（否则中断整个 composer install）

本地调试时 `post-autoload-dump` 不触发？

这个事件默认有缓存优化：如果 vendor/autoload.php 已存在且所有 autoload 配置未变，Composer 会跳过 dump 步骤，也就不会触发事件。

开发阶段强制触发的方法：

加 --no-cache 参数：composer dump-autoload --no-cache -v
删掉 vendor/autoload.php 再运行 composer install
在监听器开头加 $io->writeError('DEBUG: post-autoload-dump fired');，用 -v 查看是否输出
确认插件已激活：运行 composer diagnose，看输出里是否有 “Plugin my-vendor/my-plugin is installed”