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

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

रनटाइम इंस्टॉल (Windows) स्वीकार करने के तुरंत बाद "spawn EINVAL"

Zinnector® 0.1.0 और 0.1.1 में एक बग। Windows पर रनटाइम इंस्टॉलर नाम से npm.cmd चलाता था, और CVE-2024-27980 के लिए अपने फिक्स के बाद से Node ने बिना शेल के .cmd फ़ाइल को स्पॉन (spawn) करने से मना कर दिया है — इसलिए आपके द्वारा 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 से पुराना है। npm चेतावनी प्रिंट करता है क्योंकि पैकेज engines: >=24.18.1 घोषित करता है; इंस्टॉल वैसे पूरा हो जाता है, लेकिन बाद में किसी भ्रमित करने वाली जगह पर विफल होने के बजाय 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 रनटाइम में एक नेटिव मॉड्यूल है जिसके पूर्व-निर्मित बाइनरी केवल Node 24 और 25 के लिए मौजूद हैं। एक नए Node पर (सितंबर 2026 के अनुसार, 26 और उससे ऊपर) इसका इंस्टॉलर स्रोत से कंपाइल करने पर वापस आ जाता है, जो एक सादे Windows कंप्यूटर पर Visual Studio के अनुरोध पर समाप्त होता है। 0.1.2 में ठीक किया गया: Zinnector® कुछ भी डाउनलोड करने से पहले इसका पता लगा लेता है और अकेले रनटाइम के लिए Node 24 प्राप्त करता है — लगभग 30 MB, nodejs.org के चेकसम के विरुद्ध सत्यापित — ताकि कुछ भी कभी कंपाइल न हो। यदि अपग्रेड करने के बाद भी आपको यह दिखाई देता है, तो zinnector dev --reset-runtime चलाएं ताकि पहले से मौजूद आधा-अधूरा इंस्टॉल पहले हटा दिया जाए।

सफाई करते समय npm से "EPERM" चेतावनियाँ (Windows)

लगभग हमेशा एक एंटीवायरस स्कैनर या सर्च इंडेक्सर होता है जो रनटाइम के node_modules के तहत किसी फ़ाइल को खोले रखता है जबकि npm इसे हटाने का प्रयास करता है। अगले 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 टाइमआउट रिपोर्ट करने से पहले लटकने (hang करने) के बजाय पाँच मिनट तक प्रतीक्षा करता है।

पुश करने पर "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 घातक त्रुटि (fatal) को स्वयं दिखाता है।

संबंधित

• आरंभ करना · स्थानीय विकास · डिप्लॉय करना · कमांड संदर्भ