wp-env入门

这个@文字新闻/env包装(wp-env公司)允许您设置一个本地WordPress环境(站点)来构建和测试插件和主题,而无需任何额外配置。

在遵循本指南之前,请安装Node.js开发工具如果你还没有这样做。

wp-env基本图

快速入门

  1. 下载、安装和启动Docker桌面按照操作系统的说明进行操作。
  2. 运行npm-g install@wordpress/env在终端中安装wp-env公司全球地。
  3. 在终端中,导航到现有的插件目录、主题目录或新的工作目录。
  4. 运行wp-env启动在终端中启动本地WordPress环境。
  5. 脚本运行后,导航到http://localhost:8888/wp-管理员并使用用户名登录WordPress仪表板管理员和密码密码.

设置Docker桌面

这个wp环境工具使用码头工人创建一个运行本地WordPress站点的虚拟机。Docker Desktop应用程序对小型企业、个人使用、教育和非商业开源项目免费。查看他们的常见问题了解更多信息。

使用以下链接为您的操作系统下载并安装Docker Desktop。

如果您使用的是20.04.1之前的Ubuntu版本,请参阅其他故障排除说明如下所示。

成功安装后,启动Docker Desktop应用程序并按照提示进行设置。通常应使用推荐的(默认)设置,创建Docker帐户是可选的。

安装并运行wp-env

这个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启动来自不是插件或主题的目录。脚本将显示以下警告,但如果这是您的意图,请忽略。

!! 警告:找不到.wp-env.json配置文件,无法确定'DIR'是WordPress安装、插件还是主题。

您也可以使用.wp-env.json配置文件来创建一个使用多个插件和/或主题的环境。请参阅@wordpress/env包有关更多配置详细信息的自述文件。

卸载或重置wp-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启动.

Ubuntu Docker设置

如果您使用的是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.

其他资源