Хөгжүүлэгчийн CLI болох Zinnector®-тэй ажиллаж эхлэх

Zinnector® бол Zinn Digital®-ийн WordPress хөгжүүлэгчдэд зориулсан үнэ төлбөргүй, MIT лицензтэй командын мөрийн хэрэгсэл юм. Энэ нь сайтыг бэлтгэж, таны машинд Node-оос өөр юу ч суулгаагүй байхад — Docker байхгүй, MAMP байхгүй, PATH дээр тань PHP байхгүй үед ч жинхэнэ WordPress-ийг ажиллуулж, дараа нь таны бүтээсэн зүйлийг байршуулах гэж буй хостинг слоттой харьцуулан шалгаад илгээдэг. Энэхүү гарын авлага нь таныг ойролцоогоор хоёр минутын дотор хоосон байдлаас ажиллаж буй сайттай болгож, алхам бүрд амжилттай үр дүн ямар харагдахыг зааж өгөх тул ямар нэг зүйл буруу болсныг мэдэх боломжтой.

Танд юу шаардлагатай вэ

• Node 24 буюу түүнээс шинэ хувилбар. node --version командыг ажиллуулна уу; энэ нь v24 буюу түүнээс дээш утгыг хэвлэх ёстой. Одоогийн LTS хувилбарыг nodejs.org дээрээс суулгана уу — Windows дээр winget install OpenJS.NodeJS.LTS, macOS дээр brew install node@24.
• Node-той хамт ирдэг npm. Zinnector® нь үүнийг WordPress ажиллах орчныг өөрийн кэш рүү татаж авахад ганц удаа ашигладаг.
• зөвхөн zinnector push-д зориулсан git — байршуулалтуудыг таны репозитороос удирддаг.
• 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® needs Node 24 or newer — this is 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, plugins/, themes/ болон mu-plugins/ туслах бүхий wp-content мод, .gitignore болон README — үүний дараа ажиллуулах дараагийн командуудыг харуулна. Үүнд ямар ч орлуулагч байхгүй; төсөл нь байгаа чигээрээ шууд эхэлнэ. --template plugin эсвэл --template theme нь үүссэн даруйдаа идэвхждэг залгаас эсвэл блок загварыг бэлтгэдэг.

Алхам 5 — үүнийг ажиллуулах

cd my-site
zinnector dev

Эхний удаад Zinnector® нь таны төсөл рүү хэзээ ч бус, зөвхөн өөрийн кэш сандаа WordPress ажиллах орчныг — PHP 5.2-оос 8.5 хүртэлх бүх угсралтыг агуулдаг тул ойролцоогоор 570 МБ — татаж авахаасаа өмнө нэг удаа асуудаг. Асуултыг алгасахын тулд Y гэж хариулах эсвэл --yes дамжуулна уу. Node 26 буюу түүнээс шинэ хувилбар дээр энэ нь зөвхөн ажиллах орчинд зориулж Node 24-ийг (nodejs.org-ийн шалгах нийлбэрээр баталгаажсан, ойролцоогоор 30 МБ) мөн татаж авдаг бөгөөд учир нь ажиллах орчны үндсэн модуль нь зөвхөн 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 хаягаар зочилно уу. Амжилттай: таны хүссэн PHP хувилбараар үйлчлэгдэж буй My WordPress Website нэртэй шинэ WordPress сайт. 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®-ээр байршуулах — нэвтрэх, төслийг слоттой холбох, урьдчилсан шалгалт хийх, илгээх.
• Командын лавлах — команд, туг болон жишээ бүр.
• Алдааг олж засварлах — хүмүүст бодитоор тулгардаг алдаанууд болон тэдгээрийг шийдвэрлэх арга замууд.

Ижилхэн баримт бичиг нь npm болон GitHub дээрх багцын README дотор байгаа бөгөөд тэнд асуудал үүсгэх болон pull хүсэлт илгээхийг урьж байна.