Első lépések a Zinnector® fejlesztői parancssori felülettel

A Zinnector® a Zinn Digital® ingyenes, MIT-licencű parancssori eszköze WordPress-fejlesztők számára. Létrehozza a webhely alapstruktúráját, valódi WordPress-t futtat a saját gépén úgy, hogy a Node-on kívül semmi más nincs telepítve – nincs Docker, nincs MAMP, nincs PHP a PATH-ban –, majd ellenőrzi az elkészült munkát a célként szolgáló tárhelyfiókkal szemben, ahová telepíteni készül, és közzéteszi azt. Ez az útmutató körülbelül két perc alatt eljuttatja Önt a nulláról egy működő webhelyig, és minden lépésnél bemutatja a sikeres kimenetet, hogy lássa, ha valami hiba történt.

Amire szüksége lesz

• Node 24 vagy újabb. Futtassa a node --version parancsot; v24 vagy magasabb verziót kell kiírnia. Telepítse az aktuális LTS-verziót a nodejs.org oldalról – Windows rendszeren a winget install OpenJS.NodeJS.LTS, macOS rendszeren a brew install node@24 paranccsal.
• npm, amely a Node részét képezi. A Zinnector® egyszer használja, hogy letöltse a WordPress futtatókörnyezetet a saját gyorsítótárába.
• git, kizárólag a zinnector push parancshoz – a telepítések a saját adattárából történnek.
• Docker, kizárólag akkor, ha a --runtime docker kapcsolóval kifejezetten kéri. Az alapértelmezett futtatókörnyezethez nincs rá szükség.

Az alábbiak közül semmihez sem szükséges fiók. API-kulcsra csak akkor lesz szüksége, amikor elér egy tárhelyfiókot, a Telepítés a Zinnector® segítségével részben leírtak szerint.

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

npm install -g zinnector

Ha az npm a npm WARN EBADENGINE üzenetet írja ki, az Ön Node-verziója régebbi, mint a csomag által megkövetelt >=24.18.1. A telepítés ennek ellenére befejeződik, de a parancssori felület nem fog elindulni. Először frissítse a Node-ot, majd futtassa újra a telepítést.

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 fájl telepítve van, de a Node-verzió túl régi; a parancs a 78-as kóddal leáll ahelyett, hogy bármit csinálna.

3. lépés — a súgó áttekintése

zinnector --help

Siker: egy fejléc, amely megnevezi a munkafolyamat öt parancsát (new, dev, link, check, push), majd mindegyik parancsot egy egysoros leírással. Minden parancs saját --help kapcsolóval is rendelkezik – a zinnector dev --help listázza a futtatókörnyezet, a PHP és a port kapcsolóit. A teljes lista a példákkal együtt a parancsreferenciában található.

4. lépés — webhely létrehozása

zinnector new my-site

Siker: egy Created my-site címsor és a létrehozott fájlok listája – zinnector.json, egy wp-content fa a plugins/, themes/ mappákkal é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 a jelenlegi formájában elindul. A --template plugin vagy a --template theme kapcsolók olyan bővítményt vagy blokksablont hoznak létre, amely a létrejötte pillanatában azonnal aktiválódik.

5. lépés — futtatás

cd my-site
zinnector dev

Az első alkalommal a Zinnector® egyszer megerősítést kér, mielőtt letöltené a WordPress futtatókörnyezetet – körülbelül 570 MB-ot, mivel az 5.2-től a 8.5-ig az összes PHP-verziót tartalmazza – a saját gyorsítótár-könyvtárába, soha nem az Ön projektjébe. Válaszoljon Y-nal, vagy adja meg a --yes kapcsolót a kérdés kihagyásához. Node 26 vagy újabb verzió esetén kizárólag a futtatókörnyezet számára egy Node 24-et is letölt (körülbelül 30 MB, a nodejs.org ellenőrzőösszegeivel hitelesítve), mivel a futtatókörnyezet natív modulja csak a Node 24 és 25 verziókhoz tartalmaz előre lefordított binárisokat; nincs szüksége fordítóprogramra vagy Visual Studió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

Nyissa meg a http://127.0.0.1:9400 címet egy böngészőben. Siker: egy friss WordPress-webhely My WordPress Website címmel, amelyet a kért PHP-verzió szolgál ki. A http://127.0.0.1:9400/wp-admin cím már bejelentkezve nyitja meg a vezérlőpultot. Helyezzen el egy bővítményt a wp-content/plugins/ mappába vagy egy sablont a wp-content/themes/ mappába, és a következő oldalfrissítéskor már ott is lesz – a futtatókörnyezet ezeket a könyvtárakat közvetlenül a projektjéből szolgálja ki.

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ó adatokat (PHP-verzió, WordPress-verzió, betöltött kiterjesztések), majd leáll – ez akkor hasznos, ha ígéretek helyett bizonyítékot szeretne.

További lépések

• Helyi fejlesztés a zinnector dev segítségével — a két futtatókörnyezet, a PHP- és WordPress-verziók kiválasztása, és hogy mi honnan kerül kiszolgálásra.
• Telepítés a Zinnector® segítségével — jelentkezzen be, kapcsolja a projektet egy tárhelyfiókhoz, végezzen előzetes ellenőrzést, tegye közzé.
• A parancsreferencia — minden parancs, kapcsoló és példa.
• Hibaelhárítás — a felhasználók által ténylegesen tapasztalt hibák és azok megoldásai.

Ugyanez a dokumentáció megtalálható a csomag README fájljában az npm és a GitHub felületén is, ahol szívesen fogadjuk a hibajelentéseket és a pull requesteket.