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
- Open
PlugBench.dmgen sleep PlugBench naar de map Toepassingen. - Open PlugBench. De eerste keer verschijnt een welkomstvenster met een lijst van de benodigde pakketten: nginx, PHP, MariaDB en Mailpit, allemaal afkomstig van Homebrew.
- 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.
- 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.
| Keuze | Wat je krijgt |
|---|---|
| WordPress | De nieuwste versie van WordPress. Voorbeeldinhoud: geen, een blog met foto's, een WooCommerce-winkel met 17 producten, categorieën, klanten en bestellingen, of testgegevens. |
| Joomla | De nieuwste Joomla-versie, klaar om in te loggen. |
| Drupal | Drupal met Drush. Optioneel voorbeeldmagazine met artikelen en foto's. |
| Grav | Flat-file CMS, geen database. |
| Craft CMS, TYPO3, Statamic, Laravel, Symfony | Geïnstalleerd vanuit recepten met Composer. |
| Aangepaste ZIP | Elke PHP-website uit een ZIP-bestand, met een optioneel SQL-bestand om te importeren. Gebruik dit om een klantwebsite lokaal te kopiëren. |
| Leeg | Een 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
- Klik in het ontwikkelmenu op 'Pluginmap koppelen...' en kies de map waarin u aan het programmeren bent.
- 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.
- Schakel de foutopsporingsmodus om PHP-meldingen en -waarschuwingen naar het foutopsporingslogboek te schrijven, en klik op ' Logboeken bekijken' om ze te lezen.
- 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_filesizeenpost_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
- Installeer mkcert in Versies .
- Klik 'Lokale HTTPS vertrouwen...' . Terminal vraagt om je Mac-wachtwoord om een lokale certificeringsinstantie toe te voegen.
- 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_DEBUGenWP_DEBUG_LOGin 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.
| Dienst | Gebruik | Adres |
|---|---|---|
| Redis | Objectcache-plugins | 127.0.0.1:6379 |
| Memcached | Objectcache | 127.0.0.1:11211 |
| PostgreSQL 17 | Laravel, Drupal | 127.0.0.1:5433 |
| Node.js | Block-ontwikkeling, bouwtools | in het eindpad |
| mkcert | Lokale HTTPS | |
| Mailpit | Onderschept e-mails | localhost:8025 |
| cloudflared | Deel 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.
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:
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 | status | Controlediensten |
plugbench dokter | Toon gedetecteerde tools |
plugbench-versies | Lijst 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 lijst | Lijst 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|uit | Xdebug op poort 9003 |
plugbench move-db<slug><formula> | Verplaats de database of de standaardinstellingen |
plugbench https<slug> aan|uit | Lokale 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|uit | WP_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 mail | Lijst 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 beheerder | Beheerdersadres |
plugbench delen aan/uit | Wifi-deling |
plugbench share-online<slug> [emails|stop] | Openbare link |
plugbench iphone<slug> [pad] | Simulator en screenshot |
plugbench recepten | Lijst met recepten |
plugbench-licentie [activeren]<key> | deactiveren] | Licentie |
plugbench mcp | Start 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
| Vrij | Pro, $29 eenmalig | |
|---|---|---|
| Locaties | 3 | Onbeperkt |
| Alle CMS-, PHP- en databaseversies, Xdebug, HTTPS, back-ups, phpMyAdmin, Mailpit | Ja | Ja |
| Online delen en wifi-deling | Ja | |
| iPhone-tools | Ja | |
| 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 |
| Servers | Homebrew, /opt/homebrew |
Havens
| Locaties | 8801 en hoger; HTTPS op dezelfde poort + 1000 |
| phpMyAdmin | 8799 |
| Beheerder | 8800 |
| Mailpit | 8025 (web), 1025 (SMTP) |
| MariaDB, standaard | 3307 |
| Andere databaseservers | 3308 en hoger |
| Redis, Memcached, PostgreSQL | 6379, 11211, 5433 |
| Xdebug | 9003 (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.