Erorile pe care utilizatorii le întâmpină efectiv cu interfața CLI Zinnector®, semnificația fiecăreia și remedierea acestora. Fiecare intrare menționează textul exact pe care îl veți vedea, astfel încât să îl puteți căuta în această pagină. Dacă a dumneavoastră nu se află aici, rulați comanda care eșuează cu ZINNECTOR_DEBUG=1 și deschideți un tichet la github.com/Zinn-Digital/zinnector/issues cu rezultatul afișat, versiunea dumneavoastră de node --version și sistemul dumneavoastră de operare.
„spawn EINVAL” imediat după acceptarea instalării runtime-ului (Windows)
O eroare în Zinnector® 0.1.0 și 0.1.1. Pe Windows, programul de instalare a runtime-ului a rulat npm.cmd după nume, iar Node a refuzat să creeze un proces derivat pentru un fișier .cmd fără un shell încă de la remedierea pentru CVE-2024-27980 — astfel încât instalarea s-a întrerupt neașteptat la o secundă după ce ați răspuns cu Y. Remediat în 0.1.2: npm este rulat acum ca node npm-cli.js, ceea ce este identic pe orice platformă și nu necesită un shell. Rulați npm install -g zinnector@latest, apoi din nou zinnector dev.
„npm WARN EBADENGINE” în timpul instalării, sau „Zinnector® needs Node 24 or newer”
Versiunea dumneavoastră de Node este mai veche de 24. npm afișează avertismentul deoarece pachetul declară engines: >=24.18.1; instalarea se finalizează oricum, dar zinnector refuză ulterior să pornească (cod de ieșire 78) în loc să eșueze undeva mai târziu într-un mod derutant. Instalați versiunea LTS curentă de la nodejs.org — winget install OpenJS.NodeJS.LTS pe Windows, brew install node@24 pe macOS — confirmați că node --version afișează v24 sau o versiune superioară și instalați Zinnector® din nou.
„gyp ERR!”, „Building from source with node-gyp”, sau „You need to install Visual Studio”
Runtime-ul WordPress are un modul nativ ale cărui fișiere binare precompilate există doar pentru Node 24 și 25. Pe o versiune Node mai nouă (26 și peste, începând cu septembrie 2026), programul său de instalare revine la compilarea din sursă, ceea ce pe o mașină Windows simplă se încheie cu o solicitare pentru Visual Studio. Remediat în 0.1.2: Zinnector® detectează acest lucru înainte de a descărca ceva și preia o versiune Node 24 exclusiv pentru runtime — aproximativ 30 MB, verificată pe baza sumelor de control de pe nodejs.org — astfel încât nimic nu este compilat vreodată. Dacă încă vedeți acest mesaj după actualizare, rulați zinnector dev --reset-runtime pentru ca instalarea pe jumătate finalizată de dinainte să fie eliminată mai întâi.
Avertismente „EPERM” de la npm în timpul curățării (Windows)
Aproape întotdeauna un scaner antivirus sau un indexator de căutare care ține un fișier deschis în directorul node_modules al runtime-ului în timp ce npm încearcă să îl elimine. Instalarea este reîncercată dintr-un director curat la următoarea rulare zinnector dev; dacă problema persistă, zinnector dev --reset-runtime elimină mai întâi întregul director al runtime-ului și instalează din nou.
„the local playground runtime could not be installed”
Mesajul include ultimele linii afișate de npm și comanda exactă rulată de Zinnector®, astfel încât să o puteți rula dumneavoastră și să vedeți rezultatul complet. Cauzele obișnuite sunt o problemă de rețea sau de proxy — runtime-ul este preluat folosind propriul dumneavoastră npm, așadar npm config set proxy … și un mirror de registry se aplică — sau o instalare anterioară finalizată parțial, pe care --reset-runtime o elimină.
„the local playground exited before it was ready”, sau acesta nu devine niciodată pregătit
Rulați zinnector dev --verbose pentru a vedea rezultatul propriu al runtime-ului. Un port deja utilizat este cauza frecventă: zinnector dev --port 9401, sau setați port în zinnector.json. Un runtime care s-a instalat, dar nu vrea să pornească: zinnector dev --reset-runtime. Prima pornire descarcă, de asemenea, WordPress în sine, așa că, dacă aveți o conexiune lentă, acordați-i câteva minute; CLI-ul așteaptă până la cinci minute înainte de a raporta o expirare a timpului, în loc să se blocheze.
„this project is not a git repository” la comanda push
Implementările sunt gestionate dintr-un depozit, prin urmare zinnector push necesită unul cu un server la distanță pe care platforma îl poate accesa. Rulați git init && git add -A && git commit -m initial, adăugați serverul dumneavoastră la distanță GitHub sau GitLab, apoi zinnector link pentru a-l conecta la site.
Site-ul afișează o pagină albă după o implementare
Rulați zinnector check. În nouă din zece cazuri este vorba despre o discrepanță de versiune PHP — ați compilat pe o versiune PHP mai nouă decât cea pe care o rulează slotul — iar raportul indică la ce versiune să comutați slotul cu zinnector php <version>, sau pentru care să dezvoltați cu zinnector dev --php <version>. zinnector logs --error afișează eroarea fatală propriu-zisă.
Conexe