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
- Abra o
ficheiro PlugBench. dmge arraste o PlugBench para a pasta Aplicações. - Abra o PlugBench. Na primeira vez, uma janela de boas-vindas lista o que ele precisa: nginx, PHP, MariaDB e Mailpit, todos do Homebrew.
- 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.
- 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.
| Escolha | O 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. |
| Drupal | Drupal com Drush. Exemplo opcional de revista com artigos e fotos. |
| Grav | CMS baseado em ficheiros simples, sem base de dados. |
| Craft CMS, TYPO3, Statamic, Laravel, Symfony | Instalado a partir de receitas com o Composer. |
| CEP personalizado | Qualquer 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 branco | Uma 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
- Em Desenvolvimento, clique em Ligar Pasta do Plugin… e escolha a pasta onde está a programar.
- O PlugBench integra-o no site e ativa-o. Nada é copiado: cada alteração guardada é apresentada no próximo carregamento da página.
- 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.
- 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_filesizeepost_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
- Em Versões, instale o mkcert.
- 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.
- 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_DEBUGeWP_DEBUG_LOGno 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ço | Uso | Morada |
|---|---|---|
| Redis | Plugins de cache de objetos | 127.0.0.1:6379 |
| Memcached | Cache de objetos | 127.0.0.1:11211 |
| PostgreSQL 17 | Laravel, Drupal | 127.0.0.1:5433 |
| Node.js | Desenvolvimento em blocos, ferramentas de construção | no caminho do terminal |
| mkcert | HTTPS local | |
| Mailpit | Captura e-mails | localhost:8025 |
| nuvem flamejante | Compartilhe 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.
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:
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 | status | Serviços de controlo |
médico de bancada | Mostrar ferramentas detetadas |
versões plugbench | Liste 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 plugbench | Listar 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|desligado | Xdebug na porta 9003 |
plugbench move-db<slug><formula> | Mova a base de dados ou use o padrão. |
plugbench https<slug> ligado|desligado | HTTPS 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|desligado | Registo 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 plugbench | Lista 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 plugbench | Endereço do administrador |
Partilhar plugbench ligado|desligado | Partilha de Wi-Fi |
plugbench share-online<slug> [emails|parar] | Link público |
plugbench iphone<slug> [percurso] | Simulador e captura de ecrã |
receitas de plugbench | Lista de receitas |
Licença Plugbench [ativar]<key> | desativar] | Licença |
plugbench mcp | Execute 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
| Livre | Profissional, 29 dólares (preço único) | |
|---|---|---|
| Sites | 3 | Ilimitado |
| Todas as versões de CMS, PHP e base de dados, Xdebug, HTTPS, backups, phpMyAdmin, Mailpit | Sim | Sim |
| Partilhe online e partilhe via Wi-Fi | Sim | |
| Ferramentas para iPhone | Sim | |
| 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 |
| Servidores | Homebrew, /opt/homebrew |
Portos
| Sites | 8801 e superior; HTTPS na mesma porta + 1000 |
| phpMyAdmin | 8799 |
| Administrador | 8800 |
| Mailpit | 8025 (web), 1025 (SMTP) |
| MariaDB, padrão | 3307 |
| Outros servidores de base de dados | 3308 e superiores |
| Redis, Memcached, PostgreSQL | 6379, 11211, 5433 |
| Xdebug | 9003 (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.