Otklanjanje poteškoća s uslugom Zinnector®

Pogreške s kojima se korisnici doista susreću u CLI-ju Zinnector®, što svaka od njih znači i kako ih riješiti. Svaki unos navodi točan tekst koji ćete vidjeti, tako da ga možete potražiti na ovoj stranici. Ako vaša pogreška nije ovdje, pokrenite naredbu koja javlja pogrešku uz ZINNECTOR_DEBUG=1 i otvorite prijavu poteškoće na github.com/Zinn-Digital/zinnector/issues s ispisom, vašom verzijom node --version i vašim operacijskim sustavom.

„spawn EINVAL” odmah nakon prihvaćanja instalacije runtimea (Windows)

Programska pogreška u izdanjima Zinnector® 0.1.0 i 0.1.1. Na sustavu Windows instalacijski program runtimea pokretao je npm.cmd po imenu, a Node odbija pokrenuti datoteku .cmd bez ljuske od svojeg popravka za CVE-2024-27980 — stoga se instalacija prekinula jednu 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š Node stariji je od verzije 24. npm ispisuje upozorenje jer paket definira engines: >=24.18.1; instalacija se svejedno dovršava, ali zinnector se zatim odbija pokrenuti (izlazni kod 78) umjesto da poslije zakaže uz zbunjujuću pogrešku. Instalirajte trenutačnu 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 verziju v24 ili noviju i ponovno instalirajte Zinnector®.

„gyp ERR!”, „Building from source with node-gyp” ili „You need to install Visual Studio”

Runtime za WordPress sadrži nativni modul čije unaprijed izgrađene binarne datoteke postoje samo za Node 24 i 25. Na novijem Nodeu (26 i noviji, od rujna 2026.) njegov instalacijski program prebacuje se na kompajliranje iz izvornog koda, što na standardnom računalu sa sustavom Windows završava zahtjevom za instalaciju alata Visual Studio. Ispravljeno u verziji 0.1.2: Zinnector® to prepoznaje prije preuzimanja i dohvaća Node 24 samo za runtime — oko 30 MB, provjereno prema kontrolnim zbrojevima sa stranice nodejs.org — tako da se ništa ne mora kompajlirati. Ako se to i dalje pojavljuje nakon nadogradnje, pokrenite zinnector dev --reset-runtime kako bi se prvo odbacila napola dovršena instalacija od ranije.

„EPERM” upozorenja alata npm tijekom čišćenja (Windows)

Gotovo uvijek antivirusni program ili indeksator pretraživanja drži datoteku otvorenom unutar direktorija node_modules runtimea dok je npm pokušava ukloniti. Instalacija se ponovno pokušava iz čistog direktorija pri sljedećem pokretanju naredbe zinnector dev; ako se to nastavi događati, zinnector dev --reset-runtime prvo uklanja cijeli direktorij runtimea i ponovno pokreće instalaciju.

„the local playground runtime could not be installed”

Poruka uključuje zadnje retke samog alata npm i točnu naredbu koju je Zinnector® pokrenuo, tako da je možete sami pokrenuti i vidjeti cijeli ispis. Uobičajeni uzroci su mrežni problem ili problem s proxyjem — runtime se dohvaća putem vašeg alata npm, pa se primjenjuju postavke npm config set proxy … i zrcalni poslužitelj registra — ili napola dovršena ranija instalacija koju --reset-runtime briše.

„the local playground exited before it was ready” ili se nikada ne pripremi za rad

Pokrenite zinnector dev --verbose kako biste vidjeli vlastiti ispis runtimea. Priključak koji se već koristi čest je uzrok: upotrijebite zinnector dev --port 9401 ili postavite port u datoteci zinnector.json. Za runtime koji se instalirao, ali se ne želi pokrenuti: zinnector dev --reset-runtime. Prvo pokretanje ujedno preuzima i sam WordPress, pa na sporoj vezi pričekajte nekoliko minuta; CLI čeka do pet minuta prije prijave isteka vremena umjesto da se blokira.

„this project is not a git repository” pri slanju (push)

Uvođenja se pokreću iz repozitorija, stoga zinnector push zahtijeva repozitorij s udaljenim poslužiteljem kojem platforma može pristupiti. Pokrenite git init && git add -A && git commit -m initial, dodajte svoj GitHub ili GitLab udaljeni poslužitelj, a zatim pokrenite zinnector link kako biste ga povezali sa stranicom.

Stranica prikazuje prazan bijeli zaslon nakon uvođenja

Pokrenite zinnector check. U devet od deset slučajeva riječ je o nepodudaranju verzije PHP-a — gradili ste na novijoj verziji PHP-a od one koju utor pokreće — a izvještaj navodi na koju verziju trebate prebaciti utor pomoću zinnector php <version> ili za koju trebate razvijati pomoću zinnector dev --php <version>. Naredba zinnector logs --error prikazuje samu fatalnu pogrešku.

Povezano

• Početak rada · Lokalni razvoj · Uvođenje · Pregled naredbi