เริ่มต้นใช้งาน 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® จะใช้งานเพียงครั้งเดียว เพื่อดาวน์โหลดรันไทม์ของ WordPress เข้าสู่แคชของตัวเอง
• git สำหรับคำสั่ง zinnector push เท่านั้น — การปรับใช้จะดำเนินการจากที่เก็บข้อมูลของคุณ
• Docker เฉพาะในกรณีที่คุณเรียกใช้ด้วย --runtime docker เท่านั้น โดยรันไทม์เริ่มต้นไม่จำเป็นต้องใช้เลย

ไม่มีขั้นตอนใดด้านล่างที่จำเป็นต้องมีบัญชี คีย์ 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" แสดงว่าไบนารีได้รับการติดตั้งแล้วแต่ Node ของคุณเก่าเกินไป คำสั่งจะหยุดการทำงานด้วยรหัส 78 แทนที่จะดำเนินการใดๆ

ขั้นตอนที่ 3 — อ่านวิธีใช้

zinnector --help

สำเร็จ: แบนเนอร์ที่ระบุชื่อคำสั่งทั้งห้าคำสั่งของเวิร์กโฟลว์ (new, dev, link, check, push) และตามด้วยแต่ละคำสั่งพร้อมคำอธิบายวัตถุประสงค์หนึ่งบรรทัด แต่ละคำสั่งยังรองรับ --help ในตัวของมันเองด้วย — zinnector dev --help จะแสดงรายการแฟล็กของรันไทม์, 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 — ประมาณ 570 MB เนื่องจากมีบิลด์ PHP ทุกเวอร์ชันตั้งแต่ 5.2 ถึง 8.5 — เข้าสู่ไดเรกทอรีแคชของตัวเอง และจะไม่ดาวน์โหลดลงในโปรเจกต์ของคุณ ให้ตอบ Y หรือส่งแฟล็ก --yes เพื่อข้ามคำถาม บน Node 26 หรือใหม่กว่า ระบบจะดึง Node 24 สำหรับรันไทม์โดยเฉพาะด้วย (ประมาณ 30 MB ได้รับการตรวจสอบเทียบกับผลรวมตรวจสอบของ nodejs.org แล้ว) เนื่องจากโมดูลเนทีฟของรันไทม์มีไบนารีที่คอมไพล์ไว้ล่วงหน้าสำหรับ 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/ และปลั๊กอินหรือธีมนั้นจะปรากฏขึ้นในการโหลดซ้ำครั้งถัดไป — รันไทม์จะให้บริการไดเรกทอรีเหล่านั้นโดยตรงจากโปรเจกต์ของคุณ

กด Ctrl-C เพื่อหยุดการทำงาน zinnector dev --once จะเริ่มต้นรันไทม์ แสดงสิ่งที่กำลังทำงานอยู่จริง (เวอร์ชัน PHP, เวอร์ชัน WordPress, ส่วนขยายที่โหลด) และหยุดการทำงาน — มีประโยชน์เมื่อคุณต้องการหลักฐานที่ชัดเจนมากกว่าคำรับรอง

ขั้นตอนต่อไป

• การพัฒนาในเครื่องด้วย zinnector dev — รันไทม์ทั้งสอง การเลือกเวอร์ชัน PHP และ WordPress รวมถึงสิ่งใดที่ให้บริการจากที่ไหน
• การปรับใช้ด้วย Zinnector® — ลงชื่อเข้าใช้ เชื่อมโยงโปรเจกต์กับสล็อต ตรวจสอบความพร้อมก่อนบิน พุช
• เอกสารอ้างอิงคำสั่ง — ทุกคำสั่ง แฟล็ก และตัวอย่าง
• การแก้ไขปัญหา — ข้อผิดพลาดที่ผู้ใช้พบเจอจริง และวิธีแก้ไขสำหรับแต่ละข้อผิดพลาด

เอกสารเดียวกันนี้มีอยู่ใน README ของแพ็กเกจบน npm และบน GitHub ซึ่งยินดีต้อนรับการแจ้งปัญหาและพูลรีเควสต์เสมอ