Lokální vývoj pomocí zinnector dev

zinnector dev spustí skutečný systém WordPress na vašem vlastním počítači, přičemž obsluhuje pluginy a šablony ve vašem projektu s vámi zvolenou verzí PHP. Tento článek vysvětluje dva běhové prostory, které může používat, jak vybírat verze, co se odkud obsluhuje a kde běhový prostor sídlí na disku – aby to, co testujete lokálně, bylo to, co nasazujete.

Dva běhové prostory a proč jsou oba skutečné

Playground je výchozí možnost. WordPress Playground zkompiluje PHP do WebAssembly a spustí jej uvnitř Node, takže notebook, na kterém není nainstalováno nic jiného než Node, spustí systém WordPress během několika sekund. K dispozici je libovolná verze PHP od 5.2 do 8.5. Obsahuje malou sadu rozšíření PHP (intl, redis, memcached měřeno v aktuálním sestavení), což stačí pro většinu práce s pluginovými a šablonovými soubory.

Docker spouští nativní kontejnery php-fpm a MariaDB. Je pomalejší, vyžaduje démona Docker a přibližně 1,2 GB obrazů a podporuje PHP od 7.4 do 8.5 – spouští však nativní PHP s úplnou sadou rozšíření včetně imagick a gd. Je to upřímná odpověď v případech, kdy potřebujete otestovat rozšíření, které sestavení WebAssembly neobsahuje.

zinnector dev                       # playground
zinnector dev --runtime docker      # nativní PHP + MariaDB

K záložnímu použití Dockeru se nikdy nepřistupuje potichu. Vývojářovi, který se domnívá, že používá WebAssembly, přičemž ve skutečnosti používá Docker, by nástroj snažící se pomoci poskytl nesprávnou odpověď, a proto je nutné si jej vyžádat jménem.

Výběr verzí PHP a WordPress

zinnector dev --php 8.1 --wp 6.7    # vývoj proti konkrétní dvojici
zinnector dev --port 9401           # když je port 9400 obsazen
zinnector dev --no-login            # nepřihlašovat se do wp-admin automaticky
zinnector dev --verbose             # zobrazit vlastní výstup běhového prostředí

Výchozí hodnoty pocházejí ze souboru zinnector.json v projektu – php, wordpress, runtime a port –, který zapisuje nástroj zinnector new a který byste měli odeslat do úložiště (commit), aby všichni v projektu používali stejné verze. Přepínač v příkazovém řádku má pro dané spuštění přednost před souborem.

Verze, kterou deklarujete, a verze, která běží, jsou dvě různé skutečnosti. Příkaz zinnector dev --once spustí běhové prostředí, vytiskne to, co skutečně hlásí – verzi PHP, verzi WordPress, načtená rozšíření – a zastaví se. Příkaz zinnector check --probe využívá stejné měření při porovnávání vašeho projektu s hostingovým slotem.

Co se obsluhuje z vašeho projektu

Běhové prostředí přímo připojuje adresáře vašeho projektu wp-content/plugins, wp-content/themes a wp-content/mu-plugins, takže soubor, který uložíte, je aktivní při příštím načtení. Adresáře, které existují, ale neobsahují žádný skutečný obsah, se záměrně nepřipojují: prázdný adresář themes/ připojený přes vlastní šablony běhového prostředí by zanechal WordPress zcela bez šablony, což znamená prázdnou chybu 500 namísto vašeho webu. Proto základní struktura zachovává prázdné adresáře se souborem .gitkeep a proto nic nestíní, dokud do nich umistíte šablonu.

Kde běhové prostředí sídlí

Běhové prostředí WordPress se při prvním použití stahuje namísto toho, aby bylo dodáváno s rozhraním CLI – balíček, který nese každé sestavení PHP, má přibližně 570 MB a vývojář, který pouze vypisuje weby, by za něj neměl platit. Je uchováváno ve vlastní mezipaměti Zinnector®, ~/.cache/zinnector/runtimes/playground/<version> (nebo tam, kam ukazuje proměnná ZINNECTOR_CACHE_DIR), nikdy ne ve vašem projektu, takže nemůže skončit ve vašem úložišti ani ve stromu, který měří příkaz zinnector push. Stahování provádí váš vlastní nástroj npm spuštěný jako node npm-cli.js – nikdy prostřednictvím shellu.

Verze běhového prostředí je připnuta k verzi CLI, takže dva vývojáři pracující na jednom projektu používají stejná sestavení PHP. Příkaz zinnector dev --reset-runtime odstraní nainstalované běhové prostředí a nainstaluje jej znovu, což představuje opravu běhového prostředí, které se nainstalovalo, ale nespustí se.

Na Node 26 nebo novějším

Samotné rozhraní CLI běží na libovolné verzi Node od 24 výše. Nativní modul běhového prostředí však dodává předem sestavené binární soubory pouze pro Node 24 a 25 (stav k září 2026). Namísto kompilování čehokoli – což v systému Windows znamená instalaci sady Visual Studio – načte Zinnector® Node 24 pouze pro běhové prostředí (přibližně 30 MB, ověřené oproti kontrolním součtům zveřejněným na webu nodejs.org) do stejné mezipaměti. Instalační výzva to při použití oznámí. Na vašem vlastním Node se nic nemění.

Související

• Začínáme · Nasazení · Referenční příručka příkazů · Řešení problémů