Zinnector®-ის ხარვეზების აღმოფხვრა

იმ შეცდომებს, რომლებსაც მომხმარებლები რეალურად აწყდებიან Zinnector® CLI-ს გამოყენებისას, თითოეულის მნიშვნელობას და გამოსწორების გზებს. თითოეული ჩანაწერი მიუთითებს ზუსტ ტექსტზე, რომელსაც დაინახავთ, რათა შეძლოთ მისი ძებნა ამ გვერდზე. თუ თქვენი შეცდომა აქ არ არის, გაუშვით წარუმატებელი ბრძანება ZINNECTOR_DEBUG=1 ცვლადით და გახსენით ინციდენტი (issue) მისამართზე github.com/Zinn-Digital/zinnector/issues გამოსავალ (output) მონაცემებთან, თქვენს node --version-თან და ოპერაციულ სისტემასთან ერთად.

"spawn EINVAL" მუშაობის გარემოს (runtime) ინსტალაციის მიღებიდან მალევე (Windows)

ხარვეზი Zinnector® 0.1.0 და 0.1.1 ვერსიებში. Windows-ზე მუშაობის გარემოს ინსტალატორი უშვებდა npm.cmd-ს სახელით, ხოლო Node-მა უარი თქვა .cmd ფაილის გაშვებაზე შეველის გარეშე მას შემდეგ, რაც გამოვიდა CVE-2024-27980-ის შესწორება — ამიტომ ინსტალაცია ჩამოინგრა მას შემდეგ, რაც გასცდით პასუხს 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) იმის მაგივრად, რომ მოგვიანებით სადმე გაურკვეველი მიზეზით ჩავარდეს. დააინსტალირეთ მიმდინარე 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 წლის სექტემბრის მდგომარეობით) მისი ინსტალატორი უბრუნდება წყაროდან კომპილაციას, რაც ჩვეულებრივ 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 … და რეესტრის სარკე — ან ნახევრად დასრულებული ადრინდელი ინსტალაცია, რომელსაც --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-ის დროს

განთავსება (deploy) ხორციელდება რეპოზიტორიიდან, ამიტომ zinnector push-ს სჭირდება ისეთი რეპოზიტორიი დისტანციური (remote) სერვერით, რომელთანაც პლატფორმას წვდომა აქვს. git init && git add -A && git commit -m initial, დაამატეთ თქვენი GitHub ან GitLab remote, შემდეგ კი zinnector link, რათა დააკავშიროთ ის საიტს.

განთავსების შემდეგ საიტი თეთრია

გაუშვით zinnector check. ათიდან ცხრა შემთხვევაში ეს არის PHP ვერსიების შეუსაბამობა — თქვენ ააწყვეთ უფრო ახალ PHP-ზე, ვიდრე სლოტი უშვებს — და ანგარიში მიუთითებს, რომელ ვერსიაზე უნდა გადართოთ სლოტი zinnector php <version> ბრძანებით, ან რომელთან მიმართებითაც უნდა იმუშაოთ zinnector dev --php <version> გამოყენებით. zinnector logs --error აჩვენებს თავად საბედისწერო (fatal) შეცდომას.

დაკავშირებული

• დაწყება · ლოკალური დამუშავება · განთავსება · ბრძანებების ცნობარი