这个@文字新闻/env包装(wp-env公司
)允许您设置一个本地WordPress环境(站点)来构建和测试插件和主题,而无需任何额外配置。
在遵循本指南之前,请安装Node.js开发工具如果你还没有这样做。
![wp-env基本图](https://i0.wp.com/developer.wordpress.org/files/2023/10/wp-env-diagram.png?ssl=1)
- 下载、安装和启动Docker桌面按照操作系统的说明进行操作。
- 运行
npm-g install@wordpress/env
在终端中安装wp-env公司
全球地。
- 在终端中,导航到现有的插件目录、主题目录或新的工作目录。
- 运行
wp-env启动
在终端中启动本地WordPress环境。
- 脚本运行后,导航到
http://localhost:8888/wp-管理员
并使用用户名登录WordPress仪表板管理员
和密码密码
.
这个wp环境
工具使用码头工人创建一个运行本地WordPress站点的虚拟机。Docker Desktop应用程序对小型企业、个人使用、教育和非商业开源项目免费。查看他们的常见问题了解更多信息。
使用以下链接为您的操作系统下载并安装Docker Desktop。
如果您使用的是20.04.1之前的Ubuntu版本,请参阅其他故障排除说明如下所示。
成功安装后,启动Docker Desktop应用程序并按照提示进行设置。通常应使用推荐的(默认)设置,创建Docker帐户是可选的。
这个wp-env公司
该工具用于使用Docker创建本地WordPress环境。因此,在您设置了Docker Desktop之后,打开终端并安装wp-env公司
通过运行以下命令:
npm-g install@wordpress/env
这将安装wp-env公司
全局,允许从任何目录运行该工具。要确认它已安装并可用,请运行wp-env--版本
,并应显示版本号。
接下来,导航到终端中的现有插件目录、主题目录或新工作目录并运行:
wp-env启动
脚本完成后,您可以在以下位置访问本地环境:本地主机:8888
。使用用户名登录WordPress仪表板管理员
和密码密码
.
一些项目,如古腾堡,包括他们自己特定的wp-env公司
配置,文档可能会提示您运行npm运行启动wp-env
而不是。
有关控制Docker环境的更多信息,请参阅@wordpress/env包自述文件。
这个wp-env公司
该工具几乎可以从任何地方运行。在开发单个插件时使用脚本时,wp-env启动
当从包含插件的目录运行时,可以自动挂载和激活插件。当从开发主题的目录运行时,这也适用于主题。
如果您运行wp-env启动
来自不是插件或主题的目录。脚本将显示以下警告,但如果这是您的意图,请忽略。
!! 警告:找不到.wp-env.json配置文件,无法确定'DIR'是WordPress安装、插件还是主题。
您也可以使用.wp-env.json
配置文件来创建一个使用多个插件和/或主题的环境。请参阅@wordpress/env包有关更多配置详细信息的自述文件。
如果您需要重新开始或想要删除已安装的内容,这里有一些说明。
- 如果你只想重置和清理WordPress数据库,运行
wp-env清洁所有
- 要完全删除特定项目的本地环境,请运行
wp-env销毁
- 要全局卸载
wp-env公司
工具,管路npm-g卸载@wordpress/env
使用时wp-env公司
,通常会出现以下错误:运行docker-compose命令时出错
- 检查Docker Desktop是否已启动并正在运行。
- 检查Docker Desktop仪表板以获取日志、重新启动或删除现有虚拟机。
- 然后尝试重新运行
wp-env启动
.
如果您看到错误:主机已被另一个容器使用
- 您尝试启动的容器已在运行,或者另一个容器正在运行。您可以通过运行
wp-env停止
从您启动它的目录。
- 如果您不记得开始的目录
wp环境
,可以通过运行以下命令停止所有容器停靠站$(停靠站ps-q)
。这将停止所有Docker容器,因此请谨慎使用。
- 然后尝试重新运行
wp-env启动
.
如果您使用的是20.04.1之前的Ubuntu版本,则在使用设置本地WordPress环境时可能会遇到错误wp-env公司
.
要解决此问题,请从以下步骤开始安装指南来自Docker。码头组装
也是必需的,您可能需要单独安装。请参阅Docker撰写文档.
一旦Docker和wp环境
已安装,并且假定wp-env公司
已全局配置,请尝试运行wp-env启动
在目录中。如果遇到此错误:
错误:无法连接到http上的Docker守护程序+docker://localhost(docker://本地主机)-它在运行吗?如果它位于非标准位置,请使用DOCKER_HOST环境变量指定URL。
首先,确保Docker正在运行。你可以通过运行ps-ef | grep驳接器
,它应该返回如下内容:
/usr/bin/dockerd-H fd://--containerd=/run/containerd/containert.sock
如果Docker未运行,请尝试通过运行sudo systemctl启动docker.service
.
如果Docker正在运行,那么它就不会监听WordPress环境如何进行通信。尝试添加以下服务覆盖文件以包含侦听tcp协议
。请参阅Docker文档关于如何配置Docker守护进程的远程访问。
#/etc/systemd/system/docker.service.d/override.conf【服务】执行启动=ExecStart=/usr/bin/dockerd-H fd://-Htcp://0.0.0.0:2376
从命令行重新启动服务:
sudo systemctl守护程序重新加载sudo systemctl重启docker.service
重新启动服务后,设置环境变量码头主机
并尝试启动wp-env公司
具有:
导出DOCKER_HOST=tcp://127.0.0.1:2376wp-env启动
您的环境现在应该设置为本地主机:8888
.