Оғози кор бо Zinnector®, интерфейси сатри фармон барои барномасозон

Zinnector® асбоби сатри фармони ройгон ва таҳти иҷозатномаи MIT будаи Zinn Digital® барои таҳиягарони 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 ба ҳофизаи ниҳонии (cache) худ истифода мебарад.
• git, танҳо барои zinnector push — интиқолҳо аз анбори (repository) шумо идора карда мешаванд.
• 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, дарахти wp-content бо plugins/, themes/ ва ёрдамчии mu-plugins/, як .gitignore ва як README — ва пас аз он фармонҳои навбатӣ барои иҷро. Ҳеҷ чиз дар он пуркунанда нест; лоиҳа ҳамон тавре ки ҳаст ба кор медарояд. --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 мавҷуданд, ки дар он ҷо фикру мулоҳизаҳо ва дархостҳои ҷалб (pull requests) истиқбол карда мешаванд.