Пойгоҳи дониш

Бартараф кардани нуқсонҳои Zinnector®

Хатогиҳое, ки корбарон воқеан дар Zinnector® CLI дучор мешаванд ва роҳи ҳалли ҳар яке: spawn EINVAL дар Windows, огоҳии EBADENGINE аз npm, талаби Visual Studio аз ҷониби node-gyp дар Node 26, EPERM ҳангоми насб, муҳити иҷрое, ки оғоз намеёбад ва порти бандбуда.

Хатоҳое, ки корбарон воқеан ҳангоми кор бо 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) нишон медиҳад.

Марбут

Ҳамаи ҳуҷҷатҳои таҳиягар →

Навтаринҳо аз блог

Он чи ки мо дар бораи хостинг, SEO ва идораи сомонаҳо дар миқёси бузург навиштаем.

SEO ва бунёди пайвандҳо аз қабати ҳостинг: Дидгоҳи оператори соли 2026

Чӣ тавр хостинг индексатсия ва арзиши истинодҳоро (link equity) дар соли 2026 муайян мекунад: дар ҳолати индексатсия нигоҳ доштани саҳифаҳо, санҷиши доменҳои кӯҳна пеш аз истифодаи онҳо, сохтани истинодҳо бидуни пайгирӣ (footprint) ва назари воқеӣ ба он ки инфрасохтор барои SEO чиро метавонад ва чиро наметавонад анҷом диҳад.

Хондани навишта →

Тезкор ва бехатар гардонидани WordPress: рӯйхати санҷиши маҳсулнокӣ ва плагинҳо

Рӯйхати амалии санҷишӣ барои WordPress-и зудкор ва амн: кэшкунӣ дар сатҳи сервер, кэши объектҳо барои ҳар як сомона, чанд плагини воқеан арзанда, дар ҳолати нав нигоҳ доштани маҷмӯи нармафзорҳо ва саҳифаҳои WooCommerce, ки шумо набояд ҳеҷ гоҳ онҳоро кэш кунед.

Хондани навишта →

Чӣ тавр хостинги идорашавандаи вебро дар соли 2026 интихоб кардан мумкин аст: Дастури харидор

Он чист, ки мизбонии хуби идорашавандаро аз сервери арзони дорои панели идоракунӣ воқеан фарқ мекунад — интиқолҳо, нусхаҳои эҳтиётӣ, ҷудокунӣ, захиракунии воқеии муваққатӣ ва миқёспазирии софдилона — ва чӣ гуна онро пеш аз пайвастшавӣ баҳодиҳӣ кардан мумкин аст.

Хондани навишта →

Блогро хонед →

Ҳанӯз ҳам мушкилӣ доред?

Дастгирӣ ба ҳар як нақша дохил карда шудааст, мизи корӣ дар давоми 24 соат дар як рӯз кушода аст ва шумо метавонед ба мо бо ҳар яке аз забонҳои 58-и мо нависед — мо ба забони шумо ҷавоб медиҳем.

Тамос бо хадамоти дастгирӣ → Ҳамаи мақолаҳо →