Những Gì Bạn Đang Thấy
Các notice của PHP xuất hiện dưới dạng văn bản thô đổ trực tiếp vào output của trang — hiển thị ở frontend, trong trang quản trị, hoặc ẩn trong mã nguồn HTML khi bạn xem View Source. Chúng trông như thế này:
Notice: Undefined index: sidebar_position in /var/www/html/wp-content/themes/mytheme/functions.php on line 42
Notice: Undefined variable: post_id in /var/www/html/wp-content/plugins/myplugin/class-plugin.php on line 118
Notice: Trying to get property 'ID' of non-object in /var/www/html/wp-content/themes/mytheme/single.php on line 27
Bản thân chúng sẽ không làm sập site của bạn. Nhưng chúng làm rối HTML output, làm hỏng JSON từ các AJAX call, và phá vỡ các REST API consumer khi gặp văn bản bất ngờ trước phần body JSON. Tệ hơn, chúng thường là triệu chứng của code bỏ qua các kiểm tra an toàn cơ bản — và đó chính xác là nơi các lỗi thực sự ẩn náu.
Tại Sao Điều Này Xảy Ra
PHP ném ra một notice bất cứ khi nào code đọc một array key hoặc biến chưa được định nghĩa. Đó là nguyên nhân gốc rễ — nhưng WordPress làm nó hiển thị ra ngoài.
WP_DEBUG trong wp-config.php bật tính năng hiển thị lỗi. Khi đã bật, bất kỳ theme, plugin, hoặc code tùy chỉnh nào chạm vào một giá trị chưa được định nghĩa sẽ hiển thị dưới dạng notice. Các nguyên nhân thường gặp:
- Truy cập các key của
$_GET,$_POST, hoặc$_SERVERmà không kiểm tra chúng có tồn tại không - Gọi
get_post_meta()và sử dụng kết quả mà không kiểm tra null - Các tùy chọn Theme hoặc cài đặt Customizer chưa được lưu
- Code của plugin chạy trên các hook trước khi dữ liệu cần thiết sẵn sàng
Bước 1 — Xác Định Nguồn Gốc Của Các Notice
Bạn cần đường dẫn file đầy đủ và số dòng trước khi có thể sửa bất cứ điều gì. Bật ghi log nhưng ẩn output khỏi frontend:
// wp-config.php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true); // ghi log vào /wp-content/debug.log
define('WP_DEBUG_DISPLAY', false); // ẩn khỏi frontend, ghi log thay thế
Đặt WP_DEBUG_DISPLAY thành false sẽ ngay lập tức loại bỏ các notice trên frontend trong khi vẫn ghi chúng vào log. Bây giờ hãy theo dõi log:
tail -f /var/www/html/wp-content/debug.log
Tải lại trang hiển thị notice. Log sẽ cho thấy chính xác file và số dòng.
Bước 2 — Sửa Undefined Index/Variable
Tên file và số dòng sẽ chỉ thẳng đến vấn đề. Cách sửa hầu như luôn khớp với một trong bốn pattern sau:
Pattern A: Undefined array index
// BỊ LỖI — kích hoạt Notice
$value = $options['sidebar_position'];
// ĐÃ SỬA — dùng isset() hoặc null coalescing
$value = isset($options['sidebar_position']) ? $options['sidebar_position'] : 'right';
// Cú pháp ngắn PHP 7+:
$value = $options['sidebar_position'] ?? 'right';
Pattern B: Undefined variable
// BỊ LỖI
echo $post_id;
// ĐÃ SỬA
$post_id = $post_id ?? null;
if ($post_id) {
echo $post_id;
}
Pattern C: Undefined $_GET / $_POST / $_REQUEST key
// BỊ LỖI — phổ biến trong các form handler của plugin
$action = $_POST['my_action'];
// ĐÃ SỬA
$action = sanitize_text_field($_POST['my_action'] ?? '');
if (empty($action)) {
return;
}
Pattern D: get_post_meta() trả về chuỗi rỗng
// BỊ LỖI — $meta là chuỗi rỗng khi meta không tồn tại
$meta = get_post_meta($post->ID, 'custom_field', true);
echo $meta['key']; // Notice nếu $meta là '' chứ không phải array
// ĐÃ SỬA
$meta = get_post_meta($post->ID, 'custom_field', true);
if (is_array($meta) && isset($meta['key'])) {
echo $meta['key'];
}
Bước 3 — Xử Lý Notice Từ Plugin hoặc Theme Bên Thứ Ba
Khi notice đến từ plugin hoặc theme bạn không tự viết, bạn có hai lựa chọn.
Lựa chọn A: Chặn ở cấp độ PHP (sửa nhanh)
Thêm đoạn này vào wp-config.php để tiếp tục ghi log lỗi thực sự trong khi tắt các notice và deprecation:
// wp-config.php — chặn notice từ code bên thứ ba
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
error_reporting(E_ALL & ~E_NOTICE & ~E_DEPRECATED & ~E_STRICT);
Lựa chọn B: Báo cáo cho tác giả plugin/theme
Sao chép toàn bộ notice — đường dẫn file, số dòng, và tất cả — rồi mở một issue trong repository của plugin. Các notice trong các plugin được duy trì tích cực được xem là lỗi và thường được vá trong một hoặc hai bản phát hành.
Bước 4 — Nếu Các Notice Làm Hỏng Phản Hồi JSON/AJAX
Các notice xâm nhập vào phản hồi JSON không chỉ là vấn đề thẩm mỹ — chúng phá hỏng mọi thứ một cách nghiêm trọng. Bất kỳ văn bản nào được thêm vào trước phần body JSON đều khiến JSON.parse ném lỗi trên trình duyệt:
// Những gì AJAX handler của bạn thực sự gửi:
Notice: Undefined index: nonce in /wp-content/plugins/myplugin/ajax.php on line 5
{"success":true,"data":"result"}
// Trình duyệt thấy JSON bị lỗi — JS của bạn bị hỏng
Bắt đầu với WP_DEBUG_DISPLAY false (Bước 1) và sửa undefined index trong AJAX handler của bạn. Nếu vẫn còn output lạ lọt qua, hãy bọc handler trong ob_start() và ob_end_clean() để bắt và loại bỏ nó trước khi wp_send_json() được gọi:
add_action('wp_ajax_my_action', function() {
ob_start(); // bắt bất kỳ output notice nào
$nonce = $_POST['nonce'] ?? '';
if (!wp_verify_nonce($nonce, 'my_action')) {
ob_end_clean();
wp_send_json_error('Invalid nonce');
}
ob_end_clean(); // loại bỏ bất cứ thứ gì đã lọt ra
wp_send_json_success(['result' => 'ok']);
});
Xác Nhận Bản Sửa
-
Tải lại trang đang hiển thị notice. Văn bản notice sẽ biến mất khỏi HTML.
-
Xác nhận log đã sạch:
tail -20 /var/www/html/wp-content/debug.log
-
Đã sửa một AJAX endpoint? Mở DevTools → Network, kích hoạt action, và xác nhận phản hồi là JSON hợp lệ không có văn bản nào được thêm vào trước.
-
Chạy kiểm tra cú pháp nhanh trên bất kỳ file nào bạn đã chỉnh sửa:
php -l wp-content/themes/mytheme/functions.php
Danh Sách Kiểm Tra Cho Production
- Đặt
WP_DEBUGthànhfalsetrên production — các notice trên site thực tế làm lộ đường dẫn file nội bộ cho người dùng - Giữ
WP_DEBUG_LOGđặt thànhtruetrên production để lỗi được ghi lại một cách âm thầm - Xoay vòng
wp-content/debug.log— một cửa hàng WooCommerce bận rộn có thể tạo ra hơn 200MB chỉ trong một ngày nếu không có log rotation - Sử dụng môi trường staging để kiểm tra với
WP_DEBUG_DISPLAY truetrước khi đẩy lên production