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

Zinnector CLI सह लोकांना खरोखर येणाऱ्या त्रुटी आणि प्रत्येकावरील उपाय: Windows वर spawn EINVAL, npm चा EBADENGINE चेतावणी, Node 26 वर Visual Studio विचारणारे node-gyp, इन्स्टॉल दरम्यान EPERM, बूट न होणारा रनटाइम आणि वापरात असलेले पोर्ट.

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

रनटाइम इन्स्टॉल स्वीकारल्यानंतर लगेच "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 आवृत्ती २४ पेक्षा जुनी आहे. पॅकेज engines: >=24.18.1 घोषित करत असल्यामुळे npm चेतावणी छापत आहे; इन्स्टॉलेशन कसेतरी पूर्ण होते, परंतु नंतर गोंधळात टाकणाऱ्या ठिकाणी अयशस्वी होण्याऐवजी zinnector सुरू होण्यास नकार देतो (एक्झिट कोड ७८). 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 रनटाइममध्ये एक नेटिव्ह मॉड्युल आहे ज्याचे प्रीबिल्ट बायनरीज फक्त Node 24 आणि 25 साठी अस्तित्त्वात आहेत. नवीन Node वर (सप्टेंबर २०२६ नुसार २६ आणि त्यापुढील) त्याचा इन्स्टॉलर सोर्सेसमधून कंपाईलिंग करण्याकडे परत जातो, ज्यावर साध्या Windows मशीनवर व्हिज्युअल स्टुडिओसाठी विनंती समाप्त होते. 0.1.2 मध्ये सुधारित: Zinnector® काहीही डाउनलोड करण्यापूर्वी हे ओळखते आणि केवळ रनटाइमसाठी Node 24 आणते — सुमारे ३० MB, nodejs.org च्या चेकसम्स विरुद्ध सत्यापित — त्यामुळे काहीही कधीही कंपाईल केले जात नाही. अपग्रेड केल्यानंतरही तुम्हाला ते दिसत असल्यास, 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 वापरा.

डिप्लॉय झाल्यानंतर साइट पांढरी असते

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