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独立存放。
- 在
composer.json中添加:
"require": {
"johnpbloch/wordpress-core": "^6.5"
},
"extra": {
"wordpress-install-dir": "wordpress"
}再配合wordpress-core-installer或自定义webroot重写规则,就能实现核心与内容分离——升级只需改版本号,运行composer update即可。
避免直接提交wp-content/plugins到Git
启用Composer后,wp-content/plugins应被视为构建产物,而非源码。把它加入.gitignore,只提交composer.json和composer.lock。
- 典型
.gitignore片段:
wp-content/plugins/* !wp-content/plugins/.keep wp-content/themes/* !wp-content/themes/.keep
部署时运行composer install --no-dev,插件自动还原。团队协作或CI/CD中,这能彻底避免版本冲突和手动同步遗漏。
基本上就这些。不用魔改WordPress,也不用写一堆脚本,靠标准Composer机制+几个关键配置,就能让插件管理变得可复现、可追踪、可自动化。










