Zinnector® ပြဿနာဖြေရှင်းခြင်း

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

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

Zinnector® 0.1.0 နှင့် 0.1.1 ရှိ ချွတ်ယွင်းချက်တစ်ခုဖြစ်သည်။ Windows တွင် runtime installer သည် npm.cmd ကို အမည်ဖြင့် run ခဲ့ပြီး Node သည် CVE-2024-27980 အတွက် ၎င်း၏ဖြေရှင်းချက်ထွက်ရှိပြီးကတည်းက shell မပါဘဲ .cmd ဖိုင်တစ်ခုကို spawn လုပ်ရန် ငြင်းဆိုခဲ့ပါသည် — ထို့ကြောင့် သင် Y ဖြေကြားပြီး တစ်စက္ကန့်အကြာတွင် ထည့်သွင်းမှု crash ဖြစ်သွားခဲ့သည်။ 0.1.2 တွင် ဖြေရှင်းပြီးဖြစ်သည်: npm ကို ယခုအခါ platform တိုင်းတွင် တူညီပြီး shell မလိုအပ်သော node npm-cli.js အဖြစ် run ပေးထားပါသည်။ 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 အတွက်သာ prebuilt binary များရှိသော native module တစ်ခု ပါဝင်ပါသည်။ ပိုမိုသစ်လွင်သော Node (စက်တင်ဘာ ၂၀၂၆ အထိ၊ ၂၆ နှင့်အထက်) တွင် ၎င်း၏ installer သည် source မှ compile လုပ်ခြင်းသို့ ပြန်ပြောင်းသွားပြီး သာမန် Windows စက်တစ်ခုတွင် Visual Studio တောင်းဆိုမှုဖြင့် အဆုံးသတ်သွားပါသည်။ 0.1.2 တွင် ဖြေရှင်းပြီးဖြစ်သည်: Zinnector® သည် မည်သည့်အရာကိုမျှ ဒေါင်းလုဒ်မလုပ်မီ ၎င်းကို စစ်ဆေးသိရှိပြီး runtime တစ်ခုတည်းအတွက်သာ ရည်ရွယ်သည့် Node 24 တစ်ခုကို ရယူပေးပါသည် — 30 MB ခန့်ရှိပြီး nodejs.org ၏ checksum များနှင့် စစ်ဆေးအတည်ပြုထားပါသည် — ထို့ကြောင့် မည်သည့်အရာကိုမျှ compile လုပ်ရန် မလိုအပ်တော့ပါ။ အဆင့်မြှင့်ပြီးနောက်တွင်လည်း ၎င်းကို မြင်တွေ့နေရသေးပါက ယခင်က တစ်ဝက်တစ်ပျက်ထည့်သွင်းထားမှုကို ဦးစွာစွန့်ပစ်နိုင်ရန် zinnector dev --reset-runtime ကို run ပါ။

ရှင်းလင်းနေစဉ်အတွင်း npm ထံမှ "EPERM" သတိပေးချက်များ (Windows)

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

"the local playground runtime could not be installed"

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

"the local playground exited before it was ready" သို့မဟုတ် ဘယ်သောအခါမှ အဆင်သင့်မဖြစ်တော့ခြင်း

runtime ၏ ကိုယ်ပိုင် output ကို ကြည့်ရှုရန် zinnector dev --verbose ကို run ပါ။ 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 တစ်ခုမှ လုပ်ဆောင်ခြင်းဖြစ်သောကြောင့် zinnector push သည် platform က ရောက်ရှိနိုင်သော remote ရှိသည့် repository တစ်ခု လိုအပ်ပါသည်။ git init && git add -A && git commit -m initial ပြုလုပ်ပါ၊ သင်၏ GitHub သို့မဟုတ် GitLab remote ကို ပေါင်းထည့်ပါ၊ ထို့နောက် ၎င်းကို site နှင့် ချိတ်ဆက်ရန် zinnector link ကို run ပါ။

deploy ပြီးနောက် site သည် အဖြူရောင်ဖြစ်နေခြင်း

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

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

• စတင်ခြင်း · စက်တွင်း ရေးသားထုတ်လုပ်ခြင်း · Deploy လုပ်ခြင်း · Command လမ်းညွှန်