Zinnector® දෝෂ නිරාකරණය

Zinnector® CLI භාවිතයේදී පරිශීලකයින්ට සැබවින්ම හමුවන දෝෂ, ඒ එකින් එකෙන් අදහස් වන දේ සහ ඒවාට පිළියම්. සෑම සටහනකම ඔබට දැකිය හැකි නිවැරදි පෙළම සඳහන් කර ඇති බැවින්, ඔබට එය සඳහා මෙම පිටුව සෙවිය හැක. ඔබගේ දෝෂය මෙහි නොමැති නම්, අසාර්ථක වන කටයුත්ත ZINNECTOR_DEBUG=1 සමඟ ක්‍රියාත්මක කර, ලැබෙන ප්‍රතිදානය (output), ඔබගේ node --version සහ ඔබගේ මෙහෙයුම් පද්ධතිය ද සමඟ github.com/Zinn-Digital/zinnector/issues හි ලැයිස්තුගත කරන්න.

රන් ටයිම් ස්ථාපනය පිළිගත් වහාම එන "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 රන් ටයිම් හි ඇති native module හි prebuilt binaries පවතින්නේ Node 24 සහ 25 සඳහා පමණි. නව Node එකක (2026 සැප්තැම්බර් වන විට, 26 සහ ඊට වැඩි) එහි ස්ථාපකය මූලාශ්‍රයෙන් සංකලනය (compiling from source) කිරීමට පෙළඹේ, එය සාමාන්‍ය Windows යන්ත්‍රයක Visual Studio ඉල්ලා සිටීමෙන් කෙළවර වේ. 0.1.2 හිදී නිවැරදි කර ඇත: Zinnector® කිසිවක් බාගත කිරීමට පෙර මෙය හඳුනාගෙන රන් ටයිම් එක සඳහා පමණක් Node 24 එකක් ලබා ගනී — මෙගාබයිට් 30 ක් පමණ, nodejs.org හි checksums වලට අනුව සත්‍යාපනය කර ඇත — එබැවින් කිසිවක් සංකලනය වන්නේ නැත. යාවත්කාලීන කිරීමෙන් පසුවත් මෙය දිස්වන්නේ නම්, 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® මගින් ක්‍රියාත්මක කළ exact command ඇතුළත් වේ, එබැවින් ඔබටම එය ක්‍රියාත්මක කර සම්පූර්ණ ප්‍රතිදානය බැලිය හැක. සාමාන්‍ය හේතු වන්නේ ජාල හෝ ප්‍රොක්සි ගැටලුවක් — රන් ටයිම් ලබා ගන්නේ ඔබගේම npm මගින් බැවින් npm config set proxy … සහ registry mirror අදාළ වේ — නැතහොත් --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 එක විසන්ධි නොවී (hanging) තත්පර ගණනක් රැඳී සිටීමට පෙර කාලය ඉක්මවා යාමක් (timeout) වාර්තා කිරීමට මිනිත්තු පහක් දක්වා රැඳී සිටියි.

push කිරීමේදී "this project is not a git repository"

යෙදවීම් (Deploys) සිදු කරනු ලබන්නේ ගබඩාවක (repository) සිට බැවින්, zinnector push සඳහා ප්ලැට්ෆෝම් එකට සම්බන්ධ විය හැකි remote එකක් සහිත එකක් අවශ්‍ය වේ. git init && git add -A && git commit -m initial, ඔබගේ GitHub හෝ GitLab remote එක එකතු කරන්න, ඉන්පසු එය වෙබ් අඩවියට සම්බන්ධ කිරීමට zinnector link භාවිතා කරන්න.

යෙදවීමෙන් (deploy) පසුව වෙබ් අඩවිය හිස් (white) වේ

zinnector check ක්‍රියාත්මක කරන්න. දස වතාවෙන් නව වතාවක්ම එය PHP අනුවාදයේ වෙනසකි — ඔබ ස්ලොට් එක ක්‍රියාත්මක වන ප්‍රමාණයට වඩා නව PHP අනුවාදයක ගොඩනඟා ඇත — සහ වාර්තාව මගින් zinnector php <version> සමඟ ස්ලොට් එක මාරු කළ යුත්තේ කුමන අනුවාදයටද, නැතහොත් zinnector dev --php <version> සමඟ සංවර්ධනය කළ යුත්තේ කුමන අනුවාදයටද යන්න පවසයි. zinnector logs --error මගින් දෝෂයම පෙන්වයි.

සබඳිත

• ආරම්භ කිරීම · දේශීය සංවර්ධනය · යෙදවීම · විධානයන් පිළිබඳ විස්තර