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

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

რა გჭირდებათ

• 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 ბრძანებისთვის — განთავსება (deploy) ხორციელდება თქვენი რეპოზიტორიიდან.
• Docker, მხოლოდ იმ შემთხვევაში, თუ ამას მოითხოვთ --runtime docker პარამეტრით. ნაგულისხმევ გაშვების გარემოს ის არ სჭირდება.

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

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

npm install -g zinnector

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

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

zinnector --version

წარმატება: ვერსიის ნომერი, მაგალითად 0.1.2. თუ ხედავთ "Zinnector®-ს სჭირდება Node 24 ან უფრო ახალი — ეს არის Node 20.x", ბინარული ფაილი დაინსტალირებულია, მაგრამ თქვენი Node ძალიან ძველია; ბრძანება იხურება კოდით 78 და არაფერს ასრულებს.

ნაბიჯი 3 — წაიკითხეთ დახმარება

zinnector --help

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

ნაბიჯი 4 — შექმენით საიტის შაბლონი

zinnector new my-site

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

ნაბიჯი 5 — გააშვეთ ის

cd my-site
zinnector dev

პირველ ჯერზე, Zinnector® ერთხელ ითხოვს თანხმობას WordPress-ის გაშვების გარემოს ჩამოტვირთვამდე — დაახლოებით 570 მბ, რადგან მას მოჰყვება PHP-ის ყველა ვერსია 5.2-დან 8.5-მდე — თავის საკუთარ ქეშის დირექტორიაში და არასდროს თქვენს პროექტში. უპასუხეთ Y, ან გადაეცით --yes კითხვის გამოტოვებისთვის. Node 26 ან უფრო ახალ ვერსიაზე ის ასევე ჩამოტვირთავს Node 24-ს მხოლოდ გაშვების გარემოსთვის (დაახლოებით 30 მბ, გადამოწმებული nodejs.org-ის საკონტროლო ჯამებთან), რადგან გაშვების გარემოს მშობლიურ მოდულს აქვს წინასწარ აწყობილი ბინარული ფაილები მხოლოდ 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/-ში და ის გამოჩნდება გვერდის შემდეგი განახლებისთანავე — გაშვების გარემო ამ დირექტორიებს პირდაპირ თქვენი პროექტიდან აწვდის.

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

საით წავიდეთ შემდეგ

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

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