Мушкилкушоии Zinnector®

Хатогиҳои воқеие, ки корбарон бо 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 сар карда, бе истифодаи shell оғоз кардани файли .cmd-ро рад мекунад — бинобар ин, насбкунӣ як сония пас аз посухи шумо ба 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 дорои модули маҳаллие мебошад, ки бинарҳои пешакӣ сохташудаи он танҳо барои 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) ба ҷои ях кардан, то панҷ дақиқа интизор мешавад.

"this project is not a git repository" ҳангоми боргузорӣ (push)

Корҳои паҳнкунӣ (deploys) аз репозитория идора карда мешаванд, бинобар ин zinnector push ба репозиторияе ниёз дорад, ки дорои пайванди дурдасте (remote) бошад, ки платформа ба он дастрасӣ пайдо карда тавонад. git init && git add -A && git commit -m initial-ро иҷро кунед, пайванди дурдасти GitHub ё GitLab-и худро илова кунед ва сипас zinnector link-ро барои пайваст кардани он ба сайт иҷро кунед.

Сайт пас аз паҳнкунӣ сафед аст

zinnector check-ро иҷро кунед. Дар нуҳ ҳолат аз даҳ ҳолат ин фарқияти версияи PHP аст — шумо дар версияи PHP-и навтар аз он версияе, ки дар он слот кор мекунад, сохтаед — ва ҳисобот нишон медиҳад, ки бо истифодаи zinnector php <version> слот ба кадом версия гузаронида шавад ва ё бо истифодаи zinnector dev --php <version> барномасозӣ карда шавад. zinnector logs --error худи хатогии ҷиддиро нишон медиҳад.

Марбута

• Оғози кор · Рушди маҳаллӣ · Паҳнкунӣ · Дастури фармонҳо