Zinnector® muammolarini bartaraf qilish

Odamlar Zinnector® CLI bilan duch keladigan haqiqiy xatolar, ularning har biri nimani anglatishi va tuzatish usuli. Har bir bandda siz koʻradigan aniq matn koʻrsatilgan, shuning uchun uni ushbu sahifadan qidirishingiz mumkin. Agar sizdagi xato bu yerda boʻlmasa, ishlamayotgan buyruqni ZINNECTOR_DEBUG=1 bilan bajaring va github.com/Zinn-Digital/zinnector/issues manzilida chiqish natijasi, node --version maʼlumotingiz hamda operatsion tizimingizni koʻrsatgan holda muammo (issue) oching.

Ish vaqti muhitini (runtime) oʻrnatishga rozilik bergandan soʻng darhol "spawn EINVAL" xatosi (Windows)

Zinnector® 0.1.0 va 0.1.1 versiyalaridagi xatolik. Windows tizimida runtime oʻrnatuvchisi npm.cmd ni nomi orqali ishga tushirgan va Node CVE-2024-27980 tuzatilishidan beri qobiqsiz (shell) .cmd faylini ishga tushirishdan bosh tortib keladi — shu sababli Y deb javob berganingizdan bir soniya oʻtib oʻrnatish toʻxtab qolgan. 0.1.2 versiyasida tuzatildi: npm endi node npm-cli.js sifatida ishga tushiriladi, bu barcha platformalarda bir xil va qobiqni talab qilmaydi. npm install -g zinnector@latest buyrugʻini bajaring, soʻngra yana zinnector dev buyrugʻini ishga tushiring.

Oʻrnatish vaqtida "npm WARN EBADENGINE", yoki "Zinnector® needs Node 24 or newer"

Sizdagi Node versiyasi 24 dan eski. Paketda engines: >=24.18.1 deb koʻrsatilgani sababli npm ogohlantirish chiqaradi; oʻrnatish baribir yakunlanadi, biroq zinnector keyinroq tushunarsiz joyda xato berish oʻrniga ishga tushishdan bosh tortadi (chiqish kodi 78). nodejs.org saytidan joriy LTS versiyasini oʻrnating — Windows uchun winget install OpenJS.NodeJS.LTS, macOS uchun brew install node@24 — node --version buyrugʻi v24 yoki undan yuqori natijani koʻrsatayotganini tasdiqlang va Zinnector® dasturini qaytadan oʻrnating.

"gyp ERR!", "Building from source with node-gyp", yoki "You need to install Visual Studio"

WordPress runtime muhitida faqat Node 24 va 25 uchun oldindan tuzilgan (prebuilt) binar fayllarga ega native modul mavjud. Yangiroq Node versiyalarida (2026-yil sentabr holatiga koʻra 26 va undan yuqori) uning oʻrnatuvchisi dastlabki koddan kompilyatsiya qilishga oʻtadi, bu esa oddiy Windows mashinasida Visual Studio talab qilinishi bilan tugaydi. 0.1.2 versiyasida tuzatildi: Zinnector® hech narsani yuklab olishdan oldin buni aniqlaydi va faqat runtime uchun alohida Node 24 ni yuklab oladi — taxminan 30 MB, nodejs.org ning nazorat summalari (checksums) orqali tekshiriladi — shuning uchun hech narsa kompilyatsiya qilinmaydi. Agar yangilaganingizdan keyin ham bu xatoni koʻrsangiz, oldingi chala qolgan oʻrnatish avval tashlab yuborilishi uchun zinnector dev --reset-runtime buyrugʻini ishga tushiring.

Tozalash vaqtida npm tomonidan "EPERM" ogohlantirishlari (Windows)

npm faylni oʻchirishga urinayotgan vaqtda, deyarli har doim antivirus skaneri yoki qidiruv indeksatori runtimeʼning node_modules katalogidagi faylni ochiq ushlab turgan boʻladi. Keyingi zinnector dev buyrugʻida oʻrnatish toza katalogdan qayta urinib koʻriladi; agar bu holat takrorlanaversa, zinnector dev --reset-runtime avval butun runtime katalogini oʻchirib tashlaydi va qaytadan oʻrnatadi.

"the local playground runtime could not be installed"

Xabarda npmʼning shaxsiy oxirgi satrlari va Zinnector® bajargan aniq buyruq keltiriladi, shuning uchun uni oʻzingiz ishga tushirib, toʻliq chiqish natijasini koʻrishingiz mumkin. Odatdagi sabablar — tarmoq yoki proksi muammosi (runtime shaxsiy npm dasturingiz yordamida yuklab olinadi, shuning uchun npm config set proxy … va registrlash oynasi sozlamalari qoʻllaniladi) yoki avvalgi chala qolgan oʻrnatishdir, buni --reset-runtime tozalaydi.

"the local playground exited before it was ready", yoki u hech qachon tayyor holatga kelmaydi

Runtimeʼning shaxsiy chiqish natijasini koʻrish uchun zinnector dev --verbose buyrugʻini ishga tushiring. Eng koʻp uchraydigan holat — portning allaqachon bandligi: zinnector dev --port 9401 buyrugʻidan foydalaning yoki zinnector.json faylida port qiymatini belgilang. Oʻrnatilgan, lekin yuklanmayotgan runtime uchun: zinnector dev --reset-runtime. Birinchi ishga tushirishda WordPressʼning oʻzi ham yuklab olinadi, shuning uchun sekin ulanishda bir necha daqiqa kuting; CLI qotib qolmasdan, kutish vaqti tugaganligi (timeout) haqida xabar berishdan oldin besh daqiqagacha kutadi.

Push paytida "this project is not a git repository"

Deploy qilish jarayoni repozitoriydan boshqariladi, shuning uchun zinnector push platforma ulana oladigan masofaviy repozitoriyga ega tizimni talab qiladi. git init && git add -A && git commit -m initial buyruqlarini bajaring, GitHub yoki GitLab masofaviy repozitoriyingizni qoʻshing, soʻngra uni saytga bogʻlash uchun zinnector link buyrugʻini bering.

Deploydan soʻng sayt oq rangda (boʻsh) boʻlib qoladi

zinnector check buyrugʻini ishga tushiring. Oʻntadan toʻqqizta holatda bu PHP versiyalari orasidagi tafovutdir — siz slotdagi ishlayotgan versiyadan yangiroq PHPʼda tuzgansiz — va hisobot slotni zinnector php <version> orqali qaysi versiyaga oʻtkazish kerakligini yoki zinnector dev --php <version> orqali qaysi versiyada ishlab chiqish kerakligini koʻrsatadi. zinnector logs --error kritik xatoning oʻzini koʻrsatadi.

Tegishli

• Ishni boshlash · Mahalliy ishlab chiqish · Deploy qilish · Buyruqlar maʼlumotnomasi