Composer安装WordPress开发脚手架的正确姿势
如果你打算用Composer管理WordPress，第一步就千万别踩坑。记住，composer require wordpress/core 这种命令是行不通的——官方压根就没在Packagist发布过这个包。你真正需要的，其实是一个集成了现代开发流程、能用Composer优雅管理核心代码、插件和主题的项目脚手架。而在众多方案中，Bedrock无疑是那个最成熟、社区支持最稳的选择。
为什么必须用 create-project 而不是 require
这里的关键在于理解Bedrock的本质：它是一个项目模板，而不是一个可以简单require进来的库。如果你错误地执行了composer require roots/bedrock，那么Bedrock的所有文件都会被塞进vendor/目录里。结果呢？像web/、config/、.env这些决定项目生死的核心目录，要么位置错乱，要么直接缺失，后续所有的路径配置和环境变量加载都会彻底失效。
- 正确命令只有一条：
composer create-project roots/bedrock my-site - 执行成功后，
my-site/目录就是完整的项目根目录，里面已经包含了web/（网站根目录）、config/（配置文件）和.env（环境变量）等结构。 - 千万别跳过
cp .env.example .env这一步。如果.env文件是空的，那么WP_HOME、数据库连接等关键配置都会缺失，直接后果就是后台链接和媒体文件路径全部崩溃。 - 另外请注意，Bedrock的
wp-config.php是在config/application.php中动态生成的，不要试图去手动修改它。
johnpbloch/wordpress 和 roots/wordpress 的区别在哪
这两个包都是社区维护的WordPress核心镜像，但它们的定位和集成方式有本质区别：
johnpbloch/wordpress：它只做一件事，就是同步官方的WordPress核心文件。更新速度快，适合那些希望完全自定义项目结构的开发者。它不包含任何软链接或自动加载的逻辑。roots/wordpress：这个包是专门为Bedrock量身定制的。它在下载核心文件后，内置了一套软链接机制，能自动将WordPress核心映射到web/wp/目录下。当然，为了适配这套机制，其版本同步可能会比前者稍慢一些。- Bedrock项目在初始化时，默认就已经预置了
roots/wordpress。你不需要、也不应该手动再去require它——create-project命令生成的composer.json里已经配置好了。 - 切记不要混用：如果你强行在Bedrock项目里执行
composer require johnpbloch/wordpress，会导致两个核心包冲突，最终wp-settings.php加载失败。
插件/主题怎么装才不会进错目录
这是Bedrock设计的一大亮点，也是容易出错的地方。它把插件和主题的默认安装路径从传统的wp-content/，分别改为了web/app/plugins/和web/app/themes/。这个路径映射的魔法，是由composer/installers插件配合installer-paths配置实现的，并不是wpackagist仓库自己能决定的。
- 首先，确保你的
composer.json里已经配置了"type": "wordpress-plugin"和"type": "wordpress-theme"的路径匹配规则（Bedrock模板已经帮你配好了）。 - 然后，在
repositories部分添加wpackagist仓库："repositories": [{"type": "composer", "url": "https://wpackagist.org"}]。 - 安装插件时，使用命令如：
composer require wpackagist-plugin/query-monitor。Composer会自动将其安装到web/app/plugins/query-monitor/。 - 需要手动创建
web/app/plugins/目录吗？不需要。Composer会在安装时自动创建，前提是它的父目录web/app/存在（create-project命令已经建立了这个结构）。 - 对于私有插件，你可以使用Git仓库URL。先在
repositories中声明你的私有仓库，然后使用composer require myorg/my-plugin:dev-main安装。关键是，确保你的私有插件自己的composer.json里也定义了"type": "wordpress-plugin"。
WP-CLI 命令找不到 wp-config.php 怎么办
在Bedrock项目中，wp-config.php并不在项目根目录，而是位于web/wp-config.php（它实际上是由config/application.php生成的）。WP-CLI默认会从当前目录开始向上寻找这个文件，因此直接运行命令肯定会报错。解决方法有以下几种：
- 进入
web/目录再执行命令：cd web && wp plugin list。 - 或者，在执行命令时直接指定完整路径：
wp --path=web plugin list。 - 更推荐的方式是使用Bedrock自带的封装脚本：
./vendor/bin/wp。这个脚本已经预设好了--path=web和--require=../config/application.php参数，用起来最省心。 - 所以，千万别在项目根目录下直接运行类似
wp rewrite structure的命令，出现“Could not find wp-config.php”的错误是必然的。
最后，还有一个最容易被忽略、但至关重要的部署要点：Bedrock的web/目录才是真正的网站根目录。你的Nginx或Apache配置，必须指向这个web/文件夹，而不是整个项目的根目录。同时，.env文件中的WP_HOME和WP_SITEURL必须设置为生产环境的真实域名。如果留空或者还写着localhost，那么后台的所有菜单链接和媒体文件URL都会出现混乱。这一点，务必在部署前反复确认。
