Bien débuter avec Zinnector®, l'interface de ligne de commande pour développeurs

Installez l'outil gratuit Zinnector CLI sur Node 24 ou une version plus récente, puis vérifiez son bon fonctionnement en deux minutes : --version, --help, générez un site, exécutez un vrai WordPress en local sans Docker et ouvrez-le dans votre navigateur, avec un aperçu du résultat attendu à chaque étape.

Zinnector® est l'outil en ligne de commande gratuit et sous licence MIT de Zinn Digital® destiné aux développeurs WordPress. Il génère 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, pas de PHP dans votre variable PATH), puis vérifie ce que vous avez construit par rapport à l'emplacement d'hébergement sur lequel vous vous apprêtez à déployer et l'y transfère. Ce guide vous mène d'un état vierge à un site en cours d'exécution en deux minutes environ, et vous indique à quoi ressemble un succès à chaque étape afin que vous sachiez quand un problème est survenu.

Ce dont vous avez besoin

Node 24 ou une version plus récente. Exécutez node --version ; la commande doit afficher v24 ou une version supérieure. Installez la version LTS actuelle depuis nodejs.org — sous Windows winget install OpenJS.NodeJS.LTS, sous macOS brew install node@24.
npm, qui est fourni avec Node. Zinnector® l'utilise une seule fois pour télécharger le moteur d'exécution WordPress dans son propre cache.
git, uniquement pour zinnector push — les déploiements sont gérés à partir de votre dépôt.
Docker, uniquement si vous le demandez avec --runtime docker. Le moteur d'exécution par défaut n'en requiert aucun.

Rien ci-dessous ne nécessite de compte. Une clé API n'est nécessaire que lorsque vous atteignez un emplacement d'hébergement, dans Déploiement avec Zinnector®.

Étape 1 — l'installer

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 l'interface en ligne de commande refusera de s'exécuter. Mettez d'abord à niveau Node, puis procédez à une nouvelle installation.

Étape 2 — vérifier la version

zinnector --version

Succès : un numéro de version, par exemple 0.1.2. Si vous voyez le message "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 sans rien exécuter d'autre.

Étape 3 — lire l'aide

zinnector --help

Succès : une bannière nommant les cinq commandes du flux (new, dev, link, check, push) suivie de chaque commande accompagnée de son rôle décrit en une ligne. Chaque commande accepte également sa propre option --help — zinnector dev --help liste les options relatives au moteur d'exécution, à PHP et aux ports. La liste complète, avec des exemples, se trouve dans la référence des commandes.

Étape 4 — générer la structure d'un site

zinnector new my-site

Succès : un en-tête Created my-site ainsi que la liste des fichiers écrits — zinnector.json, une arborescence wp-content contenant plugins/, themes/ et un fichier d'aide mu-plugins/, un fichier .gitignore et un fichier README — suivis des prochaines commandes à exécuter. Rien ici n'est un espace réservé ; le projet démarre tel quel. --template plugin ou --template theme permettent de générer la structure d'un extension ou d'un thème de blocs qui s'active dès sa création.

Étape 5 — l'exécuter

cd my-site
zinnector dev

La première fois, Zinnector® demande une confirmation avant de télécharger le moteur d'exécution WordPress — environ 570 Mo, car il intègre chaque version de PHP de la 5.2 à la 8.5 — dans son propre répertoire de cache, et jamais dans votre projet. Répondez Y, ou passez l'option --yes pour ignorer la question. Sur Node 26 ou une version plus récente, il récupère également un Node 24 réservé au moteur d'exécution (environ 30 Mo, vérifié par rapport aux sommes de contrôle de nodejs.org), car le module natif du moteur d'exécution 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 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

Visitez http://127.0.0.1:9400 dans un navigateur. Succès : un site WordPress flambant neuf intitulé My WordPress Website, servi par la version de PHP que vous avez demandée. http://127.0.0.1:9400/wp-admin ouvre le tableau de bord avec une session déjà active. Déposez une extension dans wp-content/plugins/ ou un thème dans wp-content/themes/ et le contenu apparaît dès le rechargement suivant — le moteur d'exécution sert ces répertoires directement depuis votre projet.

Appuyez sur Ctrl-C pour l'arrêter. zinnector dev --once démarre le moteur d'exécution, affiche ce qui est réellement exécuté (version de PHP, version de WordPress, extensions chargées) puis s'arrête — ce qui est utile lorsque vous souhaitez une preuve plutôt qu'une promesse.

Prochaines étapes

Développement local avec zinnector dev — les deux moteurs d'exécution, le choix des versions de PHP et de WordPress, et les éléments servis depuis chaque emplacement.
Déploiement avec Zinnector® — se connecter, lier le projet à un emplacement, effectuer les vérifications préalables, lancer le transfert.
La référence des commandes — l'ensemble des commandes, options et exemples.
Dépannage — les erreurs réellement rencontrées par les utilisateurs, accompagnées de leur solution respective.

La même documentation se trouve dans le fichier README du paquet sur npm et sur GitHub, où les rapports de bogue et les demandes de tirage sont les bienvenus.