Zinnector® ақаулықтарын жою

Zinnector® CLI көмегімен адамдар кездесетін қателер, олардың әрқайсысының мағынасы және шешу жолы. Әрбір жазба сіз көретін нақты мәтінді көрсетеді, сондықтан оны осы беттен іздей аласыз. Егер сіздікі бұл жерде болмаса, сәтсіз аяқталған пәрменді 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 ретінде іске қосылады, бұл барлық платформаларда бірдей және ешқандай қабықшаны қажет етпейді. 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). nodejs.org/en/download сайтынан ағымдағы 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 үшін алдын ала құрылған бинарлық файлдары бар жергілікті модуль бар. Жаңарақ Node нұсқасында (2026 жылдың қыркүйек айы жағдайы бойынша 26 және одан жоғары) оның орнатушысы бастапқы кодтан құрастыруға көшеді, бұл қарапайым Windows компьютерінде Visual Studio орнатуды сұраумен аяқталады. 0.1.2 нұсқасында түзелді: Zinnector® мұны ешнәрсе жүктеп алмай тұрып анықтайды және tek орта үшін Node 24 нұсқасын алады — шамамен 30 МБ, nodejs.org контроллер сомаларымен тексерілген — сондықтан ешқашан ештеңе құрастырылмайды. Егер жаңартқаннан кейін де оны көрсеңіз, бұрынғы жартылай аяқталған орнату жойылуы үшін 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 … және тізілім айнасы қолданылады) немесе --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 уақыттың бітуі туралы хабарлау үшін қатып қалудың орнына бес минутқа дейін күтеді.

"this project is not a git repository" (жіберу кезінде)

Орналастырулар репозиторийден басқарылады, сондықтан zinnector push үшін платформа қол жеткізе алатын қашықтағы репозиторийі бар репозиторий қажет. 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 пәрмені қатенің өзін көрсетеді.

Қатысты

• Бастау · Жергілікті әзірлеу · Орналастыру · Пәрмендер анықтамалығы