ការដោះស្រាយបញ្ហា Zinnector®

កំហុសជាក់ស្តែងដែលមនុស្សតែងតែជួបប្រទះជាមួយ Zinnector® CLI អត្ថន័យនៃកំហុសនីមួយៗ និងវិធីដោះស្រាយ។ ការពិពណ៌នានីមួយៗប្រាប់ពីអត្ថបទជាក់លាក់ដែលអ្នកនឹងឃើញ ដើម្បីឲ្យអ្នកអាចស្វែងរកវានៅលើទំព័រនេះបាន។ ប្រសិនបើកំហុសរបស់អ្នកមិនមាននៅទីនេះទេ សូមប្រកួតពាក្យបញ្ជាដែលបរាជ័យនោះជាមួយ ZINNECTOR_DEBUG=1 ហើយបើកបញ្ហានៅ github.com/Zinn-Digital/zinnector/issues ជាមួយនឹងលទ្ធផលទទួលបាន node --version របស់អ្នក និងប្រព័ន្ធប្រតិបត្តិការរបស់អ្នក។

"spawn EINVAL" ភ្លាមៗបន្ទាប់ពីទទួលព្រមដំឡើង runtime (Windows)

កំហុសនៅក្នុង Zinnector® 0.1.0 និង 0.1.1។ លើ Windows កម្មវិធីដំឡើង runtime បានដំណើរការ npm.cmd តាមឈ្មោះ ហើយ Node បានបដិសេធមិនដំណើរការឯកសារ .cmd ដោយគ្មាន shell ចាប់តាំងពីការកែសម្រួលសម្រាប់ CVE-2024-27980 — ដូច្នេះការដំឡើងបានគាំងមួយវិនាទីបន្ទាប់ពីអ្នកបានឆ្លើយ Y។ បានកែសម្រួលក្នុង 0.1.2: ឥឡូវនេះ npm ត្រូវ​បានដំណើរការជា node npm-cli.js ដែលដូចគ្នាលើគ្រប់ប្រព័ន្ធប្រតិបត្តិការ និងមិនត្រូវការ shell ឡើយ។ សូមដំណើរការ npm install -g zinnector@latest បន្ទាប់មក zinnector dev ម្តងទៀត។

"npm WARN EBADENGINE" កំឡុងពេលដំឡើង ឬ "Zinnector® needs Node 24 or newer"

Node របស់អ្នកចាស់ជាងកំណែ 24។ npm បង្ហាញការព្រមានព្រោះកញ្ចប់ប្រកាស engines: >=24.18.1 តែការដំឡើងនៅតែបញ្ចប់ ប៉ុន្តែ zinnector បដិសេធមិនចាប់ផ្តើម (កូដចាកចេញ 78) ជាជាងបរាជ័យនៅកន្លែងណាមួយដែលនាំឲ្យច្រឡំនៅពេលក្រោយ។ សូមដំឡើង LTS បច្ចុប្បន្នពី nodejs.org — winget install OpenJS.NodeJS.LTS លើ Windows, brew install node@24 លើ macOS — ផ្ទៀងផ្ទាត់ថា node --version បង្ហាញ v24 ឬខ្ពស់ជាងនេះ ហើយដំឡើង Zinnector® ម្តងទៀត។

"gyp ERR!", "Building from source with node-gyp", ឬ "You need to install Visual Studio"

WordPress runtime មាន native module ដែល prebuilt binaries របស់វាមានសម្រាប់តែ Node 24 និង 25 ប៉ុណ្ណោះ។ លើ Node កំណែថ្មីជាង (26 ឡើងទៅ គិតត្រឹមខែកញ្ញា ឆ្នាំ 2026) កម្មវិធីដំឡើងរបស់វាធ្លាក់ទៅប្រើការចងក្រងពី source វិញ ដែលនៅលើម៉ាស៊ីន Windows ធម្មតានឹងបញ្ចប់ដោយការស្នើសុំ Visual Studio។ បានកែសម្រួលក្នុង 0.1.2: Zinnector® ចាប់យកបញ្ហានេះមុនពេលទាញយកអ្វីមួយ ហើយទាញយក Node 24 សម្រាប់តែ runtime ប៉ុណ្ណោះ — ប្រហែល 30 MB ដោយបានផ្ទៀងផ្ទាត់ជាមួយ checksums របស់ nodejs.org — ដូច្នេះគ្មានអ្វីត្រូវ compile ឡើយ។ ប្រសិនបើអ្នកនៅតែឃើញវារួចរាល់បន្ទាប់ពីដំឡើងកំណែថ្មី សូមដំណើរការ zinnector dev --reset-runtime ដើម្បីបោះបង់ការដំឡើងដែលមិនទាន់រួចរាល់ពីមុនចោលសិន។

ការព្រមាន "EPERM" ពី npm កំឡុងពេលវាសម្អាត (Windows)

ស្ទើរតែតែងតែបណ្តាលមកពីកម្មវិធីស្កែនវីរុស ឬ search indexer កំពុងកាន់ឯកសារមួយចំហនៅក្នុង node_modules របស់ runtime កំឡុងពេល npm ព្យាយាមលុបវា។ ការដំឡើងត្រូវបានព្យាយាមម្តងទៀតចេញពីថតស្អាតនៅពេល zinnector dev បន្ទាប់ ប្រសិនបើវានៅតែបន្តកើតមាន zinnector dev --reset-runtime នឹងលុបថត runtime ទាំងមូលចេញជាមុនសិន ហើយដំឡើងម្តងទៀត។

"the local playground runtime could not be installed"

សារនេះរួមបញ្ចូលទាំងបន្ទាត់ចុងក្រោយរបស់ npm ផ្ទាល់ និងពាក្យបញ្ជាជាក់លាក់ដែល Zinnector® បានដំណើរការ ដើម្បីឲ្យអ្នកអាចដំណើរការវាដោយខ្លួនឯង និងមើលលទ្ធផលពេញលេញបាន។ មូលហេតុធម្មតាគឺបញ្ហាបណ្តាញ ឬ proxy — runtime ត្រូវ​បានទាញយកជាមួយ npm ផ្ទាល់ខ្លួនរបស់អ្នក ដូច្នេះ npm config set proxy … និង registry mirror ត្រូវ​បានអនុវត្ត — ឬការដំឡើងមុនដែលមិនទាន់រួចរាល់ ដែល --reset-runtime នឹងសម្អាតចោល។

"the local playground exited before it was ready" ឬវាមិនដែលត្រៀមខ្លួនរួចរាល់ឡើយ

សូមដំណើរការ zinnector dev --verbose ដើម្បីមើលលទ្ធផលផ្ទាល់របស់ runtime។ Port ដែលកំពុងប្រើប្រាស់រួចជាករណីញឹកញាប់៖ zinnector dev --port 9401 ឬកំណត់ port នៅក្នុង zinnector.json។ Runtime ដែលបានដំឡើងប៉ុន្តែមិនព្រម boot៖ zinnector dev --reset-runtime។ ការ boot លើកដំបូងក៏ទាញយក WordPress ផ្ទាល់ផងដែរ ដូច្នេះលើការភ្ជាប់អ៊ីនធឺណិតយឺត សូមផ្តល់ពេលពីរបីនាទី ការបញ្ជា CLI រង់ចាំរហូតដល់ប្រាំនាទីមុនពេលរាយការណ៍ពីការអស់ពេល (timeout) ជាជាងព្យួរចោល។

"this project is not a git repository" នៅពេល push

ការដាក់ឱ្យដំណើរការ (Deploys) ត្រូវ​បានដំណើរការចេញពីឃ្លាំងផ្ទុកទិន្នន័យ (repository) ដូច្នេះ zinnector push ត្រូវការឃ្លាំងមួយដែលមាន remote ដែលផ្លែតហ្វមអាចចូលទៅដល់បាន។ git init && git add -A && git commit -m initial បន្ថែម GitHub ឬ GitLab remote របស់អ្នក បន្ទាប់មក zinnector link ដើម្បីភ្ជាប់វាទៅកាន់គេហទំព័រ។

គេហទំព័រចេញពណ៌សបន្ទាប់ពី deploy

សូមដំណើរការ zinnector check។ ប្រាំបួនដងក្នុងចំណោមដប់ដង វាគឺជាគម្លាតកំណែ PHP — អ្នកបានបង្កើតលើ PHP កំណែថ្មីជាង slot កំពុងដំណើរការ — ហើយរបាយការណ៍នឹងប្រាប់ថាកំណែណាដែលត្រូវផ្លាស់ប្តូរ slot ទៅដោយប្រើ zinnector php <version> ឬកំណែណាដែលត្រូវអភិវឌ្ឍប្រៀបធៀបជាមួយ zinnector dev --php <version>។ zinnector logs --error បង្ហាញកំហុស fatal នោះផ្ទាល់។

ដែលទាក់ទង

• ការចាប់ផ្តើម · ការអភិវឌ្ឍក្នុងស្រុក · ការដាក់ឱ្យដំណើរការ · ឯកសារយោងពាក្យបញ្ជា