Pusat Pengetahuan
Pemecahan Masalah Zinnector®
Kesalahan yang benar-benar dialami orang dengan Zinnector CLI beserta perbaikannya masing-masing: spawn EINVAL di Windows, peringatan EBADENGINE dari npm, node-gyp meminta Visual Studio pada Node 26, EPERM saat pemasangan, runtime yang tidak mau boot, dan port yang sedang digunakan.
Kesalahan yang benar-benar dialami pengguna dengan CLI Zinnector®, apa arti masing-masing, beserta cara memperbaikinya. Setiap entri menyebutkan teks persis yang akan Anda lihat, sehingga Anda dapat mencari halaman ini untuk menemukannya. Jika masalah Anda tidak ada di sini, jalankan perintah yang gagal dengan ZINNECTOR_DEBUG=1 dan buka issue di github.com/Zinn-Digital/zinnector/issues beserta output-nya, node --version Anda, dan sistem operasi Anda.
"spawn EINVAL" tepat setelah menyetujui penginstalan runtime (Windows)
Sebuah bug di Zinnector® 0.1.0 dan 0.1.1. Pada Windows, penginstal runtime menjalankan npm.cmd berdasarkan namanya, dan Node menolak untuk men-spawn file .cmd tanpa shell sejak perbaikan untuk CVE-2024-27980 — sehingga penginstalan mengalami kegagalan satu detik setelah Anda menjawab Y. Diperbaiki pada 0.1.2: npm sekarang dijalankan sebagai node npm-cli.js, yang sama di setiap platform dan tidak memerlukan shell. Jalankan npm install -g zinnector@latest, lalu jalankan zinnector dev lagi.
"npm WARN EBADENGINE" selama penginstalan, atau "Zinnector® needs Node 24 or newer"
Versi Node Anda lebih lama dari 24. npm menampilkan peringatan tersebut karena paket mendeklarasikan engines: >=24.18.1; penginstalan tetap selesai, tetapi zinnector kemudian menolak untuk memulai (kode keluar 78) alih-alih gagal di bagian lain yang membingungkan nantinya. Instal versi LTS saat ini dari nodejs.org — winget install OpenJS.NodeJS.LTS pada Windows, brew install node@24 pada macOS — pastikan node --version mencetak v24 atau yang lebih baru, dan instal kembali Zinnector®.
"gyp ERR!", "Building from source with node-gyp", or "You need to install Visual Studio"
Runtime WordPress memiliki modul asli yang binary prabuatnya hanya tersedia untuk Node 24 dan 25. Pada Node yang lebih baru (26 ke atas, per September 2026), penginstalnya beralih ke proses kompilasi dari sumber, yang pada komputer Windows standar akan berakhir dengan permintaan untuk Visual Studio. Diperbaiki pada 0.1.2: Zinnector® mendeteksi hal ini sebelum mengunduh apa pun dan mengambil Node 24 khusus untuk runtime — sekitar 30 MB, diverifikasi terhadap checksum nodejs.org — sehingga tidak ada yang pernah dikompilasi. Jika Anda masih melihatnya setelah memperbarui, jalankan zinnector dev --reset-runtime sehingga penginstalan setengah jalan dari sebelumnya dibuang terlebih dahulu.
Peringatan "EPERM" dari npm saat membersihkan (Windows)
Hampir selalu disebabkan oleh pemindai antivirus atau indexer pencarian yang menahan file agar tetap terbuka di bawah node_modules milik runtime saat npm mencoba menghapusnya. Penginstalan akan dicoba kembali dari direktori bersih pada zinnector dev berikutnya; jika hal ini terus terjadi, zinnector dev --reset-runtime akan menghapus seluruh direktori runtime terlebih dahulu dan menginstalnya kembali.
"the local playground runtime could not be installed"
Pesan tersebut menyertakan baris terakhir dari npm sendiri dan perintah persis yang dijalankan oleh Zinnector®, sehingga Anda dapat menjalankannya sendiri dan melihat output lengkapnya. Penyebab yang biasa terjadi adalah masalah jaringan atau proxy — runtime diambil menggunakan npm Anda sendiri, sehingga npm config set proxy … dan mirror registry akan diterapkan — atau penginstalan sebelumnya yang belum selesai, yang dapat dibersihkan dengan --reset-runtime.
"the local playground exited before it was ready", atau tidak pernah siap
Jalankan zinnector dev --verbose untuk melihat output dari runtime itu sendiri. Port yang sudah digunakan adalah masalah yang umum terjadi: gunakan zinnector dev --port 9401, atau atur port di zinnector.json. Untuk runtime yang terinstal tetapi tidak mau melakukan boot: jalankan zinnector dev --reset-runtime. Boot pertama juga mengunduh WordPress itu sendiri, jadi pada koneksi yang lambat, berikan waktu beberapa menit; CLI akan menunggu hingga lima menit sebelum melaporkan waktu habis (timeout) alih-alih berhenti merespons.
"this project is not a git repository" saat melakukan push
Penyebaran (deploy) dijalankan dari sebuah repositori, sehingga zinnector push memerlukan repositori dengan remote yang dapat diakses oleh platform. Lakukan git init && git add -A && git commit -m initial, tambahkan remote GitHub atau GitLab Anda, lalu jalankan zinnector link untuk menghubungkannya ke situs.
Situs berwarna putih setelah dilakukan deploy
Jalankan zinnector check. Sembilan dari sepuluh kasus adalah perbedaan versi PHP — Anda membangun menggunakan versi PHP yang lebih baru daripada yang dijalankan oleh slot tersebut — dan laporan akan menunjukkan versi mana yang harus diatur pada slot tersebut menggunakan zinnector php <version>, atau versi PHP mana yang digunakan untuk pengembangan melalui zinnector dev --php <version>. zinnector logs --error menampilkan kesalahan fatal itu sendiri.
Terkait
Masih bingung?
Dukungan disertakan di setiap paket dan dijawab dalam bahasa Anda sendiri.
Hubungi dukungan → Semua artikel →