Baza znanja
Rješavanje problema s Zinnector®
Pogreške na koje ljudi zapravo nailaze s Zinnector CLI-jem i rješenje za svaku: spawn EINVAL na sustavu Windows, npm-ovo upozorenje EBADENGINE, node-gyp koji traži Visual Studio na verziji Node 26, EPERM tijekom instalacije, okruženje za izvođenje koje se ne želi pokrenuti i zauzet port.
Pogreške s kojima se korisnici zapravo susreću pri korištenju Zinnector® CLI-ja, značenje svake od njih i rješenje. Svaki unos navodi točan tekst koji ćete vidjeti, tako da ga možete potražiti na ovoj stranici. Ako se vaš problem ovdje ne nalazi, pokrenite naredbu koja uzrokuje pogrešku s ZINNECTOR_DEBUG=1 i otvorite problem na github.com/Zinn-Digital/zinnector/issues s ispisom, vašom naredbom node --version i vašim operativnim sustavom.
"spawn EINVAL" odmah nakon prihvaćanja instalacije okruženja za izvršavanje (Windows)
Pogreška u verzijama Zinnector® 0.1.0 i 0.1.1. Na sustavu Windows instalacijski program okruženja pokretao je npm.cmd prema nazivu, a Node odbija pokrenuti datoteku .cmd bez ljuske (shell) od svog ispravka za CVE-2024-27980 — stoga se instalacija srušila sekundu nakon što ste odgovorili s Y. Ispravljeno u verziji 0.1.2: npm se sada pokreće kao node npm-cli.js, što je jednako na svakoj platformi i ne zahtijeva ljusku. Pokrenite npm install -g zinnector@latest, a zatim ponovno zinnector dev.
"npm WARN EBADENGINE" tijekom instalacije ili "Zinnector® needs Node 24 or newer"
Vaša verzija sustava Node starija je od 24. npm prikazuje upozorenje jer paket deklarira engines: >=24.18.1; instalacija ipak završava, ali se zinnector tada odbija pokrenuti (izlazni kod 78) umjesto da kasnije negdje propadne uz zbunjujuću poruku. Instalirajte trenutnu LTS verziju s nodejs.org — winget install OpenJS.NodeJS.LTS na sustavu Windows, brew install node@24 na sustavu macOS — provjerite ispisuje li node --version v24 ili noviju verziju te ponovno instalirajte Zinnector®.
"gyp ERR!", "Building from source with node-gyp" ili "You need to install Visual Studio"
WordPress okruženje sadrži izvorni modul čiji unaprijed izgrađeni binarni elementi postoje samo za Node 24 i 25. Na novijoj verziji sustava Node (26 i novijim, od rujna 2026.) njegov instalacijski program se vraća na kompajliranje iz izvornog koda, što na običnom Windows računalu završava zahtjevom za Visual Studio. Ispravljeno u verziji 0.1.2: Zinnector® to detektira prije preuzimanja bilo čega i dohvaća Node 24 samo za okruženje — oko 30 MB, potvrđeno prema kontrolnim zbrojevima s web-mjesta nodejs.org — tako da se nikada ništa ne kompajlira. Ako to i dalje vidite nakon nadogradnje, pokrenite zinnector dev --reset-runtime kako bi se prethodna poluzavršena instalacija najprije odbacila.
Upozorenja "EPERM" iz npm-a tijekom čišćenja (Windows)
Gotovo uvijek se radi o antivirusnom skeneru ili indekseru pretraživanja koji drži datoteku otvorenom unutar direktorija node_modules okruženja dok je npm pokušava ukloniti. Instalacija se ponovno pokušava izvesti iz čistog direktorija prilikom sljedećeg pokretanja naredbe zinnector dev; ako se to nastavi događati, zinnector dev --reset-runtime najprije uklanja cijeli direktorij okruženja i ponovno ga instalira.
"the local playground runtime could not be installed"
Poruka uključuje posljednje retke samog npm-a i točnu naredbu koju je Zinnector® pokrenuo, tako da je možete sami pokrenuti i vidjeti cijeli ispis. Uobičajeni uzroci su problemi s mrežom ili proxyjem — okruženje se dohvaća s vašim vlastitim npm-om, pa se primjenjuju naredbe poput npm config set proxy … i zrcalna registracija (registry mirror) — ili poluzavršena ranija instalacija koju naredba --reset-runtime briše.
"the local playground exited before it was ready" ili okruženje nikada ne postane spremno
Pokrenite zinnector dev --verbose kako biste vidjeli izlazni ispis samog okruženja. Port koji se već koristi čest je uzrok: upotrijebite zinnector dev --port 9401 ili postavite port u datoteci zinnector.json. Okruženje koje se instaliralo, ali se ne želi pokrenuti: zinnector dev --reset-runtime. Prvo pokretanje također preuzima sam WordPress, pa mu na sporoj vezi dajte nekoliko minuta; CLI čeka do pet minuta prije nego što prijavi istek vremena (timeout) umjesto da se blokira.
"this project is not a git repository" prilikom slanja (push)
Nacrti (deploys) pokreću se iz repozitorija, stoga zinnector push zahtijeva repozitorij s udaljenom lokacijom (remote) koju platforma može dosegnuti. git init && git add -A && git commit -m initial, dodajte svoju GitHub ili GitLab udaljenu lokaciju, a zatim zinnector link kako biste je povezali sa web-mjestom.
Web-mjesto je bijelo nakon primjene nacrta (deploy)
Pokrenite zinnector check. U devet od deset slučajeva radi se o razlici u verziji PHP-a — gradili ste na novijoj verziji PHP-a nego što je ona na kojoj utor radi — a izvješće govori na koju verziju trebate prebaciti utor pomoću zinnector php <version> ili protiv koje verzije trebate razvijati pomoću zinnector dev --php <version>. zinnector logs --error prikazuje samu kobnu pogrešku (fatal).
Povezano
Još uvijek zapeli?
Podrška je uključena u svaki paket i odgovori stižu na vašem jeziku.
Kontaktirajte podršku → Svi članci →