یکی از مهم ترین دغدغه های مدیران سایت های وردپرسی و فروشگاه های اینترنتی ووکامرس، مواجهه با خطاها و مشکلات ناگهانی است. شاید برای شما هم پیش آمده باشد که سایت به طور ناگهانی سفید شود (White Screen of Death)، بخش ورود به پیشخوان غیر فعال شود یا در فرآیند خرید فروشگاه اختلال ایجاد گردد.

در چنین شرایطی، داشتن یک ابزار قدرتمند برای بررسی پشت پرده کدنویسی سایت ضروری است. خوشبختانه وردپرس قابلیتی به نام حالت دیباگ (WP Debug) دارد که به شما امکان می‌دهد به‌جای حدس و گمان، ریشه اصلی خطا را پیدا کنید.

با ووکامرس همراه باشید ❤️

حالت دیباگ وردپرس چیست؟

دیباگ (Debug) در زبان برنامه نویسی به معنی عیب یابی است. وقتی یک نرم افزار اجرا می‌شود، ممکن است خطاهایی در کدنویسی یا تنظیمات وجود داشته باشد که مانع اجرای صحیح آن شود.

وردپرس به عنوان یک سیستم مدیریت محتوا، قابلیتی به نام WP_DEBUG را در هسته خود قرار داده است. با فعال سازی این قابلیت، تمام خطاهای PHP، اخطارها (Warning) و هشدارها (Notice) به مدیر سایت نمایش داده می شوند.

چرا باید حالت دیباگ را فعال کنیم؟

فعال سازی دیباگ مزایای زیادی برای مدیران سایت دارد:

1. شناسایی تداخل افزونه ها یا قالب ها
2. بررسی مشکلات ووکامرس
3. بهبود عملکرد سایت
4. افزایش امنیت

روش اول: فعال سازی حالت دیباگ از طریق فایل wp-config.php

برای فعال سازی دستی:

1. وارد هاست یا FTP شوید.
2. فایل wp-config.php را باز کنید.
3. کد  define( ‘WP_DEBUG’, false); را پیدا کرده و مقدار آن را به true تغییر دهید.
4. برای ذخیره خطاها در فایل لاگ، کدهای زیر را اضافه کنید:

define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

حالا خطاها در فایل debug.log ذخیره می شوند.

روش دوم: فعال سازی دیباگ با افزونه ها

اگر تمایل به ویرایش فایل ها ندارید می توانید از افزونه های WP Debugging ،Query Monitor یا Debug Bar استفاده کنید.

روش سوم: فعال سازی از طریق کنترل پنل هاست

برخی هاستینگ ها در cPanel یا DirectAdmin گزینه‌ای برای نمایش خطاهای PHP دارند. البته برای خطاهای وردپرس همچنان روش wp-config.php توصیه می شود.

حالت دیباگ در ووکامرس

ووکامرس لاگ اختصاصی دارد:

1. به پیشخوان وردپرس → ووکامرس → وضعیت → لاگ‌ها بروید.
2. خطاهای مربوط به سفارش و پرداخت را مشاهده کنید.

همچنین مسیر ذخیره لاگ‌ها: wp-content/uploads/wc-logs/

نکات امنیتی در استفاده از حالت دیباگ

1. دیباگ را در سایت زنده طولانی مدت روشن نگذارید.
2. فایل debug.log را پس از بررسی پاک کنید.
3. همیشه قبل از تغییرات مهم بکاپ بگیرید.

جمع‌بندی

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

امیدواریم از آموزش فعال سازی حالت دیباگ لذت برده باشید. اگر نکته یا پیشنهادی دارید لطفا در بخش دیدگاه ها با ما به اشتراک بگذارید.