Bilowga Zinnector®, CLI-ga horumariyaha

Zinnector® waa qalab khadka-amarka ah ee bilaashka ah ee Zinn Digital® ee shatiga u haysta MIT ee loogu talagalay horumariyeyaasha WordPress. Waxay diyaarsataa bog, waxay ku shaqaysaa WordPress dhab ah mashiinkaaga adiga oo aan waxba ku rakibin oo aan ahayn Node mooyaane — ma jiro Docker, ma jiro MAMP, ma jiro PHP oo ku jira PATH-kaaga — ka dib waxay hubisaa waxa aad dhisatay marka loo eego booska martigelinta ee aad diyaarinaysato oo ay riixaysaa. Hagahan ayaa kaa qaadaya eber ilaa bog shaqaynaya laba daqiiqo gudahood, wuxuuna kuu sheegayaa waxa guushu u egtahay tallaabo kasta si aad u ogaato goorta wax qaldameen.

Waxa aad u baahan tahay

• Node 24 ama ka cusub. Sii wad node --version; waa inay daabacdaa v24 ama ka sarreeya. Ku rakib LTS-ka hadda jira nodejs.org — Windows winget install OpenJS.NodeJS.LTS, macOS brew install node@24.
• npm, oo la socota Node. Zinnector® waxay isticmaashaa hal mar, si ay ugu soo dejiso mashiinka WordPress kaydkeeda gaarka ah.
• git, kaliya zinnector push — geynta waxaa laga wadaa bakhaaradaada.
• Docker, kaliya haddii aad ka codsato --runtime docker. Mashiinka caadiga ah uma baahna wax.

Wax walba oo hoose ma u baahna akoon. Furaha API waxaa kaliya loo baahan yahay marka aad gaarto booska martigelinta, gudaha Deploying with Zinnector®.

Tallaabada 1 — ku rakib

npm install -g zinnector

Haddii npm uu daabaco npm WARN EBADENGINE, Node-kaagu waa ka da' weyn yahay >=24.18.1 ee xirmadu sheegayso. Rakibiddu way dhammaataa si kastaba, laakiin CLI waxay diidi doontaa inay shaqeyso. Horumari Node marka hore, kadibna ku rakib mar kale.

Tallaabada 2 — hubi nooca

zinnector --version

Guul: nambarka nooca, tusaale ahaan 0.1.2. Haddii aad aragto "Zinnector® needs Node 24 or newer — this is Node 20.x" binary-ga waa la rakibay laakiin Node-kaagu waa mid aad u da' weyn; amarku wuxuu ka baxayaa code 78 halkii uu wax samayn lahaa.

Tallaabada 3 — akhri caawinta

zinnector --help

Guul: calanka magacaabaya shanta amar ee socodka (new, dev, link, check, push) kadibna amar kasta oo wata ujeedo hal sadar ah. Amar kastaa wuxuu sidoo kale qaataa --help u gaar ah — zinnector dev --help waxay ku qortaa calanka mashiinka, PHP iyo dekedda. Liiska dhammaystiran, oo wata tusaalooyin, wuxuu ku jiraa command reference.

Tallaabada 4 — diyaari bog

zinnector new my-site

Guul: madax Created my-site ah iyo liiska faylalka ay qortay — zinnector.json, geed wp-content ah oo wata plugins/, themes/ iyo caawiye mu-plugins/, .gitignore iyo README — oo ay ku xigaan amarrada xiga ee la maamulayo. Wax ku jira ma aha meel bannaan; mashruucu wuxuu kabaxaa sida uu yahay. --template plugin ama --template theme waxay diyaariyaan plugin ama mawduuc xannibaad ah oo hawlgeliya xilliga uu jiro.

Tallaabada 5 — ku shaqee

cd my-site
zinnector dev

Markii ugu horreysay, Zinnector® waxay weydiisaa hal mar ka hor intaysan soo dejisan mashiinka WordPress — qiyaastii 570 MB, sababtoo ah waxay sidataa dhisme kasta oo PHP ah laga bilaabo 5.2 ilaa 8.5 — galka kaydkeeda gaarka ah, waligeedna ma gelin mashruucaaga. Ka jawaab Y, ama gudub --yes si aad uga boodo su'aasha. On Node 26 ama ka cusub waxay sidoo kale soo qaadataa Node 24 mashiinka kaliya (qiyaastii 30 MB, oo lagu xaqiijiyay xisaabinta nodejs.org), sababtoo ah moduleka asalka ah ee mashiinka wuxuu leeyahay binary hore loo dhisay oo kaliya Node 24 iyo 25; uma baahnid soo-ururiye ama Visual Studio.

Guul: block magacaabaya mashruuca, nooca PHP iyo nooca WordPress, ka dib:

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

Tallaabada 6 — fur

Booqo http://127.0.0.1:9400 biraawsarka dhexdiisa. Guul: bog WordPress cusub oo cinwaankiisu yahay My WordPress Website, oo ay u adeegto nooca PHP ee aad codsatay. http://127.0.0.1:9400/wp-admin waxay furaysaa dashboardka iyadoo horay loo saxiexay. Ku rid plugin wp-content/plugins/ ama mawduuc wp-content/themes/ waana halkaas dib-u-rarashada xigta — mashiinku wuxu u adeegaa hagayaashaas si toos ah mashruucaaga.

Riix Ctrl-C si aad u joojiso. zinnector dev --once waxay kordhisaa mashiinka, waxay daabacdaa waxa dhab ahaantii shaqaynaya (nooca PHP, nooca WordPress, kordhinta la raray) iyo joogsiga - faa'iido leh markaad rabto caddayn halkii aad ka heli lahayd ballanqaad.

Halkudhegyada xiga

• Local development with zinnector dev — labada mashiin, doorashada noocyada PHP iyo WordPress, iyo waxa laga adeegayo halka.
• Deploying with Zinnector® — gal, ku xidh mashruuca boos, diyaarso duulimaadka, riix.
• The command reference — amar kasta, calan iyo tusaale.
• Troubleshooting — khaladaadka dadku dhab ahaantii ku dhufteen, iyo hagaajinta mid kasta.

Dukumentiyada la midka ah waxay ku jiraan README-ka xirmada ee npm iyo GitHub, halkaas oo arrimaha iyo codsiyada jiidista ay soo dhow yihiin.