วิธีดู Log และ Debug Joomla สำหรับนักพัฒนา

การดู Log และ Debug ใน Joomla ช่วยให้นักพัฒนาหาสาเหตุของข้อผิดพลาดจากโค้ด ส่วนเสริม หรือการตั้งค่าได้เป็นขั้นตอน โดยเปิด Debug System และ System – Debug plugin เมื่อต้องตรวจข้อมูลบนหน้าเว็บ และใช้ระบบ Logging เมื่อต้องการบันทึกเหตุการณ์ลงไฟล์ ควรจำกัดสิทธิ์ผู้เห็นข้อมูลและปิดโหมด Debug หลังตรวจสอบเสร็จ

❶ เปิดเครื่องมือ Debug ของ Joomla

① เปิด Debug System

เข้าสู่ System → Global Configuration → System แล้วตั้งค่า Debug System เป็น Yes เมื่อเปิดใช้งาน Joomla จะแสดงแถบ Debug พร้อมข้อมูลวิเคราะห์เพิ่มเติม ซึ่งอาจรวมถึงข้อมูลคำขอ ฐานข้อมูล และเวลาการทำงาน

② ตั้งค่าปลั๊กอิน System – Debug

ไปที่รายการปลั๊กอิน ค้นหา System – Debug แล้วตรวจสอบว่าปลั๊กอินเปิดใช้งานอยู่ กำหนด Allowed Groups ให้เฉพาะกลุ่มนักพัฒนาหรือผู้ดูแลที่จำเป็นต้องดูแถบ Debug อย่าเปิดให้ผู้เข้าชมทั่วไปเห็นข้อมูลนี้

③ ปรับ Error Reporting เมื่อต้องหาข้อผิดพลาด PHP

หากกำลังหาข้อผิดพลาด PHP ให้ปรับ Error Reporting ใน Global Configuration → Server เป็นระดับที่เหมาะกับการพัฒนา โดยควรทำบนเว็บทดสอบ หากจำเป็นต้องตรวจบนเว็บจริง ให้จำกัดการเปิดเผยข้อมูลและปิดกลับทันทีหลังตรวจเสร็จ

❷ เปิด Logging และหาไฟล์ Log

ใน Global Configuration → Logging ให้ตรวจสอบค่า Path to Log Folder ว่าชี้ไปยังโฟลเดอร์ที่มีอยู่และ Joomla เขียนไฟล์ได้ จากนั้นเลือก Log Almost Everything เมื่อจำเป็นต้องเก็บเหตุการณ์หลายประเภท

ไฟล์ Log มักอยู่ในโฟลเดอร์ที่กำหนดไว้ เช่น administrator/logs แต่ตำแหน่งจริงขึ้นกับการตั้งค่าของเว็บไซต์ หากไม่มีไฟล์หรือไม่มีรายการใหม่ ให้ตรวจเส้นทาง สิทธิ์เขียนไฟล์ และค่าการกรอง Log

หากต้องการดูเฉพาะส่วนเสริม ให้ใช้ Custom Logging ระบุระดับความสำคัญและชื่อ Category ที่ต้องการ ระบบจะเขียนเฉพาะข้อความที่ตรงกับเงื่อนไข ทำให้ค้นหาข้อความจากส่วนเสริมของตนเองได้ง่ายกว่าการเปิด Log รวมทั้งหมด

❸ เพิ่มข้อความ Log ในโค้ดส่วนเสริม

นักพัฒนาสามารถบันทึกข้อความจากโค้ด Joomla ด้วยคลาส Log และกำหนดระดับความสำคัญกับ Category ตัวอย่างเช่น

use Joomla\CMS\Log\Log;

Log::add(
    'ไม่สามารถประมวลผลข้อมูลตัวอย่างได้',
    Log::ERROR,
    'my-extension'
);

ใช้ Category ที่สื่อถึงชื่อคอมโพเนนต์ โมดูล หรือปลั๊กอิน เพื่อกรองดูเฉพาะข้อความของโค้ดส่วนนั้นได้ อย่าบันทึกรหัสผ่าน API Token หรือข้อมูลส่วนบุคคลลง Log

ถ้าต้องการบันทึกข้อความสำหรับการพัฒนาเท่านั้น สามารถตรวจค่า JDEBUG ก่อนเขียน Log เพื่อไม่ให้ข้อความ Debug ที่ละเอียดเกินไปถูกสร้างในสภาพแวดล้อมที่ไม่ได้เปิด Debug

❹ ไล่ตรวจปัญหาอย่างเป็นระบบ

① ทำให้ปัญหาเกิดซ้ำได้

จดขั้นตอนที่ทำก่อนเกิดข้อผิดพลาด เช่น หน้าเว็บที่เปิด บัญชีที่ใช้ และข้อมูลที่ส่ง วิธีนี้ช่วยให้ทดสอบซ้ำหลังแก้โค้ดได้

② ตรวจเวลาและข้อความใน Log

เปิด Log ที่ตรงกับช่วงเวลาที่เกิดปัญหา แล้วค้นหาคำสำคัญ เช่น ERROR, ชื่อคอมโพเนนต์ หรือชื่อ Category ตรวจทั้งข้อความผิดพลาดและบรรทัดที่เกี่ยวข้องเพื่อหาว่าปัญหาเกิดในส่วนใด

③ แยก Log ของ Joomla กับ Log ของเซิร์ฟเวอร์

Joomla บันทึกข้อผิดพลาดที่ระบบดักจับได้ ส่วนข้อผิดพลาดจาก PHP หรือเว็บเซิร์ฟเวอร์บางชนิดอาจอยู่ใน Error Log ของโฮสติ้งหรือเซิร์ฟเวอร์ หากไม่พบสาเหตุใน Log ของ Joomla ให้ตรวจ Log ของ PHP และเว็บเซิร์ฟเวอร์ประกอบ

④ เปลี่ยนทีละจุดแล้วทดสอบซ้ำ

ปิดหรือปรับส่วนเสริมที่สงสัยทีละรายการบนเว็บทดสอบ และทำตามขั้นตอนเดิมเพื่อดูว่าปัญหาหายหรือไม่ การเปลี่ยนหลายอย่างพร้อมกันทำให้ระบุสาเหตุได้ยาก

❺ ปิด Debug หลังตรวจสอบ

เมื่อแก้ปัญหาเสร็จ ให้ปิด Debug System และลด Error Reporting กลับสู่ค่าที่เหมาะกับเว็บไซต์จริง ตรวจ Allowed Groups ของ System – Debug อีกครั้ง และลบหรือจัดเก็บไฟล์ Log ตามแนวทางดูแลระบบ เพราะ Log อาจมีรายละเอียดที่ไม่ควรเปิดเผย

ComSiam แนะนำให้ทดสอบบนเว็บ Staging ก่อน และใช้ Category แยก Log ของส่วนเสริมแต่ละตัว เมื่อต้องวิเคราะห์บนเว็บไซต์จริง ควรเปิดเครื่องมือเฉพาะช่วงเวลาที่จำเป็นและจำกัดผู้มีสิทธิ์ดูข้อมูลไว้เสมอ