Справка PlugBench

PlugBench — это локальный веб-сервер для вашего Mac, созданный для сборки и тестирования плагинов и тем. На этой странице описаны все его возможности.

Начиная

  1. Откройте файл PlugBench.dmg и перетащите PlugBench в папку «Приложения».
  2. Откройте PlugBench. При первом запуске появится приветственное окно со списком необходимых компонентов: nginx, PHP, MariaDB и Mailpit, все из Homebrew.
  3. Нажмите «Настроить PlugBench». Откроется терминал и установит все необходимое, включая Homebrew, если он отсутствует. Homebrew может один раз запросить пароль от вашего Mac. PlugBench сообщит о завершении установки.
  4. Нажмите «Пуск», затем «Создать сайт».

Требования: macOS 14 или более поздняя версия, процессоры Apple Silicon или Intel, около 2 ГБ свободного места на серверах.

Закрытие окна позволяет сайтам оставаться запущенными. PlugBench остается в строке меню. Закройте PlugBench, чтобы остановить все приложения.

Окно

  • Слева — раздел «Сайты» : каждый сайт с указанием его CMS и адреса. Выберите один, чтобы просмотреть его подробную информацию
  • Сервисы: только те, которые запущены в данный момент, такие как nginx, PHP 8.5, MariaDB, Mailpit и Redis.
  • Кнопки на панели инструментов: phpMyAdmin, Adminer, Mail, Sites (открывает папку сайтов), Logs и Versions.
  • Панель общего доступа: появляется, когда сайт доступен для общего доступа, с кнопками для копирования ссылки или прекращения общего доступа.
  • Значок в строке меню: запуск или остановка, открытие любого сайта, на который вы авторизованы, прекращение общего доступа, открытие почты.

На каждой странице сайта есть следующие карточки:

Заголовок
Название, адрес и строка, например, WordPress · PHP 8.5 · MariaDB 13.0. Кнопки «Открыть сайт» и «Открыть административную панель».
PHP и сервер
Версия PHP, объем памяти, размер загружаемого файла, ограничение по времени, Xdebug, сервер базы данных, HTTPS и терминал.
iPhone
Откройте в симуляторе iPhone или отсканируйте QR-код с помощью настоящего iPhone.
Поделиться онлайн
Временная публичная ссылка HTTPS.
Разработка
Связанные плагины, режим отладки, журналы и обновления.
Резервные копии
Создайте резервную копию, восстановите и клонируйте.
База данных
Имя пользователя, пароль, порт и кнопка для открытия файла в phpMyAdmin.

Создание сайтов

Нажмите «Новый сайт», выберите, что нужно установить, дайте ему имя и нажмите «Создать сайт».

ВыборЧто вы получите
WordPressПоследняя версия WordPress. Пример контента: отсутствует, блог с фотографиями, магазин WooCommerce с 17 товарами, категориями, клиентами и заказами, или тестовые данные.
JoomlaПоследняя версия Joomla, готова к входу.
DrupalDrupal с Drush. Дополнительный пример журнала со статьями и фотографиями.
ГравCMS на основе плоских файлов, без базы данных.
Craft CMS, TYPO3, Statamic, Laravel, SymfonyУстанавливается из рецептов с помощью Composer.
Пользовательский ZIP-архивЛюбой 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 .

Настройки для каждого сайта, соответствующие хостингу клиента:

  • Память: 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и запустите Listen for Xdebug. PlugBench использует порт 9003. PhpStorm по умолчанию прослушивает порт 9003 и работает аналогично.

Базы данных

В качестве сервера по умолчанию используется MariaDB на порту 3307, поэтому он никогда не будет взаимодействовать с MySQL, который уже запущен на порту 3306. Установите дополнительные серверы в разделе «Версии»:

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

Каждый сервер работает на своем собственном порту. Выберите один из них при создании сайта или переместите существующий сайт с помощью «Сервер базы данных» : PlugBench выполнит дамп базы данных, импортирует ее на другой сервер и обновит конфигурацию сайта.

phpMyAdmin и Adminer открывают уже авторизованные системы со списком всех серверов. Карточка базы данных на сайте открывает свою собственную базу данных напрямую. Оба инструмента работают только на Mac.

PostgreSQL 17 доступен как служба на порту 5433, пользователь postgres, с тем же паролем, что и у пользователя root MySQL.

Локальный HTTPS

  1. В разделе «Версии»установите mkcert.
  2. Нажмите кнопку «Доверять локальному HTTPS…» один раз. Терминал запросит пароль от вашего Mac для добавления локального центра сертификации.
  3. Включите HTTPS на сайте. Он будет обслуживаться на порту + 1000, например, https://my-site.localhost:9801.

В WordPress PlugBench обновляет адреса сайтов в базе данных, включая Multisite. Отключение HTTPS отменяет эти изменения.

WordPress Multisite

Включите сетевое подключение WordPress в новом сайте. Вы получите сеть с сайтами в подкаталогах, например , /shop/. Добавьте сайты в разделе «Мои сайты», «Администрирование сети», «Сайты». Клонирование, HTTPS и общий доступ обеспечивают работу сети.

Терминал и WP-CLI

Открытие терминала на сайте запускает командную оболочку в его папке, при этом PHP-код сайта находится в пути, а WordPress готов к работе. PHP, Composer и WordPress используют версию PHP этого сайта. Ваши собственные настройки командной оболочки также загружаются.

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 в WordPress.
  • В разделе Logs отображаются отладочные журналы, журналы ошибок PHP и ошибки nginx. Функция Clear очищает их перед тестированием.

Резервное копирование, клонирование и обновления

  • Функция «Создать резервную копию сейчас» сохраняет файлы и базу данных. Функция «Восстановить» восстанавливает последнюю резервную копию.
  • Функция клонирования копирует сайт под новым именем, при необходимости используя другую версию PHP. Адреса в базе данных обновляются.
  • Функция обновления создает резервные копии базы данных, а затем обновляет CMS. В WordPress функция обновления плагинов и тем обновляет все остальное.
  • Удаление приводит к удалению сайта, его базы данных и сертификата.

Услуги

Установите из раздела «Версии». После установки они будут запускаться и останавливаться вместе с PlugBench.

УслугаИспользоватьАдрес
РедисПлагины кэширования объектов127.0.0.1:6379
МемкэшедКэш объектов127.0.0.1:11211
PostgreSQL 17Laravel, Drupal127.0.0.1:5433
Node.jsБлокировка разработки, инструменты сборкив пути терминала
мкцертЛокальный HTTPS
Почтовая ямаПерехватывает электронные письмаlocalhost:8025
облачная вспышкаПоделиться онлайн

iPhone

  • Функция «Открыть в симуляторе» открывает сайт в симуляторе iPhone, предварительно авторизовавшись. Для этого требуется симулятор Xcode.
  • На настоящем iPhone: нажмите «Поделиться по Wi-Fi», затем отсканируйте QR-код камерой iPhone. iPhone должен быть подключен к той же сети Wi-Fi. После завершения отключите функцию «Поделиться».

Совместное использование сайта

Share Online предоставляет сайту временную https://…trycloudflare.com через бесплатный туннель Cloudflare. Регистрация не требуется. Отправьте ссылку клиенту для проверки сайта, работающего на вашем Mac.

  • Чтобы ограничить круг лиц, которые могут открыть это сообщение, введите адрес электронной почты или *@client.com. Cloudflare сначала попросит посетителей подтвердить свой адрес электронной почты.
  • Функция «Поделиться онлайн» и «Скопировать ссылку» запускает функцию обмена и помещает ссылку в буфер обмена. Функция «Скопировать приглашение» копирует готовое к отправке сообщение со ссылкой.
  • Функция «Остановить общий доступ онлайн» на сайте, «Остановить общий доступ ко всему контенту» в строке общего доступа или «Остановить общий доступ ко всему контенту» в строке меню приводит к немедленному закрытию ссылки. Ссылка перестаёт работать.

Страницы WordPress, изображения и ссылки для входа в систему отображаются независимо от адреса, указанного посетителем.

Инструменты искусственного интеллекта (MCP)

PlugBench использует протокол контекста модели (Model Context Protocol), поэтому Claude Code, Claude Desktop, Cursor и другие инструменты искусственного интеллекта могут работать с ним. Подключите Claude Code одной командой:

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

Затем спросите, например: Создайте магазин WooCommerce, свяжите его с папкой ~/Code/my-plugin, включите режим отладки, разместите заказ и сообщите, появятся ли какие-либо предупреждения PHP.

26 инструментов:

list_sitessite_infostatusstart_servicescreate_siteclone_site list_versionsset_phpset_php_settingset_xdebugmove_database list_pluginslink_pluginunlink_pluginset_plugin_active set_debugread_logsclear_logsrun_phpread_mail backup_siterestore_sitelogin_urliphone_screenshot share_onlineshare_on_network

Функция run_php запускает код внутри WordPress, авторизованный как администратор. Функция iphone_screenshot позволяет ИИ просмотреть сайт на iPhone.

Командная строка

Все функции приложения также работают из Терминала. Добавьте инструмент в переменную PATH:

ln -s /Applications/PlugBench.app/Contents/MacOS/plugbench /opt/homebrew/bin/plugbench
Услуги
запуск | остановка | состояние диагностического стендаКонтрольные службы
plugbench doctorПоказать обнаруженные инструменты
версии для верстакаПеречислите PHP-серверы, серверы баз данных и сервисы
plugbench add<formula>Установите одну из них, например, php@7.4 или mysql@8.0.
расширение верстака<php><name>Соберите xdebug, redis, imagick или memcached
Сайты
список стендовСписок сайтов
установка plugbench<cms><name> [источник]Создайте сайт. Параметры: --sample, --version, --sql, --database, --php, --multisite
информация о стенде для испытаний<slug>Подробная информация и данные для входа в систему в формате JSON
вход в Plugbench<slug> [admin|front]Распечатайте одноразовую ссылку для входа в систему
удаление скамейки<slug>Удалить сайт
plugbench rename-address<slug>Переместите старый сайт на slug.localhost
PHP и сервер
plugbench php<slug><version>Изменить версию PHP
plugbench php-setting<slug><name><value>memory_limit, upload_max_filesize, max_execution_time
plugbench xdebug<slug> вкл|выклXdebug на порту 9003
plugbench move-db<slug><formula>Переместите базу данных или используйте значение по умолчанию.
plugbench https<slug> вкл|выклЛокальный HTTPS
клемма разъема<slug>Терминал с PHP-кодом сайта и WP-CLI
Плагины и отладка
ссылка на стенд<slug><folder>Подключите и активируйте плагин
plugbench unlink<slug><folder>Удалить связанный плагин
плагины plugbench<slug>Список плагинов в формате JSON
отладка plugbench<slug> вкл|выклWP_DEBUG логирование
журналы стенда<slug> [строки]Показать журналы
журналы верстака - очистить<slug>Пустые журналы
запуск на стенде<slug><file.php|->Запуск PHP внутри сайта
электронная почтаСписок перехваченных писем
Резервное копирование и обновления
резервное копирование plugbench | восстановление<slug>Создайте резервную копию или восстановите данные
клон настольного компьютера<slug><name> [php]Скопировать сайт
версия для верстака<slug>Установлена ​​последняя версия CMS
обновление plugbench<slug>Обновите CMS
plugbench update-extensions<slug>Обновите плагины и темы
Инструменты и обмен информацией
plugbench phpmyadmin [slug]адрес phpMyAdmin
plugbench adminerАдрес администратора
plugbench share on|offСовместное использование Wi-Fi
plugbench share-online<slug> [emails|stop]Общедоступная ссылка
plugbench iphone<slug> [путь]Симулятор и скриншот
рецепты для стендаСписок рецептов
лицензия plugbench [активировать]<key> [деактивировать]Лицензия
plugbench mcpЗапустите сервер MCP

Рецепты: добавьте свою собственную CMS

Рецепт — это небольшой JSON-файл, который сообщает PlugBench, как установить CMS или фреймворк. Поместите свой рецепт в папку ~/Library/Application Support/PlugBench/recipes/ , и он появится в списке новых сайтов.

{ "id": "winter", "title": "Winter CMS", "summary": "CMS на основе Laravel."", "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/recipes
Резервные копии…/PlugBench/backups
Журналы…/PlugBench/logs
СерверыHomebrew, /opt/homebrew

Порты

Сайты8801 и выше; HTTPS на том же порту + 1000
phpMyAdmin8799
Администратор8800
Почтовая яма8025 (веб), 1025 (SMTP)
MariaDB, по умолчанию3307
Другие серверы баз данных3308 и выше
Redis, Memcached, PostgreSQL6379, 11211, 5433
Xdebug9003 (ваш редактор слушает)

Все устройства прослушивают 127.0.0.1 , за исключением сайтов, где включена функция совместного использования Wi-Fi.

Поиск неисправностей

Запуск не удается или служба остается отключенной

Откройте журналы и прочтите сообщение об ошибке. Порт может быть уже занят другим сервером, например MAMP или Valet: закройте его и снова нажмите «Запустить». Команда `plugbench doctor` покажет, что обнаружила программа PlugBench.

Процесс установки остановлен в терминале

Прочитайте последние строки в Терминале. Часто Homebrew запрашивает ваш пароль или доступ к инструментам командной строки Xcode. Ответьте, затем снова нажмите «Настроить PlugBench» : процесс продолжится с того места, где остановился.

В окне «Открыть административную панель» отображается страница входа в систему

Ссылки для входа действуют 2 минуты и срабатывают только один раз. Нажмите «Открыть административную панель» еще раз. Если проблема не исчезнет, ​​пароль администратора находится на странице сайта.

Браузер предупреждает о HTTPS

нажмите «Доверять локальному HTTPS…» , затем перезапустите браузер. Firefox требует, nss из Homebrew доверял ему.

Расширение не собирается

Расширения можно добавить в PHP только через Homebrew. Прочитайте вывод терминала в логах; установка последних версий инструментов командной строки Xcode с помощью команды 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.