Első lépések a Zinnector® fejlesztői CLI-vel

Telepítse az ingyenes Zinnector CLI-t Node 24-es vagy újabb verzióra, majd bizonyosodjon meg a működéséről két perc alatt: --version, --help, webhely keretrendszer létrehozása, egy valós WordPress futtatása helyben, Docker nélkül, és a megnyitása a böngészőben – megmutatva, hogy mi a siker jele az egyes lépéseknél.

A Zinnector® a Zinn Digital® ingyenes, MIT-licences parancssori eszköze WordPress-fejlesztők számára. Felépít egy webhelyet, elindít egy valós WordPress-t a saját gépén anélkül, hogy a Node-on kívül bármi más telepítve lenne – nincs Docker, nincs MAMP, nincs PHP a PATH-ban –, majd ellenőrzi a megépített oldalt a kiszolgálási hellyel, amelyre telepíteni kívánja, és feltölti azt. Ez az útmutató a semmitől a futó webhelyig vezeti el körülbelül két perc alatt, és minden lépésnél megmutatja, hogy milyen a sikeres eredmény, így tudni fogja, ha valami hiba történt.

Amire szüksége lesz

Node 24 vagy újabb. Futtassa a node --version parancsot; annak a v24 vagy újabb verziót kell kiírnia. Telepítse az aktuális LTS-t a nodejs.org webhelyről – Windowson a winget install OpenJS.NodeJS.LTS, macOS-en a brew install node@24 paranccsal.
npm, amely a Node tartozéka. A Zinnector® egyszer használja, hogy letöltse a WordPress futtatókörnyezetet a saját gyorsítótárába.
git, csak a zinnector push parancshoz – a telepítések a tárolóból indulnak ki.
Docker, csak akkor, ha a --runtime docker kapcsolóval kéri azt. Az alapértelmezett futtatókörnyezet nem igényel semmit.

Az alábbiakban semmi sem igényel fiókot. API-kulcsra csak akkor van szükség, amikor eléri a kiszolgálási helyet a Telepítés a Zinnector® használatával című részben.

1. lépés — telepítés

npm install -g zinnector

Ha az npm az npm WARN EBADENGINE üzenetet írja ki, az Ön Node-verziója régebbi, mint a csomag által megadott >=24.18.1. A telepítés ettől függetlenül befejeződik, de a parancssori felület (CLI) elutasítja a futtatást. Először frissítse a Node-ot, majd telepítse újra.

2. lépés — a verzió ellenőrzése

zinnector --version

Siker: egy verziószám, például 0.1.2. Ha a "Zinnector® needs Node 24 or newer — this is Node 20.x" üzenetet látja, a bináris telepítve van, de a Node verziója túl régi; a parancs a 78-as hibakóddal kilép anélkül, hogy bármit tennél.

3. lépés — a súgó elolvasása

zinnector --help

Siker: egy banner, amely felsorolja a folyamat öt parancsát (new, dev, link, check, push), majd minden parancsot egy egysoros céllal. Minden parancs saját --help kapcsolót is elfogad – a zinnector dev --help felsorolja a futtatókörnyezetre, a PHP-re és a portokra vonatkozó jelölőket. A teljes lista a példákkal együtt a parancsreferenciában található.

4. lépés — webhely felépítése

zinnector new my-site

Siker: egy Created my-site fejléc és a megírt fájlok listája – zinnector.json, egy wp-content fastruktúra plugins/, themes/ és egy mu-plugins/ segéddel, egy .gitignore és egy README –, amelyet a következő futtatandó parancsok követnek. Semmi sem helyőrző benne; a projekt abban az állapotában elindul. A --template plugin vagy --template theme kapcsolók olyan bővítményt vagy blokktémát építenek fel, amely a létezése pillanatában aktiválódik.

5. lépés — futtatás

cd my-site
zinnector dev

Az első alkalommal a Zinnector® egyszer kérdez, mielőtt letöltené a WordPress futtatókörnyezetet – ez körülbelül 570 MB, mivel az 5.2-es verziótól a 8.5-ös verzióig minden PHP-buildet tartalmazza – a saját gyorsítótár-könyvtárába, soha nem a projektjébe. Válaszoljon Y-nal, vagy adja meg a --yes kapcsolót a kérdés kihagyásához. Node 26-os vagy újabb verzión egy Node 24-et is letölt kizárólag a futtatókörnyezethez (körülbelül 30 MB, ellenőrizve a nodejs.org ellenőrzőösszegei alapján), mivel a futtatókörnyezet natív modulja csak a Node 24-hez és 25-höz rendelkezik előre lefordított binárisokkal; nincs szüksége fordítóprogramra vagy a Visual Studio-ra.

Siker: egy blokk, amely megnevezi a projektet, a PHP-verziót és a WordPress-verziót, majd:

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

6. lépés — megnyitás

Látogasson el a http://127.0.0.1:9400 címre egy böngészőben. Siker: egy friss WordPress-webhely My WordPress Website címmel, amelyet az Ön által kért PHP-verzió szolgál ki. A http://127.0.0.1:9400/wp-admin megnyitja a vezérlőpultot már bejelentkezett állapotban. Dobjon be egy bővítményt a wp-content/plugins/ mappába vagy egy témát a wp-content/themes/ mappába, és az ott lesz a következő újratöltéskor – a futtatókörnyezet közvetlenül a projektjéből szolgálja ki ezeket a könyvtárakat.

A leállításhoz nyomja meg a Ctrl-C billentyűkombinációt. A zinnector dev --once elindítja a futtatókörnyezetet, kiírja a ténylegesen futó elemeket (PHP-verzió, WordPress-verzió, betöltött kiterjesztések), majd leáll – ez akkor hasznos, ha bizonyítékot szeretne egy ígéret helyett.

További lépések

Helyi fejlesztés a zinnector dev használatával – a két futtatókörnyezet, a PHP- és WordPress-verziók kiválasztása, valamint hogy mit honnan szolgálnak ki.
Telepítés a Zinnector® használatával – bejelentkezés, a projekt összekapcsolása egy hellyel, indítás előtti ellenőrzés, feltöltés.
A parancsreferencia – minden parancs, kapcsoló és példa.
Hibaelhárítás – a hibák, amelyekkel a felhasználók valóban találkoznak, és ezek javítása.

Ugyanez a dokumentáció megtalálható a csomag README fájljában az npm webhelyén és a GitHubon is, ahol örömmel várjuk a hibajelentéseket és a pull kérelmeket.