Хатоҳое, ки корбарон воқеан ҳангоми кор бо CLI-и Zinnector® дучор мешаванд, маънои ҳар яки онҳо ва тарзи ислоҳашон. Ҳар як бахш матни дақиқеро, ки шумо мебинед, дар бар мегирад, то тавонед онро дар ин саҳифа ҷустуҷӯ кунед. Агар мушкили шумо дар ин ҷо набошад, фармони иҷронашударо бо ZINNECTOR_DEBUG=1 иҷро кунед ва дар github.com/Zinn-Digital/zinnector/issues бо фиристодани натиҷаи баромади фармон, нишондоди node --version ва системаи оператсионии худ сабти мушкилот (issue) боз кунед.
"spawn EINVAL" дарҳол пас аз қабули насби муҳити иҷро (Windows)
Хатогие дар Zinnector® 0.1.0 ва 0.1.1. Дар Windows насбкунандаи муҳити иҷро npm.cmd-ро бо номаш иҷро мекард ва Node аз замони ислоҳи CVE-2024-27980 аз иҷро кардани файли .cmd бидуни shell даст мекашад — бинобар ин, насбкунӣ як сония пас аз он ки шумо ба савол Y посух додед, қатъ мешуд. Дар 0.1.2 ислоҳ шудааст: ҳоло npm ҳамчун node npm-cli.js иҷро мешавад, ки ин дар ҳамаи платформаҳо якхела аст ва ба shell ниёз надорад. Фармони npm install -g zinnector@latest ва сипас дубора zinnector dev-ро иҷро кунед.
"npm WARN EBADENGINE" ҳангоми насбкунӣ, ё "Zinnector® needs Node 24 or newer"
Версияи Node-и шумо аз 24 кӯҳнатар аст. npm огоҳиро ба хотире нишон медиҳад, ки баста шарти engines: >=24.18.1-ро муқаррар кардааст; насбкунӣ ба ҳар ҳол ба охир мерасад, аммо zinnector барои пешгирӣ аз хатогиҳои нофаҳмо дар оянда, аз оғоз шудан даст мекашад (рамзи баромад 78). Версияи ҷории LTS-ро аз nodejs.org насб кунед — winget install OpenJS.NodeJS.LTS дар Windows, brew install node@24 дар macOS — боварӣ ҳосил намоед, ки node --version натиҷаи v24 ё болотарро медиҳад, ва Zinnector®-ро дубора насб кунед.
"gyp ERR!", "Building from source with node-gyp", ё "You need to install Visual Studio"
Муҳити иҷрои WordPress модули маҳаллӣ (native) дорад, ки файлҳои дугонаи (binary) пешакӣ омодашудаи он танҳо барои Node 24 ва 25 мавҷуданд. Дар Node-и навтар (26 ва болотар, то моҳи сентябри соли 2026) насбкунанда ба компилятсия аз манбаъ (source) мегузарад, ки он дар компютери оддии Windows бо дархости насби Visual Studio ба анҷом мерасад. Дар 0.1.2 ислоҳ шудааст: Zinnector® инро пеш аз боргирии чизе муайян мекунад ва танҳо барои муҳити иҷро версияи Node 24-ро боргирӣ менамояд — тақрибан 30 МБ, ки бо маблағи назоратии nodejs.org санҷида шудааст — бинобар ин чизе компилятсия намешавад. Агар пас аз навсозӣ инро боз бинед, zinnector dev --reset-runtime-ро иҷро кунед, то насби нимакораи қаблӣ пешакӣ нест карда шавад.
Огоҳиҳои "EPERM" аз npm ҳангоми поккорӣ (Windows)
Кариб ҳамеша ин аз сабаби он рух медиҳад, ки барномаи зиддивирусӣ ё индексатори ҷустуҷӯ файлро дар зери директорияи node_modules-и муҳити иҷро боз нигоҳ медорад, вақте ки npm кӯшиши нест кардани онро дорад. Ҳангоми иҷрои навбатии 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, ё танзими port дар zinnector.json. Муҳити иҷрое, ки насб шудааст, вале оғоз намеёбад: zinnector dev --reset-runtime. Ҳангоми оғози аввал худи WordPress низ боргирӣ мешавад, бинобар ин дар суръати пасти интернет чанд дақиқа интизор шавед; CLI то панҷ дақиқа интизор мешавад ва ба ҷои овезон мондан, гузаштани вақти интизориро (timeout) гузориш медиҳад.
Ҳангоми фиристодан (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 сохтед, назар ба оне ки slot истифода мебарад — ва гузориш нишон медиҳад, ки бо zinnector php <version> slot-ро ба кадом версия гузаронед, ё бо zinnector dev --php <version> барои кадомаш барномарезӣ кунед. Фармони zinnector logs --error худи хатои ҷиддиро (fatal) нишон медиҳад.
Марбут