Kuanza na Zinnector®, CLI ya msanidi programu

Zinnector® ni zana ya bure ya mstari wa amri iliyo na leseni ya MIT ya Zinn Digital® kwa watengenezaji wa WordPress. Inatengeneza tovuti, inaendesha WordPress halisi kwenye kompyuta yako bila kusakinisha chochote isipokuwa Node — hakuna Docker, hakuna MAMP, hakuna PHP kwenye njia yako ya PATH — kisha inakagua kile ulichounda dhidi ya nafasi ya mwenyeji unayokaribia kupeleka na kukisukuma. Mwongozo huu unakupeleka kutoka bila kitu hadi kwenye tovuti inayofanya kazi kwa takriban dakika mbili, na unakuambia jinsi mafanikio yanavyoonekana katika kila hatua ili ujue wakati kitu kimeenda vibaya.

Unachohitaji

• Node 24 au mpya zaidi. Endesha node --version; lazima iandike v24 au 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 inakuja na Node. Zinnector® huitumia mara moja, kupakua mfumo wa uendeshaji wa WordPress kwenye kache yake yenyewe.
• git, tu kwa ajili ya zinnector push — upelekaji unaendeshwa kutoka kwa hazina yako.
• Docker, tu ikiwa utaiomba kwa --runtime docker. Mfumo chaguomsingi wa uendeshaji hauhitaji chochote.

Hakuna kitu kilicho hapa chini kinachohitaji akaunti. Ufunguo wa API unahitajika tu unapofika kwenye nafasi ya mwenyeji, katika Deploying with Zinnector®.

Hatua ya 1 — isakinishe

npm install -g zinnector

Ikiwa npm itaandika npm WARN EBADENGINE, Node yako ni ya zamani kuliko >=24.18.1 ambayo kifurushi kinatangaza. Usakinishaji unakamilika hata hivyo, lakini CLI itakataa kuendesha. Pandisha daraja la 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 imewekwa lakini Node yako ni ya zamani sana; amri inatoka na nambari 78 badala ya kufanya kitu chochote.

Hatua ya 3 — soma msaada

zinnector --help

Mafanikio: bendera inayotaja amri tano za mtiririko (new, dev, link, check, push) na kisha kila amri yenye lengo la mstari mmoja. Kila amri pia inachukua --help yake yenyewe — zinnector dev --help inaorodhesha bendera za mfumo wa uendeshaji, PHP na bandari. Orodha kamili, yenye mifano, iko katika command reference.

Hatua ya 4 — tengeneza tovuti

zinnector new my-site

Mafanikio: kichwa cha Created my-site na orodha ya faili ilizoandika — zinnector.json, mti wa wp-content wenye plugins/, themes/ na msaidizi wa mu-plugins/, \.gitignore na README — ikifuatiwa na amri zinazofuata za kuendesha. Hakuna kitu ndani yake kilicho kibadilishaji nafasi; mradi unaanza kama ulivyo. --template plugin au --template theme hutengeneza programu-jalizi au mandhari ya kuzuia inayowashwa mara tu inapokuwepo.

Hatua ya 5 — iendeshe

cd my-site
zinnector dev

Mara ya kwanza, Zinnector® kuuliza mara moja kabla ya kupakua mfumo wa uendeshaji wa WordPress — takriban 570 MB, kwa sababu hubeba kila ujenzi wa PHP kutoka 5.2 hadi 8.5 — kwenye saraka yake ya kache, kamwe kwenye mradi wako. Jibu Y, au pitisha --yes kuruka swali. Kwenye Node 26 au mpya zaidi pia hupata Node 24 kwa ajili ya mfumo wa uendeshaji pekee (takriban 30 MB, imethibitishwa dhidi ya jumla hakiki za nodejs.org), kwa sababu moduli ya asili ya mfumo wa uendeshaji ina binary zilizojengwa mapema kwa ajili ya Node 24 na 25 pekee; hutaki kikusanyaji 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 katika kivinjari. Mafanikio: tovuti mpya ya WordPress yenye kichwa My WordPress Website, inayohudumiwa na toleo la PHP ambalo uliomba. http://127.0.0.1:9400/wp-admin inafungua dashibodi ikiwa tayari imeingia. Weka programu-jalizi kwenye wp-content/plugins/ au mandhari kwenye wp-content/themes/ na iko pale kwenye upakiaji upya unaofuata — mfumo wa uendeshaji unahudumia saraka hizo moja kwa moja kutoka kwa mradi wako.

Bonyeza Ctrl-C kusimamisha. zinnector dev --once huanzisha mfumo wa uendeshaji, inaandika kile kinachoendelea kwa sasa (toleo la PHP, toleo la WordPress, viendelezi vilivyopakiwa) na kusimama — ni muhimu unapotaka uthibitisho badala ya ahadi.

Mahali pa kwenda baadaye

• Local development with zinnector dev — mifumo miwili ya uendeshaji, kuchagua matoleo ya PHP na WordPress, na kile kinachohudumiwa kutoka wapi.
• Deploying with Zinnector® — ingia, unganisha mradi kwenye nafasi, fanya ukaguzi wa kabla ya safari, sukuma.
• The command reference — kila amri, bendera na mfano.
• Troubleshooting — makosa ambayo watu hukutana nayo, na suluhisho kwa kila moja.

Nyaraka zile zile ziko kwenye README ya kifurushi kwenye npm na kwenye GitHub, ambapo masuala na maombi ya kuvuta yanakaribishwa.