Tərtibatçı CLI aləti olan Zinnector® ilə işə başlamaq

Zinnector® Zinn Digital®-in WordPress tərtibatçıları üçün pulsuz, MIT lisenziyalı əmr sətri alətidir. O, saytın strukturunu qurur, Node-dan başqa heç nə quraşdırılmadan — Docker olmadan, MAMP olmadan, PATH-inizdə PHP olmadan — öz maşınınızda real WordPress işlədir, sonra qurduğunuzu yerləşdirmək üzrə olduğunuz hostinq yuvası ilə müqayisə edərək yoxlayır və göndərir. Bu bələdçi sizi təxminən iki dəqiqə ərzində sıfırdan işlək bir sayta çatdırır və hər bir addımda uğurlu nəticənin necə göründüyünü izah edir ki, nəyinsə səhv getdiyini biləsiniz.

Sizə nə lazımdır

• Node 24 və ya daha yeni. node --version əmrini işə salın; o, v24 və ya daha yüksək versiya göstərməlidir. Cari LTS-i nodejs.org saytından quraşdırın — Windows-da winget install OpenJS.NodeJS.LTS, macOS-da brew install node@24.
• npm, Node ilə birlikdə gəlir. Zinnector® ondan bir dəfə, WordPress icra mühitini öz keşinə yükləmək üçün istifadə edir.
• git, yalnız zinnector push üçün — yerləşdirmələr sizin repozitoriyanızdan idarə olunur.
• Docker, yalnız --runtime docker ilə tələb etsəniz. Defolt icra mühiti heç birinə ehtiyac duymur.

Aşağıdakı heç bir şey üçün hesab tələb olunmur. API açarı yalnız hostinq yuvasına çatdıqda lazımdır, baxın: Zinnector® ilə yerləşdirmə.

Addım 1 — quraşdırın

npm install -g zinnector

Əgər npm npm WARN EBADENGINE çıxararsa, Node versiyanız paketin bəyan etdiyi >=24.18.1 versiyasından daha köhnədir. Quraşdırma hər halda başa çatır, lakin CLI işləməkdən imtina edəcək. Əvvəlcə Node-u təkmilləşdirin, sonra yenidən quraşdırın.

Addım 2 — versiyanı yoxlayın

zinnector --version

Uğur: versiya nömrəsi, məsələn 0.1.2. Əgər "Zinnector® needs Node 24 or newer — this is Node 20.x" görsəniz, ikili fayl quraşdırılıb, lakin Node-unuz çox köhnədir; əmr heç bir iş görmədən 78 kodu ilə çıxış edir.

Addım 3 — kömək məlumatını oxuyun

zinnector --help

Uğur: iş axınının beş əmrinin adını çəkən banner (new, dev, link, check, push) və sonra hər bir əmrin bir sətirlik təyinatı. Hər bir əmr həmçinin özünə aid --help qəbul edir — zinnector dev --help icra mühiti, PHP və port bayraqlarını sadalayır. Tam siyahı nümunələrlə birlikdə əmr sorğu kitabçasında yerləşir.

Addım 4 — saytın strukturunu qurun

zinnector new my-site

Uğur: Created my-site başlığı və yazdığı faylların siyahısı — zinnector.json, plugins/, themes/ və mu-plugins/ köməkçisi olan wp-content ağacı, .gitignore və README — ardınca icra ediləcək növbəti əmrlər. Oradakı heç nə yer tutucu deyil; layihə olduğu kimi işə düşür. --template plugin və ya --template theme yaradıldığı anda aktivləşən plaginin və ya blok mövzusunun strukturunu qurur.

Addım 5 — işə salın

cd my-site
zinnector dev

İlk dəfə Zinnector® WordPress icra mühitini — təxminən 570 MB, çünki o, 5.2-dən 8.5-ə qədər hər bir PHP yığımını daşıyır — heç vaxt layihənizə deyil, öz keş qovluğuna yükləməzdən əvvəl bir dəfə soruşur. Y cavabı verin və ya sualı ötürmək üçün --yes parametrini ötürün. Node 26 və ya daha yeni versiyalarda o, həmçinin təkcə icra mühiti üçün bir Node 24 əldə edir (təxminən 30 MB, nodejs.org-un yoxlama cəmləri ilə təsdiqlənmişdir), çünki icra mühitinin yerli modulu yalnız Node 24 və 25 üçün əvvəlcədən yığılmış ikili fayllara malikdir; sizə kompilyator və ya Visual Studio lazım deyil.

Uğur: layihənin, PHP versiyasının və WordPress versiyasının adını çəkən blok, sonra:

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

Addım 6 — onu açın

Brauzerdə http://127.0.0.1:9400 ünvanına daxil olun. Uğur: tələb etdiyiniz PHP versiyası ilə təqdim edilən, My WordPress Website başlıqlı yeni WordPress saytı. http://127.0.0.1:9400/wp-admin ünvanı artıq daxil olunmuş idarəetmə panelini açır. Plagini wp-content/plugins/ və ya mövzunu wp-content/themes/ qovluğuna atın və növbəti yeniləmədə o, artıq oradadır — icra mühiti həmin qovluqları birbaşa layihənizdən təqdim edir.

Dayandırmaq üçün Ctrl-C basın. zinnector dev --once icra mühitini işə salır, faktiki olaraq nəyin işlədiyini göstərir (PHP versiyası, WordPress versiyası, yüklənmiş genişlənmələr) və dayanır — vəd deyil, sübut istədiyiniz zaman faydalıdır.

Növbəti hara getməli

• zinnector dev ilə lokal tərtibat — iki icra mühiti, PHP və WordPress versiyalarının seçilməsi və nəyin haradan təqdim edildiyi.
• Zinnector® ilə yerləşdirmə — daxil olun, layihəni yuvaya bağlayın, ilkin yoxlamanı aparın, göndərin.
• Əmr sorğu kitabçası — hər bir əmr, bayraq və nümunə.
• Nasazlıqların aradan qaldırılması — insanların həqiqətən qarşılaşdığı xətalar və hər birinin həlli yolu.

Eyni sənədlər paketin npm və məsələlərin və sorğuların qəbul edildiyi GitHub üzərindəki README faylında mövcuddur.