Bẹrẹ pẹlu Zinnector®, CLI olùgbòró

Zinnector® jẹ́ irinṣẹ́ àṣẹ-ọ̀rọ̀ ọ̀fẹ́, tí a ní ìwé-àṣẹ MIT ti Zinn Digital® fún àwọn olùgbééṣẹ́ WordPress. Ó gbé ojula kalẹ, ó sì ń ṣe ìṣiṣẹ́ WordPress gidi kan lori ẹ̀rọ tirẹ pẹ̀lú ohunkohun tí kò ní ohunkohun ti a fi sori ẹrọ ayafi Node — ko si Docker, ko si MAMP, ko si PHP lori PATH rẹ — lẹhinna o ṣayẹwo ohun ti o kọ lodi si aye igbalejo ti o fẹ lati ranṣẹ si o si Titari rẹ. Itọsọna yii mu ọ lati inu ohunkohun si aaye ti n ṣiṣẹ ni bii iṣẹju meji, o si sọ fun ọ ohun ti aṣeyọri dabi ni gbogbo igbesẹ ki o le mọ nigbati ohun kan tiṣẹ aiṣedeede.

Ohun ti o nilo

Node 24 tabi titun. Ṣiṣe node --version; o gbọdọ tẹ v24 tabi ga julọ. Fi LTS lọwọlọwọ sori ẹrọ lati nodejs.org — lori Windows winget install OpenJS.NodeJS.LTS, lori macOS brew install node@24.
npm, eyiti o wa pẹlu Node. Zinnector® nlo o lẹẹkan, lati ṣe igbasilẹ akoko ṣiṣe WordPress sinu kaṣe tirẹ.
git, nikan fun zinnector push — awọn ifijiṣẹ ni iṣakoso lati ibi ipamọ rẹ.
Docker, nikan ti o ba beere fun pẹlu --runtime docker. Akoko ṣiṣe aiyipada ko nilo kankan.

Ko si nkan ti o wa ni isalẹ ti o nilo akọọlẹ kan. Bọtini API kan ni a nilo nikan nigbati o ba de aaye igbalejo kan, ninu Deploying with Zinnector®.

Igbesẹ 1 — fi sori ẹrọ

npm install -g zinnector

Ti npm ba tẹ npm WARN EBADENGINE, Node rẹ jẹ agbalagba ju >=24.18.1 ti package n kede. Fifi sori ẹrọ pari lonakona, ṣugbọn CLI yoo kọ latiṣiṣẹ. Ṣe igbega Node kọkọ, lẹhinna fi sori ẹrọ lẹẹkansi.

Igbesẹ 2 — ṣayẹwo ẹya naa

zinnector --version

Aṣeyọri: nọmba ẹya kan, fun apẹẹrẹ 0.1.2. Ti o ba ri "Zinnector® needs Node 24 or newer — this is Node 20.x" alakomeji naa ti fi sori ẹrọ ṣugbọn Node rẹ ti dagba ju; aṣẹ naa jade pẹlu koodu 78 dipo ṣiṣe ohunkohun.

Igbesẹ 3 — ka iranlọwọ

zinnector --help

Aṣeyọri: asia kan ti o npè awọn aṣẹ marun ti sisan (new, dev, link, check, push) ati lẹhinna gbogbo aṣẹ pẹlu idi laini kan. Gbogbo aṣẹ tun gba --help tirẹ — zinnector dev --help ṣe akojọ akoko ṣiṣe, PHP ati awọn asia ibudo. Akojọ pipe, pẹlu awọn apẹẹrẹ, wa ninu command reference.

Igbesẹ 4 — gbe aaye kan kalẹ

zinnector new my-site

Aṣeyọri: akọle Created my-site ati atọnisọna ti awọn faili ti o kọ — zinnector.json, igi wp-content kan pẹlu plugins/, themes/ ati oluranlọwọ mu-plugins/, .gitignore kan ati README kan — ti o tẹle nipasẹ awọn aṣẹ atẹle latiṣiṣẹ. Ko si nkan ti o wa ninu rẹ ti o jẹ apẹẹrẹ; iṣẹ naa bẹrẹ bi o ti wa. --template plugin tabi --template theme gbe afikun tabi akori bulọọki kalẹ ti o muu ṣiṣẹ ni akoko ti o wa.

Igbesẹ 5 — ṣiṣẹ ẹ

cd my-site
zinnector dev

Ni igba akọkọ, Zinnector® beere lẹẹkan ṣaaju gbigba akoko ṣiṣe WordPress silẹ — bii 570 MB, nitori o gbe gbogbo ikole PHP lati 5.2 si 8.5 — sinu itọsọna kaṣe tirẹ, kii ṣe sinu iṣẹ rẹ lailai. Dahun Y, tabi kọja --yes lati foju ibeere naa. Lori Node 26 tabi titun o tun gba Node 24 fun akoko ṣiṣe nikan (bii 30 MB, ti a rii daju lodi si awọn iṣiro nodejs.org), nitori module abinibi ti akoko ṣiṣe ni awọn alakomeji ti a ti kọ tẹlẹ nikan fun Node 24 ati 25; o ko nilo alamọ tabi Visual Studio.

Aṣeyọri: bulọọki kan ti o npè iṣẹ naa, ẹya PHP ati ẹya WordPress, lẹhinna:

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

Igbesẹ 6 — ṣii ẹ

Ṣabẹwo http://127.0.0.1:9400 ninu ẹrọ aṣawakiri kan. Aṣeyọri: aaye WordPress tuntun ti akọle rẹ jẹ My WordPress Website, ti oṣiṣẹ nipasẹ ẹya PHP ti o beere fun. http://127.0.0.1:9400/wp-admin ṣii dasibodu naa ti a ti wọle tẹlẹ. Ju afikun kan sinu wp-content/plugins/ tabi akori kan sinu wp-content/themes/ ati pe o wa nibẹ lori atunkọ atẹle — akoko ṣiṣe nṣe iranlọwọ fun awọn ilana wọnyẹn taara lati iṣẹ rẹ.

Tẹ Ctrl-C lati da duro. zinnector dev --once bẹrẹ akoko ṣiṣe, tẹ ohun ti n ṣiṣẹ gangan jade (ẹya PHP, ẹya WordPress, awọn amugbooro ti a kojọpọ) o si duro — wulo nigbati o fẹ ẹri dipo ileri kan.

Nibo ni lati lọ nigbakan

Local development with zinnector dev — awọn akoko ṣiṣe meji, yiyan awọn ẹya PHP ati WordPress, ati ohun ti a nṣe iranlọwọ lati ibo.
Deploying with Zinnector® — wọle, so iṣẹ pọ si aaye kan, ṣe iṣaju rẹ, tari.
The command reference — gbogbo aṣẹ, asia ati apẹẹrẹ.
Troubleshooting — awọn aṣiṣe ti eniyan n kọlu gangan, ati atunṣe fun ọkọọkan.

Iwe aṣẹ kanna wa ninu README package lori npm ati lori GitHub, nibiti awọn ọran ati awọn ibeere fifaa ti kaabo.