Zinnector® nasazluqlarının aradan qaldırılması

İnsanların Zinnector® CLI ilə qarşılaşdıqları faktiki xətalar, hər birinin mənası və həlli. Hər bir qeyd görəcəyiniz dəqiq mətni ehtiva edir ki, bu səhifədə onu axtara biləsiniz. Əgər sizinki burada yoxursa, xəta verən əmri ZINNECTOR_DEBUG=1 ilə işə salın və çıxış məlumatı, node --version və əməliyyat sisteminizlə birlikdə github.com/Zinn-Digital/zinnector/issues ünvanında məsələ (issue) açın.

İşləmə mühitinin (runtime) quraşdırılmasını qəbul etdikdən dərhal sonra "spawn EINVAL" (Windows)

Zinnector® 0.1.0 və 0.1.1 versiyalarındakı səhv. Windows-da işləmə mühitinin quraşdırıcısı npm.cmd faylını adıyla işə salırdı və Node CVE-2024-27980 üçün düzəlişindən bəri qabıq (shell) olmadan .cmd faylını işə salmaqdan imtina edir — ona görə də quraşdırma siz Y cavabını verdikdən bir saniyə sonra qəza ilə dayandı. 0.1.2 versiyasında düzəldilib: npm artıq hər platformada eyni olan və qabıq tələb etməyən node npm-cli.js kimi işlədilir. npm install -g zinnector@latest əmrini, ardınca isə yenidən zinnector dev əmrini icra edin.

Quraşdırma zamanı "npm WARN EBADENGINE" və ya "Zinnector® needs Node 24 or newer"

Node versiyanız 24-dən köhnədir. Paketin engines: >=24.18.1 bəyan etməsinə görə npm xəbərdarlıq çap edir; quraşdırma yenə də başa çatır, lakin sonradan çaşdırıcı bir yerdə uğursuz olmaq əvəzinə zinnector işə düşməkdən imtina edir (çıxış kodu 78). Cari LTS versiyasını nodejs.org saytından quraşdırın — Windows-da winget install OpenJS.NodeJS.LTS, macOS-da brew install node@24 — node --version əmrinin v24 və ya daha yüksək versiya çap etdiyini yoxlayın və Zinnector®-u yenidən quraşdırın.

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

WordPress işləmə mühitinin yalnız Node 24 və 25 üçün əvvəlcədən yığılmış ikili faylları (binaries) mövcud olan yerli modulu var. Daha yeni Node versiyasında (2026-cı ilin sentyabr ayına olan məlumata görə 26 və yuxarı) onun quraşdırıcısı mənbədən (source) komilyasiya etməyə keçir ki, bu da adi Windows kompüterində Visual Studio tələbi ilə nəticələnir. 0.1.2 versiyasında düzəldilib: Zinnector® hər hansı bir şeyi yükləməzdən əvvəl bunu aşkar edir və yalnız işləmə mühiti üçün Node 24-ü əldə edir — təxminən 30 MB, nodejs.org-un checksum dəyərləri ilə yoxlanılır — ona görə də heç nə heç vaxt komilyasiya olunmur. Əgər yeniləmədən sonra hələ də bunu görürsünüzsə, əvvəlki yarıçıq quraşdırmanın ləğv edilməsi üçün zinnector dev --reset-runtime əmrini icra edin.

Təmizləmə zamanı npm-dən gələn "EPERM" xəbərdarlıqları (Windows)

Demək olar ki, həmişə npm onu silməyə çalışarkən işləmə mühitinin node_modules qovluğu altındakı faylı açıq saxlayan antivirus skaneri və ya axtarış indeksləyicisidir. Növbəti zinnector dev zamanı quraşdırma təmiz qovluqdan yenidən cəhd edilir; əgər bu, təkrarlanmağa davam edərsə, zinnector dev --reset-runtime əmri əvvəlcə bütün işləmə mühiti qovluğunu silir və yenidən quraşdırır.

"the local playground runtime could not be installed"

Mesaj npm-in özünün son sətirlərini və Zinnector®-un icra etdiyi dəqiq əmri ehtiva edir ki, onu özünüz işə salıb tam çıxışı görə biləsiniz. Adətən səbəb şəbəkə və ya proksi problemidir — işləmə mühiti sizin öz npm-inizlə əldə edilir, buna görə də npm config set proxy … və reyestr güzgüsü (registry mirror) tətbiq olunur — yaxud --reset-runtime vasitəsilə təmizlənən yarıçıq əvvəlki quraşdırmadır.

"the local playground exited before it was ready" və ya onun heç vaxt hazıra çevrilməməsi

İşləmə mühitinin öz çıxışını görmək üçün zinnector dev --verbose əmrini icra edin. İstifadə olunan portun artıq məşğul olması ümumi səbəblərdəndir: zinnector dev --port 9401 və ya zinnector.json faylında port təyin edin. Quraşdırılmış, lakin yüklənməyəcək işləmə mühiti: zinnector dev --reset-runtime. İlk yükləmə həm də WordPress-in özünü endirir, ona görə də yavaş əlaqədə bir neçə dəqiqə gözləyin; CLI fasilə vermək əvəzində vaxtaşımı (timeout) bildirənə qədər beş dəqiqəyə qədər gözləyir.

Göndərmə (push) zamanı "this project is not a git repository"

Deploy-lar repozitoriyadan idarə olunur, buna görə də zinnector push platformanın çata biləcəyi uzaq (remote) ünvanı olan repozitoriya tələb edir. git init && git add -A && git commit -m initial əmrlərini icra edin, GitHub və ya GitLab uzaq ünvanınızı əlavə edin, daha sonra sayta qoşmaq üçün zinnector link əmrini işlədin.

Deploy-dan sonra sayt ağ rəngdədir

zinnector check əmrini icra edin. On haldan doqquzunda bu, PHP versiyasının uyğunsuzluğudur — siz slotun işlədiyindən daha yeni PHP-də yaratmısınız — və hesabat slotun zinnector php <version> ilə hansı versiyaya keçirilməli olduğunu və ya zinnector dev --php <version> ilə hansına qarşı işlənilməli olduğunu göstərir. zinnector logs --error kritik xətanın özünü göstərir.

Əlaqəli

• Başlanğıc · Yerli işlənmə · Deploy etmə · Əmr arayışı