PlugBench 帮助

PlugBench 是一款适用于 Mac 的本地 Web 服务器,专为构建和测试插件及主题而设计。本页面将介绍它的所有功能。.

入门

  1. 打开 PlugBench.dmg 并将 PlugBench 拖到“应用程序”文件夹中。
  2. 打开 PlugBench。首次运行时,会弹出一个欢迎窗口,列出它需要的组件:nginx、PHP、MariaDB 和 Mailpit,全部来自 Homebrew。
  3. 点击 “设置 PlugBench”。终端将打开并安装所有组件,包括 Homebrew(如果缺少)。Homebrew 可能会要求您输入一次 Mac 密码。PlugBench 会在设置完成后发出通知。
  4. 点击 “开始”,然后点击 “新建站点”。

系统要求:macOS 14 或更高版本,Apple Silicon 或 Intel 处理器,服务器需要大约 2 GB 的可用空间。.

关闭窗口不会影响网站的正常运行。PlugBench 会保留在菜单栏中。退出 PlugBench 即可停止所有操作。.

窗户

  • 左侧是网站列表:每个网站都包含其内容管理系统 (CMS) 和地址。选择一个网站即可查看其详细信息。
  • 服务:仅包括当前正在运行的服务,例如 nginx、PHP 8.5、MariaDB、Mailpit 和 Redis。
  • 工具栏按钮:phpMyAdmin、Adminer、邮件、站点(打开站点文件夹)、日志和版本。
  • 分享栏:在网站共享时出现,带有复制链接或停止共享的按钮。
  • 菜单栏图标:开始或停止、打开已登录的网站、停止共享、打开邮件。

每个网站的页面都包含以下卡片:

标题
名称、地址以及类似 WordPress · PHP 8.5 · MariaDB 13.0。“打开站点”和“打开管理后台”按钮。
PHP 和服务器
PHP 版本、内存、上传大小、时间限制、Xdebug、数据库服务器、HTTPS 和终端。.
iPhone
在 iPhone 模拟器中打开,或使用真正的 iPhone 扫描二维码。.
在线分享
临时公共https链接。.
发展
链接插件、调试模式、日志和更新。.
备份
备份、恢复和克隆。.
数据库
名称、用户名、密码、端口,以及一个用于在 phpMyAdmin 中打开它的按钮。.

创建网站

点击 “新建站点”,选择要安装的内容,给它命名,然后点击 “创建站点”。

选择你将获得什么
WordPress最新版 WordPress。示例内容:无,一个带照片的博客,一个 WooCommerce 商店 ,或测试数据。
Joomla最新版 Joomla,可直接登录。.
DrupalDrupal 与 Drush 结合使用。可选的杂志示例,包含文章和照片。.
重力基于平面文件的CMS,无需数据库。.
Craft CMS、TYPO3、Statamic、Laravel、Symfony通过Composer 的配方安装。
自定义邮政编码任何 PHP 网站都可以从 ZIP 文件导入,还可以选择导入 SQL 文件。使用此功能可以将客户网站复制到本地。.
空白的一个包含 PHP 文件和数据库的空文件夹,供您编写自己的代码。.

新站点窗口中的选项: PHP 版本、 数据库 服务器、特定 CMS 版本和 WordPress 多站点网络。

每个站点都有自己的地址(例如 http://my-site.localhost:8801)、数据库和管理员。除非您共享站点,否则只有您的 Mac 才能访问这些站点。

一键登录

使用 Open Admin 和 Open Site 即可以管理员身份登录,无需输入密码。此功能适用于 WordPress、Joomla、Drupal、Craft 和 Statamic。

每次点击都会生成一个有效期为 2 分钟的一次性登录链接。如果您需要,管理员用户名和密码也会显示在网站页面上。.

测试插件

  1. 在 开发界面,点击 “链接插件文件夹…” ,然后选择您正在编写代码的文件夹。
  2. PlugBench 将其链接到网站并激活。不会复制任何内容:每次保存的内容都会在下次页面加载时显示。.
  3. 开启 调试模式 ,将 PHP 通知和警告写入调试日志,点击 “查看日志” 即可查看。
  4. 删除操作会将其从网站中移除。您的文件夹不会被修改。

要在多个 PHP 版本上测试插件,请将网站克隆到另一个版本(参见 备份)或更改网站的 PHP 版本。

每站点 PHP

每个网站都有自己的 PHP 版本。 PHP 和服务器设置 。网站会在一秒钟内重启并应用新版本。

可用版本:PHP 7.4、8.0、8.1、8.2、8.3、8.4 和 8.5。更多 版本。PHP 7.4 和 8.0 已停止维护,可通过 shivammathur/php Homebrew 包获取。

每个站点都进行设置,以匹配客户的主机:

  • 内存: memory_limit,例如 128M 或 512M。
  • 上传大小: upload_max_filesize 和 post_max_size。
  • 时间限制: max_execution_time,以秒为单位。

每项设置仅适用于其对应的网站。.

Xdebug 和 PHP 扩展

在 “版本”,每个已安装的 PHP 版本都会显示其扩展。单击其中一个扩展即可为其构建对应的 PHP 版本(大约需要一分钟):

  • Xdebug:单步调试。
  • Redis:phpredis,用于对象缓存插件。
  • Imagick:ImageMagick图像编辑。
  • Memcached:用于 Memcached 对象缓存。

然后启用网站上的Xdebug。Xdebug默认对所有 PHP 版本都保持关闭状态,任何网站都不需要它,所以它不产生任何费用。

VS Code:安装 PHP Debug 扩展,点击 “复制 VS Code 设置”,将其粘贴到 .vscode/launch.json 文件,然后启用 Xdebug 监听。PlugBench 使用 9003 端口。PhpStorm 默认监听 9003 端口,工作方式相同。

数据库

默认服务器是 MariaDB,端口为 3307,因此不会与您已在端口 3306 上运行的 MySQL 发生冲突。在 “版本”:

  • MariaDB 10.6、10.11、11.4、11.8
  • MySQL 8.0、8.4、9.7

每个服务器都运行在自己的端口上。创建站点时选择一个端口,或者使用 “数据库服务器” 菜单移动现有站点:PlugBench 会导出数据库,将其导入到另一个服务器,并更新站点的配置。

phpMyAdmin 和 Adminer 打开后会自动登录,并列出所有服务器。网站上的“数据库”卡片会直接打开其自身的数据库。这两个工具都只能在 Mac 上运行。

PostgreSQL 17 以服务的形式提供,端口为 5433,用户为 postgres,密码与 MySQL root 用户相同。

本地 HTTPS

  1. 在 版本,安装 mkcert。
  2. 点击 “信任本地 HTTPS…” 一次。终端会要求您输入 Mac 密码以添加本地证书颁发机构。
  3. 启用 HTTPS 。它将在其端口 + 1000 处提供服务,例如 https://my-site.localhost:9801。

在 WordPress 系统中,PlugBench 会更新数据库中的网站地址,包括多站点。关闭 HTTPS 后,这些地址将被恢复原状。.

WordPress 多站点

在“新建站点”中启用WordPress 网络。您将获得一个包含子目录(例如/shop/ )的站点网络。在“我的站点”>“网络管理”>“站点”中添加站点。克隆、HTTPS 和共享功能可确保网络正常运行。

终端和 WP-CLI

在网站上打开终端会在其所在文件夹中打开一个 shell,网站的 PHP 版本位于路径的首位, WordPress 也已准备就绪。php、 composer和wp都使用该网站的 PHP 版本。您自己的 shell 设置也会加载。

wp plugin list wp user create editor editor@example.com --role=editor wp eval 'echo get_option("home");'

邮件、日志和调试

  • 邮件应用 会打开 Mailpit。网站发送的所有邮件都会发送到那里:密码重置邮件、WooCommerce 订单邮件、联系表单邮件等等。所有邮件都不会离开你的 Mac。
  • 调试模式 会启用 WP_DEBUG 和 WP_DEBUG_LOG 。
  • 日志 显示调试日志、PHP 错误日志和 nginx 错误日志。 清除 日志会在测试前清空这些日志。

备份、克隆和更新

  • “立即备份” 会保存文件和数据库。 “恢复” 会将文件恢复到最新备份。
  • 克隆功能 会将网站复制到另一个新名称的网站,还可以选择使用不同的 PHP 版本。数据库中的地址也会随之更新。
  • 更新操作 会备份数据库,然后更新内容管理系统 (CMS)。在 WordPress 系统中, “更新插件和主题” 操作会更新其余部分。
  • 删除操作 会移除网站、其数据库及其证书。

服务

从版本库安装。安装完成后,它们会随 PlugBench 一起启动和停止。

服务使用地址
Redis对象缓存插件127.0.0.1:6379
Memcached对象缓存127.0.0.1:11211
PostgreSQL 17Laravel、Drupal127.0.0.1:5433
Node.js模块化开发,构建工具在终端路径中
mkcert本地 HTTPS
邮件投递箱捕获电子邮件localhost:8025
Cloudflare在线分享

iPhone

  • 在模拟器中打开 会在 iPhone 模拟器中打开该网站,并自动登录。这需要 Xcode 的模拟器。
  • 真机操作:点击“ 通过 Wi-Fi 分享”,然后用 iPhone 的摄像头扫描二维码。iPhone 必须连接到同一 Wi-Fi 网络。完成后请关闭分享功能。

分享网站

Share Online 为网站提供一个临时的 https://…trycloudflare.com 链接。无需注册账户。您可以将此链接发送给客户,以便他们查看运行在您 Mac 上的网站。

  • 为限制谁可以打开此邮件,请输入电子邮件地址或 *@client.com。Cloudflare会要求访客先验证其电子邮件地址。
  • “在线分享”和“复制链接”功能 会开始分享并将链接复制到剪贴板。 “复制邀请” 功能会复制一条包含链接的可发送消息。
  • 在网站上点击“停止在线分享” ,或在分享栏中点击“停止所有分享”,或在菜单栏中点击“停止所有分享”,即可立即停止分享。链接将失效。

WordPress 页面、图片和登录链接会跟随访客使用的地址。.

人工智能工具(MCP)

PlugBench 支持模型上下文协议 (Model Context Protocol),因此 Claude Code、Claude Desktop、Cursor 和其他 AI 工具都可以驱动它。只需一条命令即可连接 Claude Code:

claude mcp 添加 plugbench -- "/Applications/PlugBench.app/Contents/MacOS/plugbench" mcp

然后,例如,询问: 创建一个 WooCommerce 商店,链接 ~/Code/my-plugin,启用调试,下单,并告诉我是否出现任何 PHP 警告。

这26种工具:

列出站点站点信息状态启动服务创建站点 克隆 站点 列出版本设置PHP 设置PHP设置设置X调试 移动数据库 列出插件链接插件取消链接插件 激活插件 设置调试读取日志 清除日志运行PHP读取邮件 备份站点恢复站点 登录URLiPhone截图 在线 分享网络分享

run_php 以管理员身份登录 WordPress 运行代码。iphone_screenshot 让 AI 在 iPhone 上查看网站。

命令行

应用内的所有功能也可以在终端中使用。请将该工具添加到您的路径中:

ln -s /Applications/PlugBench.app/Contents/MacOS/plugbench /opt/homebrew/bin/plugbench
服务
插拔试验台启动 | 停止 | 状态控制服务
插拔式医生显示检测到的工具
插拔式测试台版本列出 PHP、数据库服务器和服务
Plugbench 添加<formula>安装其中一个,例如 php@7.4 或 mysql@8.0
插拔工作台扩展<php><name>构建 xdebug、redis、imagick 或 memcached
网站
插拔试验台列表列出网站
插拔式安装<cms><name>[来源]创建站点。选项: --sample、 --version、 --sql、 --database、 --php、 --multisite
插拔试验台信息<slug>详细信息和登录信息(JSON 格式)。
Plugbench 登录<slug>[管理员|前台]打印一次性登录链接
删除插件台<slug>删除网站
plugbench 重命名地址<slug>将旧站点迁移到 slug.localhost
PHP 和服务器
plugbench php<slug><version>更改 PHP 版本
plugbench php 设置<slug><name><value>内存限制、上传最大文件大小、最大执行时间
plugbench xdebug<slug>开|关端口 9003 上的 Xdebug
plugbench 移​​动数据库<slug><formula>移动数据库,或 默认设置
plugbench https<slug>开|关本地 HTTPS
插拔式终端<slug>使用网站的 PHP 和 WP-CLI 的终端
插件和调试
Plugbench 链接<slug><folder>链接并激活插件
plugbench 解链<slug><folder>移除链接的插件
Plugbench 插件<slug>以 JSON 格式列出插件
plugbench 调试<slug>开|关WP_DEBUG 日志记录
插拔试验台日志<slug>[行]显示日志
plugbench 日志清除<slug>空木柴
插拔试验台运行<slug><file.php|->在网站内运行 PHP
插拔台邮件列出捕获的电子邮件
备份和更新
Plugbench 备份 | 恢复<slug>备份或恢复
Plugbench 克隆版<slug><name>[php]复制网站
插拔测试台版本<slug>已安装最新版本的CMS
Plugbench 更新<slug>更新内容管理系统 (CMS)。
plugbench 更新扩展<slug>更新插件和主题
工具和共享
plugbench phpmyadmin [slug]phpMyAdmin 地址
plugbench 管理员管理员地址
plugbench 共享开启|关闭Wi-Fi共享
plugbench 共享在线<slug>[电子邮件|停止]公开链接
plugbench iPhone<slug> [小路]模拟器和截图
插拔式实验台配方列出食谱
Plugbench 许可证 [激活]<key> | 停用]执照
Plugbench MCP运行 MCP 服务器

配方:添加您自己的内容管理系统

配方文件是一个小型 JSON 文件,它告诉 PlugBench 如何安装 CMS 或框架。将您的配方文件放在 ~/Library/Application Support/PlugBench/recipes/ 目录 ,它就会出现在“新建站点”中。

{ "id": "winter", "title": "Winter CMS", "summary": "基于 Laravel 的 CMS。", "minimumPHP": "8.1", "composer": "wintercms/winter", "docroot": "", "adminPath": "/backend", "env": { "file": ".env", "copyFrom": ".env.example", "values": { "APP_URL": "{url}", "DB_HOST": "{db_host}", "DB_PORT": "{db_port}", "DB_DATABASE": "{db_name}", "DB_USERNAME": "{db_user}", "DB_PASSWORD": "{db_password}" } }, "steps": [ ["php", "artisan", "winter:up"] ] }

主要字段: composer 或 zip( 用于指定源文件)、 docroot( 用于指定服务文件夹)、 database:false( 用于平面文件 CMS)、 loginWithEmail 和 loginCommand( 用于一键登录)。占位符: {url}、 {root}、 {db_host}、 {db_port}、 {db_name}、 {db_user}、 {db_password}、 {admin_user}、 {admin_password}、 {admin_email}。

您也可以在新站点中点击 “添加食谱…” 。请仅添加您信任的食谱:它们的步骤将以您的用户身份运行。

plugbench recipes 列出了 PlugBench 检测到的配方。

免费版和专业版

自由的专业版,一次性支付 29 美元
网站3无限
所有 CMS、PHP 和数据库版本、Xdebug、HTTPS、备份、phpMyAdmin、Mailpit是的是的
在线共享和Wi-Fi共享是的
iPhone 工具是的
人工智能工具(MCP)是的

在主页的“许可证”卡片中激活密钥,或使用`plugbench license activate KEY` 命令激活密钥。密钥可在您的 Mac 电脑上使用;停用密钥即可将其转移到其他电脑。PlugBench 每周检查一次密钥,并可在离线状态下继续工作 30 天。

事物所在之处

网站~/PlugBench/<slug>
设置、日志、数据库、备份~/Library/Application Support/PlugBench
您的食谱…/PlugBench/配方
备份…/PlugBench/备份
日志…/PlugBench/日志
服务器Homebrew, /opt/homebrew

港口

网站8801 及以上端口;HTTPS 端口相同,加 1000 端口。
phpMyAdmin8799
管理员8800
邮件投递箱8025(网页),1025(SMTP)
MariaDB,默认3307
其他数据库服务器3308 及以上
Redis、Memcached、PostgreSQL6379, 11211, 5433
Xdebug9003(你的编辑在听)

除了 Wi-Fi 共享开启时的网站外,所有设备都只监听127.0.0.1 。

故障排除

启动失败或服务处于关闭状态

打开 日志 并查看错误信息。某个端口可能已被其他服务器(例如 MAMP 或 Valet)占用:退出该服务器并再次单击“启动”。plugbench doctor 命令 会列出 PlugBench 检测到的内容。

安装程序已在终端中停止。

阅读终端中的最后几行信息。Homebrew 通常会要求您输入密码或 Xcode 命令行工具。回答后,再次点击 “设置 PlugBench” :它会从上次中断的地方继续执行。

打开管理后台会显示登录页面。

登录链接有效期为 2 分钟,且只能使用一次。请再次点击“打开管理后台”。如果仍然失败,管理员密码位于网站页面上。.

浏览器警告 HTTPS

点击 “信任本地 HTTPS…” ,然后重启浏览器。Firefox 需要 nss 文件 才能信任它。

扩展程序不会构建

扩展程序只能通过 Homebrew 添加到 PHP。请查看日志中的终端输出;使用 `xcode-select --install` 通常可以解决问题。

Xdebug 不会在断点处停止。

请检查网站的 Xdebug 是否已启用,您的编辑器是否监听 9003 端口,以及浏览器请求是否来自同一网站。终端命令会在 Xdebug 关闭的情况下运行。.

iPhone 无法打开该网站

启用 Wi-Fi 共享,确保两台设备连接到同一 Wi-Fi 网络,并在 macOS 提示时允许传入连接。访客网络通常会阻止设备相互访问。.

共享链接已失效

Cloudflare Quick Tunnel 链接是临时的,会在停止共享或 Mac 进入睡眠状态时失效。请再次共享以获取新链接。.

如何彻底移除 PlugBench?

退出 PlugBench,将其从“应用程序”文件夹中删除,并删除~/Library/Application Support/PlugBench和~/PlugBench目录。Homebrew 安装的软件包会保留;如果需要,可以使用brew uninstall 命令将其移除。

如有疑问,请联系: support@nextstarsystems.com。