Zinnector® хөгжүүлэгчийн CLI-тай танилцах нь

Үнэгүй Zinnector CLI-ийг Node 24 эсвэл түүнээс шинэ хувилбар дээр суулгаад, хоёр минутын дотор хэрхэн ажилладагийг нь шалгаарай: --version, --help, сайтын бүтэц үүсгэх, Docker ашиглахгүйгээр WordPress-ийг локал дээрээ жинхэнээсээ ажиллуулах, мөн түүнийгээ хөтөч дээрээ нээх — алхам бүрд амжилттай болсон эсэхийг харуулна.

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

Танд шаардлагатай зүйлс

Node 24 эсвэл илүү шинэ хувилбар. node --version гэж ажиллуулна уу; энэ нь v24 эсвэл түүнээс дээш хувилбарыг хэвлэх ёстой. nodejs.org-оос одоогийн LTS хувилбарыг суулгана уу — Windows дээр winget install OpenJS.NodeJS.LTS, macOS дээр brew install node@24.
npm, энэ нь Node-той хамт ирдэг. Zinnector® нь үүнийг WordPress-ийн ажиллах орчныг өөрийн кэш рүү татаж авахад нэг удаа ашигладаг.
git, зөвхөн zinnector push-д зориулагдсан — байршуулалтууд нь таны репозиториос хийгддэг.
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 ажиллах орчныг татахаас өмнө нэг удаа асуудаг — 5.2-оос 8.5 хүртэлх PHP хувилбар бүрийг агуулдаг тул ойролцоогоор 570 МБ ба таны төсөл рүү хэзээ ч биш, өөрийн кэш лавлах руу татдаг. 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 хаягаар зочилно уу. Амжилттай: таны шаардсан 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 болон санал хүсэлт, pull request-ийг хүлээж авдаг GitHub дээрх багцын README хэсэгт мөн байгаа.