فعال‌سازی نمایش خطاها در وردپرس (WP Debug)

رفع خطاها و اشکال‌زدایی (Debug)، بخشی جدانشدنی از هر پروژه‌ی برنامه‌نویسی است. وردپرس برای راحت‌تر شدن فرایند خطایابی از ثابت‌هایی (constant) چون WP_DEBUG استفاده می‌کند تا کاربران عادی و غیر‌برنامه‌نویس هم بتوانند از این قابلیت برای دیدن اطلاعات دقیق از خطاها استفاده کنند.

ممکن است در وردپرس با خطاها یا مشکلاتی مواجه شویم که اطلاعات دقیقی از منشا و نوع خطا وجود ندشته باشد، در اینجا ما برای رفع مشکل به ابزارهای دیباگ نیاز داریم.

نمونه تنظیمات wp-config.php برای دیباگ

کدهایی که در ادامه می‌بینید را در فایل wp-config.php قرار دهید.

توجه: کدها باید قبل از خط /* That's all, stop editing! Happy blogging. */ در فایل wp-config.php قرار داده شوند. این فایل در پوشه اصلی و مسیر نصب وردپرس شما قرار دارد. مثال: public_html

1. فعال‌سازی WP_DEBUG

با تغییر مقدار WP_DEBUG به true همه‌ی خطاها، هشدارها و اعلان‌ها نمایش داده خواهند شد.
نکته: خطاها به کاربران سایت شما نیز نمایش داده می‌شوند.

// Enable WP_DEBUG mode
define( 'WP_DEBUG', true );

2. فعال‌سازی WP_DEBUG_LOG : ذخیره خطاها در فایل لاگ

با اضافه کردن WP_DEBUG_LOG همه‌ی خطاها، هشدارها و اعلان‌ها علاوه بر نمایش در سایت در فایلی به نام debug.log داخل پوشه‌ی wp-content ذخیره می‌شوند.
نکته: برای استفاده از WP_DEBUG_LOG مقدار WP_DEBUG حتما باید true باشد.

// Enable WP_DEBUG mode
define( 'WP_DEBUG', true );
// Enable Debug logging to the /wp-content/debug.log file
define( 'WP_DEBUG_LOG', true );

3. غیرفعال کردن نمایش خطاها و هشدارها در صفحات

اگر قصد دارید خطاها فقط در فایل لاگ ذخیره شوند و دیگر به کاربران نمایش داده نشوند، لازم است WP_DEBUG_DISPLAY و display_errors را هم به فایل wp-config.php اضافه کنید. کد کامل:

// Enable WP_DEBUG mode
define( 'WP_DEBUG', true );
// Enable Debug logging to the /wp-content/debug.log file
define( 'WP_DEBUG_LOG', true );
// Disable display of errors and warnings
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

4. فعال‌سازی SCRIPT_DEBUG : استفاده از نسخه فشرده نشده اسکریپت‌ها

وقتی SCRIPT_DEBUG را فعال کنید، وردپرس به‌جای نسخه‌های فشرده (minified) از فایل‌های اصلی CSS و JS استفاده می‌کند. این گزینه برای توسعه‌دهنده‌هایی که روی فایل‌های اصلی کار می‌کنن مفید است:

// Use dev versions of core JS and CSS files (only needed if you are modifying these core files)
define( 'SCRIPT_DEBUG', true );

پس دسترسی به خطاها و رفع مشکل مجددا می‌توانید مقادیر را به حالت پیشفرض بازگردانید.

اطلاعات کامل:‌ https://developer.wordpress.org/advanced-administration/debug/debug-wordpress