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

  1. Abra PlugBench.dmg y arrastre PlugBench a la carpeta Aplicaciones.
  2. Abre PlugBench. La primera vez, una ventana de bienvenida enumera lo que necesita: nginx, PHP, MariaDB y Mailpit, todo desde Homebrew.
  3. 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.
  4. 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ónLo 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.
DrupalDrupal con Drush. Muestra de revista opcional con artículos y fotos.
GravedadSistema de gestión de contenidos (CMS) basado en archivos planos, sin base de datos.
Craft CMS, TYPO3, Statamic, Laravel, SymfonyInstalado desde recetas con Composer.
Código postal personalizadoCualquier sitio PHP desde un archivo ZIP, con un archivo SQL opcional para importar. Úselo para copiar localmente el sitio de un cliente.
BlancoUna 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

  1. En Desarrollo, haga clic en Vincular carpeta de complementos… y elija la carpeta en la que está programando.
  2. PlugBench lo integra al sitio y lo activa. No se copia nada: cada guardado se muestra en la siguiente carga de página.
  3. 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.
  4. 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_filesize y post_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

  1. En Versiones, instale mkcert.
  2. Haz clic Confiar en HTTPS local… La terminal te pedirá la contraseña de tu Mac para agregar una autoridad de certificación local.
  3. 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_DEBUG y WP_DEBUG_LOG en 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.

ServicioUsarDIRECCIÓN
Rediscomplementos de caché de objetos127.0.0.1:6379
Memcachedcaché de objetos127.0.0.1:11211
PostgreSQL 17Laravel, Drupal127.0.0.1:5433
Node.jsDesarrollo de bloques, herramientas de compilaciónen la ruta terminal
certificado de maestríaHTTPS local
Corral de correosCaptura correos electrónicoslocalhost:8025
nube con llamaradaCompartir 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.

Compartir un sitio

Share Online proporciona a un sitio un enlace temporal https://…trycloudflare.com a través de un túnel gratuito de Cloudflare. No se necesita cuenta. Envíalo a un cliente para que revise un sitio web que se ejecuta en tu Mac.

  • Para limitar quién puede abrirlo, introduce direcciones de correo electrónico o *@client.com. Cloudflare solicita a los visitantes que confirmen su correo electrónico previamente.
  • Compartir en línea y copiar enlace inicia la función de compartir y copia el enlace al portapapeles. Copiar invitación copia un mensaje listo para enviar con el enlace.
  • Al seleccionar "Detener uso compartido en línea" en el sitio, "Detener todo" en la barra para compartir o " Detener todo uso compartido" en la barra de menú, la acción finaliza de inmediato. El enlace deja de funcionar.

Las páginas, imágenes y enlaces de inicio de sesión de WordPress siguen la dirección IP que utilice el visitante.

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:

listar_sitiosinformación_del_sitioestadoiniciar_servicioscrear_sitioclonar_sitio listar_versionesestablecer_phpestablecer_configuración_phpestablecer_xdebugmover_base_de_datos listar_pluginsenlazar_plugindesenlazar_pluginestablecer_plugin_activo establecer_debugleer_registrosborrar_registrosejecutar_phpleer_correo copia_de_seguridad_del_sitiorestaurar_sitiourl_de_inicio_de_sesióniphone_captura_de_pantalla compartir_en_líneacompartir_en_red

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 | estadoServicios de control
doctor de banco de enchufesMostrar herramientas detectadas
versiones de plugbenchListado 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 plugbenchLista 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|apagadoXdebug 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|apagadoHTTPS 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|apagadoRegistro 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 plugbenchLista 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 plugbenchDirección del administrador
compartir plugbench activado/desactivadoCompartir 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 enchufesLista de recetas
Licencia de plugbench [activar]<key> | desactivar]Licencia
banco de conexiones mcpEjecutar 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

GratisPro, $29 una vez
Sitios3Ilimitado
Todas las versiones de CMS, PHP y bases de datos, Xdebug, HTTPS, copias de seguridad, phpMyAdmin, MailpitSíSí
Compartir en línea y compartir por Wi-FiSí
Herramientas para iPhoneSí
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
ServidoresHomebrew, /opt/homebrew

Puertos

Sitios8801 y superiores; HTTPS en el mismo puerto + 1000
phpMyAdmin8799
Administrador8800
Corral de correos8025 (web), 1025 (SMTP)
MariaDB, por defecto3307
Otros servidores de bases de datos3308 y superiores
Redis, Memcached, PostgreSQL6379, 11211, 5433
Xdebug9003 (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.