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都会出现混乱。这一点,务必在部署前反复确认。
相关攻略
Sublime Text 3 的 WordPress 插件必须启用 auto_complete_selector 才能触发补全 Sublime Text 3 的 WordPress 插件必须启用 auto_complete_selector 才能触发补全 是不是遇到过这种情况?插件明明装好了,可敲
必须配置composer installers和installer-paths映射路径,否则插件仅存于vendor 而WordPress无法识别 如果你直接运行 composer require wordpress xxx,结果大概率是失败。原因很简单:WordPress的插件并不在Packagis
Word无法启动转换器mswrd632 wpc错误:彻底解决方法指南 当您尝试打开Word文档时,遇到“Word无法启动转换器mswrd632 wpc”的弹窗提示,导致文档无法正常读取,这确实是一个令人困扰的常见问题。许多用户在接收他人发送的Word文件后,都曾遭遇此错误,点击转换后操作即告失败。本
Word中怎么打感叹号? Word作为日常办公不可或缺的工具,其丰富的功能常常隐藏着一些实用技巧。即便是输入感叹号这样看似简单的操作,也存在多种高效方法。本文将全面解析在Word文档中打出感叹号的几种常用技巧,涵盖不同使用习惯,帮助您选择最便捷的方式,提升文档编辑效率。 方法步骤 方法一:利用输入法
Word里的分数输入,其实是个隐藏技巧 Word的功能强大毋庸置疑,但在一些细节处理上,偶尔也会让用户感到头疼。比如,输入一个标准的数学分数,这里面就有点学问了。不少朋友在使用时都遇到过这个难题:Word里的分数到底该怎么打?这其实很正常,因为常规菜单里确实没有直接的“分数”按钮,微软在设计时或许没
热门专题
热门推荐
最新公司2026年度工作总结会议主持词 各位领导、各位来宾、同事们,请就坐。 现在,我宣布,×公司——××××年度工作会议正式开始! 首先,请允许我荣幸地向大家介绍今天亲临会场的各位领导和来宾:集团公司董事长×先生、×公司总经理×先生、×公司总经理×女士、集团公司财务总监×先生。同时,出席本次会议的
学生做最好的自己演讲稿,成为最好的自己,从来不是一句空谈,它需要持续的努力、踏实的实践,以及在漫长岁月里对自我的不断打磨与提升。下面为大家整理了几篇学生做最好的自己演讲稿,希望能带来一些启发和思考。 学生做最好的自己演讲稿一 尊敬的老师们,亲爱的同学们: 大家好! 你是否也曾有过这样的时刻?羡慕旁人
为了确保活动流程顺畅、氛围融洽,一份好的主持词至关重要。它不仅能有效串联各个环节,更能营造出恰当的氛围。那么,如何撰写一份出色的主持词呢?借鉴诗词和散文诗的写作手法,往往能带来意想不到的效果。如果您正在寻找灵感,不妨参考以下由我们精心整理的“幼儿园家长会主持词开场白”系列范例,相信能为您提供切实的帮
我有一个弟弟 我有个弟弟,叫浩浩。小家伙长着一双水汪汪的大眼睛,一张小嘴总惦记着吃,脸蛋儿胖乎乎的,别提多可爱了。不过啊,这浩浩除了贪吃,还有个挺出名的特点——那就是相当“小气”。 一次“护食”风波 有回我去他家玩,人还没进门呢,就被他给拦住了。只见他嘟着嘴,两脚一叉,小手一张,牢牢挡在门口,嘴里还
说起最难忘的同学 细数下来,从幼儿园到现在,认识周鑫鑫竟然已经有十年了。时间过得可真快。 这事儿说来也巧。从三岁踏入幼儿园开始,一直到六年级的今天,我和她始终都在同一个班级。更巧的是,我的爷爷奶奶还认识她的父母,这么算下来,我俩真算得上是名副其实的“发小”了。 关于“认识”的起点 周鑫鑫总说“我们从





