Zinnector®-ын алдааг олж засварлах

Zinnector® CLI-г ашиглах явцад хүмүүсийн бодитойгоор тулгардаг алдаанууд, тэдгээр тус бүрийн утга, мөн тэдгээрийг хэрхэн засах тухай. Энэ хуудаснаас хайлт хийх боломжтой байх үүднээс оруулга бүрд танд харагдах яг тэр текстийг бичсэн болно. Хэрэв таны тулгарсан алдаа ээнд байхгүй бол алдаа гаргаж буй командыг ZINNECTOR_DEBUG=1 гэж тохируулаад ажиллуулан, гаралтын мэдээлэл, таны node --version болон үйлдлийн системийн мэдээллийн хамт github.com/Zinn-Digital/zinnector/issues хаягаар хандаж асуудал үүсгэнэ үү.

Ронтаймын суулгалтыг зөвшөөрсний дараа шууд гарч ирэх "spawn EINVAL" (Windows)

Zinnector® 0.1.0 болон 0.1.1 хувилбар дахь алдаа. Windows систем дээр ронтайм суулгагч нь npm.cmd-ийг нэрээр нь ажиллуулдаг байсан бөгөөд Node нь CVE-2024-27980 эмзэг байдлыг засварласнаасаа хойш shell-гүйгээр .cmd файлыг ажиллуулахаас татгалздаг болсон — иймд та Y гэж хариулснаас хойш яг нэг секундын дараа суулгалт гацсан байна. 0.1.2 хувилбарт засагдсан: npm одоо ямар ч платформ дээр ижилхэн ажилладаг бөгөөд shell шаарддаггүй node npm-cli.js хэлбэрээр ажилладаг болсон. npm install -g zinnector@latest командыг ажиллуулаад, дараа нь zinnector dev командаа дахин ажиллуулна уу.

Суул явцад гарч ирэх "npm WARN EBADENGINE" эсвэл "Zinnector® needs Node 24 or newer"

Таны Node-ын хувилбар 24-өөс доогуур байна. Уг багц нь engines: >=24.18.1 гэж зарласан тул npm энэ анхааруулгыг харуулдаг бөгөөд суулгалт ямар ч байсан дуусдаг боловч хожим нь ямар нэгэн ойлгомжгүй зүйл дээр алдаа гаргахаас сэргийлж zinnector дараа нь эхлэхээс татгалздаг (гарах код 78). nodejs.org сайтаас одоогийн LTS хувилбарыг суулгана уу — Windows дээр winget install OpenJS.NodeJS.LTS, macOS дээр brew install node@24 — мөн node --version командын үр дүнд v24 буюу түүнээс дээш хувилбар гарч ирж байгаа эсэхийг шалгаад, Zinnector®-оо дахин суулгана уу.

"gyp ERR!", "Building from source with node-gyp", эсвэл "You need to install Visual Studio"

WordPress ронтайм нь зөвхөн Node 24 болон 25 хувилбаруудад зориулсан урьдчилан бүтээсэн хоёртын файлууд (binaries) бүхий суурь модультай байдаг. Шинэ хувилбарын Node дээр (2026 оны 9 сарын байдлаар 26 болон түүнээс дээш) түүний суулгагч нь эх кодоос нь хөрвүүлэх горим руу шилждэг бөгөөд энэ нь энгийн Windows систем дээр Visual Studio суулгах хүсэлтээр төгсдөг. 0.1.2 хувилбарт засагдсан: Zinnector® ямар нэгэн зүйл татаж авахаасаа өмнө үүнийг илрүүлж, зөвхөн ронтаймд зориулж Node 24-ийг татаж авдаг — nodejs.org сайтаас шалгасан 30 орчим MB хэмжээтэй шалгах нийлбэр (checksum) бүхий файл — ингэснээр хэзээ ч ямар нэгэн зүйл хөрвүүлэгдэхгүй. Хэрэв шинэчилсний дараа ч гэсэн энэ алдаа гарсаар байвал zinnector dev --reset-runtime командыг ажиллуулж, өмнөх хагас дутуу суулгацыг эхлээд цэвэрлэнэ үү.

npm цэвэрлэгээ хийх явцад гарах "EPERM" анхааруулга (Windows)

Энэ нь ихэвчлэн антивирус сканнер эсвэл хайлтын индексжүүлэгч нь npm уг файлыг устгах гэж оролдох үед ронтаймын node_modules доторх файлыг нээлттэй барьж байснаас үүсдэг. Дараагийн zinnector dev команд ажиллах үед суулгалтыг цэвэр директороос дахин оролддог; хэрэв энэ байдал давтагдсаар байвал zinnector dev --reset-runtime команд нь ронтаймын бүх директорийг эхлээд устгаад дахин суулгадаг.

"the local playground runtime could not be installed"

Энэхүү мэдэгдэлд npm-ийн өөрийнх нь сүүлийн мөрүүд болон Zinnector®-ын аллуулсан яг тухайн команд багтдаг бөгөөд ингэснээр та өөрөө үүнийг ажиллуулж бүрэн үр дүнг нь харах боломжтой болно. Үүний шалтгаан нь ихэвчлэн сүлжээ эсвэл прокситой холбоотой асуудал байдаг — ронтайм нь таны өөрийн npm-ээр дамжин татагддаг тул npm config set proxy … болон реэстри толь (registry mirror) зэрэг тохиргоонууд үйлчилнэ — эсвэл өмнө нь хагас дутуу суулгагдсан байх ба үүнийг --reset-runtime командын тусламжтайгаар цэвэрлэх боломжтой.

"the local playground exited before it was ready", эсвэл бэлэн болохгүй байх

Ронтаймын өөрийнх нь үр дүнг харахын тулд zinnector dev --verbose командыг ажиллуулна уу. Порт аль хэдийн ашиглагдаж байх нь хамгийн түгээмэл шалтгаан юм: zinnector dev --port 9401 гэж ашиглах эсвэл zinnector.json дотор port-ыг тохируулна уу. Амжилттай суулгагдсан боловч асахгүй байгаа ронтаймын хувьд: zinnector dev --reset-runtime командыг ашиглана уу. Анх удаа асаахад WordPress өөрөө мөн татагддаг тул удаан холболттой үед хэдэн минут хүлээнэ үү; хугацаа хэтэрсэн тухай мэдээлэхээсээ өмнө CLI нь гацахын оронд тав хүртэлх минут хүлээдэг.

push хийх үед гарч ирэх "this project is not a git repository"

Байршуулалт (Deploys) нь репозитороос удирдагддаг тул zinnector push командын хувьд платформын хандах боломжтой алсын (remote) холболт бүхий репозитор шаардлагатай. git init && git add -A && git commit -m initial командыг ажиллуулж, GitHub эсвэл GitLab алсын репозитороо нэмсний дараа сайттай холбохын тулд zinnector link командыг ашиглана уу.

Байршуулсны дараа сайт цагаан өнгөтэй харагдах

zinnector check командыг ажиллуулна уу. Арван тохиолдлын есөд нь энэ нь PHP хувилбарын зөрүү байдаг — таны бүтээсэн PHP хувилбар нь уг слот дээр ажиллаж байгаа хувилбараас шинэ байна — мөн уг тайланд слотыг ямар PHP хувилбар руу шилжүүлэх ёстойг zinnector php <version> командаар, эсвэл ямар хувилбартай нийцүүлэн хөгжүүлэх ёстойг zinnector dev --php <version> командаар зааж өгдөг. zinnector logs --error команд нь фатал алдааг өөрийг нь харуулдаг.

Холбогдох

• Эхлэх · Локал хөгжүүлэлт · Байршуулах · Командын лавлах