Kullanıcıların Zinnector® CLI ile fiilen karşılaştığı hatalar, her birinin ne anlama geldiği ve çözümü. Her girdi tam olarak göreceğiniz metni belirtir, böylece bu sayfada arama yapabilirsiniz. Sizinki burada yoksa, başarısız olan komutu ZINNECTOR_DEBUG=1 ile çalıştırın ve çıktı, node --version bilginiz ve işletim sisteminizle birlikte github.com/Zinn-Digital/zinnector/issues adresinde bir sorun kaydı açın.
Çalışma zamanı kurulumunu onayladıktan hemen sonra "spawn EINVAL" (Windows)
Zinnector® 0.1.0 ve 0.1.1 sürümlerindeki bir hata. Windows'ta çalışma zamanı yükleyicisi npm.cmd dosyasını adıyla çalıştırıyordu ve Node, CVE-2024-27980 düzeltmesinden bu yana bir kabuk olmadan .cmd dosyasını başlatmayı reddetmektedir; bu nedenle kurulum, siz Y yanıtını verdikten bir saniye sonra çökmekteydi. 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ılmaktadır. 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 eskidir. npm bu uyarıyı paketin engines: >=24.18.1 bildirmesi nedeniyle verir; kurulum yine de tamamlanır, ancak zinnector daha sonra kafa karıştırıcı bir noktada hata vermek yerine başlatılmayı reddeder (çıkış kodu 78). nodejs.org adresinden güncel LTS sürümünü kurun — 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ı doğrulayın ve Zinnector® kurulumunu tekrar yapın.
"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 mevcut olan yerel bir modüle sahiptir. Daha yeni bir Node sürümünde (Eylül 2026 itibarıyla 26 ve üzeri), yükleyicisi kaynaktan derlemeye geri döner ve bu da standart bir Windows makinesinde Visual Studio talebiyle sonuçlanır. 0.1.2 sürümünde düzeltildi: Zinnector® herhangi bir şey indirmeden önce bunu tespit eder ve yalnızca çalışma zamanı için bir Node 24 sürümünü — yaklaşık 30 MB, nodejs.org sağlama toplamlarına göre doğrulanmış — getirir; böylece hiçbir şey asla derlenmez. Yükseltme yaptıktan sonra bunu hâlâ görüyorsanız, daha önceki yarıda kalmış kurulumun öncelikle silinmesi için zinnector dev --reset-runtime komutunu çalıştırın.
Temizleme yaparken npm kaynaklı "EPERM" uyarıları (Windows)
Neredeyse her zaman, npm kaldırmaya çalışırken bir antivirüs tarayıcısının veya arama dizinleyicisinin çalışma zamanının node_modules dizini altındaki bir dosyayı açık tutmasından kaynaklanır. Kurulum, bir sonraki zinnector dev çalıştırmasında temiz bir dizinden yeniden denenir; olmaya devam ederse, zinnector dev --reset-runtime önce tüm çalışma zamanı dizinini kaldırır ve yeniden kurar.
"the local playground runtime could not be installed"
İleti, tam çıktıyı görebilmeniz ve kendiniz çalıştırabilmeniz için npm'in kendi son satırlarını ve Zinnector® tarafından çalıştırılan tam komutu içerir. Olası nedenler genellikle bir ağ veya proxy sorunudur — çalışma zamanı kendi npm'iniz ile getirilir, bu nedenle npm config set proxy … ve bir kayıt defteri yansıması geçerlidir — ya da --reset-runtime komutunun temizlediği, daha önceden yarıda kalmış 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. Bağlantı noktasının zaten kullanımda olması yaygın bir durumdur: zinnector dev --port 9401 veya zinnector.json dosyasında port değerini ayarlayın. Kurulan ancak önyüklenemeyen bir çalışma zamanı için: zinnector dev --reset-runtime. İlk önyükleme WordPress'in kendisini de indirir, bu nedenle yavaş bir bağlantıda birkaç dakika bekleyin; CLI takılı kalmak yerine zaman aşımı bildirmeden önce beş dakikaya kadar bekler.
Dağıtım sırasında "this project is not a git repository"
Dağıtımlar bir depodan yönetilir, bu nedenle zinnector push platformun erişebileceği bir uzak konuma sahip bir depoya ihtiyaç duyar. git init && git add -A && git commit -m initial, GitHub veya GitLab uzak konumunuzu ekleyin, ardından siteye bağlamak için zinnector link çalıştırın.
Dağıtımdan sonra site beyaz görünüyor
zinnector check komutunu çalıştırın. Onda dokuz bu durum bir PHP sürüm farkıdır — alanı çalıştıran sürümden daha yeni bir PHP üzerinde derleme yapmışsınızdır — ve rapor, alanın zinnector php <version> ile hangi sürüme geçirilmesi gerektiğini veya zinnector dev --php <version> ile hangi sürüme karşı geliştirme yapılması gerektiğini belirtir. zinnector logs --error doğrudan ölümcül hatayı gösterir.
İlgili