ການແກ້ໄຂບັນຫາ 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 ທີ່ມີ binary ທີ່ສ້າງໄວ້ລ່ວງໜ້າສຳລັບ Node 24 ແລະ 25 ເທົ່ານັ້ນ. ໃນ Node ລຸ້ນໃໝ່ກວ່າ (26 ຂຶ້ນໄປ, ນັບຕັ້ງແຕ່ເດືອນກັນຍາ 2026) ຕົວຕິດຕັ້ງຂອງມັນຈະປ່ຽນໄປເປັນການ compile ຈາກ source code, ເຊິ່ງໃນເຄື່ອງ Windows ທຳມະດາຈະສິ້ນສຸດລົງດ້ວຍການຮ້ອງຂໍ Visual Studio. ແກ້ໄຂແລ້ວໃນ 0.1.2: Zinnector® ຈະກວດພົບສິ່ງນີ້ກ່ອນທີ່ຈະດາວໂຫຼດຫຍັງກໍຕາມ ແລະ ດຶງເອົາ Node 24 ສຳລັບ runtime ໂດຍສະເພາະ — ປະມານ 30 MB, ຢັ້ງຢືນກັບ checksum ຂອງ nodejs.org — ດັ່ງນັ້ນຈຶ່ງບໍ່ມີສິ່ງໃດຖືກ compile ເລີຍ. ຖ້າທ່ານຍັງເຫັນມັນຢູ່ຫຼັງຈາກອັບເກຣດແລ້ວ, ໃຫ້ເປີດໃຊ້ zinnector dev --reset-runtime ເພື່ອໃຫ້ການຕິດຕັ້ງທີ່ຍັງບໍ່ແລ້ວເຄິ່ງໆກາງໆກ່ອນໜ້ານັ້ນຖືກຖິ້ມໄປກ່ອນ.

ຄຳເຕືອນ "EPERM" ຈາກ npm ໃນຂະນະທີ່ມັນກຳລັງອະນາໄມ (Windows)

ເກືອບທຸກຄັ້ງແມ່ນເກີດຈາກໂປຣແກຣມສະແກນໄວຣັສ ຫຼື ຕົວສ້າງດັດຊະນີການຄົ້ນຫາທີ່ກຳລັງເປີດໄຟລ໌ຄ້າງໄວ້ພາຍໃຕ້ 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 ເອງ. ພອດທີ່ຖືກໃຊ້ງານຢູ່ແລ້ວແມ່ນສາເຫດທົ່ວໄປ: 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 ນັ້ນເອງ.

ທີ່ກ່ຽວຂ້ອງ

• Getting started · Local development · Deploying · Command reference