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

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

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

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

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

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

npm install -g zinnector

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

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

zinnector --version

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

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

zinnector --help

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

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

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

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

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

ឯកសារដូចគ្នានេះមាននៅក្នុង README នៃកញ្ចប់នៅលើ npm និងនៅលើ GitHub ជាកន្លែងដែលបញ្ហា និង pull request ត្រូវបានស្វាគមន៍ជានិច្ច។