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 चलाएको थियो, र Node ले CVE-2024-27980 को समाधान गरेपछि शेल बिना .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 मेसिनमा Visual Studio को मागमा टुङ्गिन्छ। 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 ले गम्भीर त्रुटि आफैं देखाउँछ।

सम्बन्धित

• सुरुवात गर्दै · स्थानीय विकास · डिप्लोय गर्दै · आदेश सन्दर्भ