Composer怎么配置extra字段_Composer如何在extra中传递自定义数据给插件或脚本【基础】-composer-PHP中文网

extra字段必须写在项目根目录composer.json的顶层键，值为json-serializable类型，键名建议小写字母+下划线；插件通过$composer->getpackage()->getextra()读取，需空值判断，且仅install/update后生效。

composer怎么配置extra字段_composer如何在extra中传递自定义数据给插件或脚本【基础】

必须写在项目根目录的 composer.json 里，且是顶层键（和 require、scripts 同级），不是插件或包的配置位置。

示例正确写法：

{"extra": {"my-plugin-config": {"timeout": 30, "enabled": true}}}

Composer 插件通过 Event 对象访问 Composer\Composer 实例，再调用 getPackage()->getExtra() 获取整个 extra 数组。

常见错误：直接读 $event->getComposer()->getPackage()->getExtra()['my-key'] 却没做空值判断，一旦 key 不存在就报 Undefined index
安全读法应始终用 array_key_exists() 或三元 + null 合并（??），例如：
```
$config = $composer->getPackage()->getExtra()['my-plugin-config'] ?? [];
```
注意：只有在 install/update 后生成的 vendor/composer/installed.json 中才会固化 extra 数据；开发时改了 composer.json 必须重新 run composer install 才能被插件读到

extra 是静态配置，全局可用、生命周期长；scripts 中的命令行参数是临时、一次性的，两者定位完全不同。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

如果你需要在 post-install-cmd 脚本里用某个开关控制行为，extra 更合适；若只是某次调试想传个 flag，用 composer run-script xxx -- --debug 更轻量
extra 数据会被写入 installed.json，所有依赖该包的项目都能间接读取（只要插件支持）；而 scripts 参数只在当前执行上下文有效
性能上无差异，但滥用 extra 存大量数据（如 base64 图片、长文本）会拖慢 composer install 解析速度，也增大 installed.json 体积

最常见原因是插件没监听正确的事件，或 Composer 版本太低导致 API 不兼容。

确认插件是否注册了 post-install-cmd 或 post-update-cmd 等事件——extra 在 pre-* 阶段还不可用，因为 composer.json 尚未完全加载完成
检查 Composer 版本：extra 的完整支持从 Composer 2.0 开始稳定；1.x 中部分插件实现不一致，尤其涉及嵌套数组时容易丢键
运行 composer show -s 查看已启用插件列表，确保你的插件确实在运行；有些插件默认禁用，需在 extra 里显式开启开关（如 "enable-my-plugin": true）
调试技巧：在插件中临时加 var_dump($composer->getPackage()->getExtra()); die;，看输出是否符合预期