首页 游戏 软件 资讯 排行榜 专题
首页
编程语言
Composer安装WordPress开发脚手架的方法

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

热心网友
12
转载
2026-05-03

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/wordpressroots/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_HOMEWP_SITEURL必须设置为生产环境的真实域名。如果留空或者还写着localhost,那么后台的所有菜单链接和媒体文件URL都会出现混乱。这一点,务必在部署前反复确认。

来源:https://www.php.cn/faq/2339062.html
免责声明: 游乐网为非赢利性网站,所展示的游戏/软件/文章内容均来自于互联网或第三方用户上传分享,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系youleyoucom@outlook.com。

相关攻略

Sublime配置WordPress主题开发增强包_强化函数参考与结构预览
编程语言
Sublime配置WordPress主题开发增强包_强化函数参考与结构预览

Sublime Text 3 的 WordPress 插件必须启用 auto_complete_selector 才能触发补全 Sublime Text 3 的 WordPress 插件必须启用 auto_complete_selector 才能触发补全 是不是遇到过这种情况?插件明明装好了,可敲

热心网友
05.03
Composer如何管理WordPress插件_使用WPackagist镜像库【生态集成】
编程语言
Composer如何管理WordPress插件_使用WPackagist镜像库【生态集成】

必须配置composer installers和installer-paths映射路径,否则插件仅存于vendor 而WordPress无法识别 如果你直接运行 composer require wordpress xxx,结果大概率是失败。原因很简单:WordPress的插件并不在Packagis

热心网友
05.03
如何解决Word无法启动转换器mswrd632的问题?
电脑教程
如何解决Word无法启动转换器mswrd632的问题?

Word无法启动转换器mswrd632 wpc错误:彻底解决方法指南 当您尝试打开Word文档时,遇到“Word无法启动转换器mswrd632 wpc”的弹窗提示,导致文档无法正常读取,这确实是一个令人困扰的常见问题。许多用户在接收他人发送的Word文件后,都曾遭遇此错误,点击转换后操作即告失败。本

热心网友
05.02
word中怎么打感叹号?word中打感叹号的方法
电脑教程
word中怎么打感叹号?word中打感叹号的方法

Word中怎么打感叹号? Word作为日常办公不可或缺的工具,其丰富的功能常常隐藏着一些实用技巧。即便是输入感叹号这样看似简单的操作,也存在多种高效方法。本文将全面解析在Word文档中打出感叹号的几种常用技巧,涵盖不同使用习惯,帮助您选择最便捷的方式,提升文档编辑效率。 方法步骤 方法一:利用输入法

热心网友
05.02
两种方法在word中轻松输入分数
电脑教程
两种方法在word中轻松输入分数

Word里的分数输入,其实是个隐藏技巧 Word的功能强大毋庸置疑,但在一些细节处理上,偶尔也会让用户感到头疼。比如,输入一个标准的数学分数,这里面就有点学问了。不少朋友在使用时都遇到过这个难题:Word里的分数到底该怎么打?这其实很正常,因为常规菜单里确实没有直接的“分数”按钮,微软在设计时或许没

热心网友
05.02

最新APP

宝宝过生日
宝宝过生日
应用辅助 04-07
台球世界
台球世界
体育竞技 04-07
解绳子
解绳子
休闲益智 04-07
骑兵冲突
骑兵冲突
棋牌策略 04-07
三国真龙传
三国真龙传
角色扮演 04-07

热门推荐

最新公司2026年度工作总结会议主持词
职业与学业
最新公司2026年度工作总结会议主持词

最新公司2026年度工作总结会议主持词 各位领导、各位来宾、同事们,请就坐。 现在,我宣布,×公司——××××年度工作会议正式开始! 首先,请允许我荣幸地向大家介绍今天亲临会场的各位领导和来宾:集团公司董事长×先生、×公司总经理×先生、×公司总经理×女士、集团公司财务总监×先生。同时,出席本次会议的

热心网友
05.03
学生做最好的自己演讲稿    做最好的自己演讲稿600字左右
职业与学业
学生做最好的自己演讲稿 做最好的自己演讲稿600字左右

学生做最好的自己演讲稿,成为最好的自己,从来不是一句空谈,它需要持续的努力、踏实的实践,以及在漫长岁月里对自我的不断打磨与提升。下面为大家整理了几篇学生做最好的自己演讲稿,希望能带来一些启发和思考。 学生做最好的自己演讲稿一 尊敬的老师们,亲爱的同学们: 大家好! 你是否也曾有过这样的时刻?羡慕旁人

热心网友
05.03
幼儿园家长会主持词开场白系列
职业与学业
幼儿园家长会主持词开场白系列

为了确保活动流程顺畅、氛围融洽,一份好的主持词至关重要。它不仅能有效串联各个环节,更能营造出恰当的氛围。那么,如何撰写一份出色的主持词呢?借鉴诗词和散文诗的写作手法,往往能带来意想不到的效果。如果您正在寻找灵感,不妨参考以下由我们精心整理的“幼儿园家长会主持词开场白”系列范例,相信能为您提供切实的帮

热心网友
05.03
贪吃小气的弟弟
职业与学业
贪吃小气的弟弟

我有一个弟弟 我有个弟弟,叫浩浩。小家伙长着一双水汪汪的大眼睛,一张小嘴总惦记着吃,脸蛋儿胖乎乎的,别提多可爱了。不过啊,这浩浩除了贪吃,还有个挺出名的特点——那就是相当“小气”。 一次“护食”风波 有回我去他家玩,人还没进门呢,就被他给拦住了。只见他嘟着嘴,两脚一叉,小手一张,牢牢挡在门口,嘴里还

热心网友
05.03
我最难忘的同学
职业与学业
我最难忘的同学

说起最难忘的同学 细数下来,从幼儿园到现在,认识周鑫鑫竟然已经有十年了。时间过得可真快。 这事儿说来也巧。从三岁踏入幼儿园开始,一直到六年级的今天,我和她始终都在同一个班级。更巧的是,我的爷爷奶奶还认识她的父母,这么算下来,我俩真算得上是名副其实的“发小”了。 关于“认识”的起点 周鑫鑫总说“我们从

热心网友
05.03