Zinnector® ගැටලු නිරාකරණය

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

runtime ස්ථාපනය පිළිගත් වහාම දිස්වන "spawn EINVAL" දෝෂය (Windows)

Zinnector® 0.1.0 සහ 0.1.1 හි ඇති දෝෂයකි. Windows හි runtime ස්ථාපකය නම මඟින් npm.cmd ධාවනය කළ අතර, CVE-2024-27980 සඳහා වන නිවැරදි කිරීමෙන් පසුව Node විසින් shell එකක් රහිතව .cmd ගොනුවක් spawn කිරීම ප්‍රතික්ෂේප කර ඇත — එබැවින් ඔබ 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 runtime හි native මොඩියුලයක් ඇති අතර එහි පූර්ව-සාදන ලද binaries ඇත්තේ Node 24 සහ 25 සඳහා පමණි. නව Node එකක (2026 සැප්තැම්බර් වන විට, 26 සහ ඉහළ) එහි ස්ථාපකය මූලාශ්‍රයෙන් compile කිරීමට යොමු වන අතර, එය සාමාන්‍ය Windows පරිගණකයක Visual Studio ඉල්ලා සිටීමෙන් අවසන් වේ. 0.1.2 හි නිවැරදි කරන ලදී: කිසිවක් බාගත කිරීමට පෙර Zinnector® මෙය හඳුනාගෙන runtime එක සඳහා පමණක් Node 24 එකක් ලබා ගනී — nodejs.org හි checksums වලට සාපේක්ෂව සත්‍යාපනය කරන ලද, 30 MB පමණ — එබැවින් කිසිවක් කිසි විටෙකත් compile නොවේ. යාවත්කාලීන කිරීමෙන් පසුවද මෙය තවමත් දිස්වන්නේ නම්, කලින් සිදු කළ අඩක් නිම වූ ස්ථාපනය පළමුව ඉවත් කිරීම සඳහා zinnector dev --reset-runtime ධාවනය කරන්න.

පිරිසිදු කිරීමේදී npm වෙතින් ලැබෙන "EPERM" අනතුරු ඇඟවීම් (Windows)

බොහෝ විට ප්‍රතිවයිරස ස්කෑනරයක් හෝ සෙවුම් indexer එකක් මඟින්, npm විසින් ඉවත් කිරීමට උත්සාහ කරන අතරතුර runtime හි node_modules යටතේ ඇති ගොනුවක් විවෘතව තබා ගැනීම මෙයට හේතුවයි. ඊළඟ zinnector dev හිදී පිරිසිදු බහලුමක සිට ස්ථාපනය නැවත උත්සාහ කරනු ලැබේ; එය දිගටම සිදුවන්නේ නම්, zinnector dev --reset-runtime මඟින් පළමුව සම්පූර්ණ runtime බහලුම ඉවත් කර නැවත ස්ථාපනය කරයි.

"the local playground runtime could not be installed"

මෙම පණිවිඩයට npm හි අවසාන පේළි සහ Zinnector® විසින් ධාවනය කරන ලද නිශ්චිත විධානය ඇතුළත් වේ, එබැවින් ඔබට එය ඔබම ධාවනය කර සම්පූර්ණ ප්‍රතිදානය බලා ගත හැක. සාමාන්‍ය හේතු වන්නේ ජාල හෝ proxy ගැටලුවක් — runtime ලබා ගන්නේ ඔබගේම npm මඟින් බැවින්, npm config set proxy … සහ registry mirror එකක් අදාළ වේ — හෝ අඩක් නිම වූ පෙර ස්ථාපනයක් විය හැක, එය --reset-runtime මඟින් ඉවත් කරයි.

"the local playground exited before it was ready", හෝ එය කිසි විටෙකත් සූදානම් නොවීම

runtime හි ප්‍රතිදානය බැලීමට zinnector dev --verbose ධාවනය කරන්න. දැනටමත් භාවිතයේ පවතින port එකක් සාමාන්‍ය හේතුවයි: zinnector dev --port 9401, හෝ zinnector.json හි port සකසන්න. ස්ථාපනය වූ නමුත් boot නොවන runtime එකක් නම්: zinnector dev --reset-runtime. පළමු boot වීමේදී WordPress ද බාගත වන බැවින්, මන්දගාමී සම්බන්ධතාවයකදී එයට මිනිත්තු කිහිපයක් ලබා දෙන්න; CLI එක ඇණහිටීමට වඩා timeout එකක් වාර්තා කිරීමට පෙර මිනිත්තු පහක් දක්වා රැඳී සිටියි.

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

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

deploy කිරීමෙන් පසු අඩවිය හිස්ව (white) පැවතීම

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

අදාළ

• ආරම්භ කිරීම · දේශීය සංවර්ධනය · Deploy කිරීම · විධාන විමර්ශනය