Trình cấu hình WP_DEBUG

Bật nhật ký gỡ lỗi mà không làm hỏng website đang chạy

Chạy trong trình duyệt của bạn. Không up gì cả.

Trang web này đang ở đâu?

Điều này thay đổi khuyến nghị, chứ không chỉ thay đổi cách diễn đạt. Cấu hình an toàn trên một trang web đang chạy thật thực sự khác với cấu hình hữu ích trên máy tính của bạn.

Website đang chạy thật Máy local / staging

Kết luận

—

Tùy chọn

WP_DEBUG — bật chế độ gỡ lỗiBuộc WordPress hiển thị các notice, cảnh báo và hàm lỗi thời của PHP mà bình thường nó âm thầm bỏ qua. WP_DEBUG_LOG — ghi ra fileLỗi được ghi vào wp-content/debug.log thay vì hiện lên màn hình. Đây là hằng số giúp gỡ lỗi an toàn ngay trên site thật. WP_DEBUG_DISPLAY false — ẩn lỗi khỏi khách truy cậpKhông có dòng này, WP_DEBUG sẽ in lỗi PHP thẳng vào trang của bạn. Tắt nó đi là dòng quan trọng nhất trên trang này. Ghi log ra ngoài thư mục web rootTrên nhiều host, wp-content/debug.log ai cũng đọc được — chỉ cần mở link là tải về. Chuyển nó ra ngoài web root sẽ khắc phục điều đó. Chỉnh lại đường dẫn cho khớp với server của bạn. SAVEQUERIES — ghi lại mọi truy vấn cơ sở dữ liệuHữu ích khi truy tìm trang bị chậm. Tốn bộ nhớ ở MỌI request, nên nhớ tắt lại sau khi xong. SCRIPT_DEBUG — nạp JS/CSS lõi bản chưa nénChỉ hữu ích khi bạn đang gỡ lỗi trình soạn thảo khối (block editor) hoặc các script lõi.

wp-config.php

Dán những dòng này PHÍA TRÊN dòng có nội dung /* That's all, stop editing! */ — mọi thứ nằm bên dưới nó đều bị bỏ qua, đó là lý do rất nhiều người phản ánh rằng WP_DEBUG "chẳng làm gì cả".

Về Trình cấu hình WP_DEBUG

Tạo các hằng số WP_DEBUG để ghi lỗi vào tệp log thay vì hiển thị chúng cho khách truy cập. Đoạn WP_DEBUG mặc định mà hầu hết website sao chép sẽ phơi bày lỗi PHP ra công khai — đoạn này thì không.

Liên quan

Các công cụ khác bạn có thể cần

Trình giải mã lỗi PHP nghiêm trọng của WordPress

Dán lỗi vào. Chúng tôi chỉ ra plugin gây lỗi.

Trình tạo wp-config.php

Tạo một tệp wp-config.php chuẩn mà không phải sao chép từ bài blog năm 2014

Câu hỏi thường gặp

Câu hỏi

Bật WP_DEBUG trên một trang đang chạy có an toàn không?

Chỉ khi đặt WP_DEBUG_DISPLAY thành false. Đứng một mình, WP_DEBUG in ra các thông báo và cảnh báo PHP — bao gồm cả các đường dẫn file tuyệt đối trên máy chủ của bạn — thẳng vào những trang mà khách của bạn tải. Gần như mọi bài hướng dẫn đưa cho bạn đúng một dòng đó rồi dừng. Ghép nó với WP_DEBUG_LOG và WP_DEBUG_DISPLAY false thì nó an toàn.

Debug log của WordPress đặt ở đâu?

wp-content/debug.log theo mặc định. Đáng biết: trên nhiều hosting file đó có thể tải công khai — bất kỳ ai cũng có thể yêu cầu nó trong trình duyệt. Bạn có thể truyền một đường dẫn cho WP_DEBUG_LOG để ghi log lên trên web root, điều mà công cụ này sẽ tạo cho bạn.

Tôi đặt WP_DEBUG thành true mà chẳng có gì xảy ra. Tại sao?

Gần như luôn là vì hằng số được thêm vào PHÍA DƯỚI dòng ghi "That's all, stop editing!" trong wp-config.php. Mọi thứ sau dòng đó bị bỏ qua. Hãy chuyển nó lên trên.