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

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

ServBay มอบสภาพแวดล้อมแบบครบวงจรที่ผนวกรวม PHP, Composer, บริการฐานข้อมูล (เช่น MySQL/MariaDB, PostgreSQL) และเว็บเซิร์ฟเวอร์ (เช่น Caddy, Nginx, Apache) ไว้ในที่เดียว ทำให้การตั้งค่าการพัฒนาโลคอลเป็นเรื่องง่าย ด้วย ServBay คุณจึงสามารถตอบสนองข้อกำหนดสำหรับการใช้งาน Contao ได้อย่างสะดวก

Contao คืออะไร?

Contao คือระบบจัดการเนื้อหา (CMS) แบบโอเพนซอร์สที่พัฒนาด้วย PHP โดดเด่นด้านการใช้งานง่าย ความยืดหยุ่นสูง และมีแผงผู้ดูแลระบบที่ทรงพลัง มาพร้อมฟีเจอร์มากมาย เช่น การจัดการสิทธิ์อย่างละเอียด การควบคุมเวอร์ชัน การสนับสนุนหลายภาษา ระบบจัดการรูปภาพแบบ Responsive และโครงสร้างแบบโมดูลาร์ที่สามารถขยายฟังก์ชั่นได้อย่างง่ายดาย แนวคิดการออกแบบหลักของ Contao คือการให้รากฐานที่มั่นคงสำหรับนักพัฒนาและดีไซเนอร์สามารถสร้างเว็บไซต์ที่ปรับแต่งได้ โดยไม่ต้องเริ่มจากศูนย์

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

ก่อนเริ่มติดตั้ง Contao กรุณาตรวจสอบตามเงื่อนไขต่อไปนี้:

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

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

ส่วนนี้จะพาคุณไปทีละขั้นตอนสำหรับการติดตั้งและตั้งค่า Contao ในสภาพแวดล้อม ServBay

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

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

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

เราจะติดตั้ง Contao ลงในไดเรกทอรี servbay-contao-app

ขั้นตอนที่ 2: สร้างโปรเจค Contao ด้วย Composer

Contao แนะนำให้ใช้ Composer ในการติดตั้งและจัดการแพ็คเกจต่าง ๆ ServBay ได้ติดตั้ง Composer ไว้แล้ว คุณสามารถรันคำสั่งนี้ในโฟลเดอร์โปรเจคเพื่อสร้างโปรเจค Contao ได้เลย:

composer create-project contao/managed-edition .

คำสั่งนี้จะดาวน์โหลด Contao Managed Edition รุ่นล่าสุดพร้อมกับ dependencies ทั้งหมดมาไว้ในโฟลเดอร์ปัจจุบัน (.) กระบวนการนี้อาจใช้เวลาสักครู่ ขึ้นอยู่กับความเร็วอินเทอร์เน็ตของคุณ

คำอธิบายเกี่ยวกับ Contao Managed Edition: contao/managed-edition คือเวอร์ชันแจกจ่ายอย่างเป็นทางการของ Contao ที่มีแกนหลักและ dependencies ที่แนะนำ พร้อมโครงสร้างโปรเจคมาตรฐาน หมายเหตุสำคัญคือ โฟลเดอร์ web ในโปรเจคนี้จะเป็น root ของเว็บไซต์

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

Contao ต้องการฐานข้อมูลสำหรับจัดเก็บข้อมูลและการตั้งค่าต่าง ๆ ServBay มีเครื่องมือจัดการฐานข้อมูล เช่น phpMyAdmin หรือ Adminer ให้ใช้งาน ที่นี่เราจะอ้างอิงการสร้างฐานข้อมูลด้วย phpMyAdmin:

1. เข้าสู่ phpMyAdmin ของ ServBay

   เปิดบราว์เซอร์และไปที่ที่อยู่โลคอลของ ServBay https://servbay.host/ ค้นหาและคลิกลิงก์เพื่อเข้าใช้งาน phpMyAdmin

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

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

   a. เข้าสู่หน้าจัดการบัญชีผู้ใช้

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

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

   คลิก "เพิ่มบัญชีผู้ใช้" จากนั้นกรอกข้อมูลต่อไปนี้:
   
   *   **ชื่อผู้ใช้:** ตั้งชื่อสำหรับการเชื่อมต่อฐานข้อมูล (เช่น `contao_user`)
   *   **โฮสต์:** เลือก `localhost` เพื่อให้สามารถเชื่อมต่อฐานข้อมูลได้จากเครื่องนี้เท่านั้น เพิ่มความปลอดภัย
   *   **รหัสผ่าน:** กำหนดรหัสผ่านที่**แข็งแกร่ง** อย่าใช้รหัสผ่านง่าย ๆ เช่น `password123` ให้ใช้ตัวสร้างรหัสผ่านหากเป็นไปได้
   *   **ยืนยันรหัสผ่าน:** กรอกซ้ำอีกครั้ง
   
   ที่ส่วน "สร้างฐานข้อมูลสำหรับผู้ใช้" ให้เลือก "สร้างฐานข้อมูลที่ชื่อเดียวกับผู้ใช้และให้สิทธิ์ทั้งหมด" ระบบจะสร้างฐานข้อมูลชื่อเดียวกับผู้ใช้ (เช่น `contao_user`) และให้สิทธิ์ครบถ้วนแก่ผู้ใช้ที่สร้างใหม่
   
   *   ตรวจสอบว่าเลือก "ให้สิทธิ์ทั้งหมด" แล้ว
   *   กดปุ่ม "ดำเนินการ" ที่ด้านล่างเพื่อสร้างผู้ใช้และฐานข้อมูล
   

ขั้นตอนที่ 4: ตั้งค่าเว็บไซต์ใน ServBay

ตอนนี้คุณต้องเพิ่มเว็บไซต์ใหม่ใน ServBay โดยให้ชี้ไปยังไดเรกทอรีโปรเจค Contao ที่สร้างไว้

1. เปิด ServBay และสร้างเว็บไซต์ใหม่

   เปิดหน้าแรกของแอป ServBay เลือกแท็บ "เว็บไซต์" ทางซ้ายมือ กดปุ่ม "เพิ่ม" เพื่อสร้างเว็บไซต์ใหม่

2. กำหนดค่าข้อมูลเว็บไซต์

   • ชื่อ: ตั้งชื่อให้เว็บไซต์ของคุณ เช่น My Contao Site
   • โดเมน: ระบุโดเมนสำหรับการพัฒนาโลคอล แนะนำลงท้ายด้วย .local หรือ .servbay.demo เช่น servbay-contao.local ServBay จะตั้งค่า DNS ให้อัตโนมัติ
   • ประเภทเว็บไซต์: เลือก PHP
   • เวอร์ชัน PHP: เลือกเวอร์ชันที่รองรับ Contao ตาม เอกสารทางการ
   • รากเว็บไซต์ (Web Root): สำคัญมาก สำหรับโปรเจคที่ติดตั้งด้วย Composer contao/managed-edition ไฟล์สาธารณะจะอยู่ในโฟลเดอร์ web ดังนั้นระบุ path เป็น /Applications/ServBay/www/servbay-contao-app/web

3. บันทึกการตั้งค่า

   เมื่อตั้งค่าครบแล้ว ให้กดปุ่ม "บันทึก" ด้านล่าง ServBay จะเริ่มตั้งค่าเว็บไซต์ตามข้อมูลที่ระบุ

ขั้นตอนที่ 5: รันโปรแกรมติดตั้ง Contao ผ่านเว็บ

เมื่อเว็บไซต์ได้รับการตั้งค่าแล้ว คุณสามารถเข้าถึงโปรแกรมติดตั้งของ Contao ผ่านเบราว์เซอร์

1. เข้าสู่หน้าติดตั้ง

   เปิดเบราว์เซอร์และเข้าไปที่โดเมนที่ตั้งค่าไว้พร้อมเส้นทาง /contao/install ตัวอย่างเช่น: https://servbay-contao.local/contao/install

   หากทุกอย่างถูกต้อง คุณจะเห็นหน้าติดตั้งของ Contao

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

   โปรแกรมติดตั้งจะขอข้อมูลสำหรับการเชื่อมต่อฐานข้อมูล ให้กรอกข้อมูลที่สร้างไว้ในขั้นตอนที่ 3:

   • โฮสต์ฐานข้อมูล: localhost
   • ชื่อฐานข้อมูล: contao_user (หากกำหนดให้สร้างฐานข้อมูลชื่อเดียวกับผู้ใช้)
   • ชื่อผู้ใช้: contao_user
   • รหัสผ่าน: รหัสผ่านที่คุณตั้งไว้ให้ contao_user

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

   กรอกชื่อผู้ใช้ รหัสผ่าน อีเมลของแอดมินตามที่โปรแกรมติดตั้งร้องขอ แนะนำให้ตั้งรหัสผ่านที่รัดกุม

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

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

ขั้นตอนที่ 6: ตรวจสอบการติดตั้งและเข้าสู่แผงควบคุม

เมื่อติดตั้งเสร็จสิ้นแล้ว คุณสามารถตรวจสอบความสมบูรณ์ของ Contao และเข้าสู่แผงผู้ดูแลระบบได้

1. เยี่ยมชมหน้าแรกของเว็บไซต์

   ใช้เบราว์เซอร์เข้าโดเมนที่กำหนดไว้ เช่น https://servbay-contao.local/ คุณควรเห็นหน้า Welcome ของ Contao หรือหน้าเปล่า (ขึ้นอยู่กับค่าดีฟอลต์) นั่นหมายถึงเว็บเซิร์ฟเวอร์และการตั้งค่าทุกอย่างถูกต้อง

2. เข้าสู่ระบบผู้ดูแล Contao

   เข้าหน้าเข้าสู่ระบบผู้ดูแลที่ https://servbay-contao.local/contao

   ใช้ชื่อผู้ใช้และรหัสผ่านที่ตั้งไว้ในขั้นตอนที่ 5 เพื่อเข้าระบบ หากเข้าสู่ระบบสำเร็จ คุณจะเห็นแดชบอร์ดผู้ดูแล สามารถเริ่มสร้างเนื้อหา ติดตั้งส่วนขยาย และกำหนดค่าเว็บไซต์ได้ทันที

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

ถาม: เมื่อเปิด https://servbay-contao.local/ หรือ https://servbay-contao.local/contao/install พบข้อผิดพลาด ควรทำอย่างไร?

ตอบ:

• ตรวจสอบสถานะของ ServBay: ตรวจสอบว่าแอป ServBay ทำงานอยู่และบริการต่าง ๆ (PHP, เว็บเซิร์ฟเวอร์ เช่น Caddy หรือ Nginx) เปิดใช้งานแล้วหรือไม่
• ตรวจสอบการตั้งค่าเว็บไซต์ใน ServBay: ตรวจสอบชื่อโดเมน ประเภทเว็บไซต์ เวอร์ชัน PHP และโดยเฉพาะ รากเว็บไซต์ (Web Root) ว่าเป็น path /web ของโปรเจคหรือไม่
• ตรวจสอบ DNS: ServBay จะตั้งค่าโดเมน .local ให้อัตโนมัติ ถ้าใช้โดเมนอื่นหรือเจอปัญหา ลองรีสตาร์ท ServBay หรือดูไฟล์ hosts ของระบบ (โดยปกติ ServBay จะดูแลให้แล้ว)
• ตรวจสอบล็อกของเว็บเซิร์ฟเวอร์: อ่าน Log ของ Caddy หรือ Nginx ใน ServBay อาจช่วยให้เห็นสาเหตุของข้อผิดพลาด

ถาม: เชื่อมต่อฐานข้อมูลไม่ได้ควรทำอย่างไร?

ตอบ:

• ตรวจสอบว่าสถานะบริการฐานข้อมูลใช้งานได้: ตรวจสอบ MySQL/MariaDB หรือ PostgreSQL ใน ServBay ว่าทำงานอยู่
• ตรวจสอบข้อมูลการเชื่อมต่อ: ตรวจสอบ Host, ชื่อฐานข้อมูล, ชื่อผู้ใช้, และรหัสผ่านว่าใส่ถูกต้องตรงกับที่ตั้งไว้ใน phpMyAdmin หรือไม่
• ตรวจสอบสิทธิ์ผู้ใช้: มั่นใจว่าผู้ใช้ฐานข้อมูลมีสิทธิ์ครบถ้วนกับฐานข้อมูลของ Contao

ถาม: พบปัญหา Permission Error ระหว่างติดตั้งควรทำอย่างไร?

ตอบ: โปรแกรมติดตั้ง Contao ต้องมีสิทธิ์เขียนในบางไดเรกทอรี แม้ ServBay จะตั้งค่ามาตรฐานให้เพียงพอ แต่หากเจอปัญหา สามารถเข้า terminal และตั้งค่าสิทธิ์โฟลเดอร์ดังนี้:

cd /Applications/ServBay/www/servbay-contao-app
sudo chown -R your_username:staff . # เปลี่ยน your_username เป็นชื่อผู้ใช้ macOS ของคุณ
sudo chmod -R 755 .
sudo chmod -R 777 var/ cache/ system/config/ # จำเป็นต้องให้สิทธิ์เขียนกับไดเรกทอรีเหล่านี้ใน Contao

กรุณาใช้ chmod 777 อย่างระมัดระวัง โดยปกติในเซิร์ฟเวอร์จริงไม่ควรใช้ แต่ในเครื่องพัฒนาโลคอลถือว่าเป็นวิธีแก้ไขปัญหาชั่วคราวที่ยอมรับได้

สรุป

เมื่อทำตามคู่มือนี้ คุณจะสามารถติดตั้งและตั้งค่า Contao CMS ในสภาพแวดล้อมการพัฒนาโลคอลด้วย ServBay ได้สำเร็จ ServBay ช่วยให้การจัดการ dependency ด้วย Composer, การตั้งค่าฐานข้อมูล และเว็บเซิร์ฟเวอร์ เป็นเรื่องง่าย คุณจึงสามารถมีสมาธิกับการพัฒนาเว็บไซต์บน Contao ได้อย่างเต็มที่ ตอนนี้คุณสามารถเริ่มสร้างเนื้อหา ออกแบบหน้า ติดตั้งส่วนขยายและธีม เพื่อพัฒนาเว็บไซต์ของคุณตามต้องการ

หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับการใช้งานและฟีเจอร์ของ Contao สามารถอ่านได้ที่ เอกสารอย่างเป็นทางการของ Contao