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
- Ouvrez
PlugBench.dmget faites glisser PlugBench dans Applications. - 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.
- 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.
- 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.
| Choix | Ce que vous obtenez |
|---|---|
| WordPress | Derniè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. |
| Joomla | Dernière version de Joomla, prête à être utilisée. |
| Drupal | Drupal avec Drush. Exemple de magazine optionnel avec articles et photos. |
| Grav | Système de gestion de contenu à fichier plat, sans base de données. |
| Craft CMS, TYPO3, Statamic, Laravel, Symfony | Installé à 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. |
| Vide | Un 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
- Dans l' onglet Développement, cliquez sur Lier le dossier du plugin… et choisissez le dossier dans lequel vous codez.
- 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.
- 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.
- 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_filesizeetpost_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
- Dans Versions, installez mkcert.
- Cliquez « Faire confiance au HTTPS local » . Le Terminal vous demandera votre mot de passe Mac pour ajouter une autorité de certification locale.
- 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_DEBUGetWP_DEBUG_LOGsur 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.
| Service | Utiliser | Adresse |
|---|---|---|
| Redis | plugins de cache d'objets | 127.0.0.1:6379 |
| Memcached | Cache d'objets | 127.0.0.1:11211 |
| PostgreSQL 17 | Laravel, Drupal | 127.0.0.1:5433 |
| Node.js | Développement de blocs, outils de construction | dans le chemin du terminal |
| mkcert | HTTPS local | |
| Mailpit | Capture les courriels | localhost:8025 |
| nuage flamboyant | Partager 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é.
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 :
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'essai | Services de contrôle |
docteur de banc d'essai | Afficher les outils détectés |
versions plugbench | Liste 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 plugbench | Liste 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êt | Xdebug 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êt | HTTPS 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êt | Journalisation 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 plugbench | Liste 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 plugbench | Adresse 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'essai | Liste de recettes |
Licence Plugbench [activer]<key> | désactiver] | Licence |
plugbench mcp | Exé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
| Gratuit | Pro, 29 $ une fois | |
|---|---|---|
| Sites | 3 | Illimité |
| Toutes les versions de CMS, PHP et de bases de données, Xdebug, HTTPS, sauvegardes, phpMyAdmin, Mailpit | Oui | Oui |
| Partage en ligne et partage Wi-Fi | Oui | |
| Outils iPhone | Oui | |
| 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 |
| Serveurs | Homebrew, /opt/homebrew |
Ports
| Sites | 8801 et suivants ; HTTPS sur le même port + 1000 |
| phpMyAdmin | 8799 |
| Administrateur | 8800 |
| Mailpit | 8025 (web), 1025 (SMTP) |
| MariaDB, par défaut | 3307 |
| Autres serveurs de bases de données | 3308 et plus |
| Redis, Memcached, PostgreSQL | 6379, 11211, 5433 |
| Xdebug | 9003 (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.