post-install-cmd是Composer内置事件，仅在composer install真正从零安装依赖时自动触发，需在composer.json的scripts下严格配置为"post-install-cmd"数组，否则静默失效。
Composer install 时如何触发自定义 PHP 脚本？
直接靠 composer.json 的 scripts 字段就能实现，不需要写插件。关键在于选对事件名：安装依赖时默认触发 post-install-cmd，不是 post-update-cmd（后者只在 composer update 时触发）。
常见错误是把逻辑全塞进 post-autoload-dump——它只在 autoloader 重建时执行，而首次 composer install 可能跳过 autoload 生成（比如没配置 autoload），导致脚本完全不运行。
-
post-install-cmd稳定可靠，只要install成功就执行 - 脚本必须是可执行的 PHP 文件（如
bin/post-install.php），或直接调用带php前缀的命令 - 避免在脚本里依赖尚未安装的包——此时
vendor/autoload.php已存在，但第三方类可能还没加载进 autoloader
怎么让监听器访问 Composer 的内部对象（如 Package、IO）？
纯脚本方式拿不到 Composer\Script\Event 对象，得改用“脚本类”写法。把逻辑封装成静态方法，并接受 Composer\Script\Event 参数，才能读取当前安装的包列表、交互输入、甚至修改操作流程。
示例：在 src/Scripts/InstallHook.php 中定义：
namespace App\Scripts;
<p>use Composer\Script\Event;</p><p>class InstallHook
{
public static function onPostInstall(Event $event)
{
$io = $event->getIO();
$io->writeError('✅ 正在初始化项目配置...');</p><pre class="brush:php;toolbar:false;"> // 获取已安装的包名列表
$packages = $event->getComposer()->getPackage()->getRequires();
if (isset($packages['monolog/monolog'])) {
// 执行特定逻辑
}
}}
然后在 composer.json 中注册："post-install-cmd": "App\Scripts\InstallHook::onPostInstall"
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
注意：类必须能被 autoloader 加载（即路径和命名空间匹配 autoload 配置），否则报 Class not found 错误。
为什么 post-install-cmd 在 CI 环境中不执行？
因为 Composer 默认在非交互模式下禁用部分脚本——尤其是涉及用户输入或终端输出的。CI（如 GitHub Actions）通常设置 COMPOSER_NO_INTERACTION=1，这会跳过所有需要交互的脚本钩子。
解决办法只有两个：
- 显式启用：在 CI 的
composer install命令后加--no-interaction=false（不推荐，可能引发其他问题） - 更稳妥的做法：在脚本内部用
$event->getIO()->isInteractive()判断，把需交互的部分绕过，只保留无副作用的逻辑（如生成 config、清理缓存） - 检查 CI 是否用了
--no-scripts标志——这是最常被忽略的开关，一旦启用，所有scripts都不会执行
能否监听单个包的安装过程？
不能。Composer 的事件机制是全局的，没有 post-package-install 这类钩子。所谓“监听某个包”，实际只能靠事后扫描 vendor/ 目录或解析 composer.lock 文件判断是否新增了该包。
例如，在 post-install-cmd 中读取 composer.lock：
$lock = json_decode(file_get_contents('composer.lock'), true);
$installed = array_column($lock['packages'], 'name');
再检查 in_array('foo/bar', $installed)。但要注意：
- composer.lock 可能尚未写入（某些极端并发场景）
- 该方式无法区分是首次安装还是重复安装
- 不适用于 composer require foo/bar 单独操作，因为它触发的是 post-update-cmd，不是 post-install-cmd
真正想做细粒度控制，得上 Composer Plugin，但那意味着要维护独立的包、处理版本兼容、应对 Composer 自身升级带来的 API 变动——多数项目没必要走到这一步。
