فعال سازی دیباگ در وردپرس

عملکرد صحیح یک سیستم مدیریت محتوا به عوامل سخت افزاری و نرم افزاری متعددی بستگی دارد. پس وجود روش هایی برای نمایش خطا در وردپرس و استفاده از ابزارهای اشکال زدایی در وردپرس منطقی است. شما با فعال سازی دیباگ در وردپرس (wp_debug) و کار با فایل debug می توانید به راحتی خطاهای ایجاد شده را ردیابی کنید و به عیب یابی سایت وردپرس خود بپردازید. در این مقاله خواهید دید که گاهی غیر فعال کردن نمایش خطا در وردپرس هم ضروری ست. همراه ما باشید تا با جزئیات نمایش خطا در وردپرس آشنا شوید.

حالت دیباگ (debugging mode) وردپرس چیست؟

WP_DEBUG یک ثابت از نوع بولین در فایل wp-config.php در وردپرس است که بصورت پیش فرض مقدار false را داراست و این به معنی غیر فعال بودن حالت دیباگ وردپرس است.  برای فعالسازی debuge در وردپرس کافیست است که مقدار آن را به  true تغییر دهیم. فعال کردن حالت دیباگ، سبب می شود تمام خطا ها، اعلانات و هشدار های سایت (errors ،notices ،warnings) را نمایش می دهد.

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

نحوه فعال سازی دیباگ در وردپرس

• وارد هاست سایت خود شوید و بر روی گزینه File Manager کلیک کنید.
• پس از ورود به صفحه مدیریت فایل ها  public_html  را انتخاب  کنید.
•  در public_html فایل wp-config.php را پیدا کنید.
• بر روی wp-config.php کلیک راست کنید و گزینه Edit را انتخاب کنید.
• WP_DEBUG را پیدا کنید.
• false را به true تغییر دهید.

;define( 'WP_DEBUG', true )

اگر WP_DEBUG را پیدا نکردید، دقت کنید که این کد را دقیقا در بالای خط  /* That’s all, stop editing! Happy blogging. */  بنویسید.

در ویدئو زیر مراحل بالا را نمایش دادیم:

 غیر فعال کردن نمایش خطا در وردپرس در سمت کاربر با تابع  WP_DEBUG_DISPLAY

اگر قصد دارید دیباگ وردپرس که فعال شده نمایش داده نشود دقیقا در زیر خط WP_DEBUG می توانید تابع WP_DEBUG_DISPLAY را قرار دهید و خاصیت نمایش دیباگ وردپرس را غیر فعال کنید. این خاصیت به طور پیش فرض فعال است.

;define('WP_DEBUG_DISPLAY', false)

برای فعال سازی نمایش آنی خطاها در وردپرس بجای false مقدار true را قرار می دهیم. در این صورت پیام های خطا در بالای هر صفحه نمایش داده خواهد شد. البته اغلب WP_DEBUG_DISPLAY را غیر فعال می کنیم چون دیدن تمام خطا ها و اعلانات علاوه بر موارد امنیتی وبسایت، برای بازدید کنندگان سایت اصلا جالب نیست.

;define( 'WP_DEBUG_DISPLAY', true )

فعالسازی فایل دیباگ با تابع WP_DEBUG_LOG

پس از فعال کردن حالت دیباگ در وردپرس، با استفاده از WP_DEBUG_LOG می توانید تمام خطاهایی که به آن ها دسترسی ندارید را مشاهده کنید. این مورد تمام خطاها و اعلانات را به همراه ساعت و تاریخ در پوشه wp-content و در فایل debug.log ذخیره می کند. WP_DEBUG_LOG به طور پیش فرض غیر فعال است.

;define( 'WP_DEBUG_LOG', true )

وقتی WP_DEBUG_DISPLAY را false قرار د هیم و WP_DEBUG_LOG ، true باشد. کلیه خطا ها در فایل log موجود در wp-content ذخیره می شوند. در این صورت پیام های خطا بصورت آنلاین به کاربران نمایش داده نمی شود و همه ی آن های در فایل log  در wp-content ذخیره می شوند. یکی از دلایلی که نباید خطاها به صورت آنی نمایش داده شوند اینست که هکر ها با ضعف سایت شما آشنا می شوند و ممکن است به سایت شما آسیب بزنند.

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

;define( 'WP_DEBUG', true )
;define( 'WP_DEBUG_LOG', true )
;define( 'WP_DEBUG_DISPLAY', false )

⚠️ افزایش سایز فایل log، موجب اشغال فضای دیسک سرویس خواهد شد، بنابراین حالت دیباگ را در طولانی مدت فعال نگه ندارید.

SCRIPT_DEBUG

هنگامی که SCRIPT_DEBUG فعال باشد، وردپرس استفاده از نسخه های CSS هسته و فایل های جاوا اسکریپت به جای نسخه های فشرده استفاده می کند. اینکار برای بررسی تغییرات اعمال شده در فایل های .js و .css اصلی سایت بسیار کاربردی است.

;define( 'SCRIPT_DEBUG', true )

SAVEQUERIES

با فعال سازی این ویژگی کوئری هایی که بر روی دیتابیس گرفته شده را در یک آرایه نگه داری می کند. شما می توانید با نمایش این کوئری ها، مشکلات احتمالی را رفع کنید.

;define( 'SAVEQUERIES', true )

موارد بالا در خود وردپرس قرار دارند ولی علاوه بر آن ها استفاده از دستورالعمل های بازبینی قالب وردپرس ( کدنویسی استاندارد در وردپرس)، استفاده از افزونه های مورد استفاده برای عیب یابی وردپرس مانند افزونه health check در وردپرس، همچنین داده های تست یا Test Data با هدف اشکال زدایی وردپرس وجود دارند.

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

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