Zinnector® ကို ဖြေရှင်းခြင်း

လူအများ Zinnector® CLI တွင် အမှန်တကယ် ကြုံတွေ့ရလေ့ရှိသည့် အမှားများ၊ တစ်ခုချင်းစီ၏ အဓိပ္ပာယ်နှင့် ဖြေရှင်းနည်း။ အဝင်တစ်ခုချင်းစီတွင် သင်တွေ့မြင်ရမည့် စာသားအတိအကျကို ဖော်ပြထားသဖြင့် ဤစာမျက်နှာတွင် ရှာဖွေနိုင်ပါသည်။ သင့်အမှား ဤနေရာတွင် မရှိပါက ပျက်ကွက်နေသည့် ထိန်းချုပ်မိန့် (command) ကို ZINNECTOR_DEBUG=1 ဖြင့် ပူးတွဲစတင်ပါ၊ ထို့နောက် ထွက်ပေါ်လာသည့် ရလဒ်များ၊ သင့် node --version နှင့် သင့်လုပ်ဆောင်ရေးစနစ် (operating system) တို့နှင့်အတူ github.com/Zinn-Digital/zinnector/issues တွင် ပြဿနာတစ်ခု ထုတ်ပြန်အကြောင်းကြားပေးပါ။

Runtime ထည့်သွင်းခြင်းကို လက်ခံပြီးနောက်တွင် "spawn EINVAL" ထွက်ပေါ်လာခြင်း (Windows)

Zinnector® 0.1.0 နှင့် 0.1.1 တို့တွင် ရှိသော ဘဂ် (bug) တစ်ခုကြောင့် ဖြစ်ပါသည်။ Windows တွင် runtime ထည့်သွင်းပေးသည့် စနစ်သည် npm.cmd ကို အမည်ဖြင့် တိုက်ရိုက် run ခဲ့ပြီး Node သည် CVE-2024-27980 အတွက် ပြုပြင်မှု ပြုလုပ်ခဲ့ပြီးကတည်းက shell မပါဘဲ .cmd ဖိုင်တစ်ခုကို စတင်ရန် ငြင်းဆိုခဲ့သည် - ထို့ကြောင့် သင် Y ဟု အကြောင်းပြန်ပြီး တစ်စက္ကန့်အကြာတွင် ထည့်သွင်းခြင်း ပျက်စီးသွားခဲ့သည်။ 0.1.2 တွင် ပြုပြင်ပြီးပါပြီ: npm ကို ယခုအခါ node npm-cli.js အဖြစ် စတင်မည်ဖြစ်ရာ စနစ်တိုင်းတွင် တူညီပြီး shell မလိုအပ်တော့ပါ။ npm install -g zinnector@latest ကို run ပါ၊ ထို့နောက် zinnector dev ကို နောက်တစ်ကြိမ် ထပ်မံ run ပါ။

ထည့်သွင်းစဉ် "npm WARN EBADENGINE" ပြခြင်း သို့မဟုတ် "Zinnector® needs Node 24 or newer" ဟု ပြခြင်း

သင့် Node အဆင့်သည် 24 ထက် ဟောင်းနေပါသည်။ Package သည် 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 တွင် Node 24 နှင့် 25 အတွက်သာ အဆင်သင့်ပြုလုပ်ထားသော binary များရှိသည့် native module တစ်ခု ပါဝင်သည်။ ပိုမိုသစ်လွင်သော Node (၂၀၂၆ စက်တင်ဘာလ စာရင်းအရ 26 နှင့် အထက်) တွင် ၎င်း၏ ထည့်သွင်းမှုစနစ်သည် ပင်မရင်းမြစ်မှ ပြန်လည်ရေးဆွဲခြင်း (compiling) သို့ ပြောင်းလဲသွားပြီး ရိုးရိုး Windows စက်တစ်ခုတွင် Visual Studio လိုအပ်သည်ဆိုသော တောင်းဆိုချက်ဖြင့် ပြီးဆုံးသွားပါသည်။ 0.1.2 တွင် ပြုပြင်ပြီးပါပြီ: Zinnector® သည် မည်သည်ကိုမျှ ဒေါင်းလုဒ်မဆွဲမီ ဤအခြေအနေကို သတိပြုမိပြီး runtime တစ်ခုတည်းအတွက်သာ Node 24 ကို ဒေါင်းလုဒ်ဆွဲယူပါသည် — 30 MB ခန့်ရှိပြီး nodejs.org ၏ checksum များဖြင့် စစ်ဆေးထားပါသည် — ထို့ကြောင့် မည်သည့်အရာကိုမျှ စုစည်းရေးဆွဲရန် မလိုတော့ပါ။ အဆင့်မြှင့်တင်ပြီးနောက်တွင်လည်း ဤအမှားကို တွေ့နေရသေးပါက မပြီးသေးသော ထည့်သွင်းမှုကို အရင်စွန့်ပစ်ရန် zinnector dev --reset-runtime ကို run ပေးပါ။

Clean up လုပ်နေစဉ် npm မှ "EPERM" သတိပေးချက်များ ထွက်ပေါ်လာခြင်း (Windows)

npm က ဖယ်ရှားရန် ကြိုးစားနေစဉ် runtime ၏ node_modules အောက်ရှိ ဖိုင်တစ်ခုကို ဗိုင်းရပ်စ်ကာကွယ်ရေးစနစ် (antivirus scanner) သို့မဟုတ် ရှာဖွေရေးညွှန်းကိန်းစနစ် (search indexer) က ဖွင့်ထားဆဲ ဖြစ်လေ့ရှိပါသည်။ နောက်တစ်ကြိမ် zinnector dev လုပ်ဆောင်ချိန်တွင် သန့်ရှင်းသော ဖိုဒါတစ်ခုမှ ထည့်သွင်းခြင်းကို ပြန်လည်ကြိုးစားပါမည်၊ ဆက်လက်ဖြစ်ပွားနေပါက zinnector dev --reset-runtime က runtime ဖိုဒါတစ်ခုလုံးကို အရင်ဆုံး ဖယ်ရှားပြီးမှ ပြန်လည်ထည့်သွင်းပေးပါမည်။

"the local playground runtime could not be installed"

ဤသတင်းစကားတွင် npm ၏ နောက်ဆုံးလိုင်းများနှင့် Zinnector® run ခဲ့သော တိကျသည့် ထိန်းချုပ်မိန့် ပါဝင်သောကြောင့် သင့်ဘာသာ run ကြည့်ပြီး ရလဒ်အပြည့်အစုံကို ကြည့်ရှုနိုင်ပါသည်။ ပုံမှန်ဖြစ်လေ့ရှိသော အကြောင်းရင်းများမှာ ကွန်ရက် သို့မဟုတ် proxy ပြဿနာများ ဖြစ်သည် — runtime ကို သင့်ကိုယ်ပိုင် npm ဖြင့် ရယူထားခြင်းဖြစ်သဖြင့် npm config set proxy … နှင့် registry mirror တို့ သက်ရောက်ပါသည် — သို့မဟုတ် အစောပိုင်းက မပြီးပြတ်ခဲ့သော ထည့်သွင်းမှုကြောင့် ဖြစ်နိုင်ပြီး --reset-runtime ဖြင့် ရှင်းလင်းနိုင်ပါသည်။

"the local playground exited before it was ready" သို့မဟုတ် စတင်ရန် အဆင်သင့် လုံးဝမဖြစ်ခြင်း

Runtime ၏ ကိုယ်ပိုင်ထွက်ရှိချက်များကို ကြည့်ရန် zinnector dev --verbose ကို run ပါ။ Port တစ်ခုကို အသုံးပြုနေပြီးဖြစ်ခြင်းမှာ အဖြစ်များသော အကြောင်းရင်းဖြစ်သည်: zinnector dev --port 9401 ကို အသုံးပြုပါ သို့မဟုတ် zinnector.json တွင် port ကို သတ်မှတ်ပါ။ ထည့်သွင်းပြီးသော်လည်း စတင်မည်မဟုတ်သော runtime အတွက်: zinnector dev --reset-runtime ကို အသုံးပြုပါ။ ပထမဆုံး စတင်ချိန်တွင် WordPress ကိုယ်တိုင်ကိုလည်း ဒေါင်းလုဒ်ဆွဲယူသဖြင့် ကွန်ရက်နှေးကွေးပါက မိနစ်အနည်းငယ် စောင့်ဆိုင်းပေးပါ၊ CLI သည် ရပ်တန့်မသွားဘဲ အချိန်ကုန်ဆုံးကြောင်း မတိုင်ကြားမီ ငါးမိနစ်အထိ စောင့်ဆိုင်းပေးမည် ဖြစ်သည်။

Push လုပ်ချိန်တွင် "this project is not a git repository" ဟု ပြခြင်း

ဖြန့်ကျက်မှုများကို repository တစ်ခုမှ မောင်းနှင်ခြင်းဖြစ်သဖြင့် zinnector push သည် ပလပ်ဖောင်းမှ ရောက်ရှိနိုင်သော remote တစ်ခုရှိသည့် repository တစ်ခု လိုအပ်ပါသည်။ git init && git add -A && git commit -m initial ကို run ပါ၊ သင့် GitHub သို့မဟုတ် GitLab remote ကို ထည့်သွင်းပါ၊ ထို့နောက် ဆိုဒ်နှင့် ချိတ်ဆက်ရန် zinnector link ကို run ပါ။

Deploy လုပ်ပြီးနောက် ဆိုဒ်သည် အဖြူရောင်ဖြစ်နေခြင်း

zinnector check ကို run ပါ။ ဆယ်ကြိမ်တွင် ကိုးကြိမ်ခန့်သည် PHP ဗားရှင်း မတူညီမှုကြောင့် ဖြစ်သည် — သင်သည် slot တွင် run ထားသည်ထက် ပိုမိုသစ်လွင်သော PHP ဖြင့် တည်ဆောက်ခဲ့ခြင်း ဖြစ်သည် — အစီရင်ခံစာတွင် slot ကို မည်သည့်ဗားရှင်းသို့ zinnector php <version> ဖြင့် ပြောင်းလဲရမည် သို့မဟုတ် မည်သည့်ဗားရှင်းဖြင့် zinnector dev --php <version> ရေးဆွဲရမည်ကို ဖော်ပြထားပါသည်။ zinnector logs --error သည် စနစ်ရပ်တန့်သွားသည့် အမှားကို တိုက်ရိုက်ပြသပေးပါသည်။

ဆက်စပ်အကြောင်းအရာများ

• စတင်ခြင်း · ဒေသတွင်း ရေးဆွဲဖန်တီးခြင်း · ဖြန့်ကျက်စတင်ခြင်း · ထိန်းချုပ်မိန့်များဆိုင်ရာ အညွှန်း