เอกสาร ServBay: การกำหนดเวอร์ชัน Node.js ในโปรเจกต์ สคริปต์ และเว็บไซต์ของคุณ

ServBay เป็นสภาพแวดล้อมการพัฒนาเว็บบนเครื่องที่ทรงพลัง รองรับภาษาการเขียนโปรแกรมหลากหลายและเทคโนโลยีต่าง ๆ รวมถึง Node.js ในการพัฒนาจริง คุณอาจต้องใช้ Node.js เวอร์ชันเฉพาะกับแต่ละโปรเจกต์ สคริปต์เดียว หรือแม้แต่เว็บไซต์ทั้งเว็บ ตัวอย่างเช่น โปรเจกต์เก่าอาจต้องพึ่งพา Node.js 14 ในขณะที่โปรเจกต์ใหม่อาจต้องใช้ฟีเจอร์ล่าสุดของ Node.js 20 ServBay ได้เตรียมวิธีที่ยืดหยุ่นเพื่อรองรับความต้องการเหล่านี้

บทความนี้จะอธิบายโดยละเอียดถึงวิธีการกำหนดเวอร์ชัน Node.js สำหรับสคริปต์และเว็บไซต์ พร้อมทั้งการใช้ไฟล์คอนฟิกของแต่ละโปรเจกต์ใน ServBay ได้อย่างง่ายดาย

ใช้ไฟล์ .servbay.config เพื่อกำหนดเวอร์ชัน Node.js และตั้งค่าระดับโปรเจกต์

สำหรับโปรเจกต์ที่ต้องการกำหนดเวอร์ชัน Node.js และตัวแปรสภาพแวดล้อมอย่างเข้มงวด ServBay ให้คุณสร้างไฟล์ .servbay.config ที่ไดเรกทอรีรูทของโปรเจกต์ ในไฟล์นี้คุณสามารถระบุเวอร์ชัน Node.js ที่ใช้ แหล่งที่เก็บแพ็กเกจของ npm/yarn และไดเรกทอรีแคช ได้อย่างชัดเจน เพื่อแยกและรักษาความสอดคล้องของสภาพแวดล้อมแต่ละโปรเจกต์

ตัวอย่างไฟล์ .servbay.config สำหรับกำหนดเวอร์ชัน Node.js เฉพาะและตั้งค่ารีจิสทรี npm/yarn รวมถึงไดเรกทอรีแคช มีรูปแบบดังนี้:

NODE_VERSION=20
YARN_CONFIG_REGISTRY=https://registry.npmmirror.com/ # ตัวอย่าง: ใช้ mirror เฉพาะ
NPM_CONFIG_REGISTRY=https://registry.npmmirror.com/ # ตัวอย่าง: ใช้ mirror เฉพาะ
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache # ตัวอย่าง: ระบุแคชไดเรกทอรี
YARN_CONFIG_CACHE=/Applications/ServBay/tmp/yarn/cache # ตัวอย่าง: ระบุแคชไดเรกทอรี

คำอธิบาย:

• NODE_VERSION: ระบุหมายเลขเวอร์ชันหลักของ Node.js ที่โปรเจกต์นี้ใช้งาน ServBay จะค้นหาและใช้งาน Node.js ที่ติดตั้งไว้ซึ่งตรงกับเวอร์ชันนั้น
• YARN_CONFIG_REGISTRY, NPM_CONFIG_REGISTRY: กำหนดแหล่งที่เก็บแพ็กเกจที่ npm หรือ yarn ใช้งานในโปรเจกต์นี้
• NPM_CONFIG_CACHE, YARN_CONFIG_CACHE: กำหนดไดเรกทอรีแคชสำหรับ npm หรือ yarn โดยตัวอย่างนี้ชี้ไปยังไดเรกทอรี /Applications/ServBay/tmp/ ซึ่งเป็นค่าเริ่มต้นของ ServBay

โดยทั่วไปไฟล์ .servbay.config ควรวางไว้ที่รูทของโปรเจกต์คุณ สำหรับรายละเอียดเพิ่มเติม กรุณาอ่าน เอกสารทางการเกี่ยวกับไฟล์ .servbay.config

การรันสคริปต์ Node.js เวอร์ชันเฉพาะผ่าน CLI

ถ้าคุณไม่ต้องการกำหนดเวอร์ชัน Node.js แบบถาวรไว้ที่โปรเจกต์ แต่ต้องการรันสคริปต์หรือคำสั่งด้วยเวอร์ชัน Node.js เฉพาะชั่วคราว สามารถใช้ alias ที่ ServBay มีให้ได้

ในเทอร์มินัลของ ServBay (สามารถเปิดได้จากหน้าหลักของแอปพลิเคชัน) คุณสามารถเรียกใช้คำสั่ง node-<เวอร์ชัน> เพื่อรันสคริปต์ด้วย Node.js เวอร์ชันที่ต้องการ ServBay จะสร้าง alias สำหรับแต่ละเวอร์ชันของ Node.js ที่ติดตั้งไว้โดยอัตโนมัติ

ตัวอย่างเช่น การรันสคริปต์ script.js ด้วย Node.js 14 สามารถพิมพ์คำสั่งต่อไปนี้:

$ node-14 script.js
Hello World
Node.js Version: 14.17.0 # ตัวอย่างผลลัพธ์ หมายเลขเวอร์ชันอาจต่างกัน

$ node-16 script.js
Hello World
Node.js Version: 16.3.0 # ตัวอย่างผลลัพธ์ หมายเลขเวอร์ชันอาจต่างกัน

$ node-20 script.js
Hello World
Node.js Version: 20.10.0 # ตัวอย่างผลลัพธ์ หมายเลขเวอร์ชันอาจต่างกัน

อธิบายตัวอย่าง

• $ node-14 script.js — ใช้ Node.js 14 (14.x.x ที่ติดตั้งใน ServBay) เพื่อรัน script.js
• $ node-16 script.js — ใช้ Node.js 16 ที่ติดตั้งใน ServBay เพื่อรันสคริปต์เดียวกัน
• $ node-20 script.js — ใช้ Node.js 20 ที่ติดตั้งใน ServBay เพื่อรันสคริปต์

ด้วยวิธีนี้ คุณสามารถทดสอบความเข้ากันได้หรือรันงานเฉพาะด้วยเวอร์ชันต่าง ๆ ได้อย่างยืดหยุ่นโดยไม่ต้องเปลี่ยน Node.js เวอร์ชันหลักสำหรับทั้งระบบ

การกำหนด Node.js เวอร์ชันให้เว็บไซต์ผ่านแผงควบคุมของ ServBay

ServBay อนุญาตให้คุณกำหนดเวอร์ชัน Node.js ที่ต้องการให้แต่ละเว็บไซต์ได้โดยตรงผ่านแผงควบคุม ซึ่งเหมาะกับเว็บไซต์ที่ต้องพึ่งพา Node.js เป็น backend (เช่น เว็บแอปที่ใช้เฟรมเวิร์ก Node.js และถูก reverse proxy ด้วย Caddy หรือ Nginx) หรือกรณีที่ต้องการสภาพแวดล้อม Node.js เฉพาะกับแต่ละเว็บไซต์

ขั้นตอน

1. เปิดแผงควบคุม ServBay
   เริ่มแอปพลิเคชัน ServBay และเข้าสู่หน้าแผงควบคุมผ่านเบราว์เซอร์ (ปกติคือ http://localhost:5200 หรือคลิกลิงก์จากหน้าต่างหลักของโปรแกรม)

2. ไปยังการจัดการเว็บไซต์
   ที่เมนูด้านซ้ายมือ ให้เลือก เว็บไซต์ (Website)

3. เลือกและแก้ไขเว็บไซต์เป้าหมาย
   ในรายการเว็บไซต์ ค้นหาเว็บไซต์ที่คุณต้องการปรับแต่ง (เช่น เว็บไซต์ใน /Applications/ServBay/www/servbay.demo) แล้วคลิกปุ่มแก้ไข (รูปเฟืองหรือดินสอ) หรือคลิกชื่อเว็บไซต์เข้าสู่รายละเอียด

4. ตั้งค่า Node.js เวอร์ชัน
   ในหน้าการตั้งค่าเว็บไซต์ มองหาตัวเลือกที่เกี่ยวกับ Node.js เวอร์ชัน (มักจะเป็นเมนูแบบดรอปดาวน์) เลือกเวอร์ชัน Node.js ที่ต้องการให้เว็บไซต์นี้ใช้งาน

5. บันทึกการเปลี่ยนแปลง
   หลังเลือกรายการเวอร์ชันแล้ว อย่าลืมกดปุ่ม บันทึก หรือ ใช้งาน ที่ส่วนล่างของหน้า

6. รีสตาร์ทเว็บไซต์หรือ ServBay (หากจำเป็น)
   การเปลี่ยนแปลงการตั้งค่าบางอย่าง อาจต้องรีสตาร์ทเว็บเซิร์ฟเวอร์ (เช่น Caddy หรือ Nginx) หรือรีสตาร์ท ServBay ทั้งหมด ServBay จะขึ้นข้อความแจ้งเตือนหากจำเป็นต้องรีสตาร์ทเพื่อให้การเปลี่ยนแปลงมีผล

หมายเหตุ

• ตรวจสอบ Node.js เวอร์ชันที่ติดตั้งและกำลังทำงานอยู่: เวอร์ชัน Node.js ที่ตั้งค่าให้เว็บไซต์ต้องมีติดตั้งและเปิดใช้งานแล้วในหน้า ซอฟต์แวร์แพ็กเกจ (Packages) ของ ServBay หากยังไม่ได้ติดตั้งหรือไม่ได้เปิดใช้งาน ให้ดำเนินการในหน้าดังกล่าวก่อน
• ประเภทเว็บไซต์: ตัวเลือกนี้มีผลกับเว็บไซต์ที่ต้องใช้ Node.js ในการรัน (เช่น เว็บไซต์ที่สร้างด้วย Express.js, Next.js, NestJS ฯลฯ) ถ้าเป็นเว็บไซต์ static หรือ backend รันด้วย PHP/Python/Go อื่น ๆ ตัวเลือกนี้จะไม่มีผลนัก
• ทดสอบความเข้ากันได้: หลังเปลี่ยน Node.js เวอร์ชัน อย่าลืมทดสอบเว็บไซต์ให้ครบถ้วน เพื่อให้แน่ใจว่าทุก dependency และบริการยังคงทำงานปกติบนเวอร์ชันใหม่
• ความสัมพันธ์กับ .servbay.config: การตั้งค่าบนแผงควบคุมนี้ถือเป็นค่าเริ่มต้น หากไดเรกทอรีเว็บไซต์มีไฟล์ .servbay.config และกำหนด NODE_VERSION ไว้ การตั้งค่าในไฟล์จะมีลำดับความสำคัญสูงกว่าเว็บไซต์ (ใช้บังคับแทน)

สรุป

ServBay ในฐานะสภาพแวดล้อมพัฒนาเว็บครบวงจร ให้คุณบริหารจัดการและกำหนดเวอร์ชันรันไทม์ Node.js ได้หลายรูปแบบอย่างยืดหยุ่น ไม่ว่าโดยการใช้ไฟล์ .servbay.config ที่รูทโปรเจกต์สำหรับควบคุมได้ละเอียด หรือรันสคริปต์ด้วย node-<เวอร์ชัน> ที่รวดเร็วผ่าน CLI หรือจะตั้งค่าบนแผงควบคุมเว็บไซต์โดยตรง ฟีเจอร์เหล่านี้ช่วยให้คุณรับมือกับความต้องการเวอร์ชัน Node.js ที่หลากหลายในการพัฒนาทุกโปรเจกต์ — ไม่ว่าจะเพื่อรองรับโปรเจกต์เก่า ทดสอบฟีเจอร์ใหม่ หรือรักษาความสอดคล้องกับสภาพแวดล้อม production ServBay ก็รองรับได้อย่างมืออาชีพ เพิ่มประสิทธิภาพการทำงานและการจัดการสภาพแวดล้อมของคุณได้อย่างแท้จริง