Zinnector® समस्यानिवारण

Zinnector® CLI वापरताना युझर्सना प्रत्यक्ष येणाऱ्या एरर्स, प्रत्येकाचा अर्थ आणि त्यावरील उपाय. प्रत्येक नोंदीमध्ये तुम्हाला दिसणारा अचूक मजकूर दिलेला आहे, ज्यामुळे तुम्ही तो या पेजवर शोधू शकता. तुमची एरर येथे नसल्यास, अयशस्वी झालेली कमांड ZINNECTOR_DEBUG=1 सह चालवा आणि आउटपुट, तुमची node --version आणि तुमची ऑपरेटिंग सिस्टम यांसह github.com/Zinn-Digital/zinnector/issues येथे एक इश्यू तयार करा.

रनटाईम इन्स्टॉलेशन स्वीकारल्यानंतर लगेच "spawn EINVAL" (Windows)

Zinnector® 0.1.0 आणि 0.1.1 मधील एक बग. Windows वर रनटाईम इन्स्टॉलरने नावाने npm.cmd चालवले, आणि CVE-2024-27980 साठीच्या फिक्सनंतर Node ने शेलशिवाय .cmd फाईल स्पॉन करण्यास नकार दिला आहे — त्यामुळे तुम्ही Y उत्तर दिल्यानंतर एका सेकंदात इन्स्टॉल क्रॅश झाले. 0.1.2 मध्ये निराकरण केले: npm आता node npm-cli.js म्हणून चालवले जाते, जे प्रत्येक प्लॅटफॉर्मवर सारखेच असते आणि त्यासाठी कोणत्याही शेलची आवश्यकता नसते. npm install -g zinnector@latest चालवा, आणि नंतर पुन्हा zinnector dev चालवा.

इन्स्टॉल दरम्यान "npm WARN EBADENGINE", किंवा "Zinnector® needs Node 24 or newer"

तुमची Node आवृत्ती 24 पेक्षा जुनी आहे. पॅकेज engines: >=24.18.1 घोषित करत असल्यामुळे npm ही चेतावणी दाखवते; इन्स्टॉलेशन कसेही पूर्ण होते, परंतु नंतर गोंधळात टाकणाऱ्या पद्धतीने अयशस्वी होण्याऐवजी zinnector सुरू होण्यास नकार देते (एक्झिट कोड 78). nodejs.org वरून चालू LTS इन्स्टॉल करा — Windows वर winget install OpenJS.NodeJS.LTS, macOS वर brew install node@24 — node --version द्वारे v24 किंवा उच्च आवृत्ती दिसत असल्याची खात्री करा, आणि Zinnector® पुन्हा इन्स्टॉल करा.

"gyp ERR!", "Building from source with node-gyp", किंवा "You need to install Visual Studio"

WordPress रनटाईममध्ये एक मूळ (native) मॉड्यूल आहे ज्याचे प्रीबिल्ट बायनरीज केवळ Node 24 आणि 25 साठी अस्तित्वात आहेत. नवीन Node वर (सप्टेंबर 2026 नुसार 26 आणि त्यावरील) त्याचे इन्स्टॉलर सोर्सवरून कंपाईल करण्याच्या पर्यायावर जाते, ज्याचा शेवट साध्या Windows मशीनवर Visual Studio च्या मागणीमध्ये होतो. 0.1.2 मध्ये निराकरण केले: काहीही डाउनलोड करण्यापूर्वी Zinnector® हे ओळखते आणि केवळ रनटाईमसाठी Node 24 प्राप्त करते — nodejs.org च्या चेकसम्सच्या आधारे पडताळणी केलेले सुमारे 30 MB — ज्यामुळे काहीही कधीही कंपाईल केले जात नाही. अपग्रेड केल्यानंतरही तुम्हाला ही एरर दिसत असल्यास, zinnector dev --reset-runtime चालवा जेणेकरून आधीचे अपूर्ण इन्स्टॉलेशन आधी काढून टाकले जाईल.

क्लीन अप करताना npm कडून "EPERM" चेतावणी (Windows)

npm रनटाईमच्या node_modules मधील फाईल काढून टाकण्याचा प्रयत्न करत असताना अँटीव्हायरस स्कॅनर किंवा सर्च इंडेक्सिंग प्रक्रियेने ती फाईल उघडी धरून ठेवल्यामुळे हे बहुतांश वेळा घडते. पुढील zinnector dev वर स्वच्छ डिरेक्टरीमधून इन्स्टॉलेशनचा पुन्हा प्रयत्न केला जातो; हे वारंवार घडत राहिल्यास, zinnector dev --reset-runtime आधी संपूर्ण रनटाईम डिरेक्टरी काढून टाकते आणि पुन्हा इन्स्टॉल करते.

"the local playground runtime could not be installed"

या मेसेजमध्ये npm च्या स्वतःच्या शेवटच्या ओळी आणि Zinnector® ने चालवलेली अचूक कमांड समाविष्ट असते, जेणेकरून तुम्ही ती स्वतः चालवून संपूर्ण आउटपुट पाहू शकता. याचे नेहमीचे कारण नेटवर्क किंवा प्रॉक्सी समस्या असते — रनटाईम तुमच्या स्वतःच्या npm सह प्राप्त केला जातो, त्यामुळे npm config set proxy … आणि एक रजिस्ट्री मिरर लागू होतात — किंवा आधीचे अर्धवट राहिलेले इन्स्टॉलेशन, जे --reset-runtime द्वारे साफ होते.

"the local playground exited before it was ready", किंवा ते कधीही सज्ज होत नाही

रनटाईमचे स्वतःचे आउटपुट पाहण्यासाठी zinnector dev --verbose चालवा. पोर्ट आधीपासून वापरात असणे ही एक सामान्य बाब आहे: zinnector dev --port 9401 चालवा, किंवा zinnector.json मध्ये port सेट करा. इन्स्टॉल झालेला परंतु बूट न होणारा रनटाईम: zinnector dev --reset-runtime. पहिल्या बूटच्या वेळी WordPress स्वतः देखील डाउनलोड होते, म्हणून मंद इंटरनेट कनेक्शनवर काही मिनिटे थांबा; CLI अडकून राहण्याऐवजी टाइमआउट रिपोर्ट करण्यापूर्वी पाच मिनिटांपर्यंत प्रतीक्षा करते.

पुश करताना "this project is not a git repository"

डिप्लॉयमेंट रिपॉझिटरीमधून चालवले जातात, त्यामुळे zinnector push ला प्लॅटफॉर्म पोहोचू शकेल अशा रिमोटसह एका रिपॉझिटरीची आवश्यकता असते. git init && git add -A && git commit -m initial चालवा, तुमचे GitHub किंवा GitLab रिमोट जोडा, आणि नंतर त्यास साईटशी जोडण्यासाठी zinnector link चालवा.

डिप्लॉयनंतर साईट पांढरी (white) दिसत आहे

zinnector check चालवा. दहा पैकी नऊ वेळा ही PHP आवृत्तीतील तफावत असते — तुम्ही स्लॉट ज्यावर चालतो त्यापेक्षा नवीन PHP वर बिल्ड केले आहे — आणि रिपोर्ट सांगतो की स्लॉट कोणत्या आवृत्तीवर zinnector php <version> द्वारे स्विच करायचा, किंवा zinnector dev --php <version> सह कोणासाठी डेव्हलपमेंट करायचे. zinnector logs --error स्वतः फॅटल एरर दाखवते.

संबंधित

• सुरुवात करणे · स्थानिक डेव्हलपमेंट · डिप्लॉय करणे · कमांड संदर्भ