Әзірлеушілерге арналған CLI құралы Zinnector®-мен жұмысты бастау

Zinnector® — WordPress әзірлеушілеріне арналған Zinn Digital® компаниясының тегін, 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.
• 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 орындалу ортасын — шамамен 570 МБ, өйткені ол 5.2-ден 8.5-ке дейінгі әрбір PHP жинағын қамтиды — жобаңызға емес, тек өзінің кэш каталогына жүктеп алмас бұрын бір рет рұқсат сұрайды. 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 платформасындағы және GitHub жүйесіндегі пакеттің README файлында бар, онда ұсыныстар мен сұраулар қабылданады.