Chế độ gỡ lỗi trên WordPress là gì?

Trong quá trình vận hành website, với rất nhiều theme và plugin khác nhau chắc chắn bạn sẽ gặp phải một số vấn đề. Những điều này có thể tiêu tốn của bạn hàng giờ đồng hồ đề tìm ra gốc rễ của vấn đề. Và chính lúc này chế độ gỡ lỗi sẽ rất hữu ích cho bạn.

Việc cài đặt plugin hoặc theme mới hoặc cập nhật WordPress có thể gây ra xung đột. Và chúng tôi cũng đã đưa ra hướng dẫn các bước kiểm tra xung đột plugin trong WordPress. Tuy nhiên tìm được nguyên nhân gây xung đột là một chuyện, và giải quyết xung đột lại là câu chuyện khác.

Việc bật chế độ gỡ lỗi trên WordPress, website sẽ hiển thị toàn bộ nhật ký lỗi của PHP, các cảnh báo. Điều này giúp bạn biết chính xác nguồn gốc của vấn đề mà bạn đang gặp phải một cách rõ ràng nhất.

Bạn còn có thể sử dụng chế độ gỡ lỗi để ngăn chặn một số vấn đề nằm ẩn sâu trong hệ thống. Một số lỗi không hiển thị ra bên ngoài mà xảy ra khi có các tác vụ chạy ngầm bên dưới.

Tại sao WordPress mặc định giấu đi thông báo lỗi?

Hãy tưởng tượng nếu mọi lỗi trên trang web đều hiện ra mỗi khi người dùng truy cập – điều này không chỉ phiền phức mà còn đe dọa đến sự an toàn của trang web. Việc tiết lộ mọi lỗi có thể làm lộ ra thông tin bảo mật, mở cửa cho hacker tận dụng và chiếm quyền kiểm soát trang web. Đó là lý do mà WordPress đã chọn mặc định ẩn đi thông báo lỗi trên trang web.

Trong quá trình phát triển trang web, Codex WP khuyến khích các nhà phát triển kích hoạt chế độ gỡ lỗi trong WordPress để dễ dàng phát hiện và khắc phục lỗi.

Có hai cách để bật chế độ gỡ lỗi WordPress, bao gồm:

Lỗi PHP: Hiển thị lỗi do viết mã PHP gây ra.
Các hàm đã bị hủy bỏ/không tồn tại: Các hàm có thể đã được sử dụng trước đó nhưng hiện tại đã bị loại bỏ.

Khi nào nên kích hoạt chế độ gỡ lỗi trong WordPress?

Hãy xem xét việc bật chế độ gỡ lỗi trong WordPress khi bạn đối mặt với những tình huống sau:

– Khi màn hình trống xuất hiện trong quá trình tải trang web.
– Khi cảnh báo với mã lỗi (như lỗi 401, lỗi 404, lỗi 500, …) xuất hiện.
– Khi toàn bộ trang web gặp sự cố.
– Khi bạn nhận thấy tốc độ tải trang web chậm.
– Khi một plugin hoặc chủ đề không hoạt động đúng cách.
– Khi sự hiếu suất của trang web gặp vấn đề và bạn muốn xác định plugin hoặc chủ đề nào đang gây ra vấn đề.

Các Hằng số Quan trọng để Xem Lỗi trong WordPress

Dưới đây là một số hằng số mà bạn có thể kích hoạt để theo dõi lỗi trong WordPress:

WP_DEBUG

Hằng số PHP quan trọng nhất để kích hoạt chế độ gỡ lỗi trên trang web của bạn là WP_DEBUG. Mặc định, giá trị của hằng số này là false và được đặt trong file wp-config.php:

xác định (‘WP_DEBUG’, sai);

Để bật chế độ debug, bạn chỉ cần thay đổi false thành true:

define( ‘WP_DEBUG’, true);
Lưu ý rằng việc chỉnh sửa file wp-config.php đòi hỏi sự cẩn trọng, vì đây là tệp cấu hình quan trọng có thể ảnh hưởng đến truy cập cơ sở dữ liệu, hiệu suất và bảo mật WordPress.

WP_DEBUG_LOG

Để xem lại lỗi và thông báo lỗi ở mọi nơi trên trang web của bạn, bạn có thể bật WP_DEBUG_LOG. Thêm dòng sau vào file wp-config.php:

define( ‘WP_DEBUG_LOG’, true);
Khi bật WP_DEBUG_LOG, một tệp debug.log sẽ được tạo trong thư mục wp-content. Để xem danh sách lỗi, chỉ cần mở tệp debug.log bằng Notepad hoặc trình soạn thảo văn bản khác.

WP_DEBUG_DISPLAY

WP_DEBUG_DISPLAY là một chức năng cần được tắt để ngăn thông báo lỗi hiển thị trên trang web của bạn. Thêm đoạn mã sau vào file wp-config.php:

define( ‘WP_DEBUG_DISPLAY’, false);
Giá trị mặc định của WP_DEBUG_DISPLAY là true, và nó cần được đặt thành false để ẩn tất cả các lỗi.

TRUY VẤN TIẾT KIỆM

Khi gỡ lỗi, bạn có thể debug với các truy vấn trong cơ sở dữ liệu. Để lưu trữ tất cả các truy vấn trong biến toàn cục $wpdb->queries, thêm đoạn mã sau vào file wp-config.php:

define( ‘SAVEQUERIES’, true);
Khi bật tùy chọn này, bạn có thể thêm đoạn mã PHP sau để xem kết quả:

<?php
toàn cầu $wpdb;
print_r( $wpdb->queries );
?>

Gỡ lỗi với các Plugin

Trong thế giới WordPress, có nhiều plugin hỗ trợ chế độ gỡ lỗi mà bạn có thể tận dụng, như Query Monitor, Debug Bar và Log Deprecated.

Giám sát truy vấn

Query Monitor là một plugin tuyệt vời cho phép bạn theo dõi một cách chính xác hoạt động của các plugin khác nhau trong WordPress.
Plugin này có khả năng:

• • Gỡ lỗi các truy vấn

• • Theo dõi lỗi PHP

• • Kiểm tra hooks và actions

• • Quản lý cuộc gọi API HTTP

• • Theo dõi các tệp và kiểu dựa vào kịch bản được enqueued

• • Gỡ lỗi các cuộc gọi AJAX

Thanh gỡ lỗi

Plugin này thường được lựa chọn bởi các nhà phát triển, vì nó cung cấp khả năng thêm chế độ debug cho chủ đề hoặc plugin của họ. Debug Bar sẽ tích hợp một menu gỡ lỗi vào thanh quản trị WordPress và hiển thị thông tin chi tiết về truy vấn, bộ đệm, và các thông báo lỗi trong WordPress mà bạn có thể xem.

Hướng dẫn kích hoạt chế độ gỡ lỗi trong WordPress để hiển thị lỗi

Việc kích hoạt chế độ gỡ lỗi WordPress sẽ giúp hiển thị các lỗi và cảnh báo PHP trên trang web của bạn, giúp bạn xác định và khắc phục các lỗi trong mã nguồn.

Để thực hiện bước kích hoạt chế độ gỡ lỗi WordPress để hiển thị lỗi, bạn cần chuẩn bị các công cụ sau đây:

Máy khách FTP để truy cập các tập tin trang web, có thể sử dụng Filezilla FTP (https://filezilla-project.org/).
Một trình soạn thảo văn bản để thực hiện các thay đổi trong tệp, ví dụ như Notepad++.

Bước 1: Kết nối với máy khách FTP

Đầu tiên, đăng nhập vào cPanel hoặc kết nối với máy khách FTP, sử dụng trình quản lý tệp để sửa tệp wp-config.php cho trang web.

Bước 2: Chỉnh sửa tệp wp-config.php

Sau khi đăng nhập, vào thư mục public_html. Tại đây, tìm tệp wp-config.php trong thư mục gốc của trang web.

Nếu sử dụng dịch vụ lưu trữ hosting với cPanel, bạn có thể truy cập tab ‘Advanced’, sau đó chuyển đến File Manager.

Trong bảng điều khiển, truy cập thư mục public_html từ menu bên trái.

Cuộn xuống tìm tệp ‘wp-config.php’.

Nhấp chuột phải vào tệp và tải xuống thiết bị.

Mở tệp bằng trình soạn thảo văn bản như Notepad hoặc Sublime Text.

Sau khi tải xuống, mở tệp và dán các dòng dưới đây ngay trước dòng có nội dung: “That’s all, stop editing! Happy publishing.”

Lưu ý rằng trước khi đóng tệp, bạn cần lưu lại các thay đổi của mình.

Tiếp theo, tải tệp wp-config.php lên máy chủ trang web của bạn bằng ứng dụng khách FTP.

Bước 3: Xem nhật ký lỗi WordPress

Để xem nhật ký lỗi WordPress, bạn cần xem tệp trang web và điều hướng đến đường dẫn public_html/wp-content/debug.log. Tải xuống tệp và xem bằng Notepad để theo dõi các vấn đề trên trang web.

Bước 4: Tắt chế độ gỡ lỗi WordPress

Lưu ý rằng sau khi sửa xong sự cố, bạn cần tắt chế độ gỡ lỗi để tránh vấn đề liên quan đến an toàn bảo mật. Để tắt chế độ gỡ lỗi, lặp lại các bước trên và xóa mã bạn đã thêm vào tệp wp-config.php hoặc chỉnh sửa mã sau:

xác định (‘WP_DEBUG’, sai);

Những bước trên đây giúp bạn sử dụng WP_DEBUG, WP_DEBUG_LOG, và WP_DEBUG_DISPLAY một cách hiệu quả, mang lại nhiều lợi ích cho chủ sở hữu và nhà phát triển trang WordPress. Việc này không chỉ giúp kích hoạt chế độ debug mà còn quản lý việc lưu hoặc ẩn tất cả lỗi để phát triển trang web một cách hiệu quả.

  Chế độ gỡ lỗi trên WordPress có vai trò quan trọng trong quá trình phát triển, xây dựng và bảo trì trang web. Nó cung cấp các thông báo lỗi chi tiết và thông tin debug để giúp bạn xác định và sửa các lỗi trong mã nguồn WordPress, theme hoặc plugin.
Lưu ý rằng chế độ gỡ lỗi nên chỉ được kích hoạt trong quá trình phát triển hoặc khi bạn cần xem thông tin debug. Khi trang web đã hoạt động ổn định, nên tắt chế độ gỡ lỗi để tránh hiển thị các thông báo lỗi cho người truy cập công khai.

Ngoài ra còn một số bài viết hửu ích khác bạn có thể tham khảo:

WordPress là gì? Tại sao nên sử dụng để thiết kế website?

Quản trị máy chủ là gì? Tầm quan trọng của quản trị máy chủ