მუშაობის დაწყება Zinnector®-თან, დეველოპერის CLI-სთან

Zinnector® არის Zinn Digital®-ის უფასო, MIT ლიცენზიის მქონე ბრძანებათა სტრიქონის ხელსაწყო WordPress დეველოპერებისთვის. ის ქმნის საიტის საწყის სტრუქტურას, უშვებს ნამდვილ WordPress-ს თქვენს საკუთარ მოწყობილობაზე ისე, რომ დაინსტალირებული მხოლოდ Node გაქვთ — Docker-ის გარეშე, MAMP-ის გარეშე, PHP-ის გარეშე თქვენს PATH-ში — შემდეგ ამოწმებს თქვენ მიერ აწყობილ სისტემას ჰოსტინგის იმ სლოტთან შედარებით, სადაც დეპლოის აპირებთ, და აგზავნის მას. ეს გზამკვლევი დაახლოებით ორ წუთში მიგიყვანთ საწყისი მდგომარეობიდან გაშვებულ საიტამდე და გაცნობებთ, როგორ გამოიყურება წარმატებული შედეგი თითოეულ ეტაპზე, რათა იცოდეთ, თუ რამე არასწორად წარიმართება.

რა გჭირდებათ

• Node 24 ან უფრო ახალი. გაუშვით node --version; მან უნდა დაბეჭდოს v24 ან უფრო მაღალი. დააინსტალირეთ მიმდინარე LTS nodejs.org-დან — Windows-ზე winget install OpenJS.NodeJS.LTS, macOS-ზე brew install node@24.
• npm, რომელიც მოყვება Node-ს. Zinnector® მას ერთხელ იყენებს, რათა WordPress-ის runtime ჩამოტვირთოს თავის საკუთარ ქეშში.
• git, მხოლოდ zinnector push-ისთვის — დეპლოები იმართება თქვენი რეპოზიტორიიდან.
• Docker, მხოლოდ იმ შემთხვევაში, თუ მოითხოვთ მას პარამეტრით --runtime docker. ნაგულისხმევ runtime-ს ის არ სჭირდება.

ქვემოთ მოცემულიდან არაფერს სჭირდება ანგარიში. API გასაღები საჭიროა მხოლოდ მაშინ, როდესაც მიაღწევთ ჰოსტინგის სლოტს, სტატიაში დეპლოი Zinnector®-ით.

ნაბიჯი 1 — დააინსტალირეთ

npm install -g zinnector

თუ npm დაბეჭდავს npm WARN EBADENGINE-ს, თქვენი Node უფრო ძველია, ვიდრე >=24.18.1, რომელსაც პაკეტი მოითხოვს. ინსტალაცია მაინც დასრულდება, მაგრამ CLI უარს იტყვის გაშვებაზე. ჯერ განაახლეთ Node, შემდეგ კი კვლავ დააინსტალირეთ.

ნაბიჯი 2 — შეამოწმეთ ვერსია

zinnector --version

წარმატება: ვერსიის ნომერი, მაგალითად 0.1.2. თუ ხედავთ შეტყობინებას "Zinnector® needs Node 24 or newer — this is Node 20.x", ბინარული ფაილი დაინსტალირებულია, მაგრამ თქვენი Node ძალიან ძველია; ბრძანება რაიმეს შესრულების ნაცვლად მუშაობას ასრულებს 78 კოდით.

ნაბიჯი 3 — გაეცანით დახმარებას

zinnector --help

წარმატება: ბანერი, რომელიც ასახელებს პროცესის ხუთ ბრძანებას (new, dev, link, check, push) და შემდეგ თითოეულ ბრძანებას ერთსტრიქონიანი დანიშნულებით. თითოეული ბრძანება ასევე იღებს საკუთარ --help-ს — zinnector dev --help ჩამოთვლის runtime-ის, PHP-ის და პორტის დროშებს. სრული სია მაგალითებთან ერთად მოცემულია ბრძანებების ცნობარში.

ნაბიჯი 4 — შექმენით საიტის საწყისი სტრუქტურა

zinnector new my-site

წარმატება: სათაური Created my-site და მის მიერ ჩაწერილი ფაილების სია — zinnector.json, wp-content ხე plugins/-ით, themes/-ით და mu-plugins/ დამხმარე მოდულით, .gitignore და README — რასაც მოსდევს შემდეგი გასაშვები ბრძანებები. მასში არაფერია შემავსებელი ადგილი; პროექტი ეშვება ისე, როგორც არის. --template plugin ან --template theme ქმნის ფლაგინის ან ბლოკ-თემის სტრუქტურას, რომელიც აქტიურდება შექმნისთანავე.

ნაბიჯი 5 — გაუშვით

cd my-site
zinnector dev

პირველ ჯერზე, Zinnector® ერთხელ გეკითხებათ ნებართვას WordPress-ის runtime-ის (დაახლოებით 570 მბ, რადგან ის შეიცავს PHP-ის ყველა ვერსიას 5.2-დან 8.5-მდე) ჩამოტვირთვამდე თავის საკუთარ ქეშ დირექტორიაში, და არა თქვენს პროექტში. უპასუხეთ Y, ან გადაეცით --yes შეკითხვის გამოსატოვებლად. Node 26-ზე ან უფრო ახალზე ის ასევე იწერს Node 24-ს მხოლოდ runtime-ისთვის (დაახლოებით 30 მბ, დამოწმებული nodejs.org-ის საკონტროლო ჯამებთან), რადგან runtime-ის ნატიურ მოდულს გააჩნია წინასწარ აწყობილი ბინარული ფაილები მხოლოდ Node 24-ისა და 25-ისთვის; თქვენ არ გჭირდებათ კომპილატორი ან Visual Studio.

წარმატება: ბლოკი, რომელიც ასახელებს პროექტს, PHP-ის ვერსიასა და WordPress-ის ვერსიას, შემდეგ კი:

✔ running at http://127.0.0.1:9400
  admin: http://127.0.0.1:9400/wp-admin  (already signed in)

ნაბიჯი 6 — გახსენით

ეწვიეთ http://127.0.0.1:9400-ს ბრაუზერში. წარმატება: ახალი WordPress საიტი სათაურით My WordPress Website, რომელსაც ემსახურება თქვენ მიერ მოთხოვნილი PHP-ის ვერსია. http://127.0.0.1:9400/wp-admin ხსნის მართვის პანელს უკვე ავტორიზებული სტატუსით. ჩააგდეთ ფლაგინი დირექტორიაში wp-content/plugins/ ან თემა დირექტორიაში wp-content/themes/ და ის გამოჩნდება მომდევნო გადატვირთვისას — runtime ემსახურება ამ დირექტორიებს პირდაპირ თქვენი პროექტიდან.

დააჭირეთ Ctrl-C-ს გასაჩერებლად. zinnector dev --once უშვებს runtime-ს, ბეჭდავს იმას, თუ რა მუშაობს რეალურად (PHP-ის ვერსია, WordPress-ის ვერსია, ჩატვირთული გაფართოებები) და ჩერდება — ეს მოსახერხებელია, როდესაც დაპირების ნაცვლად მტკიცებულება გსურთ.

შემდეგი ნაბიჯები

• ლოკალური დეველოპმენტი zinnector dev-ით — ორი runtime, PHP-ისა და WordPress-ის ვერსიების არჩევა, და რა საიდან მიეწოდება.
• დეპლოი Zinnector®-ით — შედით სისტემაში, დააკავშირეთ პროექტი სლოტთან, შეამოწმეთ წინასწარ, გაგზავნეთ.
• ბრძანებების ცნობარი — თითოეული ბრძანება, დროშა და მაგალითი.
• პრობლემების გადაჭრა — შეცდომები, რომლებსაც რეალურად აწყდებიან მომხმარებლები, და თითოეულის გადაწყვეტა.

იგივე დოკუმენტაცია მოცემულია პაკეტის README-ში npm-ზე და GitHub-ზე, სადაც საკითხების გახსნა და pull request-ები მისასალმებელია.