Menyelesaikan Masalah Zinnector®

Ralat yang sebenarnya dihadapi pengguna dengan CLI Zinnector®, maksud setiap ralat, dan cara memperbaikinya. Setiap entri menyenaraikan teks sebenar yang akan anda lihat, supaya anda boleh mencari halaman ini untuk ralat tersebut. Jika ralat anda tiada di sini, jalankan arahan yang gagal dengan ZINNECTOR_DEBUG=1 dan buka isu di github.com/Zinn-Digital/zinnector/issues berserta output tersebut, node --version anda, dan sistem pengendalian anda.

"spawn EINVAL" sejurus selepas menerima pemasangan persekitaran runut (Windows)

Pijat dalam Zinnector® 0.1.0 dan 0.1.1. Pada Windows, prapasang persekitaran runut menjalankan npm.cmd mengikut namanya, dan Node enggan memijah (spawn) fail .cmd tanpa cengkerang (shell) sejak pembaikan CVE-2024-27980 — jadi pemasangan terhenti sesaat selepas anda menjawab Y. Dibetulkan dalam 0.1.2: npm kini dijalankan sebagai node npm-cli.js, iaitu sama pada setiap platform dan tidak memerlukan cengkerang. Jalankan npm install -g zinnector@latest, kemudian jalankan zinnector dev semula.

"npm WARN EBADENGINE" semasa pemasangan, atau "Zinnector® needs Node 24 or newer"

Node anda lebih lama daripada versi 24. npm memaparkan amaran tersebut kerana pakej mengisytiharkan engines: >=24.18.1; pemasangan tetap selesai, tetapi zinnector kemudian enggan bermula (kod keluar 78) daripada gagal pada bahagian yang mengelirukan kemudian hari. Pasang LTS semasa dari nodejs.org — winget install OpenJS.NodeJS.LTS pada Windows, brew install node@24 pada macOS — sahkan node --version memaparkan v24 atau lebih tinggi, dan pasang semula Zinnector®.

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

Persekitaran runut WordPress mempunyai modul asal yang binari pra binaannya wujud untuk Node 24 dan 25 sahaja. Pada Node yang lebih baharu (26 dan ke atas, setakat September 2026), prapasangnya beralih kepada penyusunan (compiling) daripada sumber, yang pada mesin Windows biasa akan berakhir dengan permintaan untuk Visual Studio. Dibetulkan dalam 0.1.2: Zinnector® mengesan perkara ini sebelum memuat turun apa-apa dan mengambil Node 24 khusus untuk persekitaran runut sahaja — kira-kira 30 MB, disahkan terhadap hasil semak (checksum) nodejs.org — jadi tiada apa-apa yang pernah disusun. Jika anda masih melihatnya selepas peningkatan, jalankan zinnector dev --reset-runtime supaya pemasangan separuh siap sebelum ini dibuang terlebih dahulu.

Amaran "EPERM" daripada npm semasa ia membersihkan fail (Windows)

Hampir selalu disebabkan oleh pengimbas antivirus atau pengindeks carian yang menahan fail terbuka di bawah node_modules persekitaran runut semasa npm cuba membuangnya. Pemasangan dicuba semula dari direktori yang bersih pada zinnector dev seterusnya; jika ia terus berlaku, zinnector dev --reset-runtime mengalih keluar keseluruhan direktori persekitaran runut terlebih dahulu dan memasang semula.

"the local playground runtime could not be installed"

Mesej tersebut merangkumi baris terakhir npm sendiri dan arahan tepat yang dijalankan oleh Zinnector®, supaya anda boleh menjalankannya sendiri dan melihat output penuh. Punca biasa ialah masalah rangkaian atau proksi — persekitaran runut diambil dengan npm anda sendiri, jadi npm config set proxy … dan cermin registri (registry mirror) terpakai — atau pemasangan terdahulu yang separuh siap, yang dibersihkan oleh --reset-runtime.

"the local playground exited before it was ready", atau ia tidak pernah bersedia

Jalankan zinnector dev --verbose untuk melihat output persekitaran runut itu sendiri. Port yang sedang digunakan adalah masalah biasa: zinnector dev --port 9401, atau tetapkan port dalam zinnector.json. Persekitaran runut yang dipasang tetapi tidak mahu but: zinnector dev --reset-runtime. But pertama juga memuat turun WordPress itu sendiri, jadi pada sambungan yang perlahan, berikan masa beberapa minit; CLI menunggu sehingga lima minit sebelum melaporkan masa tamat (timeout) daripada terus tergendala.

"this project is not a git repository" semasa hantar (push)

Penyelarasan didorong daripada repositori, jadi zinnector push memerlukan repositori dengan storan jauh (remote) yang boleh diakses oleh platform. git init && git add -A && git commit -m initial, tambah storan jauh GitHub atau GitLab anda, kemudian zinnector link untuk menyambungkannya ke tapak web tersebut.

Tapak web berwarna putih selepas penyelarasan

Jalankan zinnector check. Sembilan daripada sepuluh kali, ia adalah jurang versi PHP — anda membina pada versi PHP yang lebih baharu daripada yang dijalankan oleh slot tersebut — dan laporan menyatakan versi yang mana untuk ditukarkan kepada slot tersebut dengan zinnector php <version>, atau versi yang mana untuk dibangunkan dengan zinnector dev --php <version>. zinnector logs --error menunjukkan ralat maut (fatal) itu sendiri.

Berkaitan

• Bermula · Pembangunan tempatan · Penyelarasan · Rujukan arahan