Ayuda de PlugBench
PlugBench es un servidor web local para tu Mac, diseñado para crear y probar plugins y temas. Esta página describe todas sus funcionalidades.
Empezando
- Abra
PlugBench.dmgy arrastre PlugBench a la carpeta Aplicaciones. - Abre PlugBench. La primera vez, una ventana de bienvenida enumera lo que necesita: nginx, PHP, MariaDB y Mailpit, todo desde Homebrew.
- Haz clic en Configurar PlugBench. Se abrirá la terminal e instalará todo, incluyendo Homebrew si no está instalado. Es posible que Homebrew te pida la contraseña de tu Mac una sola vez. PlugBench te avisará cuando la configuración haya finalizado.
- Haz clic en Inicioy luego en Nuevo sitio.
Requisitos: macOS 14 o posterior, Apple Silicon o Intel, aproximadamente 2 GB de espacio libre para los servidores.
Cerrar la ventana mantiene los sitios web en funcionamiento. PlugBench permanece en la barra de menú. Salga de PlugBench para detener todo.
La ventana
- Sitios(a la izquierda): cada sitio, con su CMS y dirección. Seleccione uno para ver sus detalles.
- Servicios: solo los que están en funcionamiento actualmente, como nginx, PHP 8.5, MariaDB, Mailpit y Redis.
- Botones de la barra de herramientas: phpMyAdmin, Adminer, Correo, Sitios (abre la carpeta de sitios), Registros y Versiones.
- Barra para compartir: aparece mientras se comparte un sitio web, con botones para copiar el enlace o dejar de compartir.
- Icono de la barra de menú: iniciar o detener, abrir cualquier sitio web donde se haya iniciado sesión, dejar de compartir, abrir el correo electrónico.
Cada página del sitio tiene estas tarjetas:
- Encabezamiento
- Nombre, dirección y una línea como WordPress · PHP 8.5 · MariaDB 13.0. Botones Abrir sitio y Abrir administración.
- PHP y servidor
- Versión de PHP, memoria, tamaño de carga, límite de tiempo, Xdebug, servidor de base de datos, HTTPS y terminal.
- iPhone
- Ábrelo en el simulador de iPhone o escanea un código QR con un iPhone real.
- Compartir en línea
- Un enlace HTTPS público temporal.
- Desarrollo
- Complementos vinculados, modo de depuración, registros y actualizaciones.
- Copias de seguridad
- Copia de seguridad, restauración y clonación.
- Base de datos
- Nombre, usuario, contraseña, puerto y un botón para abrirlo en phpMyAdmin.
Creación de sitios
Haz clic en Nuevo sitio, elige qué instalar, asígnale un nombre y haz clic en Crear sitio.
| Elección | Lo que obtienes |
|---|---|
| WordPress | Última versión de WordPress. Contenido de ejemplo: ninguno, un blog con fotos, una tienda WooCommerce con 17 productos, categorías, clientes y pedidos, o datos de prueba. |
| Joomla | Última versión de Joomla, lista para iniciar sesión. |
| Drupal | Drupal con Drush. Muestra de revista opcional con artículos y fotos. |
| Gravedad | Sistema de gestión de contenidos (CMS) basado en archivos planos, sin base de datos. |
| Craft CMS, TYPO3, Statamic, Laravel, Symfony | Instalado desde recetas con Composer. |
| Código postal personalizado | Cualquier sitio PHP desde un archivo ZIP, con un archivo SQL opcional para importar. Úselo para copiar localmente el sitio de un cliente. |
| Blanco | Una carpeta vacía con PHP y una base de datos, para que introduzcas tu propio código. |
Opciones en la ventana Nuevo sitio: Versión de PHP, de base de datos , una versión específica del CMS y red de WordPress para Multisite.
Cada sitio tiene su propia dirección, como http://my-site.localhost:8801, su propia base de datos y su propio administrador. Solo se puede acceder a los sitios desde tu Mac, a menos que los compartas.
Inicio de sesión con un solo clic
Open Admin y Open Site te dan acceso de administrador. No necesitas introducir ninguna contraseña. Funciona en WordPress, Joomla, Drupal, Craft y Statamic.
Cada clic genera un enlace de inicio de sesión de un solo uso, válido durante 2 minutos. El nombre de usuario y la contraseña del administrador también se muestran en la página web, por si los necesita.
Probando un complemento
- En Desarrollo, haga clic en Vincular carpeta de complementos… y elija la carpeta en la que está programando.
- PlugBench lo integra al sitio y lo activa. No se copia nada: cada guardado se muestra en la siguiente carga de página.
- Active el modo de depuración para que se escriban los avisos y advertencias de PHP en el registro de depuración y haga clic en Ver registros para leerlos.
- Eliminarlo desvincula del sitio. Tu carpeta nunca se modificará.
Para probar un plugin en varias versiones de PHP, clone el sitio en otra versión (consulte Copias de seguridad) o cambie la versión de PHP del sitio.
PHP por sitio
Cada sitio tiene su propia versión de PHP. Cámbiala en PHP y Servidor en la página del sitio. El sitio se reiniciará con la nueva versión en un segundo.
Disponible: PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 y 8.5. Instale más en Versiones. PHP 7.4 y 8.0 han llegado al final de su ciclo de vida y provienen del shivammathur/php de Homebrew.
Configuración por sitio, para que coincida con el servidor del cliente:
- Memoria:
límite_de_memoria, como 128M o 512M. - Tamaño de carga:
upload_max_filesizeypost_max_size. - Límite de tiempo:
max_execution_time, en segundos.
Cada configuración se aplica únicamente a su sitio.
Extensiones de Xdebug y PHP
En Versiones, cada versión de PHP instalada muestra sus extensiones. Haz clic en una para compilarla para esa versión de PHP (aproximadamente un minuto):
- Xdebug: depuración paso a paso.
- Redis: phpredis, para complementos de caché de objetos.
- Imagick: Edición de imágenes ImageMagick.
- Memcached: para la caché de objetos Memcached.
Luego, activa Xdebug en el sitio. Xdebug permanece desactivado para todas las versiones de PHP que ningún sitio necesita, por lo que no tiene costo.
VS Code: instala la extensión PHP Debug, haz clic en Copiar configuración de VS Code, pégala en .vscode/launch.jsony activa Escuchar Xdebug. PlugBench usa el puerto 9003. PhpStorm escucha en el puerto 9003 por defecto y funciona de la misma manera.
Bases de datos
El servidor predeterminado es MariaDB, en el puerto 3307, por lo que nunca se encontrará con un MySQL que ya estés ejecutando en el puerto 3306. Instala más servidores en Versiones:
- MariaDB 10.6, 10.11, 11.4, 11.8
- MySQL 8.0, 8.4, 9.7
Cada servidor se ejecuta en su propio puerto. Seleccione uno al crear un sitio o al mover un sitio existente mediante el del servidor de base de datos : PlugBench vuelca la base de datos, la importa al otro servidor y actualiza la configuración del sitio.
phpMyAdmin y Adminer se abren con la sesión iniciada y muestran todos los servidores. La tarjeta de base de datos de un sitio abre directamente su propia base de datos. Ambas herramientas solo funcionan en Mac.
PostgreSQL 17 está disponible como servicio, en el puerto 5433, usuario postgres, con la misma contraseña que el usuario root de MySQL.
HTTPS local
- En Versiones, instale mkcert.
- Haz clic Confiar en HTTPS local… La terminal te pedirá la contraseña de tu Mac para agregar una autoridad de certificación local.
- Habilita HTTPS en un sitio. Se sirve en su puerto + 1000, como por ejemplo
https://my-site.localhost:9801.
En WordPress, PlugBench actualiza las direcciones del sitio en la base de datos, incluyendo Multisite. Desactivar HTTPS revierte estos cambios.
WordPress Multisite
Activa la red de WordPress en Nuevo sitio. Obtendrás una red con sitios en subdirectorios, como /shop/. Agrega sitios en Mis sitios, Administración de red, Sitios. Los clones, HTTPS y el uso compartido mantienen la red funcionando.
Terminal y WP-CLI
Al abrir la terminal en un sitio web, se abre una consola en su carpeta, con el PHP del sitio en primer lugar en la ruta y WordPress listo. PHP, Composer y WordPress utilizan la versión de PHP de ese sitio. También se cargan tus ajustes de consola.
wp plugin list wp user create editor editor@example.com --role=editor wp eval 'echo get_option("home");'
Correo electrónico, registros y depuración
- Mail abre Mailpit. Todos los correos que envía un sitio web terminan allí: restablecimientos de contraseña, pedidos de WooCommerce, formularios de contacto. Nada sale de tu Mac.
- El modo de depuración activa
WP_DEBUGyWP_DEBUG_LOGen WordPress. - El comando `logs` muestra el registro de depuración, el registro de errores de PHP y los errores de nginx. `clear` los vacía antes de una prueba.
Copias de seguridad, clones y actualizaciones
- La función Copia de seguridad inmediata guarda los archivos y la base de datos. La función Restaurar recupera la última copia de seguridad.
- La función Clonar copia un sitio con un nombre nuevo, opcionalmente en otra versión de PHP. Las direcciones dentro de la base de datos se actualizan.
- La actualización realiza una copia de seguridad de la base de datos y luego actualiza el CMS. En WordPress, la actualización de plugins y temas actualiza el resto.
- La opción Eliminar borra el sitio, su base de datos y su certificado.
Servicios
Instalar desde Versiones. Una vez instalados, se inician y se detienen con PlugBench.
| Servicio | Usar | DIRECCIÓN |
|---|---|---|
| Redis | complementos de caché de objetos | 127.0.0.1:6379 |
| Memcached | caché de objetos | 127.0.0.1:11211 |
| PostgreSQL 17 | Laravel, Drupal | 127.0.0.1:5433 |
| Node.js | Desarrollo de bloques, herramientas de compilación | en la ruta terminal |
| certificado de maestría | HTTPS local | |
| Corral de correos | Captura correos electrónicos | localhost:8025 |
| nube con llamarada | Compartir en línea |
iPhone
- Abrir en el simulador abre el sitio en el simulador de iPhone, con la sesión iniciada. Requiere el simulador de Xcode.
- iPhone real: pulsa Compartir en Wi-Fiy escanea el código QR con la cámara del iPhone. El iPhone debe estar conectado a la misma red Wi-Fi. Desactiva la opción de compartir cuando hayas terminado.
Herramientas de IA (MCP)
PlugBench utiliza el protocolo Model Context Protocol, por lo que Claude Code, Claude Desktop, Cursor y otras herramientas de IA pueden controlarlo. Conecte Claude Code con un solo comando:
claude mcp add plugbench -- "/Applications/PlugBench.app/Contents/MacOS/plugbench" mcp
Luego, pregúntale, por ejemplo: Crea una tienda WooCommerce, enlaza ~/Code/my-plugin, activa la depuración, haz un pedido y dime si aparece alguna advertencia de PHP.
Las 26 herramientas:
run_php ejecuta código dentro de WordPress, con la sesión iniciada como administrador. iphone_screenshot permite que la IA vea el sitio en un iPhone.
Línea de comandos
Todo en la aplicación también funciona desde la terminal. Agrega la herramienta a tu ruta:
ln -s /Applications/PlugBench.app/Contents/MacOS/plugbench /opt/homebrew/bin/plugbench
| Servicios | |
|---|---|
Plugbench iniciar | detener | estado | Servicios de control |
doctor de banco de enchufes | Mostrar herramientas detectadas |
versiones de plugbench | Listado de servidores y servicios PHP y de bases de datos |
agregar banco de conexiones<formula> | Instala uno, como php@7.4 o mysql@8.0. |
Extensión del banco de enchufes<php><name> | Compilar xdebug, redis, imagick o memcached |
| Sitios | |
lista de plugbench | Lista de sitios |
Instalación del banco de enchufes<cms><name> [fuente] | Crea un sitio. Opciones: --sample, --version, --sql, --database, --php, --multisite |
Información del banco de conexiones<slug> | Detalles e inicios de sesión en formato JSON |
Inicio de sesión en plugbench<slug> [admin|frontal] | Imprime un enlace de inicio de sesión único |
eliminar banco de conexiones<slug> | Eliminar un sitio |
cambiar nombre de dirección del banco de conexiones<slug> | Trasladar un sitio antiguo a slug.localhost |
| PHP y servidor | |
plugbench php<slug><version> | Cambiar la versión de PHP |
configuración de PHP de plugbench<slug><name><value> | límite_de_memoria, tamaño_máximo_de_archivo_de_subida, tiempo_máximo_de_ejecución |
plugbench xdebug<slug> encendido|apagado | Xdebug en el puerto 9003 |
plugbench move-db<slug><formula> | Mover la base de datos o la configuración predeterminada |
banco de conexiones https<slug> encendido|apagado | HTTPS local |
terminal de banco de enchufes<slug> | Terminal con PHP y WP-CLI del sitio |
| Complementos y depuración | |
enlace del banco de conexiones<slug><folder> | Enlace y active un complemento |
desvincular el banco de conexiones<slug><folder> | Eliminar un complemento vinculado |
Plugins de Plugbench<slug> | Lista de complementos como JSON |
depuración de plugbench<slug> encendido|apagado | Registro de WP_DEBUG |
registros de plugbench<slug> [pauta] | Mostrar registros |
borrar registros de plugbench<slug> | Registros vacíos |
Prueba de banco de conexiones<slug><file.php|-> | Ejecutar PHP dentro de un sitio |
correo de plugbench | Lista de correos electrónicos interceptados |
| Copias de seguridad y actualizaciones | |
Copia de seguridad de plugbench | Restaurar<slug> | Realizar una copia de seguridad o restaurar |
clon de plugbench<slug><name> [php] | Copiar un sitio |
versión plugbench<slug> | Versión de CMS instalada y más reciente |
Actualización de plugbench<slug> | Actualizar el CMS |
extensiones de actualización de plugbench<slug> | Actualizar plugins y temas |
| Herramientas y compartición | |
plugbench phpmyadmin [slug] | Dirección de phpMyAdmin |
administrador de plugbench | Dirección del administrador |
compartir plugbench activado/desactivado | Compartir Wi-Fi |
compartir plugbench en línea<slug> [correos electrónicos|detener] | Enlace público |
banco de enchufes iPhone<slug> [camino] | Simulador y captura de pantalla |
recetas de enchufes | Lista de recetas |
Licencia de plugbench [activar]<key> | desactivar] | Licencia |
banco de conexiones mcp | Ejecutar el servidor MCP |
Recetas: añade tu propio CMS
Una receta es un pequeño archivo JSON que le indica a PlugBench cómo instalar un CMS o un framework. Coloca la tuya en ~/Library/Application Support/PlugBench/recipes/ y aparecerá en Nuevo sitio.
{ "id": "winter", "title": "Winter CMS", "summary": "El CMS basado en 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"] ] }
Campos principales: composer o zip para la fuente, docroot para la carpeta servida, database: false para CMS de archivo plano, loginWithEmail y loginCommand para inicio de sesión con un clic. Marcadores de posición: {url}, {root}, {db_host}, {db_port}, {db_name}, {db_user}, {db_password}, {admin_user}, {admin_password}, {admin_email}.
También puedes hacer clic en Agregar una receta… en Nuevo sitio. Agrega solo recetas en las que confíes: sus pasos se ejecutan como tu usuario.
plugbench recipes muestra las recetas que PlugBench detecta.
Gratis y Pro
| Gratis | Pro, $29 una vez | |
|---|---|---|
| Sitios | 3 | Ilimitado |
| Todas las versiones de CMS, PHP y bases de datos, Xdebug, HTTPS, copias de seguridad, phpMyAdmin, Mailpit | Sí | Sí |
| Compartir en línea y compartir por Wi-Fi | Sí | |
| Herramientas para iPhone | Sí | |
| Herramientas de IA (MCP) | Sí |
Activa una clave en la de licencia de la página principal o con plugbench license activate KEY. Una clave funciona en tu Mac; desactívala para transferirla. PlugBench comprueba la clave una vez por semana y sigue funcionando sin conexión durante 30 días.
Donde están las cosas
| Sitios | ~/PlugBench/<slug> |
| Configuración, registros, bases de datos, copias de seguridad | ~/Library/Application Support/PlugBench |
| Tus recetas | …/PlugBench/recetas |
| Copias de seguridad | …/PlugBench/copias de seguridad |
| Registros | …/PlugBench/registros |
| Servidores | Homebrew, /opt/homebrew |
Puertos
| Sitios | 8801 y superiores; HTTPS en el mismo puerto + 1000 |
| phpMyAdmin | 8799 |
| Administrador | 8800 |
| Corral de correos | 8025 (web), 1025 (SMTP) |
| MariaDB, por defecto | 3307 |
| Otros servidores de bases de datos | 3308 y superiores |
| Redis, Memcached, PostgreSQL | 6379, 11211, 5433 |
| Xdebug | 9003 (su editor escucha) |
Todo escucha únicamente en 127.0.0.1 , excepto los sitios web cuando la función de compartir Wi-Fi está activada.
Solución de problemas
El inicio falla o un servicio permanece apagado
Abre los registros y lee el error. Es posible que otro servidor, como MAMP o Valet, ya esté utilizando el puerto: ciérralo y vuelve a hacer clic en Iniciar. `plugbench doctor` muestra los resultados de PlugBench.
La configuración se detuvo en la terminal
Lee las últimas líneas en la terminal. A menudo, Homebrew te pedirá tu contraseña o las herramientas de línea de comandos de Xcode. Responde y vuelve a hacer clic en Configurar PlugBench : continuará donde se detuvo.
Open Admin muestra la página de inicio de sesión
Los enlaces de inicio de sesión duran 2 minutos y funcionan una sola vez. Haz clic en Abrir administración de nuevo. Si sigue fallando, la contraseña de administrador se encuentra en la página del sitio.
El navegador advierte sobre HTTPS
Haz clic en Confiar en HTTPS local… en Versiones una vez y luego reinicia el navegador. Firefox necesita nss de Homebrew para confiar en él.
Una extensión no se construye
Las extensiones solo se pueden agregar a PHP desde Homebrew. Consulta la salida de la terminal en los registros; instalar las últimas herramientas de línea de comandos de Xcode con xcode-select --install suele solucionar el problema.
Xdebug no se detiene en los puntos de interrupción
Comprueba que Xdebug esté activado para el sitio, que tu editor escuche en el puerto 9003 y que la solicitud del navegador provenga del mismo sitio. Los comandos en la terminal se ejecutan con Xdebug desactivado.
El iPhone no puede abrir el sitio
Activa la función de compartir Wi-Fi, comprueba que ambos dispositivos estén conectados a la misma red Wi-Fi y permite las conexiones entrantes si macOS lo solicita. Las redes de invitados suelen impedir que los dispositivos se vean entre sí.
Un enlace compartido dejó de funcionar
Los enlaces de Cloudflare Quick Tunnel son temporales y caducan cuando se deja de compartir o el Mac entra en modo de reposo. Vuelve a compartir para obtener un nuevo enlace.
¿Cómo puedo eliminar PlugBench por completo?
Cierra PlugBench, bórralo de Aplicaciones y borra las carpetas ~/Library/Application Support/PlugBench y ~/PlugBench . Los paquetes de Homebrew se conservarán; si quieres, puedes eliminarlos con brew uninstall
Preguntas: support@nextstarsystems.com.