Geliştirici CLI aracı olan Zinnector® ile çalışmaya başlama

Node 24 veya sonraki bir sürüm üzerinde ücretsiz Zinnector CLI'ı yükleyin ve iki dakika içinde çalıştığını doğrulayın: --version, --help, bir site iskeleleyin, Docker olmadan yerel olarak gerçek bir WordPress çalıştırın ve her adımda neyin başarı anlamına geldiğiyle birlikte tarayıcınızda açın.

Zinnector®(), WordPress geliştiricileri için Zinn Digital®'in ücretsiz, MIT lisanslı komut satırı aracıdır. Bir site taslağı oluşturur, bilgisayarınızda Node dışında hiçbir şey kurulu olmadan — Docker yok, MAMP yok, PATH üzerinde PHP yok — gerçek bir WordPress çalıştırır, ardından oluşturduğunuz yapıyı dağıtacağınız barındırma alanına göre kontrol eder ve gönderir. Bu kılavuz, hiçbir şeyden yaklaşık iki dakika içinde çalışan bir siteye geçmenizi sağlar ve bir şeyler yanlış gittiğinde bilmeniz için her adımda başarının neye benzediğini söyler.

Ne gereklidir?

Node 24 veya daha yenisi. node --version komutunu çalıştırın; v24 veya daha yüksek bir sürüm yazdırmalıdır. Mevcut LTS sürümünü nodejs.org adresinden yükleyin — Windows için winget install OpenJS.NodeJS.LTS, macOS için brew install node@24.
Node ile birlikte gelen npm. Zinnector®, WordPress çalışma zamanını kendi önbelleğine indirmek için bunu bir kez kullanır.
Yalnızca zinnector push için git — dağıtımlar deponuzdan gerçekleştirilir.
Yalnızca --runtime docker ile talep ettiğinizde Docker. Varsayılan çalışma zamanı buna ihtiyaç duymaz.

Aşağıdakilerin hiçbiri hesap gerektirmez. Bir API anahtarına yalnızca bir barındırma alanına ulaştığınızda Zinnector® ile Dağıtma bölümünde ihtiyaç duyulur.

Adım 1 — yükleyin

npm install -g zinnector

Eğer npm npm WARN EBADENGINE çıktısını verirse, Node sürümünüz paketin belirttiği >=24.18.1 sürümünden daha eskidir. Kurulum yine de tamamlanır, ancak CLI çalışmayı reddeder. Önce Node'u güncelleyin, ardından yeniden yükleyin.

Adım 2 — sürümü kontrol edin

zinnector --version

Başarı: örneğin 0.1.2 gibi bir sürüm numarası. Eğer "Zinnector® needs Node 24 or newer — this is Node 20.x" mesajını görürseniz, ikili dosya yüklenmiştir ancak Node sürümünüz çok eskidir; komut herhangi bir işlem yapmadan 78 koduyla sonlanır.

Adım 3 — yardımı okuyun

zinnector --help

Başarı: akışın beş komutunu (new, dev, link, check, push) adlandıran bir başlık ve ardından tek satırlık bir amaç içeren her komut. Her komut ayrıca kendi --help parametresini de kabul eder — zinnector dev --help çalışma zamanı, PHP ve bağlantı noktası bayraklarını listeler. Örneklerle birlikte tam liste komut referansında yer almaktadır.

Adım 4 — site taslağı oluşturun

zinnector new my-site

Başarı: bir Created my-site başlığı ve yazdığı dosyaların bir listesi — zinnector.json, plugins/, themes/ ve bir mu-plugins/ yardımcısına sahip bir wp-content ağacı, bir .gitignore ve bir README — ardından çalıştırılacak sonraki komutlar. İçindeki hiçbir şey yer tutucu değildir; proje olduğu gibi başlar. --template plugin veya --template theme komutları, var olduğu anda etkinleşen bir eklenti veya blok tema taslağı oluşturur.

Adım 5 — çalıştırın

cd my-site
zinnector dev

İlk seferinde Zinnector®, WordPress çalışma zamanını projenize değil kendi önbellek dizinine indirmeden önce bir kez sorar — 5.2'den 8.5'e kadar her PHP derlemesini taşıdığı için yaklaşık 570 MB'tır. Soruyu atlamak için Y yanıtını verin veya --yes parametresini geçirin. Node 26 veya daha yenisinde, çalışma zamanının yerel modülü yalnızca Node 24 ve 25 için önceden oluşturulmuş ikili dosyalara sahip olduğundan, çalışma zamanı için ayrıca bir Node 24 getirir (yaklaşık 30 MB, nodejs.org'un sağlama toplamlarına göre doğrulanmıştır); bir derleyiciye veya Visual Studio'ya ihtiyacınız yoktur.

Başarı: projeyi, PHP sürümünü ve WordPress sürümünü adlandıran, ardından şunları gösteren bir blok:

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

Adım 6 — açın

Bir tarayıcıda http://127.0.0.1:9400 adresini ziyaret edin. Başarı: İstediğiniz PHP sürümü tarafından sunulan, My WordPress Website başlıklı yeni bir WordPress sitesi. http://127.0.0.1:9400/wp-admin adresi kontrol panelini zaten oturum açmış olarak açar. wp-content/plugins/ içine bir eklenti veya wp-content/themes/ içine bir tema bırakın; bir sonraki yeniden yüklemede orada olacaktır — çalışma zamanı bu dizinleri doğrudan projektörünüzden sunar.

Durdurmak için Ctrl-C tuşlarına basın. zinnector dev --once çalışma zamanını başlatır, neyin çalıştığını (PHP sürümü, WordPress sürümü, yüklenen eklentiler) yazdırır ve durur — bir vaat yerine kanıt istediğinizde kullanışlıdır.

Sonraki adımlar

zinnector dev ile yerel geliştirme — iki çalışma zamanı, PHP ve WordPress sürümlerinin seçilmesi ve nereden neyin sunulduğu.
Zinnector® ile Dağıtma — oturum açın, projeyi bir yuvaya bağlayın, uçuş öncesi kontrol yapın, gönderin.
Komut referansı — her komut, bayrak ve örnek.
Sorun giderme — kullanıcıların gerçekten karşılaştığı hatalar ve her biri için çözüm.

Aynı belgelendirme npm üzerindeki ve sorunlar ile çekme isteklerinin memnuniyetle karşılandığı GitHub üzerindeki paketin README dosyasında yer almaktadır.