Composer 不能直接安装标准 WordPress 插件，必须通过 wpackagist.org 仓库并配置 installer-paths 才能将插件正确安装到 wp-content/plugins/；否则会失败或误入 vendor/ 目录。
Composer 本身不直接安装 WordPress 插件，它管理的是 PHP 包依赖，而标准 WordPress 插件（如从 wordpress.org 下载的 ZIP）不是 Composer 兼容的包。想用 Composer 安装插件，必须满足一个前提：该插件已发布为 Packagist 上的 type:wordpress-plugin 包，并配置了正确的 installer-paths。
为什么直接 composer require author/plugin-slug 大概率失败
绝大多数 WordPress 插件作者并未将插件注册到 Packagist，也未在 composer.json 中声明 "type": "wordpress-plugin" 和适配的自动安装路径。此时运行 composer require 会报错：Could not find a matching version of package author/plugin-slug，或安装后文件被放进 vendor/ 而非 wp-content/plugins/，导致 WordPress 后台无法识别。
正确做法：使用 wpackagist.org 作为自定义仓库
wpackagist.org 是一个社区维护的镜像服务，它把 wordpress.org 插件目录实时同步为 Composer 可识别的包源。你需要显式添加它，并配置插件安装路径：
- 在项目根目录的
composer.json中添加仓库配置：
{
"repositories": [
{
"type": "composer",
"url": "https://wpackagist.org"
}
],
"require": {},
"extra": {
"installer-paths": {
"wp-content/plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
- 确保项目中已存在
wp-content目录（Composer 不会自动创建） - 执行安装命令，例如安装
advanced-custom-fields：
composer require wpackagist-plugin/advanced-custom-fields
注意包名格式固定为 wpackagist-plugin/{slug}，slug 可在插件页面 URL 中找到（如 https://wordpress.org/plugins/woocommerce/ → wpackagist-plugin/woocommerce）。
常见陷阱与注意事项
以下问题极易导致安装后插件不生效：
-
wp-content目录权限不足或路径不在 Web 根目录下，导致 WordPress 找不到插件文件 - 未在
extra.installer-paths中指定"type:wordpress-plugin"对应路径，插件会被错误地放进vendor/ - 插件有 PHP 版本或扩展依赖（如
mbstring），但本地环境不满足，composer install会静默跳过或报错 -
wpackagist.org的索引有数小时延迟，新发布的插件可能暂时搜不到 - 某些插件（尤其是商业插件）不公开在 wordpress.org，也不提供 Composer 包，只能手动下载并放入
wp-content/plugins/
真正能走 Composer 流程的插件，本质是“被 wpackagist 收录 + 你配对了 installer-paths”。漏掉任一环节，就退回手动管理。别指望 Composer 自动解决所有 WordPress 插件分发问题。
