WooCommerce 文档

title: "设置您的开发环境" post_status: publish comment_status: open taxonomy: category: - woocommerce post_tag: - Getting Started - Repos - Data


设置您的开发环境

推荐软件

在开发 WooCommerce 扩展时,您需要考虑一些特定的软件要求。 必要的软件包括:

大多数 WordPress 托管环境默认不包含 Node 和 Composer,因此在分发扩展和主题时,重要的是包含所有构建好的资源。

注意: 假设您使用的是符合 POSIX 标准的操作系统(例如,Linux、macOS)。 如果您正在使用 Windows 机器,建议使用 WSL(自 Windows 10 起可用)。

设置可重复使用的 WordPress 开发环境

除了上面提到的软件之外,您还需要一种方法来设置本地开发服务器环境。 有许多不同的工具可供选择,每个工具都有其特定的功能和限制。 我们建议您从以下选项中选择最适合您工作流程的选项。

WordPress Studio - 推荐方法

对于易于设置的本地开发环境,我们推荐 WordPress Studio,这是由 WordPress.com 团队支持的本地开发环境。 Studio 提供了管理多个本地网站环境的功能,以及与您的代码编辑器和终端的集成。 Studio 还具有 WordPress 专用的 AI 助手、从 WordPress 备份的轻松导入功能、Blueprint 支持、免费的公共预览站点以及与 WordPress.com 或 Pressable 上的站点进行双向同步。

wp-env

wp-env 是由 WordPress 社区维护的一个命令行工具,它允许您使用 Docker 和 JSON 配置文件来设置和运行自定义的 WordPress 环境。 仓库中包含一个 .wp-env.json 文件,专门用于为 WooCommerce 核心贡献代码。

通用基于 PHP 的 Web 栈工具

以下是一些帮助您管理环境的工具,这些工具不特定于 WordPress。

最小服务器要求

无论您选择哪种工具来管理您的开发环境,您都应该确保它满足 WooCommerce 的 服务器推荐,以及 运行 WordPress 的要求

将 WooCommerce 核心添加到您的环境

在为 WooCommerce 开发时,安装 WooCommerce 核心的开发版本会很有帮助。

选项 1:WooCommerce Beta Tester

如果您通过传统的 WordPress 仪表盘安装 WooCommerce,您还可以安装 WooCommerce Beta Tester 扩展,以更改版本,包括访问即将发布的 beta 版本和候选版本。 WooCommerce Beta tester 可通过 Woo Marketplace 获得。

选项 2:克隆 WooCommerce 核心仓库

您还可以通过以下方式,直接在您的开发环境中,针对 WooCommerce 核心的 trunk 或即将发布的版本进行开发:

  1. 克隆 WooCommerce 核心仓库。
  2. 安装并激活所需的 Node 版本和 PNPM。
  3. 安装 WooCommerce 的依赖项。
  4. 构建 WooCommerce。
  5. plugin/woocommerce 目录链接到您的 wp-content/plugins 目录。

克隆 WooCommerce 核心仓库

您可以使用以下 CLI 命令在本地克隆 WooCommerce 核心仓库:

cd /your/server/wp-content/plugins
git clone https://github.com/woocommerce/woocommerce.git
cd woocommerce

安装并激活 Node

建议使用 Node Version Manager (或 nvm) 来安装并激活 Node。 您可以使用以下 CLI 命令来安装 nvm:

nvm install

您可以在 nvm GitHub 仓库 中了解更多关于如何安装和使用 nvm 的信息。

安装依赖项

要安装 WooCommerce 的依赖项,请使用以下 CLI 命令:

pnpm install --frozen-lockfile

构建 WooCommerce

使用以下 CLI 命令来编译 WooCommerce 运行所需的 JavaScript 和 CSS 文件:

pnpm build

注意:如果您尝试在您的服务器上运行 WooCommerce,而没有生成编译后的资源,您可能会遇到错误和其他不良的效果

创建 WooCommerce 插件的符号链接

为了将 WooCommerce 插件加载到您的本地开发环境,您可以从克隆的仓库中的 WooCommerce 插件目录创建一个符号链接,链接到您的本地 WordPress 开发环境。

ln -s woocommerce/plugins/woocommerce /path-to-local/wp-content/plugins

生成 woocommerce.zip 资源文件

或者,您可以使用以下命令生成一个 woocommerce.zip 文件:

pnpm build:zip

一个 woocommerce.zip 文件可能对您上传 WooCommerce 的修改版本到独立的测试环境时有所帮助。