Ajuda do PlugBench

O PlugBench é um servidor web local para o seu Mac, criado para desenvolver e testar plugins e temas. Esta página explica tudo o que ele pode fazer.

Começando

  1. Abra o ficheiro PlugBench. dmg e arraste o PlugBench para a pasta Aplicações.
  2. Abra o PlugBench. Na primeira vez, uma janela de boas-vindas lista o que ele precisa: nginx, PHP, MariaDB e Mailpit, todos do Homebrew.
  3. Clique em Configurar PlugBench. O Terminal será aberto e instalará tudo, incluindo o Homebrew, caso este esteja em falta. O Homebrew pode solicitar a sua palavra-passe do Mac uma vez. O PlugBench irá notificar quando a configuração estiver concluída.
  4. Clique em Iniciare, em seguida, em Novo Site.

Requisitos: macOS 14 ou posterior, Apple Silicon ou Intel, cerca de 2 GB de espaço livre para os servidores.

Fechar a janela mantém os sites em execução. O PlugBench permanece na barra de menus. Saia do PlugBench para interromper tudo.

A janela

  • Sites, à esquerda: todos os sites, com o seu CMS e endereço. Selecione um para ver os detalhes.
  • Serviços: apenas o que está a ser executado no momento, como o nginx, PHP 8.5, MariaDB, Mailpit e Redis.
  • Botões da barra de ferramentas: phpMyAdmin, Adminer, E-mail, Sites (abre a pasta de sites), Logs e Versões.
  • Barra de partilha: aparece enquanto um site está a ser partilhado, com botões para copiar o link ou parar a partilha.
  • Ícone da barra de menus: iniciar ou parar, abrir qualquer site com sessão iniciada, parar de partilhar, abrir o e-mail.

A página de cada site contém estes cartões:

Cabeçalho
Nome, endereço e uma linha como o WordPress · PHP 8.5 · MariaDB 13.0. Botões Abrir Site e Abrir Administração.
PHP e Servidor
Versão do PHP, memória, tamanho de upload, limite de tempo, Xdebug, servidor de base de dados, HTTPS e Terminal.
iPhone
Abra no Simulador do iPhone ou digitalize um código QR com um iPhone real.
Compartilhe online
Um link https público temporário.
Desenvolvimento
Plugins ligados, modo de depuração, registos e atualizações.
Cópias de segurança
Fazer backup, restaurar e clonar.
Banco de dados
Nome, utilizador, palavra-passe, porta e um botão para abrir no phpMyAdmin.

Criação de sites

Clique em Novo Site, escolha o que pretende instalar, dê-lhe um nome e clique em Criar Site.

EscolhaO que recebe
WordPressÚltima versão do WordPress. Conteúdo de exemplo: nenhum, um blog com fotos, uma loja WooCommerce com 17 produtos, categorias, clientes e encomendas, ou dados de teste.
JoomlaÚltima versão do Joomla, pronta para iniciar sessão.
DrupalDrupal com Drush. Exemplo opcional de revista com artigos e fotos.
GravCMS baseado em ficheiros simples, sem base de dados.
Craft CMS, TYPO3, Statamic, Laravel, SymfonyInstalado a partir de receitas com o Composer.
CEP personalizadoQualquer site PHP a partir de um ficheiro ZIP, com um ficheiro SQL opcional para importação. Utilize-o para copiar o site de um cliente localmente.
Em brancoUma pasta vazia com PHP e uma base de dados, para o seu próprio código.

Opções na janela Novo Site: versão do PHP, de base de dados , versão específica do CMS e rede WordPress para Multisite.

Cada site recebe o seu próprio endereço, como por exemplo http://meu-site.localhost:8801, a sua própria base de dados e o seu próprio administrador. Os sites só podem ser acedidos a partir do seu Mac, a menos que os partilhe.

Iniciar sessão com um clique

O Open Admin e o Open Site permitem-lhe iniciar sessão como administrador. Não é necessário introduzir senha. Isto funciona em WordPress, Joomla, Drupal, Craft e Statamic.

Cada clique gera um link de login de utilização única, válido por 2 minutos. O nome de utilizador e a palavra-passe do administrador também são apresentados na página do site, caso necessite deles.

Testando um plugin

  1. Em Desenvolvimento, clique em Ligar Pasta do Plugin… e escolha a pasta onde está a programar.
  2. O PlugBench integra-o no site e ativa-o. Nada é copiado: cada alteração guardada é apresentada no próximo carregamento da página.
  3. Ative o modo de depuração para registar avisos e alertas do PHP no registo de depuração e clique em "Ver registos" para os ler.
  4. Remover desvincula o item do site. A sua pasta não será alterada.

Para testar um plugin em várias versões do PHP, clone o site para outra versão (consulte Backups) ou altere a versão do PHP do site.

PHP por site

Cada site tem a sua própria versão do PHP. Altere-a nas definições de PHP e servidor na página do site. O site será reiniciado com a nova versão em segundos.

Disponível: PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 e 8.5. Instale mais versões em Versões . O PHP 7.4 e o 8.0 estão em fim de vida útil e são provenientes do repositório Homebrew shivammathur/php

Configurações específicas do site, para corresponder ao host do cliente:

  • Memória: limite_de_memória, como por exemplo 128M ou 512M.
  • Tamanho máximo de upload: upload_max_filesize e post_max_size.
  • Limite de tempo: tempo_máximo_de_execução, em segundos.

Cada configuração aplica-se apenas ao seu respetivo site.

Xdebug e extensões PHP

Em Versões, cada instalação do PHP exibe as suas extensões. Clique numa para a compilar para essa versão do PHP (cerca de um minuto):

  • Xdebug: depuração passo a passo.
  • Redis: phpredis, para plugins de cache de objetos.
  • Imagick: Edição de imagem com ImageMagick.
  • Memcached: para cache de objetos Memcached.

De seguida, ative o Xdebug no site. O Xdebug continua desativado em todas as versões do PHP, pois nenhum site necessita dele ativado, pelo que não tem qualquer custo.

VS Code: instale a extensão PHP Debug, clique em "Copy VS Code Configuration", cole o conteúdo em .vscode/launch.jsone inicie a escuta do Xdebug. O PlugBench utiliza a porta 9003. O PhpStorm também utiliza a porta 9003 por defeito e funciona da mesma forma.

Bancos de dados

O servidor predefinido é o MariaDB, na porta 3307, pelo que nunca entrará em contacto com um MySQL que já esteja a executar na porta 3306. Instale mais servidores em Versões:

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

Cada servidor é executado na sua própria porta. Selecione uma ao criar um site ou migre um site existente utilizando o Database Server : o PlugBench exporta a base de dados, importa-a para o outro servidor e atualiza a configuração do site.

O phpMyAdmin e o Adminer abrem com a sessão iniciada e todos os servidores listados. O cartão "Base de Dados" num site abre a sua própria base de dados diretamente. Ambas as ferramentas funcionam apenas no seu Mac.

O PostgreSQL 17 está disponível como um serviço, na porta 5433, utilizador postgres, com a mesma password do utilizador root do MySQL.

HTTPS local

  1. Em Versões, instale o mkcert.
  2. Clique em "Confiar em HTTPS local…" uma vez. O Terminal irá solicitar a palavra-passe do seu Mac para adicionar uma autoridade de certificação local.
  3. Ative o HTTPS num site. Será servido na porta +1000, como por exemplo https://meu-site.localhost:9801.

No WordPress, o PlugBench atualiza os endereços dos sites na base de dados, incluindo os sites multisite. Desativar o HTTPS reverte estas atualizações.

WordPress Multisite

Ative a rede WordPress em Novo Site. Terá uma rede com sites em subdiretórios, como por exemplo /loja/. Adicione sites em Os Meus Sites, Administração da Rede, Sites. Clones, HTTPS e partilha mantêm a rede a funcionar.

Terminal e WP-CLI

Ao abrir o Terminal num site, é aberto um shell na sua pasta, com o PHP do site em primeiro lugar no caminho e o WordPress pronto a usar. O PHP, o Composer e o WordPress utilizam a versão do PHP desse site. As suas configurações de shell também são carregadas.

wp plugin list wp user create editor editor@example.com --role=editor wp eval 'echo get_option("home");'

E-mail, registos e depuração

  • O Mail abre o Mailpit. Todos os e-mails enviados por um site chegam lá: redefinições de palavras-passe, pedidos WooCommerce, formulários de contacto. Nada sai do seu Mac.
  • O modo de depuração ativa as WP_DEBUG e WP_DEBUG_LOG no WordPress.
  • O parâmetro "Logs" apresenta o registo de depuração, o registo de erros PHP e os erros nginx. O parâmetro "Clear" limpa-os antes de um teste.

Cópias de segurança, clones e atualizações

  • A opção Fazer Backup Agora guarda os ficheiros e a base de dados. A opção Restaurar recupera o backup mais recente.
  • A função "clonar" copia um site com um novo nome, opcionalmente noutra versão do PHP. Os endereços na base de dados são atualizados.
  • A opção "Atualizar " faz o backup da base de dados e, em seguida, atualiza o CMS. No WordPress, a opção "Atualizar plugins e temas" atualiza os restantes.
  • A opção "Apagar" remove o site, a sua base de dados e o seu certificado.

Serviços

Instale a partir das versões. Depois de instalados, arrancam e param com o PlugBench.

ServiçoUsoMorada
RedisPlugins de cache de objetos127.0.0.1:6379
MemcachedCache de objetos127.0.0.1:11211
PostgreSQL 17Laravel, Drupal127.0.0.1:5433
Node.jsDesenvolvimento em blocos, ferramentas de construçãono caminho do terminal
mkcertHTTPS local
MailpitCaptura e-mailslocalhost:8025
nuvem flamejanteCompartilhe online

iPhone

  • A opção "Abrir no Simulador" abre o site no Simulador do iPhone, após o login. É necessário o Simulador Xcode.
  • iPhone real: clique em Partilhar via Wi-Fie, em seguida, digitalize o código QR com a câmara do iPhone. O iPhone deve estar ligado à mesma rede Wi-Fi. Desative a partilha quando terminar.

Partilhando um site

O Share Online fornece a um website uma ligação temporária https://…trycloudflare.com através de um túnel Cloudflare gratuito. Não é necessário ter conta. Envie-o a um cliente para que este possa rever um site alojado no seu Mac.

  • Para limitar quem pode abrir o ficheiro, introduza os endereços de e-mail ou *@client.com. O Cloudflare pede aos visitantes que confirmem primeiro o seu e-mail.
  • Partilhar online e copiar link inicia a partilha e coloca o link na área de transferência. Copiar convite copia uma mensagem pronta a enviar com o link.
  • Clicar em "Parar partilha online" no site, "Parar tudo" na barra de partilha ou " Parar toda a partilha" na barra de menu termina a partilha imediatamente. O link deixa de funcionar.

As páginas, imagens e links de login do WordPress seguem o endereço utilizado pelo visitante.

Ferramentas de IA (MCP)

O PlugBench utiliza o Protocolo de Contexto de Modelo (Model Context Protocol), permitindo que o Claude Code, o Claude Desktop, o Cursor e outras ferramentas de IA o controlem. Ligue o Claude Code com um único comando:

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

Depois, pergunte, por exemplo: Crie uma loja WooCommerce, ligue ~/Code/my-plugin, ative o modo de depuração, faça um pedido e diga-me se aparece algum aviso PHP.

As 26 ferramentas:

listar_sitesinformação_do_siteestadoiniciar_serviçoscriar_siteclonar_site listar_versõesdefinir_phpdefinir_configurações_phpdefinir_xdebugmover_base_de_dados listar_pluginslink_plugindesvincular_plugin ativar_plugindefinir_debug ler_logslimpar_logsexecutar_phpler_e-mail backup_do_siterestaurar_sitelogin_urlcaptura_de_ecrã_do_iphone partilhar_onlinepartilhar_na_rede

O run_php executa código dentro do WordPress, com a sessão iniciada como administrador. O iphone_screenshot permite que a IA visualize o site num iPhone.

Linha de comando

Tudo na aplicação também funciona pelo Terminal. Adicione a ferramenta ao seu PATH:

ln -s /Applications/PlugBench.app/Contents/MacOS/plugbench /opt/homebrew/bin/plugbench
Serviços
plugbench iniciar | parar | statusServiços de controlo
médico de bancadaMostrar ferramentas detetadas
versões plugbenchListe PHP, servidores de base de dados e serviços
plugbench adicionar<formula>Instale um, como o php@7.4 ou o mysql@8.0.
extensão plugbench<php><name>Compile o xdebug, redis, imagick ou memcached
Sites
lista de plugbenchListar sites
instalação do plugbench<cms><name> [fonte]Criar um site. Opções: --sample, --version, --sql, --database, --php, --multisite
informações do plugbench<slug>Detalhes e logins em formato JSON
login do plugbench<slug> [admin|frontal]Imprima um link de login único
excluir plugbench<slug>Apagar um site
plugbench renomear-endereço<slug>Mover um site antigo para slug.localhost
PHP e servidor
plugbench php<slug><version>Alterar versão do PHP
plugbench php-setting<slug><name><value>limite_da_memória, tamanho_máximo_do_ficheiro_para_upload, tempo_máximo_de_execução
plugbench xdebug<slug> ligado|desligadoXdebug na porta 9003
plugbench move-db<slug><formula>Mova a base de dados ou use o padrão.
plugbench https<slug> ligado|desligadoHTTPS local
terminal de tomada<slug>Terminal com o PHP e o WP-CLI do site
Plugins e depuração
link do plugbench<slug><folder>Vincular e ativar um plugin
plugbench unlink<slug><folder>Remover um plugin ligado
Pluginbench<slug>Listar plugins como JSON
depuração do plugbench<slug> ligado|desligadoRegisto WP_DEBUG
registos do plugbench<slug> [linhas]Exibir registos
plugbench logs-clear<slug>Registos vazios
plugbench run<slug><file.php|->Executar PHP dentro de um site
correio do plugbenchLista de e-mails capturados
Cópias de segurança e atualizações
Backup do Plugbench | Restaurar<slug>Fazer cópias de segurança ou restaurar
clone do plugbench<slug><name> [php]Copiar um site
versão plugbench<slug>Versão mais recente do CMS instalada
atualização do plugbench<slug>Atualize o CMS
plugbench update-extensions<slug>Atualize os plugins e os temas
Ferramentas e partilha
plugbench phpmyadmin [slug]Endereço do phpMyAdmin
administrador do plugbenchEndereço do administrador
Partilhar plugbench ligado|desligadoPartilha de Wi-Fi
plugbench share-online<slug> [emails|parar]Link público
plugbench iphone<slug> [percurso]Simulador e captura de ecrã
receitas de plugbenchLista de receitas
Licença Plugbench [ativar]<key> | desativar]Licença
plugbench mcpExecute o servidor MCP

Receitas: adicione o seu próprio CMS

Uma receita é um pequeno ficheiro JSON que indica ao PlugBench como instalar um CMS ou framework. Coloque a sua em ~/Library/Application Support/PlugBench/recipes/ e aparecerá em New Website.

{ "id": "winter", "title": "Winter CMS", "summary": "O CMS baseado em 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 principais: composer ou zip para a fonte, docroot para a pasta servida, base de dados: false para CMS de ficheiro plano, loginWithEmail e loginCommand para login com um clique. Marcadores de posição: {url}, {root}, {db_host}, {db_port}, {db_name}, {db_user}, {db_password}, {admin_user}, {admin_password}, {admin_email}.

Também pode clicar em Adicionar uma receita… em Novo site. Adicione apenas receitas em que confia: os passos das mesmas são executados como o seu utilizador.

comando `plugbench recipes` lista as receitas que o PlugBench reconhece.

Gratuito e Pro

LivreProfissional, 29 dólares (preço único)
Sites3Ilimitado
Todas as versões de CMS, PHP e base de dados, Xdebug, HTTPS, backups, phpMyAdmin, MailpitSimSim
Partilhe online e partilhe via Wi-FiSim
Ferramentas para iPhoneSim
Ferramentas de IA (MCP)Sim

Active uma chave no de licença na página principal ou com o comando `plugbench license activate KEY`. Uma chave funciona nos seus Macs; desative-a para a mover. O PlugBench verifica a chave uma vez por semana e continua a funcionar offline durante 30 dias.

Onde as coisas estão

Sites~/PlugBench/<slug>
Configurações, registos, bases de dados, backups~/Library/Application Support/PlugBench
As suas receitas…/PlugBench/receitas
Cópias de segurança…/PlugBench/backups
Registros…/PlugBench/logs
ServidoresHomebrew, /opt/homebrew

Portos

Sites8801 e superior; HTTPS na mesma porta + 1000
phpMyAdmin8799
Administrador8800
Mailpit8025 (web), 1025 (SMTP)
MariaDB, padrão3307
Outros servidores de base de dados3308 e superiores
Redis, Memcached, PostgreSQL6379, 11211, 5433
Xdebug9003 (o seu editor está a ouvir)

Tudo apenas escuta em 127.0.0.1 , exceto os sites quando a partilha Wi-Fi está ativada.

Solução de problemas

A inicialização falha ou um serviço permanece desligado

Abra os logs e leia o erro. Uma porta pode já estar a ser utilizada por outro servidor, como o MAMP ou o Valet: feche-a e clique novamente em Iniciar. O comando `plugbench doctor` lista o que o PlugBench encontrou.

A instalação foi interrompida no Terminal

Leia as últimas linhas no Terminal. Muitas vezes, o Homebrew pede a sua palavra-passe ou as ferramentas de linha de comandos do Xcode. Responda e clique novamente em Configurar PlugBench : continuará de onde parou.

O Open Admin apresenta a página de login

Os links de login duram 2 minutos e funcionam apenas uma vez. Clique novamente em "Abrir Administração". Se mesmo assim não funcionar, a password de administrador está na página do site.

O browser emite um aviso sobre HTTPS

Clique em "Confiar em HTTPS local…" em "Versões" uma vez e reinicie o browser. O Firefox precisa do pacote nss do Homebrew para confiar nele.

Uma extensão não é compilada

As extensões só podem ser adicionadas ao PHP pelo Homebrew. Leia a saída do Terminal nos Logs; instalar as ferramentas de linha de comandos mais recentes do Xcode com `xcode-select --install` geralmente resolve o problema.

O Xdebug não pára nos pontos de interrupção

Verifique se o Xdebug está ativado para o site, se o seu editor está a escutar na porta 9003 e se o pedido do browser vem do mesmo site. Os comandos no Terminal são executados com o Xdebug desativado.

O iPhone não consegue abrir o site

Ative a partilha Wi-Fi, verifique se ambos estão ligados à mesma rede Wi-Fi e permita ligações de entrada se o macOS o solicitar. As redes para convidados bloqueiam frequentemente a comunicação entre dispositivos.

Um link partilhado deixou de funcionar

As ligações do Cloudflare Quick Tunnel são temporárias e expiram quando a partilha é interrompida ou o Mac entra em modo de repouso. Partilhe novamente para obter um novo link.

Como faço para remover o PlugBench completamente?

Feche o PlugBench, remova-o da pasta Aplicações e apague as pastas ~/Library/Application Support/PlugBench e ~/PlugBench. Os pacotes Homebrew mantêm-se; remova-os com o comando `brew uninstall`, se desejar.

Dúvidas? para support@nextstarsystems.com.