Оғоз бо Zinnector®, CLI таҳиягар

CLI-и ройгони Zinnector-ро дар Node 24 ё навтар насб кунед, сипас дар давоми ду дақиқа кори онро санҷед: --version, --help, сохтани сохтори сайт, иҷрои як WordPress-и воқеӣ дар компютери маҳаллӣ бидуни Docker ва кушодани он дар браузер — бо шарҳи он ки дар ҳар як қадам натиҷаи муваффақ чӣ гуна аст.

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 ба кэши худи худ истифода мебарад.
git, танҳо барои zinnector push — ҷойгиркуниҳо аз репозиторийи шумо амалӣ карда мешаванд.
Docker, танҳо агар шумо онро бо --runtime docker дархост кунед. Муҳити иҷрои пешфарз ба он ниёз надорад.

Ҳеҷ чиз дар зер ҳисоби корбариро талаб намекунад. Калиди API танҳо вақте лозим аст, ки шумо ба слоти хостинг расед, дар Deploying with 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 ва портро номбар мекунад. Рӯйхати пурра бо намунаҳо дар command reference оварда шудааст.

Қадами 4 — сохтани сохтори сайт

zinnector new my-site

Success: сарлавҳаи 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, васеъшавиҳои боршуда) чоп мекунад ва меистад — вақте ки ба шумо ба ҷои ваъда исбот лозим аст, муфид аст.

Ба куҷо баъдтар рафтан мумкин аст

Local development with zinnector dev — ду муҳити иҷро, интихоби версияҳои PHP ва WordPress ва он чизе, ки аз куҷо хидмат расонида мешавад.
Deploying with Zinnector® — ворид шавед, лоиҳаро ба слот пайваст кунед, онро пешакӣ санҷед, фиристед.
The command reference — ҳар як фармон, байрақча ва намуна.
Troubleshooting — хатогиҳое, ки одамон воқеан дучор мешаванд ва роҳи ҳалли ҳар кадоми онҳо.

Ҳамин ҳуҷҷатҳо дар README-и баста дар npm ва дар GitHub мавҷуданд, ки дар он ҷо мушкилот (issues) ва дархостҳо барои тағирот (pull requests) хуш омаданд.