ติดตั้งและตั้งค่า OctoberCMS ในสภาพแวดล้อม ServBay

ภาพรวม

OctoberCMS คือระบบจัดการเนื้อหา (CMS) แบบโอเพนซอร์สที่สร้างขึ้นบนเฟรมเวิร์ก Laravel อันทรงพลัง มีจุดเด่นด้านความเรียบง่าย ความยืดหยุ่น และความเป็นมิตรต่อผู้พัฒนา เอกสารนี้จะชี้แนะคุณในการติดตั้งและตั้งค่า OctoberCMS บน ServBay — สภาพแวดล้อมการพัฒนาเว็บแบบครบวงจรสำหรับ macOS — เพื่อให้คุณเริ่มต้นโครงการบน OctoberCMS ได้อย่างรวดเร็ว

OctoberCMS คืออะไร?

OctoberCMS มอบอินเทอร์เฟซหลังบ้านที่ใช้งานง่าย พร้อมขีดความสามารถด้านการพัฒนาเว็บไซต์ขั้นสูง นักพัฒนาสามารถใช้แนวคิดที่คุ้นเคยของ Laravel (เช่น Eloquent ORM, Blade Template Engine ฯลฯ) สร้างเว็บไซต์หลากหลายตั้งแต่บล็อกเรียบง่ายไปจนถึงแอปพลิเคชันสำหรับองค์กรที่ซับซ้อน

ข้อกำหนดเบื้องต้น

ก่อนเริ่มติดตั้ง OctoberCMS กรุณาตรวจสอบให้แน่ใจว่าคุณมีสิ่งต่อไปนี้:

1. ติดตั้งและใช้งาน ServBay บน macOS แล้ว
2. เปิดใช้งานและรัน PHP (แนะนำเวอร์ชัน 7.4 ขึ้นไป) และ MySQL/MariaDB ใน ServBay
3. เปิดใช้งาน Composer ใน ServBay แล้ว
4. มีความรู้พื้นฐานเกี่ยวกับการใช้คำสั่งในเทอร์มินัล

ขั้นตอนการติดตั้ง OctoberCMS

รายละเอียดขั้นตอนการติดตั้งและตั้งค่า OctoberCMS ในสภาพแวดล้อม ServBay มีดังนี้:

ขั้นตอนที่ 1: สร้างโฟลเดอร์โปรเจกต์

ก่อนอื่น ให้ไปที่ไดเรกทอรีรากเว็บที่ ServBay แนะนำ /Applications/ServBay/www แล้วสร้างโฟลเดอร์ใหม่สำหรับโปรเจกต์ OctoberCMS ของคุณ

cd /Applications/ServBay/www
mkdir servbay-octobercms-app
cd servbay-octobercms-app

ขั้นตอนที่ 2: ติดตั้ง OctoberCMS ด้วย Composer

ServBay มาพร้อมกับ Composer ที่ตั้งค่าให้ใช้งานได้เรียบร้อยแล้ว ให้แน่ใจว่าคุณเปิดใช้ Composer ผ่านแผงควบคุม ServBay จากนั้นให้รันคำสั่ง Composer ในโฟลเดอร์โปรเจกต์ที่สร้างขึ้น เพื่อดาวน์โหลดและติดตั้งไฟล์หลักของ OctoberCMS

composer create-project october/october .

คำสั่งนี้จะดาวน์โหลด OctoberCMS เวอร์ชันล่าสุดจากคลังกลางมายังไดเรกทอรีปัจจุบัน (.)

ขั้นตอนที่ 3: สร้างฐานข้อมูลและผู้ใช้

OctoberCMS ต้องใช้ฐานข้อมูลเพื่อจัดเก็บเนื้อหา ผู้ใช้ และการตั้งค่าต่าง ๆ เราจะใช้ phpMyAdmin ที่มาพร้อม ServBay เพื่อสร้างฐานข้อมูลและผู้ใช้

1. เข้าใช้งาน phpMyAdmin ที่มาพร้อมกับ ServBay

   เปิดเว็บเบราเซอร์ของคุณ ไปที่แผงควบคุม Local Development ของ ServBay ที่ https://servbay.host/ จากนั้นคลิกหรือไปที่ลิงก์ phpMyAdmin ที่ ServBay ให้ไว้ มักอยู่ที่ https://servbay.host/phpmyadmin/ เพื่อเข้าสู่ระบบจัดการฐานข้อมูล

2. สร้างผู้ใช้ฐานข้อมูล

   เพื่อความปลอดภัยและการแยกส่วน แนะนำให้สร้างฐานข้อมูลและผู้ใช้ใหม่สำหรับแต่ละโปรเจกต์

   1. ไปที่หน้าจัดการบัญชีผู้ใช้

      ในหน้าแรกของ phpMyAdmin คลิกที่เมนูบนสุด "บัญชีผู้ใช้"

   2. เพิ่มผู้ใช้ใหม่

      คลิก "เพิ่มบัญชีผู้ใช้" แล้วกรอกข้อมูลดังนี้:

      • ชื่อผู้ใช้: ระบุชื่อผู้ใช้สำหรับเชื่อมต่อฐานข้อมูล เช่น october_user
      • โฮสต์: เลือก localhost หรือ 127.0.0.1 เพื่อจำกัดการเข้าถึงเฉพาะจากเครื่อง Local เสริมความปลอดภัย
      • รหัสผ่าน: ตั้งรหัสผ่านที่ ปลอดภัยและไม่ซ้ำกับที่อื่น อย่าใช้รหัสผ่านตัวอย่าง password123 ในระบบ Production
      • ยืนยันรหัสผ่าน: ป้อนรหัสผ่านเหมือนเดิมอีกครั้ง
      • ส่วน "สร้างฐานข้อมูลสำหรับผู้ใช้" เลือก "สร้างฐานข้อมูลที่มีชื่อเดียวกับชื่อผู้ใช้ และให้สิทธิ์ทั้งหมด"
      • ตรวจสอบให้แน่ใจว่ามีการติ๊กถูกใน "ให้สิทธิ์ทั้งหมด" ใต้สิทธิ์ระดับโลก (หากเลือกสร้างฐานข้อมูลพร้อมกับการสร้างผู้ใช้ ขั้นตอนนี้จะถูกกำหนดให้อัตโนมัติหรือไม่ต้องทำเพิ่ม)
      • คลิก "ดำเนินการ" ที่ด้านล่างเพื่อสร้างผู้ใช้และฐานข้อมูล

ขั้นตอนที่ 4: ตั้งค่าเว็บเซิร์ฟเวอร์ (เพิ่มเว็บไซต์ใน ServBay)

เพื่อเข้าถึงแอป OctoberCMS ผ่านเว็บเบราเซอร์ ต้องตั้งค่าเว็บไซต์ Local ใน ServBay

1. เพิ่มเว็บไซต์ใหม่

   เปิดแผงควบคุม ServBay คลิกที่เมนูด้านซ้าย "เว็บไซต์" (หมายเหตุ: บางเวอร์ชันอาจใช้ชื่อ "โฮสต์") จากนั้นคลิกปุ่ม "เพิ่มเว็บไซต์"

   กรอกข้อมูลดังนี้:

   • ชื่อ: กำหนดชื่อที่อ่านเข้าใจง่าย เช่น My OctoberCMS Site
   • โดเมน: ระบุชื่อโดเมนที่ต้องการใช้บนเครื่อง Local เช่น servbay-octobercms.local (แนะนำให้ใช้ .local เพื่อป้องกันชนกับโดเมนจริง)
   • ประเภทเว็บไซต์: เลือก PHP
   • เวอร์ชัน PHP: เลือกเวอร์ชันที่ต้องการให้ OctoberCMS ใช้ โดยให้ตรงกับเวอร์ชันที่เปิดใช้งานบน ServBay และเป็นไปตามข้อกำหนดของ OctoberCMS
   • รากเว็บไซต์: คลิกเลือกไดเรกทอรีโปรเจกต์ที่สร้างไว้ในขั้นตอนที่ 1 /Applications/ServBay/www/servbay-octobercms-app

2. บันทึกและรีสตาร์ท ServBay

   หลังกรอกข้อมูล คลิกบันทึก ระบบจะขอให้คุณยืนยันเพื่อใช้การเปลี่ยนแปลง โดยมักต้องรีสตาร์ทซอฟต์แวร์ที่เกี่ยวข้อง (เช่น Caddy หรือ Nginx) และ ServBay เอง ดำเนินการตามที่ระบบแนะนำเพื่อให้เปลี่ยนแปลงมีผล ServBay จะตั้งค่าการชี้โดเมน servbay-octobercms.local มายังเครื่อง Local (127.0.0.1) โดยอัตโนมัติ

ขั้นตอนที่ 5: ตั้งค่าตัวแปรสภาพแวดล้อมของ OctoberCMS

OctoberCMS (สร้างโดยใช้ Laravel) ใช้ไฟล์ .env สำหรับจัดการตัวแปรสภาพแวดล้อมของแอปพลิเคชัน เช่น การเชื่อมต่อฐานข้อมูล คีย์ลับ ฯลฯ

1. คัดลอกไฟล์ตัวอย่างสำหรับตั้งค่าตัวแปรสภาพแวดล้อม

   ที่โฟลเดอร์รากโปรเจกต์ (/Applications/ServBay/www/servbay-octobercms-app) คัดลอกไฟล์ .env.example แล้วเปลี่ยนชื่อเป็น .env:

   cd /Applications/ServBay/www/servbay-octobercms-app
   cp .env.example .env

2. แก้ไขไฟล์ .env

   ด้วยโปรแกรมแก้ไขข้อความที่คุณถนัด เปิดไฟล์ .env แล้วเลื่อนไปที่ส่วนการตั้งค่าฐานข้อมูล จากนั้นใส่ข้อมูลตามฐานข้อมูลที่คุณสร้างไว้ในขั้นตอน 3:

   # ... การตั้งค่าอื่นๆ ...
   
   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=october_user  # แทนที่ชื่อฐานข้อมูล
   DB_USERNAME=october_user  # แทนที่ชื่อผู้ใช้ฐานข้อมูล
   DB_PASSWORD=password123   # แทนที่รหัสผ่านฐานข้อมูล
   
   # ... การตั้งค่าอื่นๆ ...

   สำคัญ: อย่าลืมแทนที่ DB_DATABASE, DB_USERNAME และ DB_PASSWORD ด้วยค่าจริงที่คุณใช้

ขั้นตอนที่ 6: เรียกใช้งานตัวติดตั้ง OctoberCMS

OctoberCMS มีตัวช่วยติดตั้งบนเว็บเพื่อดำเนินการขั้นสุดท้าย เช่น migration ฐานข้อมูล และการสร้างบัญชีแอดมิน

1. เข้าไปที่หน้าติดตั้ง

   เปิดเบราเซอร์ แล้วเข้าโดเมน Local ที่ตั้งไว้ในขั้นตอน 4 เติม /install.php ต่อท้าย เช่น

   https://servbay-octobercms.local/install.php

   คุณจะเห็นหน้าติดตั้งของ OctoberCMS

2. กรอกข้อมูลฐานข้อมูล

   ตัวติดตั้งจะขอให้คุณใส่รายละเอียดการเชื่อมต่อฐานข้อมูล กรอกข้อมูลเดียวกับที่ตั้งค่าในไฟล์ .env:

   • ประเภทฐานข้อมูล: MySQL
   • โฮสต์ฐานข้อมูล: localhost หรือ 127.0.0.1
   • ชื่อฐานข้อมูล: october_user
   • ชื่อผู้ใช้ฐานข้อมูล: october_user
   • รหัสผ่านฐานข้อมูล: password123

   (ย้ำอีกครั้ง โปรดใช้รหัสผ่านที่คุณตั้งเองจริง ๆ)

3. กรอกข้อมูลผู้ดูแลระบบ

   ทำตามขั้นตอนบนหน้าจอ ใส่รายละเอียดบัญชีผู้ดูแลระบบที่จะใช้เข้าสู่หลังบ้าน OctoberCMS เช่น ชื่อผู้ใช้ รหัสผ่าน อีเมล

4. เสร็จสิ้นการติดตั้ง

   คลิก "ติดตั้ง" หรือปุ่มที่เกี่ยวข้องบนหน้าติดตั้ง โปรแกรมจะทำ migration ฐานข้อมูล สร้างคีย์ ฯลฯ รอจนเสร็จสิ้น

ขั้นตอนที่ 7: ติดตั้งปลั๊กอินและธีม (ไม่บังคับ)

หลังติดตั้ง คุณสามารถเข้าสู่หลังบ้าน OctoberCMS ได้ที่ https://servbay-octobercms.local/backend

1. ติดตั้งปลั๊กอิน

   ในหลังบ้าน ไปที่ "ระบบ" -> "การอัปเดต" -> "ปลั๊กอิน" ค้นหาและติดตั้งปลั๊กอินจาก OctoberCMS Marketplace เพื่อขยายความสามารถของเว็บไซต์

2. ติดตั้งธีม

   ไปที่ "ระบบ" -> "การอัปเดต" -> "ธีม" สำรวจและติดตั้งธีมที่ตอบโจทย์โปรเจกต์ของคุณ

การตั้งค่าและการใช้งานเบื้องต้นหลังติดตั้ง

เมื่อคุณติดตั้ง OctoberCMS สำเร็จแล้วสามารถเริ่มสร้างเว็บไซต์ได้ทันที โดยมีแนวทางเบื้องต้นดังนี้:

• เข้าใช้งานหน้าบ้าน: ไปที่โดเมน Local https://servbay-octobercms.local/ จะเห็นหน้าหลักของเว็บไซต์ (อาจเป็นธีมเริ่มต้น)
• เข้าใช้งานหลังบ้าน: ไปที่ https://servbay-octobercms.local/backend แล้วล็อกอินด้วยบัญชีผู้ดูแลระบบที่สร้างไว้
• สร้างหน้าเว็บไซต์: ในหลังบ้านไปที่ "CMS" -> "หน้า" เพื่อสร้าง/แก้ไขหน้าเว็บ
• สร้างบล็อกเนื้อหา: ในหลังบ้านไปที่ "CMS" -> "เนื้อหา" เพื่อสร้างเนื้อหาซ้ำใช้ได้
• ตั้งค่าธีม: ไปที่ "CMS" -> "ธีม" ตั้งค่าธีม เลย์เอาต์ หรือส่วนประกอบต่าง ๆ
• จัดการผู้ใช้และสิทธิ์: ใน "ระบบ" -> "การจัดการ" สำหรับจัดการผู้ใช้หลังบ้านและสิทธิ์เข้าถึง

คำถามที่พบบ่อย (FAQ)

• ถาม: เปิด servbay-octobercms.local แล้วเจอหน้าเริ่มต้นของ ServBay หรือเกิดข้อผิดพลาด?
  • ตอบ: ตรวจสอบว่าได้เพิ่มเว็บไซต์ servbay-octobercms.local ในแผงควบคุม ServBay แล้ว และกำหนดรากเว็บไซต์ไปที่ /Applications/ServBay/www/servbay-octobercms-app ถูกต้อง หลังเพิ่มหรือแก้ไข อย่าลืมรีสตาร์ท ServBay เพื่อให้การตั้งค่ามีผล และตรวจสอบว่าเซอร์วิส Caddy/Nginx และ PHP กำลังทำงานอยู่
• ถาม: เปิด https://servbay-octobercms.local/install.php แล้วได้หน้าว่างหรือ error?
  • ตอบ: มักจะเกิดจากข้อผิดพลาดของ PHP ให้ตรวจสอบ error log ของ PHP ในแผงควบคุม ServBay สาเหตุที่พบบ่อย เช่น สิทธิ์ไฟล์ไม่พอ (ตรวจสอบว่าโฟลเดอร์ storage, themes, plugins และโฟลเดอร์ย่อยๆ สามารถเขียนได้โดยเซิร์ฟเวอร์เว็บ), PHP เวอร์ชันไม่รองรับ, หรือขาด extension บางตัว
• ถาม: ติดตั้งแล้วเชื่อมต่อฐานข้อมูลไม่ได้?
  • ตอบ: ตรวจสอบความถูกต้องของข้อมูลเชื่อมต่อในไฟล์ .env (DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD) กับที่สร้างไว้ใน phpMyAdmin และตรวจสอบว่า MySQL/MariaDB ใน ServBay กำลังรันอยู่
• ถาม: รันคำสั่ง composer create-project แล้วล้มเหลว?
  • ตอบ: ตรวจสอบว่าเปิดใช้ Composer และ PHP ในแผงควบคุม ServBay แล้ว และเวอร์ชันถูกต้อง รวมถึงเช็คการเชื่อมต่ออินเทอร์เน็ตเพราะ Composer ต้องดาวน์โหลดไฟล์

สรุป

ServBay เป็นเครื่องมือที่อำนวยความสะดวกให้คุณติดตั้งและตั้งค่า OctoberCMS บน macOS ได้อย่างรวดเร็วและง่ายดาย เมื่อคุณปฏิบัติตามขั้นตอนในคู่มือนี้ จะสามารถสร้างแพลตฟอร์มการพัฒนาเว็บที่ทรงพลังและเป็นมิตรต่อผู้พัฒนาสำหรับโปรเจกต์ถัดไปของคุณ ตอนนี้ถึงเวลาสำรวจความสามารถของ OctoberCMS แล้วเริ่มสร้างเว็บไซต์ที่ยอดเยี่ยมกันเลย!