ការចាប់ផ្តើមជាមួយ Zinnector® ដែលជា CLI អ្នកអភិវឌ្ឍន៍

Zinnector® គឺជាឧបករណ៍បញ្ជាបញ្ជា (command-line) ដែលមានអាជ្ញាបណ្ណ MIT ឥតគិតថ្លៃរបស់ Zinn Digital® សម្រាប់អ្នកអភិវឌ្ឍន៍ WordPress។ វាបង្កើតរចនាសម្ព័ន្ធគេហទំព័រ ដំណើរការ WordPress ពិតប្រាកដនៅលើម៉ាស៊ីនផ្ទាល់ខ្លួនរបស់អ្នកដោយមិនចាំបាច់ដំឡើងអ្វីផ្សេងក្រៅពី Node — មិនប្រើ Docker, មិនប្រើ MAMP, មិនមាន PHP នៅក្នុង PATH របស់អ្នកឡើយ — បន្ទាប់មកពិនិត្យមើលអ្វីដែលអ្នកបានបង្កើតធៀបនឹងរន្ធបង្ហោះ (hosting slot) ដែលអ្នករៀបនឹងដាក់ឱ្យដំណើរការ (deploy) ហើយបញ្ជូនវាទៅ។ មគ្គុទ្ទេសក៍នេះនាំអ្នកពីចំណុចចាប់ផ្តើមដំបូង រហូតដល់គេហទំព័រដែលកំពុងដំណើរការក្នុងពេលប្រហែលពីរនាទី ហើយប្រាប់អ្នកអំពីលទ្ធផលជោគជ័យនៅគ្រប់ជំហាន ដើម្បីឱ្យអ្នកដឹងនៅពេលមានបញ្ហាអ្វីមួយកើតឡើង។

អ្វីដែលអ្នកត្រូវការ

• Node 24 ឬថ្មីជាងនេះ។ ដំណើរការ node --version វាត្រូវតែបង្ហាញ v24 ឬខ្ពស់ជាងនេះ។ ដំឡើង LTS បច្ចុប្បន្នពី nodejs.org — លើ Windows winget install OpenJS.NodeJS.LTS, លើ macOS brew install node@24។
• npm, ដែលមកជាមួយ Node។ Zinnector® ប្រើវាពីរដង ដើម្បីទាញយកកម្មវិធីដំណើរការ WordPress ទៅក្នុងឃ្លាំងសម្ងាត់ (cache) ផ្ទាល់ខ្លួនរបស់វា។
• git, សម្រាប់តែ zinnector push ប៉ុណ្ណោះ — ការដាក់ឱ្យដំណើរការ (deploys) ត្រូវបានបញ្ជាចេញពីឃ្លាំងផ្ទុកទិន្នន័យ (repository) របស់អ្នក។
• Docker, សម្រាប់តែករណីដែលអ្នកស្នើសុំវាជាមួយ --runtime docker ប៉ុណ្ណោះ។ កម្មវិធីដំណើរការតាមលំនាំដើមមិនត្រូវការវាទេ។

គ្មានអ្វីនៅខាងក្រោមដែលត្រូវការគណនីនោះទេ។ សោ API គឺត្រូវការតែនៅពេលអ្នកទៅដល់រន្ធបង្ហោះប៉ុណ្ណោះ នៅក្នុង ការដាក់ឱ្យដំណើរការជាមួយ Zinnector®។

ជំហានទី 1 — ដំឡើងវា

npm install -g zinnector

ប្រសិនបើ npm បង្ហាញ npm WARN EBADENGINE នោះ Node របស់អ្នកគឺចាស់ជាង >=24.18.1 ដែលកញ្ចប់បានប្រកាស។ ការដំឡើងនៅតែបញ្ចប់ ប៉ុន្តែ CLI នឹងបដិសេធមិនដំណើរការឡើយ។ សូមធ្វើបច្ចុប្បន្នភាព Node ជាមុនសិន បន្ទាប់មកដំឡើងម្តងទៀត។

ជំហានទី 2 — ពិនិត្យមើលកំណែ

zinnector --version

ជោគជ័យ៖ លេខកំណែ ឧទាហរណ៍ 0.1.2។ ប្រសិនបើអ្នកឃើញ "Zinnector® ត្រូវការ Node 24 ឬថ្មីជាងនេះ — នេះគឺជា Node 20.x" នោះឯកសារប្រព័ន្ធត្រូវបានដំឡើងហើយ ប៉ុន្តែ Node របស់អ្នកចាស់ពេក។ បញ្ជាផ្ទៃក្នុងនឹងចាកចេញដោយប្រើកូដ 78 ជាជាងធ្វើអ្វីមួយ។

ជំហានទី 3 — អានជំនួយ

zinnector --help

ជោគជ័យ៖ បដាដែលបញ្ជាក់ឈ្មោះបញ្ជាទាំងប្រាំនៃលំហូរការងារ (new, dev, link, check, push) ហើយបន្ទាប់មកបញ្ជានីមួយៗជាមួយគោលបំណងមួយជួរ។ បញ្ជានីមួយៗក៏ទទួលយក --help ផ្ទាល់ខ្លួនផងដែរ — zinnector dev --help រាយបញ្ជីកម្មវិធីដំណើរការ, PHP និងទង់ច្រក (port flags)។ បញ្ជីពេញលេញ រួមជាមួយឧទាហរណ៍ មាននៅក្នុង ឯកសារយោងបញ្ជា។

ជំហានទី 4 — បង្កើតរចនាសម្ព័ន្ធគេហទំព័រ

zinnector new my-site

ជោគជ័យ៖ ចំណងជើង Created my-site និងបញ្ជីឯកសារដែលវាបានសរសេរ — zinnector.json, ដើមឈើ wp-content ដែលមាន plugins/, themes/ និងកម្មវិធីជំនួយ mu-plugins/, ឯកសារ .gitignore និង README — បន្ទាប់មកគឺបញ្ជាបន្តបន្ទាប់ដែលត្រូវដំណើរការ។ គ្មានអ្វីនៅក្នុងនោះជាកន្លែងជំនួសបណ្តោះអាសន្នទេ គម្រោងចាប់ផ្តើមដំណើរការដូចដែលវាមានស្រាប់។ --template plugin ឬ --template theme បង្កើតរចនាសម្ព័ន្ធកម្មវិធីជំនួយ ឬប្រធានបទប្លុកដែលសកម្មភ្លាមៗនៅពេលវាមាន។

ជំហានទី 5 — ដំណើរការវា

cd my-site
zinnector dev

លើកទីមួយ Zinnector® សួរម្តងមុនពេលទាញយកកម្មវិធីដំណើរការ WordPress — ប្រហែល 570 MB ព្រោះវាផ្ទុកគ្រប់កំណែ PHP ចាប់ពី 5.2 ដល់ 8.5 — ទៅក្នុងថតឃ្លាំងសម្ងាត់ផ្ទាល់ខ្លួនរបស់វា ដោយមិនដាក់ចូលក្នុងគម្រោងរបស់អ្នកឡើយ។ ឆ្លើយ Y ឬបញ្ចូល --yes ដើម្បីរំលងសំណួរ។ លើ Node 26 ឬថ្មីជាងនេះ វាក៏ទាញយក Node 24 សម្រាប់តែកម្មវិធីដំណើរការប៉ុណ្ណោះ (ប្រហែល 30 MB ផ្ទៀងផ្ទាត់ធៀបនឹងលេខកូដផ្ទៀងផ្ទាត់របស់ nodejs.org) ព្រោះម៉ូឌុលដើមរបស់កម្មវិធីដំណើរការមានឯកសារប្រព័ន្ធដែលបានបង្កើតជាមុនសម្រាប់តែ Node 24 និង 25 ប៉ុណ្ណោះ។ អ្នកមិនត្រូវការកម្មវិធីបកប្រែកូដ (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)

ជំហានទី 6 — បើកវា

ចូលទៅកាន់ http://127.0.0.1:9400 នៅក្នុងកម្មវិធីរុករក។ ជោគជ័យ៖ គេហទំព័រ WordPress ថ្មីដែលមានចំណងជើងថា My WordPress Website ដំណើរការដោយកំណែ PHP ដែលអ្នកបានស្នើសុំ។ http://127.0.0.1:9400/wp-admin បើកផ្ទាំងគ្រប់គ្រងដែលបានចូលប្រព័ន្ធរួចរាល់។ ដាក់កម្មវិធីជំនួយទៅក្នុង wp-content/plugins/ ឬប្រធានបទទៅក្នុង wp-content/themes/ ហើយវានឹងមាននៅទីនោះនៅពេលផ្ទុកឡើងវិញលើកក្រោយ — កម្មវិធីដំណើរការផ្តល់សេវាថតទាំងនោះដោយផ្ទាល់ចេញពីគម្រោងរបស់អ្នក។

ចុច Ctrl-C ដើម្បីបញ្ឈប់។ zinnector dev --once ចាប់ផ្តើមកម្មវិធីដំណើរការ បង្ហាញអ្វីដែលកំពុងដំណើរការជាក់ស្តែង (កំណែ PHP, កំណែ WordPress, ផ្នែកបន្ថែមដែលបានផ្ទុក) ហើយបញ្ឈប់ — មានប្រយោជន៍នៅពេលអ្នកត្រូវការភស្តុតាងជាជាងការសន្យា។

កន្លែងដែលត្រូវបន្តបន្ទាប់

• ការអភិវឌ្ឍក្នុងស្រុកជាមួយ zinnector dev — កម្មវិធីដំណើរការទាំងពីរ ការជ្រើសរើសកំណែ PHP និង WordPress និងអ្វីដែលត្រូវផ្តល់សេវាមកពីណា។
• ការដាក់ឱ្យដំណើរការជាមួយ Zinnector® — ចូលប្រព័ន្ធ ភ្ជាប់គម្រោងទៅកាន់រន្ធបង្ហោះ ពិនិត្យមុនការហោះហើរ បញ្ជូនទៅ។
• ឯកសារយោងបញ្ជា — គ្រប់បញ្ជា ទង់ និងឧទាហរណ៍។
• ការដោះស្រាយបញ្ហា — កំហុសដែលមនុស្សជួបប្រទះជាក់ស្តែង និងដំណោះស្រាយសម្រាប់បញ្ហានីមួយៗ។

ឯកសារដូចគ្នានេះមាននៅក្នុង README នៃកញ្ចប់នៅលើ npm និងនៅលើ GitHub ដែលជាកន្លែងស្វាគមន៍រាល់ការរាយការណ៍បញ្ហា និងសំណើទាញយកទិន្នន័យ (pull requests)។