ເລີ່ມຕົ້ນນຳໃຊ້ Zinnector®, CLI ສຳລັບນັກພັດທະນາ

Zinnector® ແມ່ນເຄື່ອງມື command-line ຟຣີ ທີ່ໃຊ້ໃບອະນຸຍາດ MIT ຂອງ Zinn Digital® ສຳລັບນັກພັດທະນາ WordPress. ມັນສ້າງໂຄງສ້າງເວັບໄຊ, ຣັນ WordPress ແທ້ໆ ໃນເຄື່ອງຂອງທ່ານໂດຍບໍ່ຕ້ອງຕິດຕັ້ງຫຍັງນອກຈາກ Node — ບໍ່ມີ Docker, ບໍ່ມີ MAMP, ບໍ່ມີ PHP ໃນ PATH ຂອງທ່ານ — ຈາກນັ້ນກວດສອບສິ່ງທີ່ທ່ານສ້າງກັບຊ່ອງໂຮດຕິ້ງທີ່ທ່ານກຳລັງຈະ deploy ແລະ ດຳເນີນການ push. ຄູ່ມືນີ້ຈະພາທ່ານຈາກຈຸດເລີ່ມຕົ້ນໄປສູ່ເວັບໄຊທີ່ ກຳລັງຣັນຢູ່ ພາຍໃນເວລາປະມານສອງນາທີ, ແລະ ບອກທ່ານວ່າຄວາມສຳເລັດເປັນແນວໃດໃນທຸກໆຂັ້ນຕອນ ເພື່ອໃຫ້ທ່ານຮູ້ເມື່ອມີບາງຢ່າງຜິດພາດ.

ສິ່ງທີ່ທ່ານຕ້ອງມີ

• Node 24 ຫຼື ໃໝ່ກວ່າ. ຣັນ node --version; ມັນຕ້ອງສະແດງ v24 ຫຼື ສູງກວ່າ. ຕິດຕັ້ງ LTS ປັດຈຸບັນຈາກ nodejs.org — ໃນ Windows ໃຊ້ winget install OpenJS.NodeJS.LTS, ໃນ macOS ໃຊ້ brew install node@24.
• npm, ຈະມາພ້ອມກັບ Node. Zinnector® ໃຊ້ ມັນຄັ້ງດຽວ, ເພື່ອດາວໂຫຼດ runtime ຂອງ WordPress ເຂົ້າໄປໃນ cache ຂອງມັນເອງ.
• git, ໃຊ້ສຳລັບ zinnector push ເທົ່ານັ້ນ — ການ deploy ແມ່ນຖືກຄວບຄຸມຈາກ repository ຂອງທ່ານ.
• Docker, ໃຊ້ພຽງແຕ່ຖ້າທ່ານຮ້ອງຂໍດ້ວຍ --runtime docker. Runtime ເລີ່ມຕົ້ນແມ່ນບໍ່ຈຳເປັນຕ້ອງໃຊ້.

ບໍ່ມີສິ່ງໃດລຸ່ມນີ້ທີ່ຕ້ອງໃຊ້ບັນຊີ. API key ແມ່ນຈຳເປັນພຽງແຕ່ເມື່ອທ່ານໄປເຖິງຊ່ອງໂຮດຕິ້ງ, ໃນ Deploying with Zinnector®.

ຂັ້ນຕອນທີ 1 — ຕິດຕັ້ງມັນ

npm install -g zinnector

ຖ້າ npm ສະແດງ npm WARN EBADENGINE, Node ຂອງທ່ານແມ່ນເກົ່າກວ່າ >=24.18.1 ທີ່ package ປະກາດໄວ້. ການຕິດຕັ້ງຈະເສັດສົມບູນຄືເກົ່າ, ແຕ່ 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 ແລະ port flags. ລາຍການທີ່ສົມບູນ, ພ້ອມຕົວຢ່າງ, ແມ່່ນຢູ່ໃນ command reference.

ຂັ້ນຕອນທີ 4 — ສ້າງໂຄງສ້າງເວັບໄຊ

zinnector new my-site

ຄວາມສຳເລັດ: ຫົວຂໍ້ Created my-site ແລະ ລາຍການໄຟລ໌ທີ່ມັນຂຽນ — zinnector.json, ໂຄງສ້າງ tree wp-content ທີ່ ມີ plugins/, themes/ ແລະ ຕົວຊ່ວຍ mu-plugins/, ໄຟລ໌ .gitignore ແລະ README — ຕາມດ້ວຍຄຳສັ່ງຕໍ່ໄປທີ່ຈະຣັນ. ບໍ່ມີສິ່ງໃດໃນນັ້ນທີ່ເປັນ placeholder; ໂຄງການຈະເລີ່ມເຮັດວຽກຕາມທີ່ມັນເປັນ. --template plugin ຫຼື --template theme ຈະສ້າງໂຄງສ້າງ plugin ຫຼື block theme ທີ່ ເຮັດວຽກທັນທີທີ່ມັນຖືກສ້າງ.

ຂັ້ນຕອນທີ 5 — ຣັນມັນ

cd my-site
zinnector dev

ໃນຄັ້ງທຳອິດ, Zinnector® ຈະຖາມຄັ້ງດຽວກ່ອນດາວໂຫຼດ runtime ຂອງ WordPress — ປະມານ 570 MB, ເພາະມັນຮວມເອົາທຸກໆ build ຂອງ PHP ຕັ້ງແຕ່ 5.2 ຫາ 8.5 — ເຂົ້າໄປໃນ directory cache ຂອງມັນເອງ, ໂດຍບໍ່ໃສ່ໃນໂຄງການຂອງທ່ານ. ຕອບ Y, ຫຼື ໃສ່ --yes ເພື່ອຂ້າມຄຳຖາມ. ໃນ Node 26 ຫຼື ໃໝ່ກວ່າ ມັນຍັງຈະດາວໂຫຼດ Node 24 ສຳລັບ runtime ໂດຍສະເພາະ (ປະມານ 30 MB, ຖືກກວດສອບກັບ checksums ຂອງ nodejs.org ເເລ້ວ), ເພາະ native module ຂອງ runtime ມີ binaries ທີ່ສ້າງໄວ້ລ່ວງໜ້າສຳລັບ 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 ຈະເປີດ dashboard ໂດຍເຂົ້າສູ່ລະບົບໄວ້ແລ້ວ. ວາງ plugin ໃສ່ wp-content/plugins/ ຫຼື theme ໃສ່ wp-content/themes/ ແລະ ມັນຈະປະກົດຂຶ້ນໃນການ reload ຄັ້ງຕໍ່ໄປ — runtime ຈະປະມວນຜົນ directory ເຫຼົ່ານັ້ນໂດຍຕົງຈາກໂຄງການຂອງທ່ານ.

ກົດ Ctrl-C ເພື່ອຢຸດ. zinnector dev --once ຈະເລີ່ມ runtime, ສະແດງສິ່ງທີ່ກຳລັງຣັນຢູ່ແທ້ໆ (ເວີຊັນ PHP, ເວີຊັນ WordPress, extensions ທີ່ໂຫຼດ) ແລະ ຢຸດ — ມີປະໂຫຍດເມື່ອທ່ານຕ້ອງການຫຼັກຖານຫຼາຍກວ່າຄຳສັນຍາ.

ຈຸດໝາຍຕໍ່ໄປ

• Local development with zinnector dev — ສອງ runtimes, ການເລືອກເວີຊັນ PHP ແລະ WordPress, ແລະ ສິ່ງທີ່ຖືກປະມວນຜົນຈາກໃສ.
• Deploying with Zinnector® — ເຂົ້າສູ່ລະບົບ, ເຊື່ອມໂຍງໂຄງການກັບຊ່ອງໂຮດຕິ້ງ, ກວດສອບກ່ອນດຳເນີນການ, push.
• The command reference — ທຸກໆຄຳສັ່ງ, flag ແລະ ຕົວຢ່າງ.
• Troubleshooting — ຂໍ້ຜິດພາດທີ່ຜູ້ຄົນມັກພົບພໍ້, ແລະ ວິທີແກ້ໄຂສຳລັບແຕ່ລະຢ່າງ.

ເອກະສານດຽວກັນນີ້ແມ່ນມີຢູ່ໃນ README ຂອງ package ໃນ npm ແລະ ໃນ GitHub, ບ່ອນທີ່ຍິນດີຕ້ອນຮັບ issues ແລະ pull requests.