Composer在WordPress中结合Roots Bedrock进行规范化管理（项目改造）-composer-PHP中文网

直接套用 bedrock 不可行，因其是项目模板而非可 require 的库；强行迁移会破坏路径、阻断自动链接与入口生成，唯一正解是重建项目+数据迁移，并严格遵循 composer 路径映射与服务器配置要求。

composer在wordpress中结合roots bedrock进行规范化管理（项目改造）

直接把现有 WordPress 项目“套上” Bedrock 结构不可行，必须重走初始化流程；强行迁移会导致 wp-content 路径错乱、composer.json 依赖冲突、.env 加载失败等连锁问题。

为什么不能对已有 WordPress 项目 run composer require roots/bedrock

Bedrock 不是一个可 require 的库，而是一个项目模板（project-type），它的 composer.json 声明了 "type": "project"，且含大量钩子脚本（如 roots/bedrock-installer）和目录重写逻辑。直接 require 进旧项目会： - 把 web/、config/ 等目录强行拉进当前结构，破坏原有路径 - post-root-package-install 钩子不触发，vendor/roots/wordpress 不会自动 symlink 到 web/wp - wp-config.php 和 index.php 入口不会被生成或替换，导致 Call to undefined function wp() - composer install 时因 roots/bedrock-autoloader 未加载，mu-plugins 失效

现有项目迁移到 Bedrock 的唯一可行路径

不是“改造”，而是“重建 + 数据迁移”。关键动作必须按顺序执行：

备份完整数据库 + wp-content/uploads/ + 自定义主题源码 + 手动安装的插件配置（如 ACF 字段组 JSON）
用官方命令新建空 Bedrock 项目：composer create-project roots/bedrock my-site
将旧主题复制到 web/app/themes/my-theme，并确保其 style.css 中的 Text Domain 与目录名一致
插件全部通过 composer require 安装：公开插件走 wpackagist-plugin/{slug}，付费插件需在 auth.json 配置 token 后声明为 vcs 类型
wp-content/mu-plugins/ 下的文件要转成 Composer 包或移入 web/app/mu-plugins/（Bedrock 会自动加载该目录）

注意：wp-content/plugins/ 和 wp-content/themes/ 下的手动文件必须清空——下次 composer install 会彻底覆盖它们。

如何让旧插件/主题适配 Bedrock 的路径机制

Bedrock 的核心机制是靠 wp-config.php 中的常量重定向内容目录：

MiniMax Word

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

下载

define('CONTENT_DIR', dirname(__DIR__) . '/content');
define('WP_CONTENT_DIR', CONTENT_DIR);
define('WP_CONTENT_URL', WP_HOME . '/app');

这意味着所有插件/主题实际位于 content/plugins/ 和 content/themes/，但 Bedrock 的 composer/installers 插件会把 Packagist 包自动映射到 web/app/plugins/ —— 这个映射由 composer.json 中的 "installer-paths" 控制：

"installer-paths": {
  "web/app/mu-plugins/{$name}/": ["type:wordpress-muplugin"],
  "web/app/plugins/{$name}/": ["type:wordpress-plugin"],
  "web/app/themes/{$name}/": ["type:wordpress-theme"]
}

如果你的自建插件没声明 "type": "wordpress-plugin"，它就不会进 web/app/plugins/，而是落到 vendor/ 根目录，从而失效。

最容易被忽略的三个硬性条件

缺一不可，否则项目启动即报错：

Web 服务器 DocumentRoot 必须指向 web/ 目录，不是项目根目录 —— 否则 wp-config.php 无法加载 ../.env
.env 中的 WP_HOME 和 WP_SITEURL 必须显式填写完整 URL（如 https://example.com），不能留空或写 localhost，否则后台链接、媒体 URL 全错
PHP 版本必须 ≥8.0（Bedrock 当前锁死 "php": "^8.0"），若用 7.4 或 8.5.5，需先改 composer.json 的 config.platform.php 再 composer update

迁移不是文件搬运，是工作流重建。所有“手动放进去”的东西，都得找到对应的 Composer 表达方式，否则下一次 composer install 就是灾难现场。