Madogarar ilimi

Fara amfani da Zinnector®, CLI na mai haɓakawa

Shigar da kyauta Zinnector CLI akan Node 24 ko sabon abu, sannan ka tabbatar yana aiki cikin mintuna biyu: --version, --help, gina rukunin yanar gizo, gudanar da ainihin WordPress a cikin gida ba tare da Docker ba, kuma ka buɗe shi a cikin burauzarka — tare da abin da nasara take nufi a kowane mataki.

Zinnector® shine kayan aikin command-line na kyauta, mai lasisin MIT na Zinn Digital® don masu haɓaka WordPress. Yana tsara shafi, yana gudanar da ainihin WordPress akan na'urarku ba tare da an shigar da komai ba sai Node — babu Docker, babu MAMP, babu PHP akan PATH dinku — sannan yana duba abin da kuka gina da wajen hosting da kuke shirin turawa zuwa gare shi sannan ya tura shi. Wannan jagorar za ta kai ku daga babu komai zuwa shafi mai aiki a cikin kamar mintuna biyu, kuma tana gaya muku yadda nasara take a kowane mataki domin ku sani idan wani abu ya samu matsala.

Abin da kuke buƙata

  • Node 24 ko sabo fiye da haka. Gudanar da node --version; dole ne ya fito da v24 ko sama da haka. Shigar da LTS na yanzu daga nodejs.org — akan Windows winget install OpenJS.NodeJS.LTS, akan macOS brew install node@24.
  • npm, wanda ke zuwa tare da Node. Zinnector® yana amfani da shi sau ɗaya, don sauke WordPress runtime zuwa cikin cache dinsa.
  • git, kawai don zinnector push — ana gudanar da tura bayanai daga taskarku (repository).
  • Docker, kawai idan kuka buƙace shi tare da --runtime docker. Tsohuwar runtime ba ta buƙatar komai.

Babu abin da ke ƙasa da yake buƙatar asansu (account). Ana buƙatar maɓallin API kawai lokacin da kuka kai wajen hosting, a cikin Tura bayanai tare da Zinnector®.

Mataki na 1 — shigar da shi

npm install -g zinnector

Idan npm ya fito da npm WARN EBADENGINE, Node dinku ya tsufa fiye da >=24.18.1 wanda kunshin ke buƙata. Shigarwar za ta ƙare ko ta halin ƙaƙa, amma CLI zai ƙi yin aiki. Hakaƙe Node da farko, sannan kuka sake shigarwa.

Mataki na 2 — duba sigar (version)

zinnector --version

Nasara: lambar siga, misali 0.1.2. Idan kuka ga "Zinnector® yana buƙatar Node 24 ko sabo fiye da haka — wannan Node 20.x ne" an shigar da binary ɗin amma Node ɗinku ya tsufa da yawa; umarnin yana fita ne tare da lambar kulawa (code) 78 maimakon yin wani abu.

Mataki na 3 — karanta taimako

zinnector --help

Nasara: tambarin da ke ambaton umarni guda biyar na tafiyar (new, dev, link, check, push) sannan kowane umarni tare da manufa ta layi ɗaya. Kowane umarni yana amfani da --help na kansa — zinnector dev --help yana jera runtime, PHP da tutocin port. Cikakken jerin, tare da misalai, yana cikin jagorar umarni.

Mataki na 4 — tsara shafi

zinnector new my-site

Nasara: taken Created my-site da jerin fayilolin da ya rubuta — zinnector.json, itacen wp-content tare da plugins/, themes/ da mu-plugins/ mai taimakawa, .gitignore da README — wanda umarni na gaba da za a gudanar ke biye da su. Babu komai a cikinsa da yake wurin kiyayewa kawai; aikin yana farawa kamar yadda yake. --template plugin ko --template theme suna tsara plugin ko block theme wanda ke farawa da zaran ya kasance.

Mataki na 5 — gudanar da shi

cd my-site
zinnector dev

A karon farko, Zinnector® yana tambaya sau ɗaya kafin sauke WordPress runtime — kusan MB 570, saboda yana ɗauke da kowane gini na PHP daga 5.2 zuwa 8.5 — zuwa cikin jakar cache dinsa, ba a cikin aikinku ba. Amsa Y, ko gudanar da --yes don tsallake tambayar. Akan Node 26 ko sabo fiye da haka yana kuma zakulo Node 24 don runtime ɗin shi kaɗai (kusan MB 30, wanda aka tabbatar da shi a kan lambobin checksums na nodejs.org), saboda tsarin mahadi na runtime yana da prebuilt binaries ne kawai don Node 24 da 25; ba ku buƙatar compiler ko Visual Studio.

Nasara: akwati da ke ambaton sunan aikin, sigar PHP da sigar WordPress, sannan:

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

Mataki na 6 — buɗe shi

Ziyarci http://127.0.0.1:9400 a cikin mashafin yanar gizo (browser). Nasara: sabon shafin WordPress mai taken My WordPress Website, wanda sigar PHP da kuka buƙata ke gudanarwa. http://127.0.0.1:9400/wp-admin yana buɗe dashboard ɗin an riga an shiga. Sanya plugin a cikin wp-content/plugins/ ko theme a cikin wp-content/themes/ kuma zai kasance a can a sake sake gudanarwa ta gaba — runtime ɗin yana gabatar da waɗancan jakunkunan kai tsaye daga aikinku.

Danna Ctrl-C don tsayawa. zinnector dev --once yana gudanar da runtime, yana fito da abin da ke aiki a zahiri (sigar PHP, sigar WordPress, tsawaitawa da aka ɗora) sannan ya tsaya — yana da amfani lokacin da kuke buƙatar tabbaci maimakon alkawari.

Inda za a je na gaba

Irin wannan rubutun bayanan yana cikin README na kunshin a npm da kuma a GitHub, inda ake maraba da batutuwa (issues) da bukatar tura gyara (pull requests).

Kuna nan makale?

An haɗa da tallafi a kowane tsari kuma ana ba da amsa a cikin harshenka.

Tuntuɓi tallafi Dukkan labarai