ज्ञानकोष
समस्या निवारण Zinnector®
मानिसहरूले Zinnector CLI प्रयोग गर्दा वास्तवमा सामना गर्ने त्रुटिहरू र ती प्रत्येकका समाधानहरू: विन्डोजमा 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 चलायो, र Node ले CVE-2024-27980 को समाधानपछि शेलविना .cmd फाइल स्पोन (spawn) गर्न अस्वीकार गरेको छ — त्यसैले तपाईंले Y उत्तर दिएको एक सेकेन्डपछि इन्स्टोल क्र्यास भयो। 0.1.2 मा समाधान गरिएको छ: npm अब node npm-cli.js को रूपमा चल्छ, जुन हरेक प्लेटफर्ममा उस्तै हुन्छ र शेलको आवश्यकता पर्दैन। npm install -g zinnector@latest चलाउनुहोस्, अनि पुन: zinnector dev चलाउनुहोस्।
इन्स्टोलको क्रममा "npm WARN EBADENGINE", वा "Zinnector® लाई Node 24 वा नयाँ संस्करण चाहिन्छ"
तपाईंको Node 24 भन्दा पुरानो छ। प्याकेजले engines: >=24.18.1 घोषणा गरेको हुनाले npm ले चेतावनी छाप्छ; इन्स्टोल तैपनि पूरा हुन्छ, तर त्यसपछि zinnector पछि कुनै अन्य ठाउँमा अन्योलपूर्ण रूपमा असफल हुनुको सट्टा सुरु हुन अस्वीकार गर्छ (exit code 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)
प्रायः जसो एन्टीभाइरस स्क्यानर वा सर्च इन्डेक्सरले 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"
डेप्लोयहरू भण्डार (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) नै देखाउँछ।
सम्बन्धित
अझै पनि अल्झिनुभयो?
प्रत्येक प्लानमा सहयोग समावेश छ र तपाईंको आफ्नै भाषामा उत्तरहरू पाइन्छ।
सम्पर्क समर्थन → सबै लेखहरू →