PlugBench-Hilfe

PlugBench ist ein lokaler Webserver für Ihren Mac, der zum Erstellen und Testen von Plugins und Themes entwickelt wurde. Diese Seite beschreibt alle Funktionen.

Erste Schritte

  1. Öffnen Sie PlugBench.dmg und ziehen Sie PlugBench in den Ordner „Programme“.
  2. Öffnen Sie PlugBench. Beim ersten Start erscheint ein Begrüßungsfenster mit einer Liste der benötigten Pakete: nginx, PHP, MariaDB und Mailpit, alle von Homebrew.
  3. Klicken Sie auf „PlugBench einrichten“. Das Terminal öffnet sich und installiert alle benötigten Programme, inklusive Homebrew, falls es fehlt. Homebrew fragt Sie möglicherweise einmal nach Ihrem Mac-Passwort. PlugBench meldet, sobald die Einrichtung abgeschlossen ist.
  4. Klicken Sie auf Startund dann auf Neue Website.

Systemvoraussetzungen: macOS 14 oder neuer, Apple Silicon oder Intel, ca. 2 GB freier Speicherplatz für die Server.

Wenn Sie das Fenster schließen, bleiben die Websites aktiv. PlugBench bleibt in der Menüleiste. Beenden Sie PlugBench, um alle Prozesse zu stoppen.

Das Fenster

  • die Websites: Alle Websites mit ihrem CMS und ihrer Adresse. Wählen Sie eine aus, um deren Details anzuzeigen.
  • Dienste: nur die, die aktuell laufen, wie z. B. nginx, PHP 8.5, MariaDB, Mailpit und Redis.
  • Symbolleistenschaltflächen: phpMyAdmin, Adminer, Mail, Sites (öffnet den Ordner „Sites“), Logs und Versions.
  • Teilen-Leiste: Wird angezeigt, wenn eine Website geteilt wird, mit Schaltflächen zum Kopieren des Links oder zum Beenden der Freigabe.
  • Menüleistensymbol: Starten oder Stoppen, beliebige Website im angemeldeten Zustand öffnen, Freigabe beenden, E-Mail öffnen.

Auf jeder Seite der Website sind diese Karten enthalten:

Kopfzeile
Name, Adresse und eine Zeile wie WordPress · PHP 8.5 · MariaDB 13.0. Schaltflächen „Website öffnen“ und „Admin öffnen“.
PHP und Server
PHP-Version, Arbeitsspeicher, Uploadgröße, Zeitlimit, Xdebug, Datenbankserver, HTTPS und Terminal.
iPhone
Im iPhone-Simulator öffnen oder einen QR-Code mit einem echten iPhone scannen.
Online teilen
Ein temporärer öffentlicher HTTPS-Link.
Entwicklung
Verknüpfte Plugins, Debug-Modus, Protokolle und Updates.
Backups
Sichern, wiederherstellen und klonen.
Datenbank
Name, Benutzername, Passwort, Port und eine Schaltfläche zum Öffnen in phpMyAdmin.

Websites erstellen

Klicken Sie auf „Neue Website“, wählen Sie die zu installierenden Elemente aus, geben Sie der Website einen Namen und klicken Sie auf „Website erstellen“.

AuswahlWas Sie erhalten
WordPressAktuellste WordPress-Version. Beispielinhalte: keine, ein Blog mit Fotos, ein WooCommerce-Shop mit 17 Produkten, Kategorien, Kunden und Bestellungen oder Testdaten.
JoomlaDie neueste Joomla-Version ist bereit zur Anmeldung.
DrupalDrupal mit Drush. Optionale Magazin-Beispieldatei mit Artikeln und Fotos.
GravFlat-File-CMS, keine Datenbank.
Craft CMS, TYPO3, Statamic, Laravel, SymfonyInstalliert anhand von Rezepten mit Composer.
Benutzerdefinierte ZIP-DateiJede PHP-Website aus einem ZIP-Archiv, optional mit einer SQL-Datei zum Importieren. Verwenden Sie es, um eine Kundenwebsite lokal zu kopieren.
LeerEin leerer Ordner mit PHP und einer Datenbank für Ihren eigenen Code.

Optionen im Fenster „Neue Website“: PHP-Version, Datenbankserver , eine bestimmte CMS-Version und WordPress-Netzwerk für Multisite.

Jede Website erhält eine eigene Adresse, z. B. http://my-site.localhost:8801, eine eigene Datenbank und einen eigenen Administrator. Websites sind nur von Ihrem Mac aus erreichbar, es sei denn, Sie geben sie frei.

Anmeldung mit einem Klick

Mit Open Admin und Open Site werden Sie als Administrator angemeldet. Kein Passwort erforderlich. Dies funktioniert mit WordPress, Joomla, Drupal, Craft und Statamic.

Mit jedem Klick wird ein einmalig verwendbarer Anmeldelink erstellt, der 2 Minuten gültig ist. Administratorname und Passwort werden bei Bedarf ebenfalls auf der Webseite angezeigt.

Testen eines Plugins

  1. Klicken Sie im Entwicklungsmodus auf „Plugin-Ordner verknüpfen…“ und wählen Sie den Ordner aus, in dem Sie programmieren.
  2. PlugBench bindet es in die Website ein und aktiviert es. Es werden keine Kopien angefertigt: Jeder Speicherstand wird beim nächsten Seitenaufruf angezeigt.
  3. Aktivieren Sie den Debug-Modus , um PHP-Hinweise und -Warnungen in das Debug-Protokoll zu schreiben, und klicken Sie auf „Protokolle anzeigen“ , um sie zu lesen.
  4. Durch das Entfernen der Verknüpfung wird die Datei von der Website getrennt. Ihr Ordner bleibt dabei unberührt.

Um ein Plugin auf verschiedenen PHP-Versionen zu testen, klonen Sie die Website auf eine andere Version (siehe Backups) oder ändern Sie die PHP-Version der Website.

PHP pro Website

Jede Website verwendet ihre eigene PHP-Version. Ändern Sie diese auf „PHP und Server“ . Die Website startet innerhalb einer Sekunde mit der neuen Version neu.

Verfügbar: PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 und 8.5. Weitere Versionen finden Sie unter „ Versionen“ . PHP 7.4 und 8.0 werden nicht mehr unterstützt und stammen aus dem Homebrew-Repository shivammathur/php

Standortspezifische Einstellungen, die dem Host des Kunden entsprechen:

  • Speicher: memory_limit, z. B. 128M oder 512M.
  • Uploadgröße: upload_max_filesize und post_max_size.
  • Zeitlimit: max_execution_time, in Sekunden.

Jede Einstellung gilt nur für ihren jeweiligen Standort.

Xdebug- und PHP-Erweiterungen

Unter „Versionen“werden die Erweiterungen jeder installierten PHP-Version angezeigt. Klicken Sie auf eine Erweiterung, um sie für diese PHP-Version zu erstellen (ca. eine Minute):

  • Xdebug: Schrittweises Debuggen.
  • Redis: phpredis, für Objekt-Cache-Plugins.
  • Imagick: ImageMagick-Bildbearbeitung.
  • Memcached: für den Memcached-Objektcache.

Aktivieren Sie anschließend Xdebug auf der Website. Xdebug bleibt für jede PHP-Version deaktiviert, da keine Website es benötigt und es daher keine Kosten verursacht.

VS Code: Installieren Sie die PHP-Debug-Erweiterung, klicken Sie auf „VS Code-Setup kopieren“, fügen Sie es in die Datei „.vscode/launch.json“und starten Sie „Auf Xdebug lauschen“. PlugBench verwendet Port 9003. PhpStorm lauscht standardmäßig auf Port 9003 und funktioniert auf die gleiche Weise.

Datenbanken

Der Standardserver ist MariaDB auf Port 3307, sodass keine Konflikte mit einer bereits auf Port 3306 laufenden MySQL-Datenbank auftreten. Weitere Server können unter „Versionen“.

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

Jeder Server läuft auf einem eigenen Port. Wählen Sie einen Port aus, wenn Sie eine Site erstellen oder eine bestehende Site über das „Datenbankserver“ : PlugBench sichert die Datenbank, importiert sie auf den anderen Server und aktualisiert die Site-Konfiguration.

phpMyAdmin und Adminer öffnen sich automatisch mit angemeldetem Benutzer und listen alle Server auf. Die Datenbank-Karte einer Website öffnet direkt die zugehörige Datenbank. Beide Tools funktionieren nur auf Ihrem Mac.

PostgreSQL 17 ist als Dienst auf Port 5433 unter dem Benutzer postgresmit dem gleichen Passwort wie der MySQL-Root-Benutzer verfügbar.

Lokales HTTPS

  1. Unter Versioneninstallieren Sie mkcert.
  2. Klicken Sie „Lokales HTTPS vertrauen…“ . Das Terminal fragt nach Ihrem Mac-Passwort, um eine lokale Zertifizierungsstelle hinzuzufügen.
  3. Aktivieren Sie HTTPS auf einer Website. Sie wird über ihren Port + 1000 bereitgestellt, z. B. https://my-site.localhost:9801.

Bei WordPress aktualisiert PlugBench die Adressen der Website in der Datenbank, einschließlich Multisite. Durch Deaktivieren von HTTPS werden diese Änderungen rückgängig gemacht.

WordPress Multisite

Aktivieren Sie das WordPress-Netzwerk in der neuen Website. Sie erhalten ein Netzwerk mit Websites in Unterverzeichnissen, z. B. /shop/. Weitere Websites finden Sie unter „Meine Websites“, „Netzwerkverwaltung“, „Websites“. Klone, HTTPS und Freigaben gewährleisten die Funktionsfähigkeit des Netzwerks.

Terminal und WP-CLI

Das Öffnen des Terminals einer Website öffnet eine Shell im zugehörigen Verzeichnis. Die PHP-Version der Website steht dabei an erster Stelle im Pfad, und wp ist bereit. php, composer und wp verwenden alle die PHP-Version dieser Website. Ihre eigenen Shell-Einstellungen werden ebenfalls geladen.

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

E-Mails, Protokolle und Debugging

  • Mail öffnet Mailpit. Jede E-Mail, die eine Website sendet, landet dort: Passwortzurücksetzungen, WooCommerce-Bestellungen, Kontaktformulare. Nichts verlässt Ihren Mac.
  • Der Debug-Modus aktiviert WP_DEBUG und WP_DEBUG_LOG in WordPress.
  • Die Logs-Datei zeigt das Debug-Log, das PHP-Fehlerprotokoll und nginx-Fehler an. Mit dem Befehl „Clear“ werden diese vor einem Test geleert.

Backups, Klone und Updates

  • Mit „Jetzt sichern“ werden die Dateien und die Datenbank gespeichert. Mit „Wiederherstellen“ wird die letzte Sicherung wiederhergestellt.
  • Beim Klonen wird eine Website unter einem neuen Namen kopiert, optional auch mit einer anderen PHP-Version. Die Adressen in der Datenbank werden aktualisiert.
  • Das Update sichert die Datenbank und aktualisiert anschließend das CMS. Bei WordPress aktualisiert „Plugins und Themes aktualisieren“ alle übrigen Komponenten.
  • Beim Löschen werden die Website, ihre Datenbank und ihr Zertifikat entfernt.

Dienstleistungen

Installieren Sie die Software aus den Versionen. Nach der Installation starten und stoppen sie mit PlugBench.

ServiceVerwendenAdresse
RedisObjektcache-Plugins127.0.0.1:6379
MemcachedObjektcache127.0.0.1:11211
PostgreSQL 17Laravel, Drupal127.0.0.1:5433
Node.jsBlockentwicklung, Build-Toolsim Terminalpfad
mkcertLokales HTTPS
MailpitFängt E-Mails ablocalhost:8025
WolkenflareOnline teilen

iPhone

  • „Im Simulator öffnen“ öffnet die Website im iPhone-Simulator, in dem Sie angemeldet sind. Dazu wird der Simulator von Xcode benötigt.
  • Auf einem echten iPhone: Tippen Sie auf „Über WLAN teilen“und scannen Sie anschließend den QR-Code mit der iPhone-Kamera. Das iPhone muss sich im selben WLAN-Netzwerk befinden. Deaktivieren Sie die WLAN-Freigabe, wenn Sie fertig sind.

Teilen einer Website

Share Online stellt Ihrer Website einen temporären https://…trycloudflare.com-Link über einen kostenlosen Cloudflare-Tunnel zur Verfügung. Sie benötigen kein Konto. Senden Sie den Link an einen Kunden, damit dieser die auf Ihrem Mac laufende Website überprüfen kann.

  • Um den Zugriff einzuschränken, geben Sie E-Mail-Adressen oder *@client.com. Cloudflare fordert Besucher auf, ihre E-Mail-Adresse zuerst zu bestätigen.
  • „Online teilen“ und „Link kopieren“ startet die Freigabe und fügt den Link in die Zwischenablage ein. „Einladung kopieren“ kopiert eine versandfertige Nachricht inklusive Link.
  • „Online-Freigabe beenden“ auf der Website, „Alle Freigaben beenden“ in der Freigabeleiste oder „ Alle Freigaben beenden“ in der Menüleiste beenden die Freigabe sofort. Der Link funktioniert dann nicht mehr.

WordPress-Seiten, Bilder und Anmeldelinks folgen der Adresse, die der Besucher verwendet.

KI-Tools (MCP)

PlugBench unterstützt das Model Context Protocol, sodass es von Claude Code, Claude Desktop, Cursor und anderen KI-Tools gesteuert werden kann. Verbinden Sie Claude Code mit einem einzigen Befehl:

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

Dann fragen Sie beispielsweise: Erstellen Sie einen WooCommerce-Shop, verknüpfen Sie ~/Code/my-plugin, aktivieren Sie den Debug-Modus, geben Sie eine Bestellung auf und teilen Sie mir mit, ob PHP-Warnungen auftreten.

Die 26 Werkzeuge:

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 führt Code innerhalb von WordPress aus, wobei das Programm als Administrator angemeldet ist. iphone_screenshot ermöglicht es der KI, die Website auf einem iPhone zu betrachten.

Befehlszeile

Alle Funktionen der App funktionieren auch über das Terminal. Fügen Sie das Tool Ihrem Pfad hinzu:

ln -s /Applications/PlugBench.app/Contents/MacOS/plugbench /opt/homebrew/bin/plugbench
Dienstleistungen
Plugbench Start | Stopp | StatusSteuerungsdienste
Plugbench-DoktorErkannte Werkzeuge anzeigen
Plugbench-VersionenListe PHP, Datenbankserver und Dienste
Plugbench hinzufügen<formula>Installieren Sie eine, z. B. php@7.4 oder mysql@8.0.
Plugbench-Erweiterung<php><name>xdebug, redis, imagick oder memcached erstellen
Websites
Plugbench-ListeListenseiten
Plugbench-Installation<cms><name> [Quelle]Website erstellen. Optionen: --sample, --version, --sql, --database, --php, --multisite
Plugbench-Informationen<slug>Details und Anmeldedaten als JSON
Plugbench-Anmeldung<slug> [admin|front]Einmaligen Anmeldelink ausdrucken
Plugbench löschen<slug>Eine Website löschen
Plugbench-Umbenennungsadresse<slug>Verschieben Sie eine ältere Website nach slug.localhost.
PHP und Server
plugbench php<slug><version>PHP-Version ändern
plugbench php-setting<slug><name><value>Speicherlimit, maximale Upload-Dateigröße, maximale Ausführungszeit
Plugbench xdebug<slug> Ein|AusXdebug auf Port 9003
Plugbench Move-DB<slug><formula>Verschieben Sie die Datenbank oder den Standardwert.
Plugbench https<slug> Ein|AusLokales HTTPS
Plugbench-Anschluss<slug>Terminal mit der PHP- und WP-CLI-Schnittstelle der Website
Plugins und Debugging
Plugbench-Link<slug><folder>Verknüpfen und aktivieren Sie ein Plugin
Plugbench unlink<slug><folder>Ein verknüpftes Plugin entfernen
Plugbench-Plugins<slug>Plugins als JSON auflisten
Plugbench-Debugging<slug> Ein|AusWP_DEBUG-Protokollierung
Plugbench-Protokolle<slug> [Zeilen]Protokolle anzeigen
Plugbench-Logs-Clear<slug>Leere Protokolle
Plugbench-Lauf<slug><file.php|->PHP innerhalb einer Website ausführen
Plugbench-MailListe der abgefangenen E-Mails
Backups und Updates
Plugbench-Backup | Wiederherstellung<slug>Sichern oder Wiederherstellen
Plugbench-Klon<slug><name> [php]Website kopieren
Plugbench-Version<slug>Installierte und neueste CMS-Version
Plugbench-Update<slug>Aktualisieren Sie das CMS
Plugbench Update-Erweiterungen<slug>Plugins und Themes aktualisieren
Tools und Austausch
plugbench phpmyadmin [slug]phpMyAdmin-Adresse
Plugbench AdminerAdresse von Adminer
Plugbench-Freigabe ein|ausWLAN-Freigabe
Plugbench Share-Online<slug> [E-Mails|Stopp]Öffentlicher Link
Plugbench iPhone<slug> [Weg]Simulator und Screenshot
Plugbench-RezepteRezepte auflisten
Plugbench-Lizenz [aktivieren<key> | deaktivieren]Lizenz
Plugbench MCPStarten Sie den MCP-Server

Rezepte: Fügen Sie Ihr eigenes CMS hinzu

Ein Rezept ist eine kleine JSON-Datei, die PlugBench mitteilt, wie ein CMS oder Framework installiert werden soll. Legen Sie Ihre Datei in ~/Library/Application Support/PlugBench/recipes/ ; sie wird dann unter „Neue Website“ angezeigt.

{ "id": "winter", "title": "Winter CMS", "summary": "Das Laravel-basierte 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"] ] }

Hauptfelder: composer oder zip für die Quelle, docroot für den bereitgestellten Ordner, database: false für Flatfile-CMS, loginWithEmail und loginCommand für die Ein-Klick-Anmeldung. Platzhalter: {url}, {root}, {db_host}, {db_port}, {db_name}, {db_user}, {db_password}, {admin_user}, {admin_password}, {admin_email}.

Sie können auch auf „Rezept hinzufügen…“ in „Neue Website“ klicken. Fügen Sie nur Rezepte hinzu, denen Sie vertrauen: Die einzelnen Schritte werden mit Ihren Benutzerdaten ausgeführt.

„plugbench recipes“ enthält die Rezepte, die PlugBench erkennt.

Kostenlos und Pro

FreiPro, 29 $ einmalig
Websites3Unbegrenzt
Alle CMS-, PHP- und Datenbankversionen, Xdebug, HTTPS, Backups, phpMyAdmin, MailpitJaJa
Online- und WLAN-FreigabeJa
iPhone-ToolsJa
KI-Tools (MCP)Ja

Aktivieren Sie einen Lizenzschlüssel auf der Hauptseite oder mit dem Befehl `plugbench license activate KEY`. Ein Lizenzschlüssel funktioniert auf Ihren Macs; deaktivieren Sie ihn, um ihn zu übertragen. PlugBench überprüft den Lizenzschlüssel einmal wöchentlich und funktioniert 30 Tage offline.

Wo die Dinge sind

Websites~/PlugBench/<slug>
Einstellungen, Protokolle, Datenbanken, Backups~/Library/Application Support/PlugBench
Ihre Rezepte…/PlugBench/Rezepte
Backups…/PlugBench/Backups
Protokolle…/PlugBench/logs
ServerHomebrew, /opt/homebrew

Häfen

Websites8801 und höher; HTTPS auf demselben Port + 1000
phpMyAdmin8799
Adminer8800
Mailpit8025 (Web), 1025 (SMTP)
MariaDB, Standard3307
Andere Datenbankserver3308 und höher
Redis, Memcached, PostgreSQL6379, 11211, 5433
Xdebug9003 (Ihr Redakteur hört zu)

Alle Geräte lauschen ausschließlich auf 127.0.0.1 , außer Websites, bei denen die WLAN-Freigabe aktiviert ist.

Fehlerbehebung

Der Start schlägt fehl oder ein Dienst bleibt ausgeschaltet

Öffnen Sie die Protokolle und lesen Sie die Fehlermeldung. Ein Port wird möglicherweise bereits von einem anderen Server, z. B. MAMP oder Valet, verwendet: Beenden Sie diesen und klicken Sie erneut auf „Start“. Der Befehl „plugbench doctor“ zeigt die von PlugBench gefundenen Fehler an.

Die Einrichtung wurde im Terminal abgebrochen

Lesen Sie die letzten Zeilen im Terminal. Homebrew fragt häufig nach Ihrem Passwort oder den Xcode-Befehlszeilentools. Bestätigen Sie die Fragen und klicken Sie dann „PlugBench einrichten“ . Die Einrichtung wird an der Stelle fortgesetzt, an der sie unterbrochen wurde.

Open Admin zeigt die Anmeldeseite an

Die Anmeldelinks sind 2 Minuten gültig und funktionieren nur einmal. Klicken Sie erneut auf „Admin öffnen“. Falls es weiterhin nicht funktioniert, finden Sie das Administratorpasswort auf der Webseite.

Der Browser warnt vor HTTPS

Klicken Sie auf „Lokalem HTTPS vertrauen…“ und starten Sie den Browser anschließend neu. Firefox benötigt die nss-Datei von Homebrew, um dem HTTPS-Server zu vertrauen.

Eine Erweiterung wird nicht erstellt

Erweiterungen können PHP nur über Homebrew hinzugefügt werden. Lesen Sie die Terminalausgabe in den Protokollen; die Installation der neuesten Xcode-Befehlszeilentools mit `xcode-select --install` behebt das Problem oft.

Xdebug hält nicht an Haltepunkten an

Prüfen Sie, ob Xdebug für die Website aktiviert ist, Ihr Editor auf Port 9003 lauscht und die Browseranfrage von derselben Website stammt. Befehle im Terminal werden mit deaktiviertem Xdebug ausgeführt.

Das iPhone kann die Website nicht öffnen

Aktivieren Sie die WLAN-Freigabe, vergewissern Sie sich, dass sich beide Geräte im selben WLAN befinden, und erlauben Sie eingehende Verbindungen, falls macOS Sie dazu auffordert. Gastnetzwerke verhindern häufig, dass Geräte einander erkennen.

Ein freigegebener Link funktioniert nicht mehr

Cloudflare Quick Tunnel-Links sind temporär und werden deaktiviert, sobald die Freigabe beendet wird oder der Mac in den Ruhezustand wechselt. Teilen Sie erneut, um einen neuen Link zu erhalten.

Wie kann ich PlugBench vollständig entfernen?

Beenden Sie PlugBench, löschen Sie es aus dem Ordner „Programme“ und löschen Sie die Verzeichnisse „~/Library/Application Support/PlugBench“ und „~/PlugBench“ . Homebrew-Pakete bleiben erhalten; entfernen Sie diese bei Bedarf mit „brew uninstall“

Fragen? Bitte wenden Sie sich an support@nextstarsystems.com.