Kuanza kutumia Zinnector®, CLI ya msanidi programu

Zinnector® ni zana ya safu-amri ya Zinn Digital® isiyolipishwa na yenye leseni ya MIT kwa watengenezaji wa WordPress. Inaunda kiunzi cha tovuti, inaendesha WordPress halisi kwenye mashine yako mwenyewe bila kusakinisha chochote isipokuwa Node — hakuna Docker, hakuna MAMP, hakuna PHP kwenye PATH yako — kisha inalinganisha ulichounda na nafasi ya upangishaji unayokaribia kuipeleka na kuisambaza. Mwongozo huu unakuongoza kutoka mwanzo hadi kuwa na tovuti inayofanya kazi kwa takriban dakika mbili, na kueleza jinsi mafanikio yanavyoonekana katika kila hatua ili ujue panapotokea hitilafu.

Unachohitaji

• Node 24 au mpya zaidi. Endesha node --version; lazima ichapishe v24 au ya juu zaidi. Sakinisha toleo la sasa la LTS kutoka nodejs.org — kwenye Windows winget install OpenJS.NodeJS.LTS, kwenye macOS brew install node@24.
• npm, ambayo huja na Node. Zinnector® huitumia mara moja, kupakua mfumo wa utekelezaji wa WordPress kwenye hifadhi yake ya muda (cache).
• git, kwa ajili ya zinnector push pekee — usambazaji unaendeshwa kutoka kwenye ghala lako.
• Docker, pale tu unapoiomba ukitumia --runtime docker. Mfumo chaguomsingi wa utekelezaji hauihitaji.

Hakuna kinachohitaji akaunti hapa chini. Kitufe cha API kinahitajika tu unapofikia nafasi ya upangishaji, katika Kusambaza kwa Zinnector®.

Hatua ya 1 — isakinishe

npm install -g zinnector

Ikiwa npm itachapisha npm WARN EBADENGINE, Node yako ni ya zamani zaidi kuliko >=24.18.1 inayotangazwa na kifurushi. Usakinishaji unakamilika hata hivyo, lakini CLI itakataa kujiendesha. Boresha Node kwanza, kisha usakinishe tena.

Hatua ya 2 — angalia toleo

zinnector --version

Mafanikio: nambari ya toleo, kwa mfano 0.1.2. Ukiona "Zinnector® needs Node 24 or newer — this is Node 20.x" binary imesakinishwa lakini Node yako ni ya zamani sana; amri inajifunga yenyewe ikiwa na msimbo 78 badala ya kufanya chochote.

Hatua ya 3 — soma usaidizi

zinnector --help

Mafanikio: bango linalotaja amri tano za mtiririko (new, dev, link, check, push) na kisha kila amri ikiwa na kusudi la mstari mmoja. Kila amri pia inachukua --help yake yenyewe — zinnector dev --help huorodhesha lebo za runtime, PHP na lango. Orodha kamili, yenye mifano, iko kwenye rejeleo la amri.

Hatua ya 4 — unda kiunzi cha tovuti

zinnector new my-site

Mafanikio: kichwa cha Created my-site na orodha ya faili zilizoandikwa — zinnector.json, muundo wa wp-content wenye plugins/, themes/ na kisaidizi cha mu-plugins/, .gitignore na README — ikifuatiwa na amri zinazofuata za kuendesha. Hakuna kishikilia nafasi ndani yake; mradi unaanza ulivyo. --template plugin au --template theme huunda kiunzi cha jalizi au mandhari ya vizuizi inayowashwa punde tu inapokuwepo.

Hatua ya 5 — iendeshe

cd my-site
zinnector dev

Mara ya kwanza, Zinnector® huuliza mara moja kabla ya kupakua mfumo wa utekelezaji wa WordPress — takriban MB 570, kwa sababu hubeba kila toleo la uundaji wa PHP kuanzia 5.2 hadi 8.5 — kwenye saraka yake yenyewe ya akiba, kamwe si kwenye mradi wako. Jibu Y, au weka --yes ili kuruka swali. Kwenye Node 26 au mpya zaidi, pia inaleta Node 24 kwa ajili ya runtime pekee (takriban MB 30, iliyothibitishwa kwa hesabu za uhakiki za nodejs.org), kwa sababu moduli asilia ya mfumo wa utekelezaji ina mifumo ya binary iliyoundwa mapema kwa Node 24 na 25 pekee; hauhitaji kikusanyi (compiler) au Visual Studio.

Mafanikio: kizuizi kinachotaja mradi, toleo la PHP na toleo la WordPress, kisha:

✔ running at http://127.0.0.1:9400
  admin: http://127.0.0.1:9400/wp-admin  (already signed in)

Hatua ya 6 — ifungue

Tembelea http://127.0.0.1:9400 kwenye kivinjari. Mafanikio: tovuti mpya ya WordPress yenye jina My WordPress Website, inayotolewa na toleo la PHP uliloomba. http://127.0.0.1:9400/wp-admin inafungua dashibodi ukiwa tayari umeingia. Weka jalizi ndani ya wp-content/plugins/ au mandhari ndani ya wp-content/themes/ na itakuwepo wakati wa upakiaji upya unaofuata — mfumo wa utekelezaji unatoa saraka hizo moja kwa moja kutoka kwenye mradi wako.

Bonyeza Ctrl-C ili kusimamisha. zinnector dev --once huanzisha mfumo wa utekelezaji, huchapisha kile kinachoendeshwa hasa (toleo la PHP, toleo la WordPress, viendelezi vilivyopakiwa) na kusimama — muhimu unapotaka uthibitisho badala ya ahadi.

Mahali pa kuelekea baadaye

• Uendelezaji wa ndani ukitumia zinnector dev — mifumo miwili ya utekelezaji, kuchagua matoleo ya PHP na WordPress, na kile kinachotolewa kutoka wapi.
• Kusambaza kwa Zinnector® — ingia, unganisha mradi kwenye nafasi, ifanyie ukaguzi wa awali, sambaza.
• Rejeleo la amri — kila amri, lebo na mfano.
• Utatuzi wa matatizo — makosa ambayo watu hukutana nayo hasa, na marekebisho kwa kila moja.

Nyaraka hizi hizi ziko kwenye README ya kifurushi kwenye npm na kwenye GitHub, ambapo masuala na maombi ya kuunganisha mabadiliko (pull requests) yanakaribishwa.