Helyi fejlesztés a zinnector dev segítségével

A zinnector dev egy valódi WordPress-t futtat az Ön saját gépén, a projektjében lévő bővítményeket és sablonokat kiszolgálva, az Ön által választott PHP-verzióval. Ez a cikk bemutatja a két futtatókörnyezetet, amelyet használni tud, a verziók kiválasztásának módját, hogy mi honnan kerül kiszolgálásra, valamint hogy hol található a futtatókörnyezet a lemezen — így amit helyileg tesztel, pontosan az kerül telepítésre.

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

A Playground az alapértelmezett. A WordPress Playground WebAssembly-re 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, másodpercek alatt elindul egy WordPress. Bármely PHP elérhető 5.2-től 8.5-ig. Kis számú PHP-kiterjesztést tartalmaz (intl, redis, memcached a jelenlegi build alapján mérve), ami a legtöbb bővítmény- és sablonmunkához elegendő.

A Docker natív php-fpm és MariaDB konténereket futtat. Lassabb, Docker démont és körülbelül 1,2 GB-nyi lemezképet igényel, valamint a PHP 7.4-től 8.5-ig terjedő verzióit támogatja — viszont natív PHP-t futtat a teljes kiterjesztéskészlettel, beleértve az imagick és gd kiterjesztéseket is. Ez a megfelelő választás, amikor olyan kiterjesztést kell tesztelnie, amelyet a WebAssembly build nem tartalmaz.

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

A rendszer soha nem vált vissza észrevétlenül a Docker használatára. Ha egy fejlesztő azt hiszi, hogy WebAssembly-t használ, miközben valójában Docker-en fut a környezet, akkor egy segíteni próbáló eszköz téves eredményt adott neki, ezért ezt kifejezetten név szerint kell kérni.

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

zinnector dev --php 8.1 --wp 6.7    # fejlesztés egy adott párossal
zinnector dev --port 9401           # ha a 9400 már foglalt
zinnector dev --no-login            # ne jelentkezzen be automatikusan a wp-admin felületre
zinnector dev --verbose             # jelenítse meg a futtatókörnyezet saját kimenetét

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 kommitolnia, hogy a projekten dolgozók mindegyike ugyanazokat a verziókat futtassa. A parancssorban megadott jelző az adott futtatás erejéig felülbírálja a fájlt.

A verzió, amelyet Ön deklarál, és a verzió, amely ténylegesen fut, két különböző dolog. A zinnector dev --once elindítja a futtatókörnyezetet, kiírja, amit az valójában jelent — PHP-verzió, WordPress-verzió, betöltött kiterjesztések —, majd leáll. A zinnector check --probe ugyanezt a mérést használja, amikor összehasonlítja az Ön projektjét egy tárhelyfiókkal.

Mi kerül kiszolgálásra az Ön projektjéből

A futtatókörnyezet közvetlenül csatolja a projektje wp-content/plugins, wp-content/themes és wp-content/mu-plugins könyvtárait, így az Ön által elmentett fájl a következő újratöltéskor már élesben működik. A létező, de valódi tartalmat nem tartalmazó könyvtárak szándékosan nem kerülnek csatolásra: egy üres themes/ csatolása a futtatókörnyezet saját sablonjai fölé azt eredményezné, hogy a WordPress sablon nélkül maradna, ami az Ön webhelye helyett egy üres 500-as hibát jelentene. Ezért tartja meg a vázstruktúra az üres könyvtárakat egy .gitkeep fájllal, és ezért nem fednek el semmit, amíg Ön el nem helyez bennük egy sablont.

Hol található a futtatókörnyezet

A WordPress futtatókörnyezet az első használatkor töltődik le, ahelyett hogy a CLI-vel együtt érkezne — az összes PHP buildet tartalmazó csomag körülbelül 570 MB, és egy olyan fejlesztőnek, aki csak webhelyeket listáz, nem kellene ezt letöltenie. A Zinnector® saját gyorsítótárában található, a ~/.cache/zinnector/runtimes/playground/<version> útvonalon (vagy ahová a ZINNECTOR_CACHE_DIR mutat), soha nem az Ön projektjében, így nem kerülhet be az Ön adattárába vagy a zinnector push által vizsgált könyvtárfába. A letöltést az Ön saját npm eszköze végzi, node npm-cli.js formájában futtatva — soha nem parancsértelmezőn keresztül.

A futtatókörnyezet verziója hozzá van rögzítve a CLI verziójához, így egy projekten két fejlesztő ugyanazokat a PHP buildeket futtatja. A zinnector dev --reset-runtime eltávolítja a telepített futtatókörnyezetet, és újra telepíti azt, ami megoldást nyújt egy olyan futtatókörnyezet esetén, amely települt, de nem indul el.

Node 26 vagy újabb verzió esetén

Maga a CLI a Node bármely 24-es vagy újabb verzióján fut. A futtatókörnyezet natív modulja azonban (2026 szeptemberi állapot szerint) csak a Node 24 és 25 verzióihoz biztosít előre lefordított binárisokat. Ahelyett, hogy bármit is lefordítana — ami Windows alatt a Visual Studio telepítését jelentené —, a Zinnector® kizárólag a futtatókörnyezet számára letölt egy Node 24-et (körülbelül 30 MB-ot), amelyet a nodejs.org által közzétett ellenőrző összegek alapján ellenőriz, ugyanabba a gyorsítótárba. A telepítési értesítés jelzi ezt, amikor érvényes. Az Ön saját Node környezetében semmi sem változik.

Kapcsolódó anyagok

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