WordPress如何用Composer管理？插件镜像源配置【技巧】-composer-PHP中文网

直接composer require wordpress/plugin-name必然失败，因wordpress插件不在packagist官方源，必须配置wpackagist.org仓库、composer/installers依赖及extra.installer-paths路径映射三者缺一不可。

wordpress如何用composer管理？插件镜像源配置【技巧】

composer require wordpress/plugin-name 会直接报错，因为 WordPress 插件根本不在 Packagist 官方源里。必须用 wpackagist.org 镜像源，配对 composer/installers 和 extra.installer-paths，三者缺一不可。

为什么直接 require wordpress/plugin-name 失败？

Packagist（packagist.org）只收录标准 PHP 包，不抓取 WordPress.org 插件库。你输的 wordpress/xxx 这类包名在官方源里根本不存在。

wpackagist-plugin/advanced-custom-fields 才是真实可用的包名，前缀固定为 wpackagist-plugin/
插件 slug 来自 URL：比如 https://wordpress.org/plugins/yoast-seo/ → slug 是 yoast-seo
不加仓库配置时，Composer 默认只查 packagist.org，压根不会去 wpackagist.org

必须配置的三项：仓库 + 安装器 + 路径映射

少任何一项，插件都会被装进 vendor/ 下，WordPress 后台完全看不到。

MiniMax Word

MiniMax Word专业文档生成 - 基于.NET OpenXML SDK，完整保留页眉页脚目录、修订痕迹、复杂表格样式，输出可直接交付的.docx文档。

下载

在 composer.json 的 repositories 字段里加镜像源：

"repositories": [
  {
    "type": "composer",
    "url": "https://wpackagist.org"
  }
]

require composer/installers（建议 ^2.0）

在 extra 中声明路径映射，例如：

"extra": {
  "installer-paths": {
    "wp-content/plugins/{$name}/": ["type:wordpress-plugin"],
    "wp-content/themes/{$name}/": ["type:wordpress-theme"]
  }
}

私有插件或付费插件怎么处理？

自己写的插件或 ACF Pro 这类付费插件，不能靠 wpackagist 自动同步，但路径映射逻辑一样有效。

插件根目录的 composer.json 必须显式写 "type": "wordpress-plugin"，否则 composer/installers 不识别
如果是 Git 仓库方式引入（"type": "vcs"），远程仓库的 composer.json 也得有这个 type
付费插件需配合 auth.json 提供私有仓库凭证，但 installer-paths 规则照常生效
注意：路径中别写 web/app/plugins 这类 Bedrock 结构，除非你项目已用 Bedrock 的 wp-config.php 做了重定向