Zinnector® CLI இல் பயனர்கள் சந்திக்கும் பிழைகள், ஒவ்வொன்றின் பொருள் மற்றும் அதற்கான தீர்வு. நீங்கள் இந்தப் பக்கத்தில் தேடுவதற்கு ஏற்ப, ஒவ்வொரு பதிவும் நீங்கள் காணும் துல்லியமான உரைக் குறிப்பைக் கொண்டுள்ளது. உங்களுடைய பிழை இங்கு இல்லை என்றால், ZINNECTOR_DEBUG=1 எனக் கொடுத்துத் தோல்வியடைந்த கட்டளையை இயக்கி, அதன் வெளியீடு, உங்களது node --version மற்றும் உங்கள் இயங்குதள விவரங்களுடன் github.com/Zinn-Digital/zinnector/issues என்ற முகவரியில் ஒரு சிக்கலைப் பதிவுசெய்யவும் (open an issue).
இயங்குநேர நிறுவலை ஏற்ற பிறகு உடனடியாக "spawn EINVAL" என வருதல் (Windows)
Zinnector® 0.1.0 மற்றும் 0.1.1 இல் உள்ள ஒரு பிழை. Windows இல் இயங்குநேர நிறுவி npm.cmd என்பதைப் பெயர் மூலம் இயக்கியது, மேலும் CVE-2024-27980 க்கான தீர்வுக்குப் பிறகு Node ஒரு shell இல்லாமல் .cmd கோப்பை இயக்குவதை மறுத்துவிட்டது — இதனால் நீங்கள் Y எனப் பதிலளித்த ஒரு வினாடியில் நிறுவல் செயலிழந்தது. 0.1.2 இல் சரிசெய்யப்பட்டது: npm இப்போது node npm-cli.js ஆக இயக்கப்படுகிறது, இது அனைத்து தளங்களிலும் ஒரே மாதிரியானது மற்றும் shell எதுவும் தேவையில்லை. npm install -g zinnector@latest என்பதை இயக்கி, பின்னர் மீண்டும் zinnector dev என்பதை இயக்கும்.
நிறுவலின் போது "npm WARN EBADENGINE", அல்லது "Zinnector® needs Node 24 or newer" என வருதல்
உங்களது 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 ஐந்து நிமிடங்கள் வரை காத்திருக்கும்.
push செய்யும்போது "this project is not a git repository" என வருதல்
துரித பயன்பாடுகள் (deploys) ஒரு களஞ்சியத்திலிருந்து இயக்கப்படுகின்றன, எனவே zinnector push க்கு பிளாட்ஃபார்ம் அணுகக்கூடிய தொலைநிலை இணைப்புடன் கூடிய ஒன்று தேவைப்படுகிறது. git init && git add -A && git commit -m initial, உங்களது GitHub அல்லது GitLab தொலைநிலையைச் சேர்க்கவும், பின்னர் அதை தளத்துடன் இணைக்க zinnector link ஐப் பயன்படுத்தவும்.
deploy செய்த பிறகு தளம் வெண்மையாக உள்ளது
zinnector check என்பதை இயக்கவும். பத்தில் ஒன்பது முறை இது ஒரு PHP பதிப்பு இடைவெளி — ஸ்லாட் இயங்குவதை விட புதிய PHP இல் நீங்கள் உருவாக்கினீர்கள் — மேலும் zinnector php <version> மூலம் ஸ்லாட்டை எந்தப் பதிப்பிற்கு மாற்ற வேண்டும் அல்லது zinnector dev --php <version> மூலம் எதற்கு எதிராக உருவாக்க வேண்டும் என்பதை அறிக்கை கூறுகிறது. zinnector logs --error என்பது ஃபேட்டல் பிழையையே காட்டுகிறது.
தொடர்புடையவை