Zinnector® Sorun Giderme

İnsanların Zinnector® CLI ile gerçekten karşılaştığı hatalar, her birinin ne anlama geldiği ve çözümü. Her kayıt, göreceğiniz tam metni belirtir, böylece bu sayfada arama yapabilirsiniz. Sizinki burada yoksa, hatalı komutu ZINNECTOR_DEBUG=1 ile çalıştırın ve çıktıyı, node --version sürümünüzü ve işletim sisteminizi belirterek github.com/Zinn-Digital/zinnector/issues adresinde bir sorun (issue) açın.

Çalışma zamanı kurulumunu kabul ettikten hemen sonra "spawn EINVAL" (Windows)

Zinnector® 0.1.0 ve 0.1.1 sürümündeki bir hata. Windows'ta çalışma zamanı yükleyicisi npm.cmd dosyasını adıyla çalıştırdı ve Node, CVE-2024-27980 için getirdiği düzeltmeden bu yana bir kabuk (shell) olmadan .cmd dosyası başlatmayı reddediyor — dolayısıyla kurulum, Y yanıtını vermenizden bir saniye sonra kilitlendi. 0.1.2 sürümünde düzeltildi: npm artık her platformda aynı olan ve kabuk gerektirmeyen node npm-cli.js olarak çalıştırılıyor. npm install -g zinnector@latest komutunu, ardından tekrar zinnector dev komutunu çalıştırın.

Kurulum sırasında "npm WARN EBADENGINE" veya "Zinnector® needs Node 24 or newer"

Node sürümünüz 24'ten eski. Paket engines: >=24.18.1 beyan ettiği için npm bu uyarısı verir; kurulum yine de tamamlanır, ancak zinnector daha sonra kafa karıştırıcı bir yerde başarısız olmak yerine başlatmayı reddeder (çıkış kodu 78). nodejs.org/en/download adresinden güncel LTS sürümünü yükleyin — Windows'ta winget install OpenJS.NodeJS.LTS, macOS'ta brew install node@24 — node --version komutunun v24 veya daha yüksek bir sürüm yazdırdığını onaylayın ve Zinnector®'ü yeniden yükleyin.

"gyp ERR!", "Building from source with node-gyp" veya "You need to install Visual Studio"

WordPress çalışma zamanı, önceden derlenmiş ikili dosyaları yalnızca Node 24 ve 25 için var olan yerel bir modüle sahiptir. Daha yeni bir Node sürümünde (Eylül 2026 itibarıyla 26 ve üzeri) yükleyicisi kaynak koddan derlemeye geri döner; bu da standart bir Windows makinesinde Visual Studio talebiyle sonlanır. 0.1.2 sürümünde düzeltildi: Zinnector® bunu herhangi bir şey indirmeden önce algılar ve nodejs.org'un sağlama toplamlarına (checksum) karşı doğrulanmış, yaklaşık 30 MB boyutunda yalnızca çalışma zamanına yönelik bir Node 24 getirir — böylece hiçbir şey asla derlenmez. Yükseltme yaptıktan sonra yine de görürseniz, önceki yarı tamamlanmış kurulumun ilk başta atılması için zinnector dev --reset-runtime komutunu çalıştırın.

Temizlik yapılırken npm'den gelen "EPERM" uyarıları (Windows)

Neredeyse her zaman, npm bunu kaldırmaya çalışırken çalışma zamanının node_modules dizini altında bir dosya tutan bir antivirüs tarayıcısı veya arama dizin oluşturucusudur (search indexer). Sonraki zinnector dev komutunda kurulum temiz bir dizinden yeniden denenir; sorun devam ederse, zinnector dev --reset-runtime önce tüm çalışma zamanı dizinini kaldırır ve yeniden yükler.

"the local playground runtime could not be installed"

Mesaj, npm'in kendi son satırlarını ve Zinnector®'ün çalıştırdığı tam komutu içerir, böylece bunu kendiniz çalıştırabilir ve tam çıktıyı görebilirsiniz. Olağan nedenler bir ağ veya proxy sorunu (çalışma zamanı kendi npm'inizle getirilir, bu nedenle npm config set proxy … ve bir kayıt defteri aynası geçerlidir) ya da --reset-runtime komutunun temizlediği yarı tamamlanmış önceki bir kurulumdur.

"the local playground exited before it was ready" veya hiçbir zaman hazır duruma gelmiyor

Çalışma zamanının kendi çıktısını görmek için zinnector dev --verbose komutunu çalıştırın. Zaten kullanımda olan bir bağlantı noktası (port) yaygın bir nedendir: zinnector dev --port 9401 veya zinnector.json dosyasında port ayarını yapın. Kurulan ancak önyükleme yapmayacak olan bir çalışma zamanı için: zinnector dev --reset-runtime. İlk önyükleme ayrıca WordPress'in kendisini de indirir, bu nedenle yavaş bir bağlantıda birkaç dakika verin; CLI, askıda kalmak yerine zaman aşımı bildirmeden önce en fazla beş dakika bekler.

Gönderimde (push) "this project is not a git repository"

Dağıtımlar bir depodan (repository) yürütülür, bu nedenle zinnector push platformun erişebileceği uzak bir konuma (remote) sahip bir depo gerektirir. git init && git add -A && git commit -m initial komutlarını çalıştırın, GitHub veya GitLab uzak konumunuzu ekleyin ve ardından siteye bağlamak için zinnector link komutunu kullanın.

Dağıtımdan sonra site beyaz görünüyor

zinnector check komutunu çalıştırın. On seferin dokuzunda bu bir PHP sürüm uyumsuzluğudur — yuvanın (slot) çalıştırdığından daha yeni bir PHP sürümünde derleme yapmışsınızdır — ve rapor, yuvanın hangi sürüme zinnector php <version> ile geçirilmesi gerektiğini veya hangi sürümle geliştirme yapılması gerektiğini zinnector dev --php <version> ile söyler. zinnector logs --error kritik hatanın (fatal) kendisini gösterir.

İlgili

• Başlarken · Yerel geliştirme · Dağıtma · Komut başvurusu