Baza e njohurive
Zgjidhja e problemeve me Zinnector®
Gabimet me të cilat njerëzit ndeshen realisht me Zinnector CLI dhe zgjidhja për secilin: spawn EINVAL në Windows, paralajmërimi EBADENGINE i npm, node-gyp që kërkon Visual Studio në Node 26, EPERM gjatë instalimit, një mjedis ekzekutimi që nuk niset dhe një portë e zënë.
Gabimet me të cilat përdoruesit përballen realisht me CLI-në e Zinnector®, çdo kuptim i tyre dhe zgjidhja. Çdo hyrje përmend tekstin e saktë që do të shihni, kështu që ju mund të kërkoni në këtë faqe për të. Nëse e juaja nuk është këtu, ekzekutoni komandën me gabim me ZINNECTOR_DEBUG=1 dhe hapni një çështje në github.com/Zinn-Digital/zinnector/issues me daljen, versionin tuaj node --version dhe sistemin tuaj operativ.
"spawn EINVAL" menjëherë pas pranimit të instalimit të kohës së ekzekutimit (Windows)
Një gabim në Zinnector® 0.1.0 dhe 0.1.1. Në Windows, instaluesi i kohës së ekzekutimit ekzekutoi npm.cmd sipas emrit, dhe Node ka refuzuar të nisë një skedar .cmd pa një guaskë (shell) që nga rregullimi i tij për CVE-2024-27980 — kështu që instalimi u rrëzua një sekondë pasi jeni përgjigjur Y. I rregulluar në 0.1.2: npm tani ekzekutohet si node npm-cli.js, i cili është i njëjtë në çdo platformë dhe nuk ka nevojë për guaskë. Ekzekutoni npm install -g zinnector@latest, pastaj përsëri zinnector dev.
"npm WARN EBADENGINE" gjatë instalimit, ose "Zinnector® needs Node 24 or newer"
Nyja juaj (Node) është më e vjetër se 24. npm shfaq paralajmërimin sepse paketimi deklaron engines: >=24.18.1; instalimi përfundon gjithsesi, por më pas zinnector refuzon të niset (kodi i daljes 78) në vend që të dështojë diku tjetër më vonë që mund t'ju ngatërrojë. Instaloni LTS-në aktuale nga nodejs.org — winget install OpenJS.NodeJS.LTS në Windows, brew install node@24 në macOS — konfirmoni se node --version shfaq v24 ose më të lartë, dhe instaloni përsëri Zinnector®.
"gyp ERR!", "Building from source with node-gyp", ose "You need to install Visual Studio"
Koha e ekzekutimit WordPress ka një modul vendas binaret e të cilit të parafabrikuara ekzistojnë vetëm për Node 24 dhe 25. Në një Node më të ri (26 e lart, që nga shtatori 2026) instaluesi i tij kthehet te kompilimi nga burimi, i cili në një makinë të thjeshtë Windows përfundon me një kërkesë për Visual Studio. I rregulluar në 0.1.2: Zinnector® e zbulon këtë para se të shkarkojë ndonjë gjë dhe merr një Node 24 vetëm për kohën e ekzekutimit — rreth 30 MB, të verifikuara kundrejt shumave kontrolluese (checksums) të nodejs.org — kështu që asgjë nuk kompiolohet kurrë. Nëse e shihni ende pasi ta keni përditësuar, ekzekutoni zinnector dev --reset-runtime në mënyrë që instalimi i përgjysmëruar nga më parë të hiqet fillimisht.
Paralajmërimet "EPERM" nga npm ndërsa pastrohet (Windows)
Gati gjithmonë një skaner antivirusi ose një indeksues kërkimi që mban një skedar të hapur në node_modules të kohës së ekzekutimit ndërsa npm përpiqet ta fshijë atë. Instalimi provohet sërish nga një direktorisht e pastër në zinnector dev të radhës; nëse vazhdon të ndodhë, zinnector dev --reset-runtime heq fillimisht të gjithë direktorinë e kohës së ekzekutimit dhe instalon përsëri.
"the local playground runtime could not be installed"
Mesazhi përfshin rreshtat e fundit të vetë npm-së dhe komandën e saktë që Zinnector® ekzekutoi, kështu që ju mund ta ekzekutoni vetë dhe të shihni daljen e plotë. Shkaqet e zakonshme janë një problem rrjeti ose prokurimi (proxy) — koha e ekzekutimit merret me npm-në tuaj, kështu që zbatohen npm config set proxy … dhe një pasqyrë regjistri (registry mirror) — ose një instalim i mëparshëm i përgjysmëruar, të cilin --reset-runtime e pastron.
"the local playground exited before it was ready", ose nuk bëhet kurrë gati
Ekzekutoni zinnector dev --verbose për të parë daljen e vetë kohës së ekzekutimit. Një portë që tashmë është në përdorim është ajo e zakonshmja: zinnector dev --port 9401, ose vendosni port në zinnector.json. Një kohë ekzekutimi që është instaluar por nuk ndizet: zinnector dev --reset-runtime. Ndezja e parë shkarkon gjithashtu vetë WordPress, kështu që në një lidhje të ngadaltë jepini disa minuta; CLI pret deri në pesë minuta përpara se të raportojë një kohë-mbarim (timeout) në vend që të bllokohet.
"this project is not a git repository" gjatë dërgimit (push)
Vendosjet (deploys) drejtohen nga një depo (repository), kështu që zinnector push ka nevojë për një të tillë me një distancore (remote) që platforma mund ta arrijë. git init && git add -A && git commit -m initial, shtoni distancoren tuaj GitHub ose GitLab, pastaj zinnector link për ta lidhur atë me faqen.
Faqja është e bardhë pas një vendosjeje (deploy)
Ekzekutoni zinnector check. Në nëntë nga dhjetë raste është një hendek i versionit PHP — keni ndërtuar në një PHP më të ri sesa ai që ekzekuton foleja (slot) — dhe raporti tregon se në cilin version duhet të kaloni foleja me zinnector php <version>, ose kundrejt cilit të zhvilloni me zinnector dev --php <version>. zinnector logs --error tregon vetë gabimin fatal.
Të ngjashme
Akoma ngecur?
Mbështetja përfshihet në çdo plan dhe përgjigjet vijnë në gjuhën tuaj.
Kontakto mbështetjen → Të gjithë artikujt →