Kesalahan-kesalahan yang benar-benar dialami pengguna dengan CLI Zinnector®, arti dari masing-masing kesalahan tersebut, dan solusinya. Setiap entri menyebutkan teks persis yang akan Anda lihat, sehingga Anda dapat mencarinya di halaman ini. Jika masalah Anda tidak tercantum di sini, jalankan perintah yang gagal dengan ZINNECTOR_DEBUG=1 dan buka issue di github.com/Zinn-Digital/zinnector/issues yang menyertakan output tersebut, node --version Anda, dan sistem operasi Anda.
"spawn EINVAL" tepat setelah menyetujui penginstalan runtime (Windows)
Bug pada Zinnector® 0.1.0 dan 0.1.1. Pada Windows, alat penginstal runtime menjalankan npm.cmd berdasarkan nama, dan Node menolak untuk menjalankan file .cmd tanpa shell sejak perbaikannya untuk CVE-2024-27980 — sehingga penginstalan mengalami crash satu detik setelah Anda menjawab Y. Diperbaiki pada 0.1.2: npm kini 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 kembali.
"npm WARN EBADENGINE" saat 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 mengalami kegagalan yang membingungkan nantinya. Instal versi LTS saat ini dari nodejs.org — winget install OpenJS.NodeJS.LTS di Windows, brew install node@24 di macOS — pastikan node --version mencetak v24 atau lebih tinggi, lalu instal Zinnector® kembali.
"gyp ERR!", "Building from source with node-gyp", atau "You need to install Visual Studio"
Runtime WordPress memiliki modul native yang biner siap pakainya hanya tersedia untuk Node 24 dan 25. Pada Node yang lebih baru (26 ke atas, per September 2026), alat penginstalnya beralih untuk mengompilasi dari sumber (source), yang pada mesin Windows standar berakhir dengan permintaan untuk memasang Visual Studio. Diperbaiki pada 0.1.2: Zinnector® mendeteksi hal ini sebelum mengunduh apa pun dan mengambil Node 24 khusus untuk runtime saja — sekitar 30 MB, diverifikasi terhadap checksum nodejs.org — sehingga tidak ada yang dikompilasi sama sekali. Jika Anda masih melihatnya setelah melakukan pembaruan, jalankan zinnector dev --reset-runtime agar penginstalan yang baru selesai sebagian dari sebelumnya dibuang terlebih dahulu.
Peringatan "EPERM" dari npm saat sedang melakukan pembersihan (Windows)
Hampir selalu disebabkan oleh pemindai antivirus atau pengindeks pencarian yang membiarkan file tetap terbuka di bawah node_modules runtime saat npm mencoba menghapusnya. Penginstalan akan dicoba kembali dari direktori yang 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 ini menyertakan baris-baris terakhir milik npm sendiri dan perintah persis yang dijalankan Zinnector®, sehingga Anda dapat menjalankannya sendiri dan melihat output lengkapnya. Penyebab umumnya adalah masalah jaringan atau proksi — runtime diambil menggunakan npm Anda sendiri, sehingga npm config set proxy … dan mirror registri berlaku — atau penginstalan sebelumnya yang baru selesai sebagian, yang dapat dibersihkan oleh --reset-runtime.
"the local playground exited before it was ready", atau tidak kunjung siap
Jalankan zinnector dev --verbose untuk melihat output dari runtime itu sendiri. Port yang sudah digunakan adalah masalah yang umum terjadi: zinnector dev --port 9401, atau atur port di zinnector.json. Runtime yang terinstal tetapi tidak mau melakukan booting: zinnector dev --reset-runtime. Booting pertama juga mengunduh WordPress itu sendiri, jadi pada koneksi lambat, berikan waktu beberapa menit; CLI menunggu hingga lima menit sebelum melaporkan batas waktu habis alih-alih mengalami freeze.
"this project is not a git repository" saat push
Penerapan (deploy) dijalankan dari repositori, sehingga zinnector push memerlukan repositori dengan remote yang dapat dijangkau oleh platform. git init && git add -A && git commit -m initial, tambahkan remote GitHub atau GitLab Anda, lalu jalankan zinnector link untuk menghubungkannya ke situs.
Situs menjadi putih setelah penerapan
Jalankan zinnector check. Sembilan dari sepuluh kasus merupakan perbedaan versi PHP — Anda membangun pada versi PHP yang lebih baru daripada yang dijalankan slot — dan laporan tersebut menyebutkan ke versi mana slot harus dialihkan dengan zinnector php <version>, atau versi mana yang digunakan untuk pengembangan dengan zinnector dev --php <version>. zinnector logs --error menampilkan fatal error itu sendiri.
Terkait