PlugBench-help

PlugBench is een lokale webserver voor je Mac, gemaakt om plugins en thema's te bouwen en te testen. Deze pagina beschrijft alle mogelijkheden.

Aan de slag

  1. Open PlugBench.dmg en sleep PlugBench naar de map Toepassingen.
  2. Open PlugBench. De eerste keer verschijnt een welkomstvenster met een lijst van de benodigde pakketten: nginx, PHP, MariaDB en Mailpit, allemaal afkomstig van Homebrew.
  3. Klik op PlugBench instellen. Terminal wordt geopend en installeert alles, inclusief Homebrew als dat ontbreekt. Homebrew vraagt ​​mogelijk eenmalig om je Mac-wachtwoord. PlugBench geeft aan wanneer de installatie is voltooid.
  4. Klik op Starten vervolgens op Nieuwe site.

Vereisten: macOS 14 of hoger, Apple Silicon of Intel, circa 2 GB vrije schijfruimte voor de servers.

Door het venster te sluiten blijven de websites actief. PlugBench blijft in de menubalk staan. Sluit PlugBench af om alles te stoppen.

Het raam

  • Links ziet u alle websites, inclusief het CMS en het adres. Selecteer een website om de details te bekijken .
  • Services: alleen wat momenteel actief is, zoals nginx, PHP 8.5, MariaDB, Mailpit en Redis.
  • Werkbalkknoppen: phpMyAdmin, Adminer, Mail, Sites (opent de sitesmap), Logs en Versions.
  • Deelbalk: verschijnt wanneer een site wordt gedeeld, met knoppen om de link te kopiëren of het delen te stoppen.
  • Menubalkpictogram: starten of stoppen, een website openen terwijl u bent aangemeld, delen stoppen, e-mail openen.

Elke pagina van de site bevat deze kaarten:

Koptekst
Naam, adres en een regel zoals WordPress · PHP 8.5 · MariaDB 13.0. Knoppen 'Website openen' en 'Beheer openen'.
PHP en server
PHP-versie, geheugen, uploadgrootte, tijdslimiet, Xdebug, databaseserver, HTTPS en terminal.
iPhone
Open de app in de iPhone-simulator of scan een QR-code met een echte iPhone.
Deel online
Een tijdelijke openbare https-link.
Ontwikkeling
Gekoppelde plug-ins, debugmodus, logboeken en updates.
Back-ups
Back-up maken, herstellen en klonen.
Database
Naam, gebruikersnaam, wachtwoord, poort en een knop om het te openen in phpMyAdmin.

Websites maken

Klik op Nieuwe site, kies wat u wilt installeren, geef het een naam en klik op Site maken.

KeuzeWat je krijgt
WordPressDe nieuwste versie van WordPress. Voorbeeldinhoud: geen, een blog met foto's, een WooCommerce-winkel met 17 producten, categorieën, klanten en bestellingen, of testgegevens.
JoomlaDe nieuwste Joomla-versie, klaar om in te loggen.
DrupalDrupal met Drush. Optioneel voorbeeldmagazine met artikelen en foto's.
GravFlat-file CMS, geen database.
Craft CMS, TYPO3, Statamic, Laravel, SymfonyGeïnstalleerd vanuit recepten met Composer.
Aangepaste ZIPElke PHP-website uit een ZIP-bestand, met een optioneel SQL-bestand om te importeren. Gebruik dit om een ​​klantwebsite lokaal te kopiëren.
LeegEen lege map met PHP en een database, voor je eigen code.

Opties in het venster Nieuwe site: PHP-versie, databaseserver , een specifieke CMS-release en WordPress-netwerk voor Multisite.

Elke site krijgt een eigen adres, zoals http://my-site.localhost:8801, een eigen database en een eigen beheerder. Sites zijn alleen bereikbaar vanaf je Mac, tenzij je ze deelt.

Aanmelden met één klik

Open Admin en Open Site loggen je in als beheerder. Je hoeft geen wachtwoord in te voeren. Dit werkt met WordPress, Joomla, Drupal, Craft en Statamic.

Elke klik genereert een eenmalige inloglink die 2 minuten geldig is. De gebruikersnaam en het wachtwoord van de beheerder worden ook op de pagina weergegeven, mocht u deze nodig hebben.

Een plugin testen

  1. Klik in het ontwikkelmenu op 'Pluginmap koppelen...' en kies de map waarin u aan het programmeren bent.
  2. PlugBench koppelt het aan de site en activeert het. Er wordt niets gekopieerd: elke opgeslagen actie wordt weergegeven bij het laden van de volgende pagina.
  3. Schakel de foutopsporingsmodus om PHP-meldingen en -waarschuwingen naar het foutopsporingslogboek te schrijven, en klik op ' Logboeken bekijken' om ze te lezen.
  4. te verwijderen, wordt de verbinding met de site verbroken. Je map blijft ongewijzigd.

Om een ​​plugin op verschillende PHP-versies te testen, kloon je de site naar een andere versie (zie Back-ups) of wijzig je de PHP-versie van de site.

PHP per site

Elke website heeft zijn eigen PHP-versie. Wijzig deze in de PHP- en serverinstellingen op de websitepagina. De website start binnen een seconde opnieuw op met de nieuwe versie.

Beschikbaar: PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 en 8.5. Installeer meer versies in Versies. PHP 7.4 en 8.0 worden niet meer ondersteund en zijn afkomstig van de shivammathur/php Homebrew-tap.

Instellingen per site, afgestemd op de hostingprovider van de klant:

  • Geheugen: memory_limit, bijvoorbeeld 128M of 512M.
  • Uploadgrootte: upload_max_filesize en post_max_size.
  • Tijdslimiet: max_execution_time, in seconden.

Elke instelling is alleen van toepassing op de betreffende site.

Xdebug- en PHP-extensies

In 'Versies'worden voor elke geïnstalleerde PHP-versie de bijbehorende extensies weergegeven. Klik op een extensie om deze voor die PHP-versie te compileren (dit duurt ongeveer een minuut):

  • Xdebug: stapsgewijze debuggen.
  • Redis: phpredis, voor objectcache-plugins.
  • Imagick: Beeldbewerking met ImageMagick.
  • Memcached: voor Memcached-objectcache.

Schakel vervolgens Xdebug op een site. Xdebug blijft uitgeschakeld voor elke PHP-versie die niet door een site nodig is, dus het kost niets.

VS Code: installeer de PHP Debug-extensie, klik op 'VS Code Setup kopiëren', plak deze in .vscode/launch.jsonen start de extensie 'Luisteren naar Xdebug'. PlugBench gebruikt poort 9003. PhpStorm luistert standaard ook op poort 9003 en werkt op dezelfde manier.

Databases

De standaardserver is MariaDB, op poort 3307, waardoor deze nooit een MySQL-server tegenkomt die al op poort 3306 draait. Installeer meer servers in Versies:

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

Elke server draait op een eigen poort. Kies er een wanneer u een site aanmaakt, of verplaats een bestaande site via het Databaseserver' : PlugBench maakt een kopie van de database, importeert deze op de andere server en werkt de configuratie van de site bij.

phpMyAdmin en Adminer openen al ingelogd en tonen alle servers. De databasekaart op een site opent direct de bijbehorende database. Beide programma's werken alleen op je Mac.

PostgreSQL 17 is beschikbaar als service op poort 5433, gebruiker postgres, met hetzelfde wachtwoord als de root-gebruiker van MySQL.

Lokale HTTPS

  1. Installeer mkcert in Versies .
  2. Klik 'Lokale HTTPS vertrouwen...' . Terminal vraagt ​​om je Mac-wachtwoord om een ​​lokale certificeringsinstantie toe te voegen.
  3. Schakel HTTPS voor een website. Deze wordt dan aangeboden op poort + 1000, bijvoorbeeld https://my-site.localhost:9801.

Op WordPress werkt PlugBench de IP-adressen van de site in de database bij, inclusief Multisite. Door HTTPS uit te schakelen worden deze adressen teruggezet naar de oorspronkelijke instellingen.

WordPress Multisite

Schakel het WordPress-netwerk bij het aanmaken van een nieuwe site. Je krijgt dan een netwerk met sites in submappen, zoals /shop/. Voeg sites toe via Mijn sites, Netwerkbeheer, Sites. Klones, HTTPS en delen zorgen ervoor dat het netwerk blijft werken.

Terminal en WP-CLI

Open Terminal op een site opent een shell in de map van die site, waarbij de PHP-versie van de site als eerste in het pad staat en WordPress klaar is. PHP, Composer en WordPress gebruiken allemaal de PHP-versie van die site. Je eigen shell-instellingen worden ook geladen.

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

E-mail, logboeken en foutopsporing

  • Mail opent Mailpit. Elke e-mail die een website verstuurt, komt daar terecht: wachtwoordherstelverzoeken, WooCommerce-bestellingen, contactformulieren. Niets verlaat je Mac.
  • De debugmodus schakelt WP_DEBUG en WP_DEBUG_LOG in op WordPress.
  • Logs toont het debuglogboek, het PHP-foutlogboek en Nginx-fouten. Clear wist deze logboeken vóór een test.

Back-ups, klonen en updates

  • Met 'Back-up nu' worden de bestanden en de database opgeslagen. 'Herstellen' wordt de meest recente back-up teruggezet.
  • Met Clone wordt een site onder een nieuwe naam gekopieerd, eventueel met een andere PHP-versie. De adressen in de database worden bijgewerkt.
  • Update maakt een back-up van de database en werkt vervolgens het CMS bij. Op WordPress zorgt Update Plugins and Themes ervoor dat de rest wordt bijgewerkt.
  • Met 'Verwijderen' worden de site, de database en het certificaat verwijderd.

Diensten

Installeer ze via Versions. Na de installatie starten en stoppen ze met PlugBench.

DienstGebruikAdres
RedisObjectcache-plugins127.0.0.1:6379
MemcachedObjectcache127.0.0.1:11211
PostgreSQL 17Laravel, Drupal127.0.0.1:5433
Node.jsBlock-ontwikkeling, bouwtoolsin het eindpad
mkcertLokale HTTPS
MailpitOnderschept e-mailslocalhost:8025
cloudflaredDeel online

iPhone

  • 'Openen in simulator' opent de website in de iPhone-simulator, nadat je bent ingelogd. Hiervoor is de simulator van Xcode nodig.
  • Echte iPhone: klik op 'Delen via wifi'en scan vervolgens de QR-code met de camera van de iPhone. De iPhone moet op hetzelfde wifi-netwerk verbonden zijn. Schakel het delen uit als je klaar bent.

Een site delen

Share Online geeft een website een tijdelijke https://…trycloudflare.com-link via een gratis Cloudflare-tunnel. Geen account nodig. Stuur het naar een klant om een ​​website te bekijken die op je Mac draait.

  • Om te beperken wie het kan openen, voer je e-mailadressen of *@client.com. Cloudflare vraagt ​​bezoekers eerst hun e-mailadres te bevestigen.
  • Met 'Online delen' en 'Link kopiëren' start u het delen en plaatst u de link in het klembord. 'Uitnodiging kopiëren ' kopieert een kant-en-klaar bericht met de link.
  • De optie ' Alles delen stoppen' in de deelbalk of ' Alles delen stoppen' in de menubalk beëindigt het delen direct. De link werkt dan niet meer.

WordPress-pagina's, afbeeldingen en inloglinks volgen het adres dat de bezoeker gebruikt.

AI-tools (MCP)

PlugBench ondersteunt het Model Context Protocol, waardoor Claude Code, Claude Desktop, Cursor en andere AI-tools ermee kunnen communiceren. Verbind Claude Code met één commando:

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

Vraag dan bijvoorbeeld: Maak een WooCommerce-winkel aan, koppel ~/Code/my-plugin, schakel de debugmodus in, plaats een bestelling en laat me weten of er PHP-waarschuwingen verschijnen.

De 26 gereedschappen:

list_sitessite_infostatusstart_servicescreate_siteclone_site list_versionsset_phpset_php_settingset_xdebugmove_database list_pluginslink_pluginunlink_pluginset_plugin_active set_debugread_logsclear_logsrun_phpread_mail backup_siterestore_sitelogin_urliphone_screenshot share_onlineshare_on_network

run_php voert code uit binnen WordPress, ingelogd als beheerder. iphone_screenshot laat de AI de site bekijken op een iPhone.

Opdrachtregel

Alles in de app werkt ook vanuit de Terminal. Voeg de tool toe aan je PATH:

ln -s /Applications/PlugBench.app/Contents/MacOS/plugbench /opt/homebrew/bin/plugbench
Diensten
plugbench starten | stoppen | statusControlediensten
plugbench dokterToon gedetecteerde tools
plugbench-versiesLijst met PHP-, database- en serviceservers
plugbench toevoegen<formula>Installeer er een, zoals php@7.4 of mysql@8.0.
plugbench-uitbreiding<php><name>Compileer xdebug, redis, imagick of memcached
Locaties
plugbench lijstLijst met sites
plugbench installatie<cms><name> [bron]Maak een site aan. Opties: --sample, --version, --sql, --database, --php, --multisite
plugbench-info<slug>Gegevens en inloggegevens als JSON
plugbench-login<slug> [admin|front]Print een eenmalige inloglink
plugbench verwijderen<slug>Een site verwijderen
plugbench hernoemen-adres<slug>Verplaats een oudere site naar slug.localhost
PHP en server
plugbench php<slug><version>PHP-versie wijzigen
plugbench php-setting<slug><name><value>geheugenlimiet, maximale bestandsgrootte voor uploads, maximale uitvoeringstijd
plugbench xdebug<slug> aan|uitXdebug op poort 9003
plugbench move-db<slug><formula>Verplaats de database of de standaardinstellingen
plugbench https<slug> aan|uitLokale HTTPS
stekkerbank terminal<slug>Terminal met de PHP- en WP-CLI-installatie van de site
Plugins en debuggen
plugbench link<slug><folder>Een plugin koppelen en activeren
plugbench ontkoppelen<slug><folder>Een gekoppelde plugin verwijderen
plugbench-plugins<slug>Lijst plugins als JSON
plugbench debug<slug> aan|uitWP_DEBUG-logboekregistratie
plugbench-logs<slug> [regels]Toon logboeken
plugbench logs-clear<slug>Lege logboeken
plugbench run<slug><file.php|->PHP uitvoeren binnen een website
plugbench mailLijst met onderschepte e-mails
Back-ups en updates
plugbench back-up | herstellen<slug>Back-up maken of herstellen
plugbench-kloon<slug><name> [php]Een site kopiëren
plugbench-versie<slug>Geïnstalleerde en meest recente CMS-versie
plugbench-update<slug>Update het CMS
plugbench update-extensies<slug>Plugins en thema's bijwerken
Hulpmiddelen en delen
plugbench phpmyadmin [slug]phpMyAdmin-adres
plugbench beheerderBeheerdersadres
plugbench delen aan/uitWifi-deling
plugbench share-online<slug> [emails|stop]Openbare link
plugbench iphone<slug> [pad]Simulator en screenshot
plugbench receptenLijst met recepten
plugbench-licentie [activeren]<key> | deactiveren]Licentie
plugbench mcpStart de MCP-server

Recepten: voeg je eigen CMS toe

Een recept is een klein JSON-bestand dat PlugBench vertelt hoe een CMS of framework geïnstalleerd moet worden. Plaats jouw recept in ~/Library/Application Support/PlugBench/recipes/ en het verschijnt in Nieuwe Site.

{ "id": "winter", "title": "Winter CMS", "summary": "Het op Laravel gebaseerde CMS.", "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"] ] }

Belangrijkste velden: composer of zip voor de bron, docroot voor de map waarin de applicatie wordt aangeboden, database: false voor een flat-file CMS, loginWithEmail en loginCommand voor aanmelden met één klik. Plaatsaanduidingen: {url}, {root}, {db_host}, {db_port}, {db_name}, {db_user}, {db_password}, {admin_user}, {admin_password}, {admin_email}.

Je kunt ook op 'Recept toevoegen… in 'Nieuwe site'. Voeg alleen recepten toe die je vertrouwt: de stappen ervan worden uitgevoerd alsof ze door jou worden gebruikt.

PlugBench Recipes geeft een overzicht van de recepten die PlugBench herkent.

Gratis en Pro

VrijPro, $29 eenmalig
Locaties3Onbeperkt
Alle CMS-, PHP- en databaseversies, Xdebug, HTTPS, back-ups, phpMyAdmin, MailpitJaJa
Online delen en wifi-delingJa
iPhone-toolsJa
AI-tools (MCP)Ja

Activeer een licentiesleutel op de hoofdpagina via de licentiekaart, of activeer de sleutel met PlugBench License . Een licentiesleutel werkt op al je Macs; deactiveer er een om deze te verplaatsen. PlugBench controleert de licentiesleutel wekelijks en blijft 30 dagen offline werken.

Waar dingen zijn

Locaties~/PlugBench/<slug>
Instellingen, logboeken, databases, back-ups~/Bibliotheek/Applicatieondersteuning/PlugBench
Jouw recepten…/PlugBench/recepten
Back-ups…/PlugBench/backups
Logboeken…/PlugBench/logs
ServersHomebrew, /opt/homebrew

Havens

Locaties8801 en hoger; HTTPS op dezelfde poort + 1000
phpMyAdmin8799
Beheerder8800
Mailpit8025 (web), 1025 (SMTP)
MariaDB, standaard3307
Andere databaseservers3308 en hoger
Redis, Memcached, PostgreSQL6379, 11211, 5433
Xdebug9003 (uw redacteur luistert)

Alles luistert alleen naar 127.0.0.1 , behalve sites wanneer wifi-deling is ingeschakeld.

Probleemoplossing

Het opstarten mislukt of een service blijft uitgeschakeld

Open de logbestanden en lees de foutmelding. Een poort is mogelijk al in gebruik door een andere server, zoals MAMP of Valet: sluit deze af en klik opnieuw op Start. plugbench doctor geeft een overzicht van wat PlugBench heeft gevonden.

Installatie is gestopt in Terminal

Lees de laatste regels in Terminal. Vaak vraagt ​​Homebrew om je wachtwoord of om de Xcode-opdrachtregeltools. Geef antwoord en klik vervolgens op PlugBench instellen : het proces gaat verder waar het was gebleven.

Open Admin toont de aanmeldpagina

De inloglinks zijn 2 minuten geldig en werken slechts één keer. Klik nogmaals op 'Beheer openen'. Als het nog steeds niet lukt, staat het beheerderswachtwoord op de websitepagina.

De browser waarschuwt voor HTTPS

Klik 'Lokale HTTPS vertrouwen…' in de versie-instellingen en herstart vervolgens de browser. Firefox heeft nss van Homebrew nodig om deze verbinding te vertrouwen.

Een extensie wordt niet gebouwd

Extensies kunnen alleen via Homebrew aan PHP worden toegevoegd. Lees de terminaluitvoer in de logbestanden; het installeren van de nieuwste Xcode-commandoregeltools met `xcode-select --install` lost het probleem vaak op.

Xdebug stopt niet bij breakpoints

Controleer of Xdebug is ingeschakeld voor de site, of je editor luistert op poort 9003 en of het browserverzoek van dezelfde site afkomstig is. Commando's in Terminal worden uitgevoerd wanneer Xdebug is uitgeschakeld.

De iPhone kan de site niet openen

Schakel wifi-deling in, controleer of beide apparaten op hetzelfde wifi-netwerk zijn aangesloten en sta inkomende verbindingen toe als macOS daarom vraagt. Gastnetwerken blokkeren vaak de verbinding tussen apparaten.

Een gedeelde link werkt niet meer

Cloudflare Quick Tunnel-links zijn tijdelijk en verlopen zodra het delen stopt of de Mac in de slaapstand gaat. Deel opnieuw voor een nieuwe link.

Hoe verwijder ik PlugBench volledig?

Sluit PlugBench af, verwijder het uit de map Programma's en verwijder de mappen ~/Library/Application Support/PlugBench en ~/PlugBench . Homebrew-pakketten blijven behouden; verwijder deze desgewenst met brew uninstall

Vragen? Neem contact op met support@nextstarsystems.com.