Helyi fejlesztés a zinnector dev eszközzel

Így futtat a zinnector dev egy igazi WordPress rendszert a saját gépeden: a két futtatókörnyezet (WebAssembly Docker nélkül, vagy natív PHP Dockerben), a PHP- és a WordPress-verzió kiválasztása, a projektből kiszolgált tartalmak, az 570 MB-os futtatókörnyezet helye, valamint hogy mi történik Node 26-on.

A zinnector dev egy valódi WordPress rendszert futtat a saját gépén, kiszolgálva a projektjében lévő bővítményeket és témákat az Ön által választott PHP-verzióval. Ez a cikk bemutatja a két futtatókörnyezetet, amelyeket használni tud, a verziók kiválasztásának módját, hogy mi honnan kerül kiszolgálásra, valamint azt, hogy a futtatókörnyezet hol helyezkedik el a lemezen – így a helyben tesztelt verzió megegyezik a telepítettel.

A két futtatókörnyezet, és hogy miért mindkettő valós

Az Playground az alapértelmezett. A WordPress Playground WebAssemblyvé fordítja a PHP-t, és a Node-on belül futtatja, így egy olyan laptopon, amelyre semmi más nincs telepítve, csak a Node, a WordPress néhány másodperc alatt elindul. Bármilyen PHP elérhető a 5.2 és 8.5 közötti tartományban. Kis számú PHP-bővítményt tartalmaz (intl, redis, memcached az aktuális build mérései szerint), ami a legtöbb bővítmény- és témamunkához elegendő.

A Docker natív php-fpm és MariaDB tárolókat futtat. Lassabb, szükség van egy Docker-daemonra és körülbelül 1,2 GB-nyi lemezképre, valamint a 7.4–8.5 közötti PHP-verziókat támogatja – de natív PHP-t futtat a bővítmények teljes készletével, beleértve az imagick és gd bővítményeket is. Ez a megfelelő választás, ha olyan bővítményt kell tesztelnie, amelyet a WebAssembly build nem tartalmaz.

zinnector dev                       # playground
zinnector dev --runtime docker      # native PHP + MariaDB

A rendszer soha nem vált át automatikusan a Dockerre figyelmeztetés nélkül. Az a fejlesztő, aki azt hiszi, hogy WebAssemblyt használ, de valójában a Dockert futtatja, téves választ kapna egy segíteni próbáló eszköztől, ezért azt név szerint kell kérni.

PHP- és WordPress-verziók kiválasztása

zinnector dev --php 8.1 --wp 6.7    # develop against a specific pair
zinnector dev --port 9401           # when 9400 is taken
zinnector dev --no-login            # do not sign in to wp-admin automatically
zinnector dev --verbose             # show the runtime's own output

Az alapértelmezett értékek a projektben található zinnector.json fájlból származnak (php, wordpress, runtime és port), amelyet a zinnector new hoz létre, és amelyet érdemes a verziókövetésbe commitolni, hogy a projekt minden résztvevője ugyanazokat a verziókat futtassa. Az adott futtatás során a parancssorban megadott kapcsoló felülírja a fájlban szereplő értéket.

A verzió, amelyet deklarál, és a verzió, amely fut, két különböző dolog. A zinnector dev --once parancs elindítja a futtatókörnyezetet, kiírja a tényleges adatait – PHP-verzió, WordPress-verzió, betöltött bővítmények –, majd leáll. A zinnector check --probe ugyanezt a mérést használja, amikor összehasonlítja a projektjét egy tárhelyhellyel.

Mi kerül kiszolgálásra a projektjéből

A futtatókörnyezet közvetlenül csatolja a projekt wp-content/plugins, wp-content/themes és wp-content/mu-plugins könyvtárait, így a mentett fájlok a következő újratöltéskor azonnal érvénybe lépnek. Azok a könyvtárak, amelyek léteznek, de nem tartalmaznak valós tartalmat, szándékosan nincsenek csatolva: egy üres themes/ könyvtár, amely a futtatókörnyezet saját témái fölé van csatolva, téma nélkül hagyná a Wikipédiát, azaz üres 500-as hibát eredményezne a webhely helyett. Ezért őrzi meg a vázlat az üres könyvtárakat egy .gitkeep fájllal, és ezért nem fednek át semmit, amíg nem helyez el bennük egy témát.

Hol él a futtatókörnyezet

A WordPress futtatókörnyezetet az első használatkor tölti le a rendszer ahelyett, hogy a CLI-vel együtt szállítaná – az összes PHP-buildet tartalmazó csomag körülbelül 570 MB méretű, és az a fejlesztő, aki csak listázni szokta a webhelyeket, nem fizethet érte. A Zinnector® saját gyorsítótárában tárolódik, a ~/.cache/zinnector/runtimes/playground/<version> útvonalon (vagy ahová a ZINNECTOR_CACHE_DIR mutat), soha nem a projektben, így az nem kerülhet be a repository-ba vagy a zinnector push által vizsgált faszerkezetbe. A letöltést a saját npm-je végzi node npm-cli.js módon futtatva – soha nem shellen keresztül.

A futtatókörnyezet verziója a CLI verziójához van kötve, így egy projekten két fejlesztő ugyanazokat a PHP-build futtatja. A zinnector dev --reset-runtime eldobja a telepített futtatókörnyezetet, és újra telepíti azt, ami megoldást jelent a fel nem álló, de telepített futtatókörnyezetek esetén.

Node 26 vagy újabb verzió esetén

Maga a CLI bármilyen 24-es vagy újabb Node verzión fut. A futtatókörnyezet natív modulja azonban csak a Node 24 és 25 verziókhoz tartalmaz előre lefordított bináris fájlokat (2026 szeptemberi adatok szerint). Ahelyett, hogy bármit is lefordítana – ami Windows esetén a Visual Studio telepítését jelentené –, a Zinnector® letölt egy Node 24-et a futtatókörnyezet számára külön, körülbelül 30 MB méretben, a nodejs.org által közzétett ellenőrzőösszegek alapján ellenőrizve, ugyanebbe a gyorsítótárba. A telepítési üzenet ezt jelzi a futtatáskor. A saját Node-beállításai változatlanok maradnak.

Kapcsolódó

Első lépések · Üzembe helyezés · Parancsreferencia · Hibaelhárítás