怎么编写一个自定义的composer installer_教你编写自定义composer安装器-composer-PHP中文网

通过创建实现InstallerInterface的类可自定义Composer包安装逻辑，如按类型将包安装到指定目录。需继承LibraryInstaller并实现supports和getInstallPath方法，再在composer.json中将type设为composer-plugin并配置extra.class指向该类，最后在目标包中设置对应type即可触发自定义安装路径。

怎么编写一个自定义的composer installer_教你编写自定义composer安装器

想让 Composer 安装某些包时走特定逻辑？比如把某个类型的包统一安装到指定目录，或者执行特殊处理？你可以编写一个自定义的 Composer Installer。这在开发框架插件、CMS 模块或企业级项目中非常实用。

理解 Composer Installer 的作用

Composer 默认会把包安装到 vendor/ 目录下。但通过自定义 installer，你可以控制包的安装路径和行为。例如：

将主题包安装到 themes/
把插件放入 plugins/
为不同类型的包执行不同的部署逻辑

实现的关键是创建一个类，实现 ComposerInstallerInstallerInterface 接口，并在 composer.json 中声明支持的类型。

步骤一：创建自定义 Installer 类

先创建一个 PHP 类文件，比如 src/MyCustomInstaller.php：

<?php namespace YourVendorCustomInstaller;

use ComposerInstallerLibraryInstaller;
use ComposerPackagePackageInterface;
use ComposerRepositoryInstalledRepositoryInterface;

class MyCustomInstaller extends LibraryInstaller
{
    public function supports($packageType)
    {
        return $packageType === 'my-custom-type';
    }

    public function getInstallPath(PackageInterface $package)
    {
        $type = $package->getType();

        $projectDir = $this->composer->getInstallationManager()->getInstallPath(
            $this->composer->getPackage()
        );

        return $projectDir . '/custom-packages/' . $package->getName();
    }
}

说明：

继承 LibraryInstaller 可以复用基础逻辑
supports() 判断是否处理该类型包
getInstallPath() 返回实际安装路径

步骤二：配置 composer.json

在你的 installer 包根目录下的 composer.json 中声明：

jm-jsjkxyjs02-zlm-405

使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。

下载

{
    "name": "your-vendor/composer-custom-installer",
    "type": "composer-plugin",
    "autoload": {
        "psr-4": {
            "YourVendor\CustomInstaller\": "src/"
        }
    },
    "require": {
        "composer-plugin-api": "^2.0"
    },
    "require-dev": {
        "composer/composer": "^2.0"
    },
    "extra": {
        "class": "YourVendor\CustomInstaller\MyCustomInstaller"
    }
}

注意：

type 必须是 composer-plugin
extra.class 指定入口类
确保 autoloading 正确指向你的类

步骤三：使用你的自定义 Installer

现在别人可以用你定义的类型了。比如一个要被特殊安装的包：

{
    "name": "your-vendor/special-package",
    "type": "my-custom-type",
    "require": {
        "php": ">=7.4"
    }
}

当这个包被安装时，Composer 会调用你的 installer，把它放到 custom-packages/your-vendor/special-package。

基本上就这些。核心就是实现 installer 类并正确注册。不复杂但容易忽略 autoload 和 extra 配置。测试时建议用本地 repo 或 path 方式引入验证。