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

वे त्रुटियाँ जिनका लोग वास्तव में 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 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 पाँच मिनट तक प्रतीक्षा करता है।

पुश पर "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 की तुलना में नए PHP पर निर्माण किया है जिस पर स्लॉट चलता है — और रिपोर्ट बताती है कि स्लॉट को zinnector php <version> के साथ किस संस्करण पर स्विच करना है, या zinnector dev --php <version> के साथ किसके विरुद्ध विकसित करना है। zinnector logs --error स्वयं फ़ेटल एरर को दिखाता है।

संबंधित

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