composer如何配置自定义安装器_composer installers插件【高级】

composer/installers 是一个 composer 插件，用于将非标准类型包（如 wordpress 插件、drupal 模块）自动安装到对应框架的指定目录（如 wp-content/plugins/），而非默认 vendor/ 下。

composer installers 是什么，它解决什么问题

composer/installers 是一个 Composer 插件，用于支持非标准包类型的自动安装路径重定向。比如你写了一个 WordPress 插件、Drupal 模块或 TYPO3 扩展，它们本不该装进 vendor/ 下默认的命名空间目录，而应放进 wp-content/plugins/、modules/ 或 typo3conf/ext/ 这类特定位置。composer/installers 就是让 composer install 知道：“这个包类型（type）该往哪儿放”。

如何声明包类型并触发自定义安装路径

关键在你的包的 composer.json 中正确设置 type 字段，并确保项目已启用 composer/installers。

• 你的包（如一个 WordPress 插件）必须声明 "type": "wordpress-plugin" —— 这个值必须是 composer/installers 官方支持的类型之一，不能随意写
• 宿主项目（即你运行 composer install 的那个项目）的 composer.json 中需包含：

  "require": {
    "composer/installers": "^2.0"
  }

  （注意：v2+ 要求 PHP ≥ 7.4，v1 不再维护）
• 不需要手动注册安装器类；只要插件已安装且 type 匹配，Composer 会在安装时自动调用对应逻辑

自定义 type 映射：覆盖默认路径或新增类型

如果你的包类型不在官方列表中，或你想把 wordpress-plugin 改装到 custom-wp-plugins/ 而非默认的 wp-content/plugins/，就得用 extra.installer-paths 或 extra.installers 配置。

Windsurf

Codeium团队打造的AI编程助手

下载

• 用 extra.installer-paths（推荐，简单直接）：

  "extra": {
    "installer-paths": {
      "custom-wp-plugins/{$name}": ["type:wordpress-plugin"],
      "my-drupal-modules/{$name}": ["type:drupal-module"]
    }
  }

  其中 {$name} 会被替换成实际包名，方括号内是包选择器（支持 type:、vendor/name、name 等）
• 不建议用已废弃的 extra.installers（v1 风格），它需要手写类名映射，易出错且无类型安全
• 路径值必须是相对路径（相对于项目根目录），不能以 / 开头，否则 Composer 会静默忽略

常见失败原因和调试方法

安装没进预期目录？大概率卡在这几个点：

• composer install 时没看到 Using installer for type 'xxx' 日志？检查是否漏装 composer/installers，或版本太低（v1 不支持新 type）
• 写了 extra.installer-paths 却没生效？确认 JSON 格式合法、缩进无误；检查包的 type 值是否拼写一致（比如 wordpress-plugin ≠ wp-plugin）
• 路径里用了 ../ 或绝对路径？Composer 会跳过，只接受项目根目录下的相对路径
• 想让某个包既被 autoload 又被复制到插件目录？composer/installers 只管文件复制，autoload 仍需靠 autoload 字段单独配置，二者不联动

最有效的验证方式：删掉 vendor/ 和 composer.lock，运行 composer install -vvv，观察日志中 installer 是否被调用、路径是否匹配成功。