使用 zinnector dev 进行本地开发

zinnector dev 可以在您自己的计算机上运行一个真实的 WordPress，为您项目中的插件和主题提供服务，并采用您选择的 PHP 版本。本文将说明它可以使用的两种运行时、如何选择版本、各项内容从何处提供服务，以及运行时在磁盘上的存储位置——从而确保您在本地测试的内容与您部署的内容完全一致。

两种运行时，以及为何两者都是真实的

Playground 是默认选项。WordPress Playground 将 PHP 编译为 WebAssembly 并在 Node 内部运行，因此一台除了 Node 之外什么都没安装的笔记本电脑也能在几秒钟内启动一个 WordPress。从 5.2 到 8.5 的任何 PHP 版本均可使用。它附带了一组精简的 PHP 扩展（根据当前构建测得包含 intl、redis、memcached），这对于大多数插件和主题开发工作来说已经足够。

Docker 则运行原生的 php-fpm 和 MariaDB 容器。它的速度较慢，需要 Docker 守护进程和大约 1.2 GB 的镜像，支持 PHP 7.4 到 8.5——但它运行的是带有完整扩展集（包括 imagick 和 gd）的原生 PHP。当您需要测试 WebAssembly 构建所不包含的扩展时，它是最实在的解决方案。

zinnector dev                       # playground
zinnector dev --runtime docker      # native PHP + MariaDB

系统绝不会静默回退到 Docker。如果开发者以为自己在 WebAssembly 上运行而实际上却在 Docker 上运行，那就是某个试图提供帮助的工具给出了错误的答案，因此必须明确按名称请求它。

选择 PHP 和 WordPress 版本

zinnector dev --php 8.1 --wp 6.7    # develop against a specific pair
zinnector dev --port 9401           # when 9400 is taken
zinnector dev --no-login            # do not sign in to wp-admin automatically
zinnector dev --verbose             # show the runtime's own output

默认值来自项目中的 zinnector.json——即 php、wordpress、runtime 和 port——这些内容由 zinnector new 写入且您应当提交到版本控制中，以便项目中的每个人都运行相同的版本。命令行上的标志在相应运行中会优先于该文件。

您声明的版本与实际运行的版本是不同的事实。zinnector dev --once 会启动运行时，打印它实际报告的内容——PHP 版本、WordPress 版本、已加载的扩展——然后停止。zinnector check --probe 在将您的项目与主机托管槽位进行对比时，也会使用相同的测定方式。

从您的项目中提供哪些内容

运行时会直接挂载您项目的 wp-content/plugins、wp-content/themes 和 wp-content/mu-plugins 目录，因此您保存的文件在下一次重新加载时就会生效。存在但未包含真实内容的目录会被故意忽略挂载：将一个空的 themes/ 挂载覆盖到运行时自身的主题上，会导致 WordPress 完全没有主题可用，从而呈现一片空白的 500 错误而非您的站点。这就是脚手架保留带有 .gitkeep 的空目录的原因，也是在您向其中放入主题之前它们不会遮蔽任何内容的原因。

运行时的存放位置

WordPress 运行时是在首次使用时下载的，而不是随 CLI 一起附带的——包含所有 PHP 构建的软件包大约有 570 MB，只用来列出站点的开发者不应为此承担下载开销。它保存在 Zinnector® 自身的缓存中，即 ~/.cache/zinnector/runtimes/playground/<version>（或 ZINNECTOR_CACHE_DIR 所指向的任何位置），绝不会存放在您的项目中，因此它不可能最终进入您的代码仓库或 zinnector push 所测量的文件树中。下载操作由您自己的 npm 以 node npm-cli.js 形式执行——绝不通过 shell 进行。

运行时版本固定在 CLI 版本上，因此同一个项目中的两名开发者运行的是相同的 PHP 构建。zinnector dev --reset-runtime 会丢弃已安装的运行时并重新安装，这也是解决已安装却无法启动的运行时的方法。

在 Node 26 或更新版本上

CLI 本身可以在 24 及以上的任何 Node 版本上运行。但是，该运行时的原生模块仅为 Node 24 和 25 提供预构建二进制文件（截至 2026 年 9 月）。Zinnector® 不会执行任何编译操作——在 Windows 上编译意味着必须安装 Visual Studio——而是单独为运行时获取一个约 30 MB 的 Node 24 到同一个缓存中，并根据 nodejs.org 发布的校验和进行验证。在适用时，安装提示中会予以说明。您自己的 Node 环境不会发生任何改变。

相关内容

• 入门指南 · 部署 · 命令参考 · 疑难解答