ການແກ້ໄຂບັນຫາ Zinnector®

ຂໍ້ຜິດພາດທີ່ຜູ້ຄົນມັກພົບເຫັນແທ້ໆກັບ Zinnector® CLI, ຄວາມໝາຍຂອງແຕ່ລະຂໍ້, ແລະ ວິທີແກ້ໄຂ. ທຸກໆລາຍການຈະລະບົບ້ຄວາມທີ່ແນ່ນອນທີ່ທ່ານຈະເຫັນ, ເພື່ອໃຫ້ທ່ານສາມາດຄົ້ນຫາໃນໜ້ານີ້ໄດ້. ຖ້າຂໍ້ຜິດພາດຂອງທ່ານບໍ່ມີຢູ່ທີ່ນີ້, ກະລຸນາຣັນຄຳສັ່ງທີ່ມີບັນຫານັ້ນດ້ວຍ ZINNECTOR_DEBUG=1 ແລະ ເປີດ issue ຢູ່ທີ່ github.com/Zinn-Digital/zinnector/issues ພ້ອມກັບຜົນການຣັນ, ລະບົບປະຕິບັດການຂອງທ່ານ ແລະ ຂໍ້ມູນ node --version ຂອງທ່ານ.

"spawn EINVAL" ທັນທີຫຼັງຈາກຍອມຮັບການຕິດຕັ້ງ runtime (Windows)

ບັກໃນ Zinnector® 0.1.0 ແລະ 0.1.1. ໃນ Windows, ຕົວຕິດຕັ້ງ runtime ໄດ້ຣັນ npm.cmd ໂດຍກົງຕາມຊື່, ແລະ Node ໄດ້ປະຕິເສດທີ່ຈະ spawn ໄຟລ໌ .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 ຈະປະຕິເສດທີ່ຈະເລີ່ມຕົ້ນ (exit code 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) ຕົວຕິດຕັ້ງຂອງມັນຈະປ່ຽນໄປໃຊ້ການ compile ຈາກ 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® ໄດ້ຣັນ, ສະນັ້ນທ່ານສາມາດຣັນມັນດ້ວຍຕົນເອງເພື່ອເບິ່ງຜົນການຣັນທັງໝົດໄດ້. ສາເຫດທົ່ວໄປແມ່ນບັນຫາເຄືອຂ່າຍ ຫຼື ພຣັອກຊີ — runtime ຖືກດຶງມາດ້ວຍ npm ຂອງທ່ານເອງ, ສະນັ້ນ npm config set proxy … ແລະ registry mirror ຈະມີຜົນນຳ — ຫຼື ການຕິດຕັ້ງກ່ອນໜ້ານີ້ທີ່ຍັງບໍ່ຮຽບຮ້ອຍ, ຢ່າງໃດກໍຕາມ --reset-runtime ຈະຊ່ວຍລ້າງຂໍ້ມູນເຫຼົ່ານີ້ໄດ້.

"the local playground exited before it was ready", ຫຼື ມັນບໍ່ພ້ອມໃຊ້ງານຈັກເທື່ອ

ກະລຸນາຣັນ zinnector dev --verbose ເພື່ອເບິ່ງ output ຂອງ runtime ເອງ. ພອດທີ່ຖືກໃຊ້ງານຢູ່ແລ້ວແມ່ນສາເຫດທີ່ພົບໄດ້ເລື້ອຍໆ: zinnector dev --port 9401, ຫຼື ຕັ້ງຄ່າ port ໃນ zinnector.json. ສຳລັບ runtime ທີ່ຕິດຕັ້ງແລ້ວແຕ່ບໍ່ຍອມ boot: zinnector dev --reset-runtime. ການ boot ຄັ້ງທຳອິດຈະດາວໂຫຼດ WordPress ເອງນຳ, ສະນັ້ນໃນການເຊື່ອມຕໍ່ທີ່ຊ້າ ກະລຸນາລໍຖ້າຈັກໜ້ອຍ; CLI ຈະລໍຖ້າດົນເຖິງຫ້ານາທີກ່ອນທີ່ຈະແຈ້ງວ່າໝົດເວລາ ແທນທີ່ຈະຄ້າງຢູ່ແບບນັ້ນ.

"this project is not a git repository" ເມື່ອ push

ການ Deploy ຖືກຂັບເຄື່ອນຈາກ repository, ສະນັ້ນ zinnector push ຈຶ່ງຕ້ອງການ repository ທີ່ມີ 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 ໂດຍກົງ.

ເນື້ອຫາທີ່ກ່ຽວຂ້ອງ

• ການເລີ່ມຕົ້ນໃຊ້ງານ · ການພັດທະນາໃນເຄື່ອງ · ການ Deploy · ບ່ອນອ້າງອີງຄຳສັ່ງ