Cách kích hoạt chế độ gỡ lỗi trong WordPress

Kích hoạt chế độ gỡ lỗi yêu cầu chỉnh sửa một tệp trong cài đặt WordPress của bạn. Việc này đơn giản nhưng cần thực hiện cẩn thận để tránh làm hỏng trang web. Bên dưới là hướng dẫn từng bước để bạn thực hiện đúng cách.

Khi đã bật, bạn có thể ghi lại lỗi, ẩn chúng khỏi khách truy cập và kiểm soát cách WordPress xử lý thông tin gỡ lỗi. Điều này đặc biệt quan trọng trên các trang web đang hoạt động, nơi bạn cần lưu lại lỗi nhưng không muốn hiển thị công khai.

Xác định vị trí tệp wp-config.php

Bước đầu tiên để kích hoạt chế độ gỡ lỗi là tìm tệp wp-config.php. Tệp này nằm trong thư mục gốc của cài đặt WordPress, cùng vị trí với wp-content, wp-includes và wp-admin. Bạn có thể truy cập nó bằng phần mềm FTP, trình quản lý tệp trong bảng điều khiển hosting hoặc trực tiếp trên máy nếu bạn đang làm việc trên máy chủ phát triển.

Bạn nên tạo một bản sao lưu của tệp này trước khi thay đổi. Chỉ cần thiếu một ký tự cũng có thể làm hỏng trang web của bạn, và bản sao lưu sẽ đảm bảo bạn có thể khôi phục ngay lập tức. Sau khi tìm thấy tệp, hãy mở nó bằng trình soạn thảo văn bản và chuẩn bị điều chỉnh cấu hình.

Kích hoạt WP_DEBUG

Trong tệp wp-config.php, cuộn xuống cho đến khi bạn thấy dòng như sau: define( 'WP_DEBUG', false );. Dòng này kiểm soát chế độ gỡ lỗi có được bật hay không. Mặc định, WordPress vô hiệu hóa gỡ lỗi vì lý do bảo mật và hiệu suất. Để bật, bạn chỉ cần đổi giá trị từ false sang true.

Dòng chính xác sẽ như sau: define( 'WP_DEBUG', true );. Sau khi lưu tệp, WordPress sẽ ngay lập tức hiển thị cảnh báo, thông báo và lỗi PHP trên toàn bộ trang web. Điều này cho phép bạn xác định plugin, giao diện hoặc đoạn mã tùy chỉnh gây sự cố.

Sử dụng WP_DEBUG_LOG để ghi lỗi

Việc hiển thị lỗi trên màn hình có thể hữu ích trong quá trình phát triển, nhưng không phải lúc nào cũng thực tế. Để giám sát lâu dài, bạn có thể bật WP_DEBUG_LOG. Để làm điều này, hãy thêm dòng sau ngay dưới hằng số WP_DEBUG: define( 'WP_DEBUG_LOG', true );. Tất cả lỗi sẽ được lưu trong tệp debug.log nằm trong thư mục wp-content.

Có một tệp nhật ký đặc biệt hữu ích khi bạn cần theo dõi lỗi xảy ra vào những thời điểm cụ thể hoặc khi không thể tái tạo trực tiếp trên màn hình. Nó cũng cho phép bạn chia sẻ tệp này với các nhà phát triển hoặc nhóm hỗ trợ mà không cần cung cấp quyền truy cập trực tiếp vào trang web.

Ẩn lỗi khỏi khách truy cập

Nếu trang WordPress của bạn đang chạy trực tuyến, có lẽ bạn không muốn khách truy cập thấy các thông báo lỗi thô. Trong trường hợp đó, bạn có thể thêm một cài đặt khác để tắt hiển thị ở frontend: define( 'WP_DEBUG_DISPLAY', false );. Điều này đảm bảo rằng lỗi vẫn được ghi lại nhưng không hiển thị với người dùng.

Ngoài ra, bạn có thể thêm @ini_set( 'display_errors', 0 ); để củng cố hành vi này. Sự kết hợp này giúp trang web của bạn chuyên nghiệp và an toàn, đồng thời vẫn cung cấp thông tin cần thiết trong nhật ký cho quản trị viên và nhà phát triển.

Gỡ lỗi nâng cao với SCRIPT_DEBUG

Đối với các nhà phát triển làm việc với JavaScript và CSS, WordPress cung cấp một hằng số bổ sung: define( 'SCRIPT_DEBUG', true );. Theo mặc định, WordPress tải các phiên bản đã nén của script và style. Khi bật gỡ lỗi script, WordPress sẽ tải phiên bản đầy đủ, chưa nén, dễ kiểm tra và gỡ lỗi hơn.

Cài đặt này đặc biệt hữu ích nếu bạn đang phát triển giao diện hoặc plugin và cần theo dõi cách script và style hoạt động. Người dùng thông thường thường không cần đến, nhưng nó có thể tạo ra sự khác biệt lớn cho các nhà phát triển khi xử lý sự cố frontend.

Tóm lại, việc bật chế độ gỡ lỗi trong WordPress là một cách đơn giản nhưng mạnh mẽ để chẩn đoán và duy trì trang web của bạn. Bằng cách chỉnh sửa tệp wp-config.php, bạn có thể hiển thị lỗi, lưu chúng vào nhật ký và giữ cho trang web trông chuyên nghiệp ngay cả khi gặp sự cố. Nếu được sử dụng đúng cách, chế độ gỡ lỗi là một trong những công cụ quan trọng nhất để giữ cho WordPress an toàn, ổn định và thân thiện với nhà phát triển.