如何编写一个符合 composer 规范的 post-install-cmd 脚本？

答案：编写 Composer 的 post-install-cmd 脚本需创建可调用类并注册到 composer.json。首先定义命名空间为 MyProject\Scripts 的 PostInstallScript 类，包含接受 Event 参数的静态 run 方法，用于输出信息、判断环境模式等操作；然后在 composer.json 中通过 PSR-4 将 scripts/ 目录映射到该命名空间，并在 scripts.post-install-cmd 中注册类方法全名；确保自动加载生效后，执行 composer install 即可触发脚本，输出预期内容并支持开发/生产环境判断与自定义逻辑扩展。

编写一个符合 Composer 规范的 post-install-cmd 脚本，关键在于理解 Composer 的脚本机制，并正确注册自定义 PHP 类或闭包函数。Composer 允许你在特定生命周期（如安装完成后）执行自定义逻辑。

定义脚本逻辑类

你需要创建一个类，其中包含静态方法或实现可调用接口。这个类将在 post-install-cmd 阶段被调用。

namespace MyProject\Scripts;

use Composer\Script\Event;
use Composer\Installer\PackageEvent;

class PostInstallScript
{
    public static function run(Event $event)
    {
        $io = $event->getIO();
        $io->write("执行 post-install-cmd 脚本");

        // 可以在这里添加清理缓存、生成配置、提示用户等操作
        if ($event->isDevMode()) {
            $io->write("当前为开发模式。");
        } else {
            $io->write("当前为生产模式。");
        }
    }
}

在 composer.json 中注册脚本

将你定义的类方法绑定到 post-install-cmd 事件。确保自动加载能识别你的脚本类。

修改 composer.json：

{
    "autoload": {
        "psr-4": {
            "MyProject\\Scripts\\": "scripts/"
        }
    },
    "scripts": {
        "post-install-cmd": [
            "MyProject\\Scripts\\PostInstallScript::run"
        ]
    }
}

这样 Composer 安装完成后会自动调用该方法。

Manus

全球首款通用型AI Agent，可以将你的想法转化为行动。

下载

支持命令行脚本与环境判断

你可以通过脚本控制行为差异，比如区分开发和生产环境，或者检查是否是首次安装。

• 输出提示信息：引导用户进行下一步操作
• 生成配置文件：基于模板创建 .env 或 config.php
• 清除缓存：确保新代码生效
• 执行权限检查：提醒用户设置目录可写

测试脚本是否生效

运行以下命令触发脚本：

composer install

如果一切正常，你会看到脚本输出的信息。若报错，请检查命名空间、路径映射和方法签名。

基本上就这些。只要类能被自动加载，方法是静态且接受 Event 对象，就能作为 post-install-cmd 正常运行。不复杂但容易忽略细节。