zinnector dev huendesha WordPress halisi kwenye mashine yako mwenyewe, ikitoa programu-jalizi na mandhari zilizo katika mradi wako, ikiwa na toleo la PHP unalochagua. Makala haya yanaeleza mazingira mawili ya utekelezaji (runtimes) inayoweza kutumia, jinsi ya kuchagua matoleo, kile kinachotolewa kutoka wapi, na mahali ambapo runtime huishi kwenye diski — ili kile unachojaribu ndani ya mashine yako kiwe kile unachopeleka kwenye seva.
Runtimes mbili, na kwa nini zote ni halisi
Playground ndiyo chaguomsingi. WordPress Playground hukusanya PHP kuwa WebAssembly na kuiendesha ndani ya Node, kwa hivyo kipakatalishi ambacho hakina kitu kingine chochote kilichosakinishwa isipokuwa Node huwasha WordPress ndani ya sekunde chache. PHP yoyote kuanzia 5.2 hadi 8.5 inapatikana. Hubeba seti ndogo ya viendelezi vya PHP (intl, redis, memcached kama ilivyopimwa kwenye toleo la sasa), ambayo inatosha kwa kazi nyingi za programu-jalizi na mandhari.
Docker huendesha kontena asilia za php-fpm na MariaDB. Ni ya polepole zaidi, inahitaji daemon ya Docker na takriban GB 1.2 za picha, na inasaidia PHP 7.4 hadi 8.5 — lakini inaendesha PHP asilia iliyo na seti kamili ya viendelezi, ikijumuisha imagick na gd. Ndilo jibu la kweli wakati unachohitaji kujaribu ni kiendelezi ambacho toleo la WebAssembly halibebi.
zinnector dev # playground
zinnector dev --runtime docker # native PHP + MariaDB
Docker haichukuliwi kamwe kama chaguo mbadala kimyakimya. Msanidi programu anayedhani yuko kwenye WebAssembly na kiuhalisia yuko kwenye Docker amepewa jibu lisilo sahihi na zana inayojaribu kusaidia, kwa hivyo ni lazima iombwe kwa jina lake.
Kuchagua matoleo ya PHP na WordPress
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
Chaguomsingi hutoka kwenye zinnector.json katika mradi — php, wordpress, runtime na port — ambayo zinnector new huandika na ambayo unapaswa kuikabidhi (commit), ili kila mtu aliye kwenye mradi aendeshe matoleo sawa. Bendera kwenye mstari wa amri hushinda faili kwa uendeshaji huo.
Toleo unalotangaza na toleo ambalo hufanya kazi ni mambo mawili tofauti. zinnector dev --once huwasha runtime, huchapisha kile inachoripoti kiuhalisia — toleo la PHP, toleo la WordPress, viendelezi vilivyopakiwa — na kusimama. zinnector check --probe hutumia kipimo hicho hicho inapolinganisha mradi wako dhidi ya nafasi ya upangishaji (hosting slot).
Kile kinachotolewa kutoka kwa mradi wako
Runtime hupachika saraka za wp-content/plugins, wp-content/themes na wp-content/mu-plugins za mradi wako moja kwa moja, kwa hivyo faili unayohifadhi huwa hai kwenye upakiaji upya unaofuata. Saraka zilizopo lakini hazina maudhui halisi kwa makusudi hazipachikwi: saraka tupu ya themes/ iliyopachikwa juu ya mandhari ya runtime yenyewe ingeiacha WordPress bila mandhari yoyote kabisa, ambayo ni kosa tupu la 500 badala ya tovuti yako. Hiyo ndiyo sababu kiunzi huweka saraka tupu na faili ya .gitkeep na kwa nini hazifuniki kitu chochote hadi utakapoweka mandhari ndani yake.
Mahali ambapo runtime huishi
Runtime ya WordPress hupakuliwa wakati wa matumizi ya kwanza badala ya kusafirishwa pamoja na CLI — kifurushi kinachobeba kila toleo la PHP ni takriban MB 570, na msanidi programu ambaye huorodhesha tovuti pekee hapaswi kuilipia. Huwekwa kwenye kache ya Zinnector® yenyewe, ~/.cache/zinnector/runtimes/playground/<version> (au popote pale ZINNECTOR_CACHE_DIR inapoelekeza), kamwe haikai kwenye mradi wako, kwa hivyo haiwezi kuishia kwenye hifadhi (repository) yako au kwenye mti ambao zinnector push hupima. Upakuaji unafanywa na npm yako mwenyewe, ikiendeshwa kama node npm-cli.js — kamwe haipiti kwenye shell.
Toleo la runtime limefungamanishwa na toleo la CLI, kwa hivyo wasanidi programu wawili kwenye mradi mmoja huendesha matoleo sawa ya PHP. zinnector dev --reset-runtime hutupa runtime iliyosakinishwa na kuisakinisha tena, ambalo ndilo suluhisho la runtime iliyosakinishwa lakini inayokataa kuwaka.
Kwenye Node 26 au mpya zaidi
CLI yenyewe huendeshwa kwenye Node yoyote kuanzia 24 na kuendelea. Hata hivyo, moduli asilia ya runtime husafirisha jozi zilizoundwa awali (prebuilt binaries) kwa ajili ya Node 24 na 25 pekee (kufikia Septemba 2026). Badala ya kukusanya chochote — ambacho kwenye Windows kinamaanisha kusakinisha Visual Studio — Zinnector® huleta Node 24 kwa ajili ya runtime pekee, takriban MB 30, iliyothibitishwa dhidi ya checksums ambazo nodejs.org huchapisha, kwenye kache hiyo hiyo. Ujumbe wa usakinishaji hueleza hivyo wakati inapotumika. Hakuna kinachobadilika kuhusu Node yako mwenyewe.
Zinazohusiana