如何通过Composer在WordPress项目里管理插件？（最佳实践）

WordPress可通过Composer管理插件、主题及核心：配置composer/installers指定安装路径，使用WPackagist获取官方插件，借助johnpbloch/wordpress-core分离核心，忽略wp-content/plugins提交，仅保留composer.json与.lock实现可复现自动化管理。

WordPress本身不原生支持Composer，但通过合理配置，完全可以把插件（甚至主题、核心）纳入Composer依赖管理——关键是用对工具和约定，而不是强行“改造”WordPress。

用composer/installers指定插件安装路径

默认情况下Composer会把包装进vendor/，这对WordPress插件没用。你需要告诉Composer：遇到wordpress-plugin类型的包，就放进wp-content/plugins/。

• 在项目根目录的composer.json中添加：

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

登录后复制

这样，执行composer require wpackagist-plugin/advanced-custom-fields就会自动装到wp-content/plugins/advanced-custom-fields/，无需手动复制。

从WPackagist拉取官方插件

WordPress.org插件没有自己的Packagist仓库，WPackagist是社区维护的镜像，把WordPress.org插件自动同步为Composer可安装包。

• 确保composer.json中已配置WPackagist为仓库源：

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

登录后复制

之后就能像安装普通PHP包一样安装插件：composer require wpackagist-plugin/woocommerce。注意包名格式固定为wpackagist-plugin/{slug}，slug可在插件页面URL里找到（如https://wordpress.org/plugins/yoast-seo/ → yoast-seo）。

用johnpbloch/wordpress-core管理WordPress核心（可选但推荐）

想把WordPress核心也纳入版本控制？用johnpbloch/wordpress-core替代官方zip包。它把WordPress按标准PSR-4结构拆分，支持wp-content独立存放。

标签： php word js git json composer wordpress seo 工具 wordpress插件