Այն սխալները, որոնց օգտատերերն իրականում բախվում են Zinnector® CLI-ի հետ, ինչ է դրանցից յուրաքանչյուրը նշանակում և ինչպես շտկել դրանք: Յուրաքանչյուր գրառում նշում է ճշգրիտ այն տեքստը, որը դուք կտեսնեք, այնպես որ կարող եք փնտրել այն այս էջում: Եթե ձեր սխալը այստեղ չկա, գործարկեք ձախողված հրամանը ZINNECTOR_DEBUG=1-ով և բացեք խնդիր (issue) github.com/Zinn-Digital/zinnector/issues հասցեով՝ նշելով արդյունքը, ձեր node --version-ը և ձեր օպերացիոն համակարգը:
«spawn EINVAL» անմիջապես runtime-ի տեղադրումն ընդունելուց հետո (Windows)
Սխալ Zinnector® 0.1.0-ում և 0.1.1-ում: Windows-ում runtime-ի տեղադրիչը գործարկում էր npm.cmd-ն ըստ անվան, իսկ Node-ը հրաժարվում է spawn անել .cmd ֆայլը առանց shell-ի՝ CVE-2024-27980-ի իր ուղղումից ի վեր — այնպես որ տեղադրումը խափանվում էր 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-ի runtime-ն ունի native մոդուլ, որի նախապես կառուցված binary-ները գոյություն ունեն միայն Node 24-ի և 25-ի համար: Ավելի նոր Node-ի վրա (26 և ավելի բարձր՝ 2026 թվականի սեպտեմբերի դրությամբ) դրա տեղադրիչը վերադառնում է աղբյուրից կոմպիլյացիա անելուն, ինչը սովորական Windows մեքենայի վրա ավարտվում է Visual Studio տեղադրելու պահանջով: Ուղղված է 0.1.2-ում. Zinnector®-ը հայտնաբերում է սա նախքան որևէ բան ներբեռնելը և բեռնում է Node 24 բացառապես runtime-ի համար — մոտ 30 ՄԲ, ստուգված nodejs.org-ի checksum-ների համեմատ — այնպես որ երբեք ոչինչ չի կոմպիլացվում: Եթե թարմացումից հետո դեռ տեսնում եք այն, գործարկեք zinnector dev --reset-runtime, որպեսզի նախ հեռացվի նախորդ կիսատ մնացած տեղադրումը:
«EPERM» նախազգուշացումներ npm-ից մաքրման ժամանակ (Windows)
Գրեթե միշտ հակավիրուսային սկաները կամ որոնման ինդեքսավորիչն են բաց պահում ֆայլը runtime-ի node_modules-ի տակ, մինչ npm-ը փորձում է հեռացնել այն: Տեղադրումը կրկին փորձարկվում է մաքուր գրացուցակից հաջորդ zinnector dev-ի ժամանակ. եթե այն շարունակում է կրկնվել, zinnector dev --reset-runtime-ը նախ հեռացնում է runtime-ի ամբողջ գրացուցակը և նորից տեղադրում:
«the local playground runtime could not be installed»
Հաղորդագրությունը ներառում է հենց npm-ի վերջին տողերը և այն ճշգրիտ հրամանը, որը գործարկել է Zinnector®-ը, այնպես որ կարող եք ինքներդ գործարկել այն և տեսնել ամբողջական արդյունքը: Սովորական պատճառներն են ցանցի կամ proxy-ի խնդիրը — runtime-ը բեռնվում է ձեր իսկ npm-ի միջոցով, այնպես որ npm config set proxy …-ը և registry mirror-ը կիրառելի են — կամ ավելի վաղ կիսատ մնացած տեղադրումը, որը --reset-runtime-ը մաքրում է:
«the local playground exited before it was ready», կամ այն երբեք պատրաստ չի դառնում
Գործարկեք zinnector dev --verbose՝ runtime-ի սեփական արդյունքը տեսնելու համար: Արդեն օգտագործվող պորտը ամենատարածված պատճառն է. zinnector dev --port 9401, կամ սահմանեք port-ը zinnector.json-ում: Եթե runtime-ը տեղադրվել է, բայց չի բեռնվում՝ zinnector dev --reset-runtime: Առաջին բեռնումը նաև ներբեռնում է հենց WordPress-ը, այնպես որ դանդաղ կապի դեպքում տվեք դրան մի քանի րոպե. CLI-ն սպասում է մինչև հինգ րոպե, նախքան կախվելու փոխարեն ժամանակի սպառման մասին հայտնելը:
«this project is not a git repository» push-ի ժամանակ
Տեղակայումները (deploy) ղեկավարվում են ռեպոզիտորիայից, այնպես որ zinnector push-ին անհրաժեշտ է այնպիսի ռեպոզիտորիա, որն ունի հեռավոր (remote) հասցե, որին հարթակը կարող է հասնել: git init && git add -A && git commit -m initial, ավելացրեք ձեր GitHub կամ GitLab remote-ը, ապա zinnector link՝ այն կայքին միացնելու համար:
Տեղակայումից հետո կայքը սպիտակ է
Գործարկեք zinnector check: Տասից ինը դեպքում դա PHP-ի տարբերակների տարբերությունն է — դուք կառուցել եք ավելի նոր PHP-ի վրա, քան գործարկում է slot-ը — և հաշվետվությունը նշում է, թե որ տարբերակին պետք է փոխարկել slot-ը zinnector php <version> հրամանով, կամ որի համար մշակել zinnector dev --php <version> հրամանով: zinnector logs --error-ը ցույց է տալիս հենց fatal սխալը:
Առնչվող նյութեր