Composer不能直接安装WordPress插件用于生产环境，因其非官方机制，不触发激活、不加载钩子，多数插件会报错或失效；需借助wpackagist+composer/installers配置installer-paths落地到wp-content/plugins/，再配合WP-CLI执行激活等运行时操作。
Composer 不能直接安装 WordPress 插件用于生产环境运行——它不是 WordPress 的官方插件管理机制，强行用 composer install 把插件放进 wp-content/plugins/ 不会触发激活、不会加载钩子、多数插件会报错或静默失效。
为什么 composer require wordpress-plugin/* 失败或不生效
绝大多数 WordPress 插件未发布到 Packagist，也没有遵循 Composer 的自动加载规范（如未定义 autoload 段、无 vendor/autoload.php 兼容入口、不提供 PSR-4 映射）。即使你用 composer require wpackagist-plugin/advanced-custom-fields 成功下载，WordPress 核心仍无法识别该插件为合法插件（缺少 Plugin Name: 注释头，文件路径不在 wp-content/plugins/ 直接子目录下）。
常见错误现象：
- 插件出现在
vendor/下，但后台「插件」列表里完全不可见 - 手动符号链接进
wp-content/plugins/后，激活时报Plugin could not be activated because it triggered a fatal error. -
wp plugin list --status=active查不到，get_plugins()返回空数组
真正可行的 Composer 集成方式：wpackagist + 安装器（installer-paths）
必须借助 wpackagist.org（非官方但广泛使用的 WordPress 插件/主题镜像源）和自定义安装路径，让 Composer 把插件文件落地到正确位置。核心依赖是 wpackagist-plugin/* 命名空间 + composer/installers 插件。
实操步骤：
- 执行
composer require composer/installers - 在
composer.json中添加配置段：{ "extra": { "installer-paths": { "wp-content/plugins/{$name}/": ["type:wordpress-plugin"], "wp-content/themes/{$name}/": ["type:wordpress-theme"] } } } - 添加 wpackagist 仓库（若尚未配置）：
"repositories": [ { "type": "composer", "url": "https://wpackagist.org" } ] - 运行
composer require wpackagist-plugin/woocommerce—— 文件将被解压至wp-content/plugins/woocommerce/
注意：wpackagist 只同步 WordPress.org 官方仓库插件，私有插件、GitHub 直链 ZIP、GPLv2 以外协议插件均不支持。
私有插件 / GitHub 仓库如何用 Composer 安装
若插件托管在 GitHub 或私有 Git 服务器，且你控制其代码结构，可绕过 wpackagist，但需满足两个硬性条件：
- 插件根目录含标准 WordPress 插件头（至少含
Plugin Name:行） -
composer.json中声明"type": "wordpress-plugin"，并配置installer-paths如上
示例私有插件 composer.json 片段：
{
"name": "myorg/my-custom-plugin",
"type": "wordpress-plugin",
"require": {}
}
然后在主项目中添加仓库：
"repositories": [
{
"type": "vcs",
"url": "https://github.com/myorg/my-custom-plugin"
}
]
再运行 composer require myorg/my-custom-plugin:dev-main。关键点：Git 分支名必须对应 Composer 版本约束（如 dev-main、1.2.3），且标签需打在含完整插件文件的提交上。
WP-CLI + Composer 协同才是生产级工作流
仅靠 Composer 无法替代 wp plugin activate、处理数据库迁移、检查依赖冲突或运行插件激活钩子。推荐组合使用：
- 用 Composer 管理插件「源码分发」和「版本锁定」（
composer.lock固定 SHA） - 用 WP-CLI 执行运行时操作：
wp plugin install --activate（适用于首次部署）、wp plugin update --all（慎用，可能绕过 lock 文件） - CI/CD 中先
composer install --no-dev，再wp rewrite structure '/%postname%/'等初始化命令
最容易被忽略的一点：WordPress 插件的「激活状态」「选项数据」「上传文件」全存在数据库或 wp-content 目录里，Composer 只管代码——备份、迁移、多环境同步时，必须把数据库 dump 和 wp-content/uploads/ 一并纳入流程，否则看似安装成功，实际功能缺失。
