Zinnector® சிக்கல்களைத் தீர்ப்பது

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 ஐ பெயரால் இயக்கியது, மேலும் 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® க்கு 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 மற்றும் அதற்கு மேல்) அதன் நிறுவி மூலத்திலிருந்து (source) கம்பைல் செய்வதற்கு மாறுகிறது, இது ஒரு சாதாரண 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) ஒரு களஞ்சியத்திலிருந்து (repository) இயக்கப்படுகின்றன, எனவே 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 பிழையையே காட்டுகிறது.

தொடர்புடையவை

• தொடங்குதல் · உள்ளூர் உருவாக்கம் · வரிசைப்படுத்துதல் · கட்டளைக் குறிப்பு