შეცდომები, რომლებსაც მომხმარებლები რეალურად აწყდებიან 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-მა უარი თქვა .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-ს გააჩნია ნატიური მოდული, რომლის წინასწარ აწყობილი ბინარული ფაილები არსებობს მხოლოდ Node 24 და 25-ისთვის. უფრო ახალ Node-ზე (26 და ზემოთ, 2026 წლის სექტემბრის მდგომარეობით) მისი ინსტალატორი გადადის პირველწყაროდან კომპილაციაზე, რაც ჩვეულებრივ Windows-ის მანქანაზე მთავრდება Visual Studio-ს მოთხოვნით. გასწორებულია 0.1.2-ში: Zinnector® აფიქსირებს ამას რაიმეს ჩამოტვირთვამდე და იღებს Node 24-ს მხოლოდ runtime-ისთვის — დაახლოებით 30 მბ, გადამოწმებული nodejs.org-ის საკონტროლო ჯამებთან — ასე რომ, არაფერი აღარ კომპილირდება. თუ განახლების შემდეგ კვლავ ხედავთ ამას, გაუშვით 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®-მა გაუშვა, ასე რომ შეგიძლიათ თავად გაუშვათ იგი და იხილოთ სრული შედეგი. ჩვეულებრივი მიზეზებია ქსელის ან პროქსის პრობლემა — runtime იტვირთება თქვენი საკუთარი npm-ით, შესაბამისად მოქმედებს npm config set proxy … და რეესტრის სარკე — ან წინა, ნახევრად დასრულებული ინსტალაცია, რასაც --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-ის დროს
დეპლოი ხორციელდება რეპოზიტორიიდან, ამიტომ zinnector push-ს სჭირდება რეპოზიტორია დისტანციური მისამართით (remote), რომელთანაც პლატფორმას ექნება წვდომა. 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 აჩვენებს თავად კრიტიკულ შეცდომას.
დაკავშირებული