Справка PlugBench
PlugBench — это локальный веб-сервер для вашего Mac, созданный для сборки и тестирования плагинов и тем. На этой странице описаны все его возможности.
Начиная
- Откройте
файл PlugBench.dmgи перетащите PlugBench в папку «Приложения». - Откройте PlugBench. При первом запуске появится приветственное окно со списком необходимых компонентов: nginx, PHP, MariaDB и Mailpit, все из Homebrew.
- Нажмите «Настроить PlugBench». Откроется терминал и установит все необходимое, включая Homebrew, если он отсутствует. Homebrew может один раз запросить пароль от вашего Mac. PlugBench сообщит о завершении установки.
- Нажмите «Пуск», затем «Создать сайт».
Требования: 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, готова к входу. |
| Drupal | Drupal с 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 минут. Имя пользователя и пароль администратора также отображаются на странице сайта, если они вам понадобятся.
Тестирование плагина
- В разделе «Разработка»нажмите «Связать папку плагина…» и выберите папку, в которой вы пишете код.
- 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 .
Настройки для каждого сайта, соответствующие хостингу клиента:
- Память:
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
- В разделе «Версии»установите mkcert.
- Нажмите кнопку «Доверять локальному HTTPS…» один раз. Терминал запросит пароль от вашего Mac для добавления локального центра сертификации.
- Включите 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 17 | Laravel, Drupal | 127.0.0.1:5433 |
| Node.js | Блокировка разработки, инструменты сборки | в пути терминала |
| мкцерт | Локальный HTTPS | |
| Почтовая яма | Перехватывает электронные письма | localhost:8025 |
| облачная вспышка | Поделиться онлайн |
iPhone
- Функция «Открыть в симуляторе» открывает сайт в симуляторе iPhone, предварительно авторизовавшись. Для этого требуется симулятор Xcode.
- На настоящем iPhone: нажмите «Поделиться по Wi-Fi», затем отсканируйте QR-код камерой iPhone. iPhone должен быть подключен к той же сети Wi-Fi. После завершения отключите функцию «Поделиться».
Инструменты искусственного интеллекта (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 инструментов:
Функция 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 |
| phpMyAdmin | 8799 |
| Администратор | 8800 |
| Почтовая яма | 8025 (веб), 1025 (SMTP) |
| MariaDB, по умолчанию | 3307 |
| Другие серверы баз данных | 3308 и выше |
| Redis, Memcached, PostgreSQL | 6379, 11211, 5433 |
| Xdebug | 9003 (ваш редактор слушает) |
Все устройства прослушивают 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.