Composer如何实现在执行安装后自动运行特定任务（事件监听）-composer-PHP中文网

composer install后自动执行脚本依靠scripts配置+post-install-cmd事件钩子机制，该钩子在依赖下载、解压及autoload生成完成后触发，需写在根composer.json顶层scripts字段中，加--no-scripts会跳过，失败则中断安装流程。

composer如何实现在执行安装后自动运行特定任务（事件监听）

Composer install 后自动执行脚本靠什么机制

靠 scripts 配置 + 事件钩子，不是插件也不是额外工具。Composer 原生支持在生命周期关键节点触发自定义命令，post-install-cmd 就是安装完成后的标准钩子。

它会在 composer install（含首次安装和更新依赖后重装）成功执行完所有包下载、解压、autoload 生成之后运行，时机可靠，且默认启用，无需额外开关。

只对当前项目生效，写在根目录 composer.json 的 scripts 字段里
不区分是否带 --no-scripts：加了这个参数，钩子直接被跳过，不会执行
如果命令失败（退出码非 0），整个 composer install 流程会报错退出，这点常被忽略

怎么配置 post-install-cmd 才能稳定运行 PHP 脚本

最稳妥的方式是调用一个可执行的 PHP 文件入口，而不是内联 php -r 或直接写类方法——前者难调试，后者依赖 autoload 尚未完全就绪（虽然通常可用，但有概率出 Class not found）。

推荐结构：scripts/post-install.php 作为统一入口，用绝对路径加载，避开 autoloader 状态不确定性。

Discussion Composer

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

下载

{
    "scripts": {
        "post-install-cmd": [
            "php scripts/post-install.php"
        ]
    }
}

scripts/post-install.php 开头需加 #!/usr/bin/env php 并设可执行权限（Linux/macOS），或确保用 php 显式调用
该文件内不要依赖 vendor/autoload.php 以外的第三方类——因为此时 autoload 已生成，但某些插件类可能尚未注册到 PSR-4
如需调用 Laravel 的 Artisan 命令，改用 php artisan optimize:clear 这类 shell 方式更稳，别尝试 Artisan::call()

常见失败现象和对应排查点

执行没反应、报错中断、或提示 Script ... handling the post-install-cmd event returned with error code 1 是高频问题。

脚本文件没有执行权限（Linux/macOS）：运行 chmod +x scripts/post-install.php
PHP 版本不一致：Composer CLI 用的 PHP 和脚本里 php 命令指向不同版本，用 which php 和 composer config --list | grep bin-dir 核对
相对路径失效：脚本里用 __DIR__ 安全，别用 getcwd() —— Composer 可能在子目录执行 install
输出被缓冲导致看不到错误：在脚本开头加 ini_set('display_errors', 1); error_reporting(E_ALL);

post-install-cmd 和 post-autoload-dump 有什么区别

两者触发时机不同，不能混用。post-install-cmd 在整个安装流程末尾运行；而 post-autoload-dump 仅在 vendor/autoload.php 重新生成后触发，比如运行 composer dump-autoload 或 install/update 中 autoload 更新阶段。