วิธีเปิด Debug Mode เพื่อหาข้อผิดพลาด WordPress

Debug Mode ช่วยบันทึกข้อผิดพลาดที่เกิดขึ้นใน WordPress เช่น ปัญหาจากปลั๊กอิน ธีม หรือ PHP ข้อมูลนี้ช่วยระบุสาเหตุเมื่อเว็บไซต์ขึ้นหน้าเปล่า เกิด Critical Error หรือทำงานผิดปกติโดยไม่มีข้อความแจ้งชัดเจน

ก่อนเปิดใช้งาน ควรสำรองไฟล์เว็บไซต์ และตั้งค่าให้บันทึกข้อผิดพลาดไว้ใน Log แทนการแสดงบนหน้าเว็บจริง ComSiam แนะนำให้เปิด Debug Mode เฉพาะช่วงตรวจสอบ แล้วปิดเมื่อแก้ปัญหาเสร็จ

❶ สำรองไฟล์ก่อนแก้การตั้งค่า

ไฟล์ตั้งค่า WordPress ชื่อ wp-config.php อยู่ในโฟลเดอร์หลักของเว็บไซต์ ก่อนแก้ไขให้ดาวน์โหลดสำเนาเก็บไว้ หรือใช้ระบบสำรองข้อมูลของโฮสติ้ง

หากไม่พบไฟล์ ให้ตรวจว่าเปิดดูโฟลเดอร์ที่ติดตั้ง WordPress ถูกต้องหรือไม่ อย่าแก้ไฟล์ชื่อใกล้เคียงในโฟลเดอร์อื่น

❷ เปิด Debug Mode ใน wp-config.php

ใช้ File Manager ของโฮสติ้งหรือ FTP เปิดไฟล์ wp-config.php แล้วตรวจส่วนการตั้งค่า Debug หากมีการกำหนดค่า Debug อยู่แล้ว ให้แก้ค่าที่มีแทนการเพิ่มรายการซ้ำ

ตั้งค่า WP_DEBUG ให้เปิด และเปิดการบันทึก Log ด้วย WP_DEBUG_LOG เพื่อเก็บข้อผิดพลาดไว้ในไฟล์ Log ตั้งค่า WP_DEBUG_DISPLAY ให้ปิด เพื่อไม่แสดงรายละเอียดข้อผิดพลาดแก่ผู้เข้าชม

วางการตั้งค่าไว้ในส่วนกำหนดค่าของ WordPress ก่อนบรรทัดที่ระบุให้หยุดแก้ไขไฟล์ หากไม่คุ้นเคยกับการแก้ไฟล์ PHP ให้ขอให้โฮสติ้งหรือผู้ดูแลเว็บไซต์ช่วยดำเนินการ

❸ ทำให้เกิดปัญหาซ้ำและตรวจไฟล์ Log

หลังเปิด Debug Mode ให้ทำขั้นตอนที่ทำให้เกิดปัญหาอีกครั้ง เช่น เปิดหน้าที่มีปัญหา บันทึกบทความ หรือใช้ฟังก์ชันที่ล้มเหลว จากนั้นตรวจไฟล์ wp-content/debug.log ผ่าน File Manager หรือ FTP

ดูรายการที่ตรงกับเวลาที่เกิดปัญหา และสังเกตชื่อปลั๊กอิน ธีม หรือไฟล์ที่ระบุไว้ หาก Log มีหลายรายการ ให้เริ่มจากข้อผิดพลาดที่เกิดในเวลาเดียวกับอาการ ไม่ควรแก้ทุกข้อความโดยไม่ตรวจความเกี่ยวข้อง

❹ ใช้ Log เพื่อหาส่วนที่ผิดพลาด

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

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

❺ ปิด Debug Mode หลังตรวจเสร็จ

เมื่อระบุสาเหตุหรือแก้ปัญหาแล้ว ให้กลับไปที่ wp-config.php และปิด WP_DEBUG รวมถึงการบันทึก Log ที่ไม่จำเป็น จากนั้นตรวจว่าไฟล์บันทึกข้อผิดพลาดไม่เปิดให้เข้าถึงจากสาธารณะ

การเปิด Debug Mode ค้างไว้อาจสร้าง Log จำนวนมากและเปิดเผยรายละเอียดทางเทคนิคได้ จึงควรปิดหลังจบการตรวจสอบ

❻ หากเปิด Debug Mode แล้วเว็บไซต์มีปัญหา

หากเปิดหน้าเว็บไม่ได้หลังแก้ wp-config.php ให้ใช้สำเนาสำรองคืนไฟล์เดิม หรือแก้ค่าที่เปลี่ยนกลับอย่างระมัดระวัง หากไม่แน่ใจ ให้ติดต่อโฮสติ้งและแจ้งว่าปัญหาเริ่มหลังแก้ไฟล์ตั้งค่า

อย่าลบไฟล์ Log หรือไฟล์ WordPress อื่นแบบสุ่ม การเก็บ Log ไว้ชั่วคราวอาจช่วยให้ผู้ดูแลตรวจหาสาเหตุได้

สรุป

การเปิด Debug Mode ทำได้โดยปรับค่าการบันทึกข้อผิดพลาดใน wp-config.php และตรวจ Log ที่ wp-content/debug.log ควรตั้งค่าไม่ให้แสดงข้อผิดพลาดแก่ผู้เข้าชม สำรองไฟล์ก่อนแก้ และปิด Debug Mode หลังตรวจเสร็จ หากไม่คุ้นเคยกับไฟล์ตั้งค่า ให้โฮสติ้งหรือผู้ดูแลช่วยดำเนินการ ComSiam แนะนำให้ใช้ Log ที่ตรงกับเวลาที่เกิดปัญหาเพื่อหาสาเหตุได้เร็วขึ้น