Prise en main de Zinnector®, l’interface en ligne de commande pour développeurs

Zinnector® est l’outil en ligne de commande gratuit et sous licence MIT de Zinn Digital®, conçu pour les développeurs WordPress. Il initialise la structure d’un site, exécute un véritable WordPress sur votre propre machine sans rien d’autre d’installé que Node — pas de Docker, pas de MAMP, aucun PHP dans votre PATH — puis vérifie ce que vous avez créé par rapport à l’emplacement d’hébergement vers lequel vous êtes sur le point de déployer, et le publie. Ce guide vous accompagne de zéro à un site opérationnel en deux minutes environ, et vous indique à quoi ressemble la réussite à chaque étape afin que vous sachiez si quelque chose s’est mal passé.

Ce dont vous avez besoin

• Node 24 ou plus récent. Exécutez node --version ; la commande doit afficher v24 ou supérieur. Installez la version LTS actuelle depuis nodejs.org — sur Windows winget install OpenJS.NodeJS.LTS, sur macOS brew install node@24.
• npm, fourni avec Node. Zinnector® l’utilise une seule fois, pour télécharger l’environnement d’exécution WordPress dans son propre cache.
• git, uniquement pour zinnector push — les déploiements sont pilotés à partir de votre dépôt.
• Docker, uniquement si vous le demandez avec --runtime docker. L’environnement d’exécution par défaut n’en a pas besoin.

Rien de ce qui suit ne nécessite de compte. Une clé API n’est requise que lorsque vous accédez à un emplacement d’hébergement, dans Déployer avec Zinnector®.

Étape 1 — installer l’outil

npm install -g zinnector

Si npm affiche npm WARN EBADENGINE, votre version de Node est plus ancienne que la version >=24.18.1 déclarée par le paquet. L’installation se termine tout de même, mais le CLI refusera de s’exécuter. Mettez d’abord Node à niveau, puis relancez l’installation.

Étape 2 — vérifier la version

zinnector --version

Succès : un numéro de version, par exemple 0.1.2. Si vous voyez « Zinnector® needs Node 24 or newer — this is Node 20.x », le binaire est installé mais votre version de Node est trop ancienne ; la commande s’arrête avec le code 78 au lieu d’effectuer une action.

Étape 3 — consulter l’aide

zinnector --help

Succès : une bannière présentant les cinq commandes du flux de travail (new, dev, link, check, push), puis chaque commande accompagnée d’une description sommaire de son rôle. Chaque commande accepte également son propre --help — zinnector dev --help liste les options pour le runtime, PHP et les ports. La liste complète, accompagnée d’exemples, se trouve dans la référence des commandes.

Étape 4 — initialiser un site

zinnector new my-site

Succès : un en-tête Created my-site et une liste des fichiers générés — zinnector.json, une arborescence wp-content avec plugins/, themes/ et un assistant mu-plugins/, un .gitignore et un README — suivis des prochaines commandes à exécuter. Aucun élément n’est un simple espace réservé temporaire ; le projet démarre tel quel. --template plugin ou --template theme initialisent un plugin ou un thème basé sur des blocs qui s’active dès sa création.

Étape 5 — le lancer

cd my-site
zinnector dev

La première fois, Zinnector® vous demande confirmation une seule fois avant de télécharger l’environnement d’exécution WordPress — environ 570 Mo, car il embarque toutes les versions de PHP de la 5.2 à la 8.5 — dans son propre répertoire de cache, jamais dans votre projet. Répondez Y, ou passez --yes pour ignorer la question. Sur Node 26 ou plus récent, il télécharge également une version de Node 24 réservée au runtime (environ 30 Mo, validée par rapport aux sommes de contrôle de nodejs.org), car le module natif du runtime ne dispose de binaires précompilés que pour Node 24 et 25 ; vous n’avez pas besoin de compilateur ni de Visual Studio.

Succès : un bloc indiquant le nom du projet, la version de PHP et la version de WordPress, puis :

✔ running at http://127.0.0.1:9400
  admin: http://127.0.0.1:9400/wp-admin  (already signed in)

Étape 6 — l’ouvrir

Rendez-vous sur http://127.0.0.1:9400 dans un navigateur. Succès : un nouveau site WordPress intitulé My WordPress Website, exécuté avec la version de PHP demandée. http://127.0.0.1:9400/wp-admin ouvre le tableau de bord en étant déjà connecté. Déposez un plugin dans wp-content/plugins/ ou un thème dans wp-content/themes/ et il sera disponible dès le rechargement suivant — l’environnement d’exécution sert directement ces répertoires depuis votre projet.

Appuyez sur Ctrl-C pour l’arrêter. zinnector dev --once démarre l’environnement d’exécution, affiche ce qui tourne réellement (version de PHP, version de WordPress, extensions chargées) et s’arrête — utile lorsque vous voulez une preuve concrète plutôt qu’une simple promesse.

Où aller ensuite

• Développement local avec zinnector dev — les deux environnements d’exécution, le choix des versions de PHP et de WordPress, et ce qui est servi d’où.
• Déployer avec Zinnector® — connectez-vous, associez le projet à un emplacement, lancez les vérifications préalables, publiez.
• La référence des commandes — l’ensemble des commandes, options et exemples.
• Dépannage — les erreurs fréquemment rencontrées et leur solution respective.

Cette même documentation est disponible dans le fichier README du paquet sur npm et sur GitHub, où les signalements de problèmes et les pull requests sont les bienvenus.