Composer安装WordPress开发脚手架的方法

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都会出现混乱。这一点，务必在部署前反复确认。