Zinnector®-ի անսարքությունների վերացում

Այն սխալները, որոնց օգտատերերն իրականում բախվում են Zinnector® CLI-ում, թե ինչ է նշանակում դրանցից յուրաքանչյուրը, և ուղղման եղանակը: Յուրաքանչյուր մուտք նշում է այն ստույգ տեքստը, որը դուք տեսնելու եք, այնպես որ կարող եք որոնել այն այս էջում: Եթե ձեր խնդիրն այստեղ չկա, գործարկեք ձախողված հրամանը ZINNECTOR_DEBUG=1 փոփոխականով և բացեք խնդիր (issue) github.com/Zinn-Digital/zinnector/issues հասցեում՝ տրամադրելով ելքային տվյալները, ձեր node --version-ը և օպերացիոն համակարգը:

«spawn EINVAL»՝ գործարկման միջավայրի տեղադրման ընդունումից անմիջապես հետո (Windows)

Սխալ Zinnector® 0.1.0 և 0.1.1 տարբերակներում: Windows-ում գործարկման միջավայրի տեղադրիչը գործարկել էր npm.cmd-ն ըստ անվան, և Node-ը հրաժարվել է գործարկել .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-ի գործարկման միջավայրն ունի բնիկ (native) մոդուլ, որի նախապես կառուցված երկծրագրային ֆայլերը (binaries) գոյություն ունեն միայն Node 24 և 25 տարբերակների համար: Ավելի նոր Node-ի վրա (26 և բարձր, սկսած 2026 թվականի սեպտեմբերից) դրա տեղադրիչը վերադառնում է սկզբնաղբյուրից կառուցմանը, ինչը սովորական Windows մեքենայի վրա հանգեցնում է Visual Studio-ի տեղադրման հարցման: Շտկված է 0.1.2 տարբերակում. Zinnector®-ը հայտնաբերում է սա նախքան որևէ բան ներբեռնելը և միայն գործարկման միջավայրի համար բերում է Node 24՝ մոտ 30 ՄԲ, ստուգված nodejs.org-ի վավերացման գումարների (checksums) հիման վրա, այնպես որ երբեք ոչինչ չի կառուցվում: Եթե թարմացումից հետո դեռ տեսնում եք այն, գործարկեք 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) կառավարվում են պահոցից (repository), ուստի zinnector push-ին անհրաժեշտ է հեռակա (remote) պահոց ունեցող մեկը, որին հարթակը կարող է հասնել: git init && git add -A && git commit -m initial, ավելացրեք ձեր GitHub կամ GitLab հեռակա պահոցը, այնուհետև zinnector link՝ այն կայքին միացնելու համար:

Տեղակայումից հետո կայքը սպիտակ է

Գործարկեք zinnector check: Տասից ինը դեպքում դա PHP-ի տարբերակների տարբերությունն է. դուք կառուցել եք PHP-ի ավելի նոր տարբերակի վրա, քան գործարկվում է սլոթում (slot), և հաշվետվությունը ցույց է տալիս, թե որ տարբերակին պետք է անցկացնել սլոթը zinnector php <version> հրամանով, կամ որի դեմ մշակել zinnector dev --php <version> հրամանով: zinnector logs --error-ը ցույց է տալիս հենց ճակատագրական սխալը (fatal):

Առնչվող

• Սկսելով · Տեղական մշակում · Տեղակայում · Հրամանների ուղեցույց