Aide PlugBench

PlugBench est un serveur web local pour Mac, conçu pour créer et tester des plugins et des thèmes. Cette page présente toutes ses fonctionnalités.

Commencer

  1. Ouvrez PlugBench.dmg et faites glisser PlugBench dans Applications.
  2. Ouvrez PlugBench. La première fois, une fenêtre de bienvenue liste les éléments nécessaires : nginx, PHP, MariaDB et Mailpit, tous installés via Homebrew.
  3. Cliquez sur « Configurer PlugBench ». Le Terminal s'ouvre et installe tous les éléments nécessaires, y compris Homebrew s'il est absent. Homebrew peut vous demander votre mot de passe Mac une seule fois. PlugBench vous avertit une fois l'installation terminée.
  4. Cliquez sur Démarrer, puis sur Nouveau site.

Configuration requise : macOS 14 ou version ultérieure, Apple Silicon ou Intel, environ 2 Go d’espace libre pour les serveurs.

Fermer la fenêtre permet aux sites de rester actifs. PlugBench reste accessible dans la barre de menus. Quitter PlugBench arrête tout.

La fenêtre

  • Sites(à gauche) : chaque site, avec son CMS et son adresse. Sélectionnez-en un pour afficher ses détails.
  • Services: uniquement ce qui est actuellement en fonctionnement, comme nginx, PHP 8.5, MariaDB, Mailpit et Redis.
  • Boutons de la barre d'outils : phpMyAdmin, Adminer, Courriel, Sites (ouvre le dossier des sites), Journaux et Versions.
  • Barre de partage : apparaît lorsqu’un site est partagé, avec des boutons permettant de copier le lien ou d’arrêter le partage.
  • Icône de la barre de menu : démarrer ou arrêter, ouvrir n’importe quel site connecté, arrêter le partage, ouvrir la messagerie.

Chaque page du site comporte ces cartes :

En-tête
Nom, adresse et une ligne telle que WordPress · PHP 8.5 · MariaDB 13.0. Boutons Ouvrir le site et Ouvrir l'administration.
PHP et serveur
Version PHP, mémoire, taille de téléchargement, limite de temps, Xdebug, serveur de base de données, HTTPS et Terminal.
iPhone
Ouvrez-le dans le simulateur iPhone ou scannez un code QR avec un véritable iPhone.
Partager en ligne
Un lien public temporaire https.
Développement
Plugins liés, mode débogage, journaux et mises à jour.
Sauvegardes
Sauvegarder, restaurer et cloner.
Base de données
Nom, utilisateur, mot de passe, port et un bouton pour l'ouvrir dans phpMyAdmin.

Création de sites

Cliquez sur Nouveau site, choisissez ce que vous souhaitez installer, donnez-lui un nom et cliquez sur Créer un site.

ChoixCe que vous obtenez
WordPressDernière version de WordPress. Exemples de contenu : aucun, un blog avec photos, une boutique WooCommerce avec 17 produits, catégories, clients et commandes, ou des données de test.
JoomlaDernière version de Joomla, prête à être utilisée.
DrupalDrupal avec Drush. Exemple de magazine optionnel avec articles et photos.
GravSystème de gestion de contenu à fichier plat, sans base de données.
Craft CMS, TYPO3, Statamic, Laravel, SymfonyInstallé à partir de recettes avec Composer.
Code postal personnaliséTout site PHP extrait d'une archive ZIP, avec un fichier SQL optionnel à importer. Utilisez-le pour copier un site client en local.
VideUn dossier vide contenant PHP et une base de données, pour votre propre code.

Options disponibles dans la fenêtre Nouveau site : version PHP, de base de données , version spécifique du CMS et réseau WordPress pour Multisite.

Chaque site possède sa propre adresse, par exemple http://my-site.localhost:8801, sa propre base de données et son propre administrateur. Les sites ne sont accessibles que depuis votre Mac, sauf si vous les partagez.

Connexion en un clic

Open Admin et Open Site vous connectent en tant qu'administrateur. Aucun mot de passe à saisir. Compatible avec WordPress, Joomla, Drupal, Craft et Statamic.

Chaque clic génère un lien de connexion à usage unique valable 2 minutes. Le nom d'utilisateur et le mot de passe de l'administrateur sont également affichés sur la page du site si nécessaire.

Test d'un plugin

  1. Dans l' onglet Développement, cliquez sur Lier le dossier du plugin… et choisissez le dossier dans lequel vous codez.
  2. PlugBench l'intègre au site et l'active. Aucune donnée n'est copiée : chaque sauvegarde apparaît au chargement de la page suivante.
  3. Activez le mode Débogage pour que les notifications et avertissements PHP soient consignés dans le journal de débogage, puis cliquez sur Afficher les journaux pour les lire.
  4. La suppression le déconnecte du site. Votre dossier reste intact.

Pour tester un plugin sur plusieurs versions de PHP, clonez le site sur une autre version (voir Sauvegardes) ou changez la version PHP du site.

PHP par site

Chaque site possède sa propre version de PHP. Modifiez-la dans les paramètres PHP et serveur de la page du site. Le site redémarrera avec la nouvelle version en une seconde.

Versions disponibles : PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 et 8.5. Installez-en d’autres dans la section « Versions ». Les versions PHP 7.4 et 8.0 ne sont plus prises en charge et proviennent du shivammathur/php .

Paramètres par site, adaptés à l'hébergeur du client :

  • Mémoire: limite_mémoire, par exemple 128M ou 512M.
  • Taille de téléchargement: upload_max_filesize et post_max_size.
  • Limite de temps: max_execution_time, en secondes.

Chaque paramètre s'applique uniquement à son site.

Extensions Xdebug et PHP

Dans la section Versions, chaque version de PHP installée affiche ses extensions. Cliquez sur l'une d'elles pour la compiler pour cette version de PHP (environ une minute) :

  • Xdebug: débogage pas à pas.
  • Redis: phpredis, pour les plugins de cache d'objets.
  • Imagick: Édition d'images ImageMagick.
  • Memcached: pour le cache d'objets Memcached.

Activez ensuite Xdebug sur le site. Xdebug reste désactivé pour toutes les versions de PHP, aucun site n'en ayant besoin ; son activation est donc gratuite.

VS Code : installez l’extension PHP Debug, cliquez sur « Copier la configuration VS Code », collez-la dans le fichier .vscode/launch.jsonet activez l’écoute Xdebug. PlugBench utilise le port 9003. PhpStorm écoute par défaut sur le port 9003 et fonctionne de la même manière.

Bases de données

Le serveur par défaut est MariaDB, sur le port 3307, il n'entrera donc jamais en contact avec un serveur MySQL déjà en cours d'exécution sur le port 3306. Installez d'autres serveurs dans les versions :

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

Chaque serveur fonctionne sur son propre port. Choisissez-en un lors de la création d'un site, ou déplacez un site existant via le Serveur de base de données : PlugBench exporte la base de données, l'importe sur l'autre serveur et met à jour la configuration du site.

phpMyAdmin et Adminer s'ouvrent automatiquement, affichant la liste de tous les serveurs. La fiche « Base de données » d'un site ouvre directement sa propre base de données. Ces deux outils fonctionnent uniquement sur Mac.

PostgreSQL 17 est disponible en tant que service, sur le port 5433, utilisateur postgres, avec le même mot de passe que l'utilisateur root de MySQL.

HTTPS local

  1. Dans Versions, installez mkcert.
  2. Cliquez « Faire confiance au HTTPS local » . Le Terminal vous demandera votre mot de passe Mac pour ajouter une autorité de certification locale.
  3. Activez le protocole HTTPS sur un site. Il sera servi sur son port + 1000, par exemple https://my-site.localhost:9801.

Sur WordPress, PlugBench met à jour les adresses du site dans la base de données, y compris pour les sites multisites. La désactivation du protocole HTTPS rétablit les adresses initiales.

WordPress Multisite

Activez le réseau WordPress lors de la création d'un nouveau site. Vous obtenez ainsi un réseau avec des sites organisés dans des sous-répertoires, comme /shop/. Ajoutez vos sites dans Mes sites, Administration du réseau, Sites. Les clones, le HTTPS et le partage assurent le bon fonctionnement du réseau.

Terminal et WP-CLI

Ouvrir un terminal sur un site ouvre un shell dans son dossier, avec le PHP du site en premier dans le chemin et WordPress prêt à l'emploi. PHP, Composer et WordPress utilisent tous la version de PHP de ce site. Vos paramètres de shell personnels sont également chargés.

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

Courriel, journaux et débogage

  • Mail ouvre Mailpit. Tous les e-mails envoyés par un site y arrivent : réinitialisations de mot de passe, commandes WooCommerce, formulaires de contact. Rien ne quitte votre Mac.
  • Le mode débogage active WP_DEBUG et WP_DEBUG_LOG sur WordPress.
  • Le panneau Logs affiche le journal de débogage, le journal des erreurs PHP et les erreurs nginx. Clear les vide avant un test.

Sauvegardes, clones et mises à jour

  • Sauvegarder maintenant enregistre les fichiers et la base de données. Restaurer permet de restaurer la dernière sauvegarde.
  • La commande Clone copie un site sous un nouveau nom, éventuellement avec une autre version de PHP. Les adresses dans la base de données sont mises à jour.
  • La fonction « Mise à jour » sauvegarde la base de données, puis met à jour le CMS. Sur WordPress, la fonction « Mise à jour des extensions et des thèmes » met à jour le reste.
  • La suppression efface le site, sa base de données et son certificat.

Services

Installez-les depuis la section Versions. Une fois installées, elles démarrent et s'arrêtent avec PlugBench.

ServiceUtiliserAdresse
Redisplugins de cache d'objets127.0.0.1:6379
MemcachedCache d'objets127.0.0.1:11211
PostgreSQL 17Laravel, Drupal127.0.0.1:5433
Node.jsDéveloppement de blocs, outils de constructiondans le chemin du terminal
mkcertHTTPS local
MailpitCapture les courrielslocalhost:8025
nuage flamboyantPartager en ligne

iPhone

  • Ouvrir dans le simulateur ouvre le site dans le simulateur iPhone, une fois connecté. Cela nécessite le simulateur Xcode.
  • iPhone : cliquez sur « Partager sur le Wi-Fi », puis scannez le code QR avec l’appareil photo de l’iPhone. L’iPhone doit être connecté au même réseau Wi-Fi. Désactivez le partage une fois terminé.

Partager un site

Share Online crée un lien temporaire https://…trycloudflare.com via un tunnel Cloudflare gratuit. Aucun compte n'est requis. Envoyez-le à un client pour qu'il examine le site hébergé sur votre Mac.

  • Pour limiter les personnes autorisées à l'ouvrir, saisissez des adresses e-mail ou *@client.com. Cloudflare demande aux visiteurs de confirmer leur adresse e-mail au préalable.
  • Partager en ligne et Copier le lien lancent le partage et placent le lien dans le presse-papiers. Copier l'invitation copie un message prêt à envoyer contenant le lien.
  • « Arrêter le partage en ligne » sur le site, « Tout arrêter » dans la barre de partage ou « Arrêter tout le partage » dans la barre de menu désactive immédiatement le partage. Le lien cesse alors de fonctionner.

Les pages WordPress, les images et les liens de connexion suivent l'adresse utilisée par le visiteur.

Outils d'IA (MCP)

PlugBench utilise le protocole MCP (Model Context Protocol), ce qui permet à Claude Code, Claude Desktop, Cursor et d'autres outils d'IA de le piloter. Connectez Claude Code en une seule commande :

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

Demandez ensuite, par exemple : créez une boutique WooCommerce, liez ~/Code/my-plugin, activez le débogage, passez une commande et dites-moi si des avertissements PHP apparaissent.

Les 26 outils :

liste_sites informations_site statut démarrer_services créer_site cloner_site liste_versions configurer_php configurer_php activer_xdebug déplacer_base_de_données liste_plugins lier_plugin supprimer_plugin activer_plugin activer_debug lire_journaux effacer_journaux exécuter_php lire_mails sauvegarder_site restaurer_site URL_connexion capture_écran_iPhone partager_en_ligne partager_sur_réseau

La commande `run_php` exécute du code dans WordPress, en étant connecté en tant qu'administrateur. commande `iphone_screenshot` permet à l'IA de visualiser le site sur un iPhone.

Ligne de commande

Toutes les fonctionnalités de l'application fonctionnent également depuis le Terminal. Ajoutez l'outil à votre chemin d'accès :

ln -s /Applications/PlugBench.app/Contents/MacOS/plugbench /opt/homebrew/bin/plugbench
Services
Démarrage | Arrêt | État du banc d'essaiServices de contrôle
docteur de banc d'essaiAfficher les outils détectés
versions plugbenchListe des serveurs PHP, des serveurs de bases de données et des services
plugbench ajouter<formula>Installez-en un, comme php@7.4 ou mysql@8.0
extension de banc d'alimentation<php><name>Compiler xdebug, redis, imagick ou memcached
Sites
liste plugbenchListe des sites
installation de plugbench<cms><name> [source]Créer un site. Options : --sample, --version, --sql, --database, --php, --multisite
Informations sur le banc d'essai<slug>Informations et identifiants au format JSON
Connexion à Plugbench<slug> [admin|front]Imprimer un lien de connexion unique
suppression de plugbench<slug>Supprimer un site
renommer l'adresse de plugbench<slug>Déplacer un ancien site vers slug.localhost
PHP et serveur
plugbench php<slug><version>Changer la version de PHP
Paramètres PHP de Plugbench<slug><name><value>limite de mémoire, taille maximale des fichiers à télécharger, durée maximale d'exécution
plugbench xdebug<slug> marche/arrêtXdebug sur le port 9003
plugbench déplacer-db<slug><formula>Déplacer la base de données ou la valeur par défaut
plugbench https<slug> marche/arrêtHTTPS local
borne de banc d'alimentation<slug>Terminal avec le PHP et l'interface de ligne de commande WordPress du site
Plugins et débogage
Lien Plugbench<slug><folder>Associez et activez un plugin
plugbench déconnecter<slug><folder>Supprimer un plugin lié
plugins plugbench<slug>Liste des plugins au format JSON
débogage de plugbench<slug> marche/arrêtJournalisation WP_DEBUG
journaux de plugbench<slug> [lignes]Afficher les journaux
effacer les journaux de plugbench<slug>bûches vides
exécution du banc d'essai<slug><file.php|->Exécuter du PHP à l'intérieur d'un site
Courriel de plugbenchListe des courriels interceptés
Sauvegardes et mises à jour
Sauvegarde Plugbench | Restauration<slug>Sauvegarder ou restaurer
clone de plugbench<slug><name> [php]Copier un site
version plugbench<slug>Version CMS installée et la plus récente
mise à jour de Plugbench<slug>Mise à jour du CMS
plugbench mise à jour-extensions<slug>Mettre à jour les plugins et les thèmes
Outils et partage
plugbench phpmyadmin [slug]Adresse phpMyAdmin
Administrateur de plugbenchAdresse de l'administrateur
Partager plugbench activé/désactivéPartage Wi-Fi
partage en ligne de plugbench<slug> [emails|stop]Lien public
plugbench iPhone<slug> [chemin]Simulateur et capture d'écran
recettes de banc d'essaiListe de recettes
Licence Plugbench [activer]<key> | désactiver]Licence
plugbench mcpExécuter le serveur MCP

Recettes : ajoutez votre propre CMS

Une recette est un petit fichier JSON qui indique à PlugBench comment installer un CMS ou un framework. Placez la vôtre dans ~/Library/Application Support/PlugBench/recipes/ et elle apparaîtra dans « Nouveau site ».

{ "id": "winter", "title": "Winter CMS", "summary": "Le CMS basé sur 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"] ] }

Champs principaux : composer ou zip pour la source, docroot pour le dossier servi, base de données : false pour les CMS à fichiers plats, loginWithEmail et loginCommand pour la connexion en un clic. Espaces réservés : {url}, {root}, {db_host}, {db_port}, {db_name}, {db_user}, {db_password}, {admin_user}, {admin_password}, {admin_email}.

Vous pouvez également cliquer sur « Ajouter une recette… » dans « Nouveau site ». N’ajoutez que les recettes de confiance : leurs étapes s’exécuteront avec vos droits d’utilisateur.

des recettes de PlugBench répertorie les recettes que PlugBench reconnaît.

Version gratuite et version Pro

GratuitPro, 29 $ une fois
Sites3Illimité
Toutes les versions de CMS, PHP et de bases de données, Xdebug, HTTPS, sauvegardes, phpMyAdmin, MailpitOuiOui
Partage en ligne et partage Wi-FiOui
Outils iPhoneOui
Outils d'IA (MCP)Oui

Activez une clé dans la Licence sur la page principale, ou avec la commande `plugbench license activate KEY`. Une clé est valable sur vos Mac ; désactivez-la pour la transférer. PlugBench vérifie la clé une fois par semaine et reste fonctionnel hors ligne pendant 30 jours.

Où sont les choses

Sites~/PlugBench/<slug>
Paramètres, journaux, bases de données, sauvegardes~/Bibliothèque/Application Support/PlugBench
Vos recettes…/PlugBench/recettes
Sauvegardes…/PlugBench/sauvegardes
bûches…/PlugBench/journaux
ServeursHomebrew, /opt/homebrew

Ports

Sites8801 et suivants ; HTTPS sur le même port + 1000
phpMyAdmin8799
Administrateur8800
Mailpit8025 (web), 1025 (SMTP)
MariaDB, par défaut3307
Autres serveurs de bases de données3308 et plus
Redis, Memcached, PostgreSQL6379, 11211, 5433
Xdebug9003 (votre rédacteur en chef vous écoute)

Tout écoute uniquement sur 127.0.0.1 , sauf les sites lorsque le partage Wi-Fi est activé.

Dépannage

Le démarrage échoue ou un service reste indisponible

Ouvrez les journaux et lisez l'erreur. Il est possible qu'un port soit déjà utilisé par un autre serveur, comme MAMP ou Valet : quittez-le et cliquez sur « Redémarrer ». La commande « plugbench doctor » affiche les résultats de PlugBench.

L'installation s'est arrêtée dans le terminal

Lisez les dernières lignes dans le Terminal. Homebrew vous demandera souvent votre mot de passe ou les outils en ligne de commande Xcode. Répondez, puis cliquez Configurer PlugBench : l’installation reprendra là où elle s’était arrêtée.

Ouvrir l'interface d'administration affiche la page de connexion

Les liens de connexion sont valides pendant 2 minutes et ne fonctionnent qu'une seule fois. Cliquez à nouveau sur « Ouvrir l'administration ». Si le problème persiste, le mot de passe administrateur se trouve sur la page du site.

Le navigateur avertit à propos du protocole HTTPS

Cliquez « Faire confiance au protocole HTTPS local… » dans la section « Versions », puis redémarrez le navigateur. Firefox a besoin de nss installé via Homebrew pour lui faire confiance.

Une extension ne construit pas

Les extensions PHP ne peuvent être ajoutées que via Homebrew. Consultez la sortie du terminal dans les journaux ; l’installation des outils en ligne de commande Xcode les plus récents avec la commande `xcode-select --install` résout souvent le problème.

Xdebug ne s'arrête pas aux points d'arrêt

Vérifiez que Xdebug est activé pour le site, que votre éditeur écoute sur le port 9003 et que la requête du navigateur provient bien du même site. Les commandes exécutées dans le Terminal ont Xdebug désactivé.

L'iPhone ne peut pas ouvrir le site

Activez le partage de connexion Wi-Fi, vérifiez que les deux appareils sont connectés au même réseau Wi-Fi et autorisez les connexions entrantes si macOS vous le demande. Les réseaux invités empêchent souvent les appareils de communiquer entre eux.

Un lien partagé ne fonctionne plus

Les liens Cloudflare Quick Tunnel sont temporaires et expirent lorsque le partage s'arrête ou que le Mac se met en veille. Partagez à nouveau pour obtenir un nouveau lien.

Comment désinstaller complètement PlugBench ?

Quittez PlugBench, supprimez-le du dossier Applications, puis supprimez les dossiers ~/Library/Application Support/PlugBench et ~/PlugBench. Les paquets Homebrew restent installés ; vous pouvez les désinstaller avec la commande `brew uninstall` si vous le souhaitez.

Questions : support@nextstarsystems.com.