Zinnector® နှင့် စတင်ခြင်း၊ developer CLI

Zinnector® သည် WordPress ဆော့ဖ်ဝဲလ်ရေးသားသူများအတွက် Zinn Digital®၏ အခမဲ့ပေးထားသော၊ MIT-licensed ကွန်မန်းလိုင်း ကိရိယာတစ်ခု ဖြစ်ပါသည်။ ၎င်းသည် ဝဘ်ဆိုက်တစ်ခုကို တည်ဆောက်ပေးပြီး၊ သင့်စက်ထဲတွင် Node တစ်ခုတည်းမှလွဲ၍ မည်သည့်အရာမျှ ထည့်သွင်းထားရန် မလိုဘဲ (Docker မလို၊ MAMP မလို၊ PATH ထဲတွင် PHP ရှိရန်မလိုပါ) တကယ့် WordPress တစ်ခုကို လည်ပတ်ပေးပါသည်။ ထို့နောက် သင်တည်ဆောက်ထားသည်များကို သင်တင်ပို့တော့မည့် ဟို့စ်တင်းစလော့နှင့် ကိုက်ညီမှုရှိမရှိ စစ်ဆေးပြီး တင်ပို့ပေးပါသည်။ ဤလမ်းညွှန်သည် သင့်အား မည်သည့်အရာမျှ မရှိသည့်အခြေအနေမှ နှစ်မိနစ်ခန့်အတွင်း လည်ပတ်နေသော ဝဘ်ဆိုက်တစ်ခု ရရှိစေမည်ဖြစ်ပြီး၊ တစ်စုံတစ်ခု မှားယွင်းသွားပါက သိရှိနိုင်ရန် အဆင့်တိုင်းတွင် အောင်မြင်ကြောင်း မည်သို့ပြသမည်ကို ပြောပြပေးမည် ဖြစ်ပါသည်။

သင်လိုအပ်သည်များ

• Node 24 သို့မဟုတ် ထိုထက်သစ်သော ဗားရှင်း။ node --version ကို လည်ပတ်ပါ၊ ၎င်းသည် v24 သို့မဟုတ် ထိုထက်မြင့်သော ဗားရှင်းကို ပြသရပါမည်။ လက်ရှိ LTS ဗားရှင်းကို nodejs.org မှ ထည့်သွင်းပါ — Windows တွင် winget install OpenJS.NodeJS.LTS၊ macOS တွင် brew install node@24 ဖြစ်ပါသည်။
• npm၊ ၎င်းသည် Node နှင့်အတူ ပါဝင်ပြီးသား ဖြစ်ပါသည်။ Zinnector® သည် WordPress runtime ကို ၎င်း၏ ကိုယ်ပိုင် Cache ထဲသို့ ဒေါင်းလုဒ်လုပ်ရန် ၎င်းကို တစ်ကြိမ် အသုံးပြုပါသည်။
• git၊ zinnector push အတွက်သာ လိုအပ်ပါသည် — တင်ပို့မှုများကို သင့် repository မှ ဆောင်ရွက်ပါသည်။
• Docker၊ --runtime docker ဖြင့် တောင်းဆိုမှသာ လိုအပ်ပါသည်။ မူလ runtime အတွက် မလိုအပ်ပါ။

အောက်ပါ မည်သည့်အရာအတွက်မျှ အကောင့်တစ်ခု မလိုအပ်ပါ။ API ကီးကို Deploying with Zinnector® တွင် ဟို့စ်တင်းစလော့သို့ ရောက်ရှိချိန်မှသာ လိုအပ်မည် ဖြစ်ပါသည်။

အဆင့် ၁ — ထည့်သွင်းပါ

npm install -g zinnector

npm က npm WARN EBADENGINE ဟု ပြသပါက သင့် Node သည် ထုပ်ပိုးမှုတွင် ကြေညာထားသော >=24.18.1 ထက် ဟောင်းနေသောကြောင့် ဖြစ်ပါသည်။ ထည့်သွင်းမှုပြီးစီးသွားမည် ဖြစ်သော်လည်း CLI က လည်ပတ်ရန် ငြင်းဆန်ပါလိမ့်မည်။ Node ကို ဦးစွာ အဆင့်မြှင့်ပါ၊ ထို့နောက် ပြန်လည် ထည့်သွင်းပါ။

အဆင့် ၂ — ဗားရှင်းကို စစ်ဆေးပါ

zinnector --version

အောင်မြင်ပါက: ဗားရှင်းနံပါတ်တစ်ခု ပြပါမည်၊ ဥပမာ 0.1.2။ အကယ်၍ "Zinnector® needs Node 24 or newer — this is Node 20.x" ဟု စာသားတွေ့ရပါက binary ကို ထည့်သွင်းပြီးဖြစ်သော်လည်း သင့် Node သည် ဟောင်းလွန်းနေသောကြောင့် ဖြစ်ပါသည်၊ ကွန်မန်းသည် မည်သည့်အရာမျှ မလုပ်ဆောင်ဘဲ ကုတ် 78 ဖြင့် ထွက်သွားပါလိမ့်မည်။

အဆင့် ၃ — အကူအညီကို ဖတ်ပါ

zinnector --help

အောင်မြင်ပါက: လုပ်ငန်းစဉ်၏ ကွန်မန်းငါးခု (new, dev, link, check, push) ကို အမည်ဖော်ပြထားသော စာတန်းတစ်ခုနှင့် ထို့နောက် ကွန်မန်းတစ်ခုချင်းစီ၏ ရည်ရွယ်ချက်ကို စာကြောင်းတစ်ကြောင်းစီဖြင့် ပြသပါမည်။ ကွန်မန်းတစ်ခုစီတွင် ၎င်း၏ ကိုယ်ပိုင် --help လည်း ပါဝင်ပါသည် — zinnector dev --help သည် runtime၊ PHP နှင့် port အမှတ်အသားများကို စာရင်းပြပေးပါသည်။ နမူနာများနှင့်တကွ ပြည့်စုံသော စာရင်းကို command reference တွင် ကြည့်ရှုနိုင်ပါသည်။

အဆင့် ၄ — ဝဘ်ဆိုက်တစ်ခု တည်ဆောက်ပါ

zinnector new my-site

အောင်မြင်ပါက: Created my-site ဟူသော ခေါင်းစဉ်တစ်ခုနှင့် ၎င်းရေးသားခဲ့သော ဖိုင်များ၏ စာရင်း — zinnector.json၊ plugins/၊ themes/ နှင့် mu-plugins/ အကူအညီများပါဝင်သော wp-content သစ်ပင်ပုံစံ၊ .gitignore နှင့် README တစ်ခု — နှင့် ဆက်လက်လည်ပတ်ရမည့် ကွန်မန်းများ ပြသပါမည်။ ၎င်းတွင် မည်သည့်အရာမျှ နေရာယူအတု မဟုတ်ပါ၊ ပရောဂျက်သည် ရှိရင်းစွဲအတိုင်း စတင်လည်ပတ်ပါသည်။ --template plugin သို့မဟုတ် --template theme သည် ဖန်တီးလိုက်သည်နှင့် ချက်ချင်း အလုပ်လုပ်သော ပလပ်ဂင် သို့မဟုတ် ဘလောက် သီးမ်ကို တည်ဆောက်ပေးပါသည်။

အဆင့် ၅ — လည်ပတ်ပါ

cd my-site
zinnector dev

ပထမဆုံးအကြိမ်တွင် Zinnector® သည် 5.2 မှ 8.5 အထိ PHP build တိုင်းပါဝင်သောကြောင့် 570 MB ခန့်ရှိသည့် WordPress runtime ကို သင့်ပရောဂျက်ထဲသို့ မဟုတ်ဘဲ ၎င်း၏ ကိုယ်ပိုင် Cache ဖိုဒါထဲသို့ ဒေါင်းလုဒ်မလုပ်မီ တစ်ကြိမ် မေးမြန်းပါလိမ့်မည်။ Y ဟု ဖြေကြားပါ၊ သို့မဟုတ် မေးခွန်းကို ကျော်လွန်ရန် --yes ကို ထည့်သွင်းပါ။ Node 26 သို့မဟုတ် ထိုထက်သစ်သော ဗားရှင်းများတွင် runtime ၏ native module တွင် Node 24 နှင့် 25 အတွက်သာ ကြိုတင်တည်ဆောက်ထားသော binaries များရှိသောကြောင့် runtime သီးသန့်အတွက် Node 24 ကိုလည်း ဆွဲယူပါမည် (30 MB ခန့်ရှိပြီး nodejs.org ၏ checksum များဖြင့် စစ်ဆေးထားပါသည်)၊ သင့်အနေဖြင့် compiler သို့မဟုတ် Visual Studio လိုအပ်မည် မဟုတ်ပါ။

အောင်မြင်ပါက: ပရောဂျက်အမည်၊ PHP ဗားရှင်းနှင့် WordPress ဗားရှင်းတို့ကို ဖော်ပြထားသော အကွက်တစ်ခု ပြသမည်ဖြစ်ပြီး၊ ထို့နောက် အောက်ပါအတိုင်း ပြပါမည် -

✔ running at http://127.0.0.1:9400
  admin: http://127.0.0.1:9400/wp-admin  (already signed in)

အဆင့် ၆ — ၎င်းကို ဖွင့်ပါ

ဘရောက်ဆာတွင် http://127.0.0.1:9400 သို့ ဝင်ရောက်ပါ။ အောင်မြင်ပါက: သင်တောင်းဆိုထားသော PHP ဗားရှင်းဖြင့် လွှင့်တင်ထားသည့် My WordPress Website ဟု ခေါင်းစဉ်တပ်ထားသော သစ်လွင်သော WordPress ဝဘ်ဆိုက်တစ်ခုကို တွေ့ရပါမည်။ http://127.0.0.1:9400/wp-admin သည် ထိန်းချုပ်ခန်းကို အကောင့်ဝင်ရောက်ပြီးသား အခြေအနေဖြင့် ဖွင့်ပေးပါမည်။ ပလပ်ဂင်တစ်ခုကို wp-content/plugins/ ထဲသို့ သို့မဟုတ် သီးမ်တစ်ခုကို wp-content/themes/ ထဲသို့ ထည့်သွင်းလိုက်ပါ၊ နောက်တစ်ကြိမ် ပြန်လည်စတင်ချိန်တွင် ရရှိနေမည်ဖြစ်သည် — runtime သည် ထိုဖိုဒါများကို သင့်ပရောဂျက်မှ တိုက်ရိုက် ရယူပေးပါသည်။

ရပ်တန့်ရန် Ctrl-C ကို နှိပ်ပါ။ zinnector dev --once သည် runtime ကို စတင်လည်ပတ်စေပြီး၊ အမှန်တကယ် လည်ပတ်နေသည်များကို ပြသကာ (PHP ဗားရှင်း၊ WordPress ဗားရှင်း၊ ထည့်သွင်းထားသော တိုးချဲ့မှုများ) ရပ်တန့်သွားပါမည် — ကတိပေးရုံမျှမက အထောက်အထား လိုအပ်သည့်အခါ အသုံးဝင်ပါသည်။

ဆက်လက်လေ့လာရန်များ

• Local development with zinnector dev — runtime နှစ်ခု၊ PHP နှင့် WordPress ဗားရှင်းများကို ရွေးချယ်ခြင်း၊ နှင့် မည်သည့်နေရာမှ မည်သည့်အရာကို ရယူပေးသည်များ။
• Deploying with Zinnector® — အကောင့်ဝင်ရန်၊ ပရောဂျက်ကို စလော့တစ်ခုနှင့် ချိတ်ဆက်ရန်၊ စစ်ဆေးရန်၊ တင်ပို့ရန်။
• The command reference — ကွန်မန်းတိုင်း၊ အမှတ်အသားတိုင်းနှင့် နမူနာများ။
• Troubleshooting — လူအများ အမှန်တကယ် ကြုံတွေ့ရသော အမှားများနှင့် တစ်ခုစီအတွက် ဖြေရှင်းနည်းများ။

ဤစာရွက်စာတမ်း အပြည့်အစုံကို npm တွင်လည်းကောင်း၊ ပြဿနာများနှင့် pull request များကို ကြိုဆိုလျက်ရှိသော GitHub တွင်လည်းကောင်း ထုပ်ပိုးမှု၏ README တွင် တွေ့ရှိနိုင်ပါသည်။