Ang mga error na aktuwal na nararanasan ng mga tao sa Zinnector® CLI, ang kahulugan ng bawat isa, at ang solusyon. Tinutukoy ng bawat entry ang eksaktong text na makikita mo, upang mahanap mo ito sa pahinang ito. Kung wala rito ang sa iyo, patakbuhin ang nabigong command nang may ZINNECTOR_DEBUG=1 at magbukas ng issue sa github.com/Zinn-Digital/zinnector/issues kasama ang output, ang iyong node --version, at ang iyong operating system.
"spawn EINVAL" pagkatapos na pagkatapos tanggapin ang pag-install ng runtime (Windows)
Isang bug sa Zinnector® 0.1.0 at 0.1.1. Sa Windows, pinatakbo ng runtime installer ang npm.cmd ayon sa pangalan, at tumatanggi ang Node na mag-spawn ng .cmd na file nang walang shell mula noong pag-aayos nito para sa CVE-2024-27980 — kaya nag-crash ang pag-install isang segundo pagkatapos mong sumagot ng Y. Naayos sa 0.1.2: pinapatakbo na ngayon ang npm bilang node npm-cli.js, na pareho sa bawat platform at hindi nangangailangan ng shell. Patakbuhin ang npm install -g zinnector@latest, pagkatapos ay zinnector dev muli.
"npm WARN EBADENGINE" habang nag-i-install, o "Zinnector® needs Node 24 or newer"
Mas luma sa 24 ang iyong Node. Ipinapakita ng npm ang babala dahil ipinapahayag ng package ang engines: >=24.18.1; natatapos pa rin ang pag-install, ngunit tatanggi ang zinnector na magsimula (exit code 78) sa halip na mabigo sa nakakalitong paraan sa ibang pagkakataon. I-install ang kasalukuyang LTS mula sa nodejs.org — winget install OpenJS.NodeJS.LTS sa Windows, brew install node@24 sa macOS — kumpirmahing nagpapakita ang node --version ng v24 o mas mataas, at i-install muli ang Zinnector®.
"gyp ERR!", "Building from source with node-gyp", o "You need to install Visual Studio"
Mayroong native module ang WordPress runtime na ang mga prebuilt binary ay umiiral lamang para sa Node 24 at 25. Sa mas bagong Node (26 pataas, simula noong Setyembre 2026), nagbabalik ang installer nito sa pag-compile mula sa source, na sa isang karaniwang Windows machine ay nagtatapos sa kahilingan para sa Visual Studio. Naayos sa 0.1.2: Natutukoy ito ng Zinnector® bago mag-download ng anuman at kumukuha ito ng Node 24 para sa runtime lamang — humigit-kumulang 30 MB, na na-verify laban sa mga checksum ng nodejs.org — kaya walang kailanman kino-compile. Kung nakikita mo pa rin ito pagkatapos mag-upgrade, patakbuhin ang zinnector dev --reset-runtime upang itapon muna ang kalahating tapos na pag-install mula dati.
Mga babalang "EPERM" mula sa npm habang naglilinis ito (Windows)
Halos palaging isang antivirus scanner o isang search indexer ang nagpapanatiling nakabukas sa isang file sa ilalim ng node_modules ng runtime habang sinusubukan itong alisin ng npm. Sinusubukang muli ang pag-install mula sa isang malinis na directory sa susunod na zinnector dev; kung patuloy itong nangyayari, aalisin muna ng zinnector dev --reset-runtime ang buong directory ng runtime at mag-i-install muli.
"the local playground runtime could not be installed"
Kasama sa mensahe ang sariling mga huling linya ng npm at ang eksaktong command na pinatakbo ng Zinnector®, upang mapatakbo mo ito mismo at makita ang buong output. Ang karaniwang mga sanhi ay problema sa network o proxy — kinukuha ang runtime gamit ang iyong sariling npm, kaya nalalapat ang npm config set proxy … at isang registry mirror — o isang kalahating tapos na naunang pag-install, na nililinis ng --reset-runtime.
"the local playground exited before it was ready", o hindi ito kailanman nagiging handa
Patakbuhin ang zinnector dev --verbose upang makita ang sariling output ng runtime. Ang isang port na ginagamit na ang karaniwang dahilan: zinnector dev --port 9401, o itakda ang port sa zinnector.json. Isang runtime na na-install ngunit hindi mag-boot: zinnector dev --reset-runtime. Dina-download din sa unang pag-boot ang WordPress mismo, kaya sa isang mabagal na koneksyon, bigyan ito ng ilang minuto; naghihintay ang CLI nang hanggang limang minuto bago mag-ulat ng timeout sa halip na mag-hang.
"this project is not a git repository" sa pag-push
Pinapagana mula sa isang repository ang mga pag-deploy, kaya nangangailangan ang zinnector push ng isa na may remote na maaabot ng platform. git init && git add -A && git commit -m initial, idagdag ang iyong GitHub o GitLab remote, pagkatapos ay zinnector link upang ikonekta ito sa site.
Puti ang site pagkatapos ng pag-deploy
Patakbuhin ang zinnector check. Siyam sa sampung beses ay isa itong agwat sa bersyon ng PHP — nag-build ka sa mas bagong PHP kaysa sa pinapatakbo ng slot — at sinasabi ng ulat kung aling bersyon ililipat ang slot gamit ang zinnector php <version>, o kung alin ang gagamitin sa pag-develop gamit ang zinnector dev --php <version>. Ipinapakita ng zinnector logs --error ang fatal error mismo.
Kaugnay