PlugBench 帮助
PlugBench 是一款适用于 Mac 的本地 Web 服务器,专为构建和测试插件及主题而设计。本页面将介绍它的所有功能。.
入门
- 打开
PlugBench.dmg并将 PlugBench 拖到“应用程序”文件夹中。 - 打开 PlugBench。首次运行时,会弹出一个欢迎窗口,列出它需要的组件:nginx、PHP、MariaDB 和 Mailpit,全部来自 Homebrew。
- 点击 “设置 PlugBench”。终端将打开并安装所有组件,包括 Homebrew(如果缺少)。Homebrew 可能会要求您输入一次 Mac 密码。PlugBench 会在设置完成后发出通知。
- 点击 “开始”,然后点击 “新建站点”。
系统要求: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,可直接登录。. |
| Drupal | Drupal 与 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 分钟的一次性登录链接。如果您需要,管理员用户名和密码也会显示在网站页面上。.
测试插件
- 在 开发界面,点击 “链接插件文件夹…” ,然后选择您正在编写代码的文件夹。
- PlugBench 将其链接到网站并激活。不会复制任何内容:每次保存的内容都会在下次页面加载时显示。.
- 开启 调试模式 ,将 PHP 通知和警告写入调试日志,点击 “查看日志” 即可查看。
- 删除操作会将其从网站中移除。您的文件夹不会被修改。
要在多个 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
- 在 版本,安装 mkcert。
- 点击 “信任本地 HTTPS…” 一次。终端会要求您输入 Mac 密码以添加本地证书颁发机构。
- 启用 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 17 | Laravel、Drupal | 127.0.0.1:5433 |
| Node.js | 模块化开发,构建工具 | 在终端路径中 |
| mkcert | 本地 HTTPS | |
| 邮件投递箱 | 捕获电子邮件 | localhost:8025 |
| Cloudflare | 在线分享 |
iPhone
- 在模拟器中打开 会在 iPhone 模拟器中打开该网站,并自动登录。这需要 Xcode 的模拟器。
- 真机操作:点击“ 通过 Wi-Fi 分享”,然后用 iPhone 的摄像头扫描二维码。iPhone 必须连接到同一 Wi-Fi 网络。完成后请关闭分享功能。
人工智能工具(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种工具:
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 端口。 |
| phpMyAdmin | 8799 |
| 管理员 | 8800 |
| 邮件投递箱 | 8025(网页),1025(SMTP) |
| MariaDB,默认 | 3307 |
| 其他数据库服务器 | 3308 及以上 |
| Redis、Memcached、PostgreSQL | 6379, 11211, 5433 |
| Xdebug | 9003(你的编辑在听) |
除了 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。