فعال کردن حالت عیبیابی وردپرس (WP_DEBUG)
خط `define('WP_DEBUG', false);` را در فایل wp-config.php پیدا کرده و مقدار آن را به `true` تغییر دهید.
مشخصات فنی و شناسنامه کد (Code Information)
بازبینی: 1405/06/29/**
* فعالسازی حالت اشکالزدایی عمومی وردپرس
*/
define( 'WP_DEBUG', true );
کد را کجا قرار دهیم؟ (Placement Guide)
در فایل wp-config.php خط موجود WP_DEBUG را ویرایش کنید.
این کد چگونه کار میکند؟ (How it Works)
هنگامی که این ثابت روی true تنظیم میشود، تابع error_reporting در سطح E_ALL فعال شده و کدهای PHP ملزم به اعلام تمام خطاها، اخطارها و نوتیسها میگردند.
چه زمانی از این کد استفاده کنیم؟ (Use Cases)
در زمان توسعه افزونه و قالب یا مواجهه با صفحه سفید مرگ (White Screen of Death) جهت کشف ریشه خطا.
چه زمانی نباید از این کد استفاده کنیم؟ (Anti-patterns)
در سایت آنلاین عمومی بدون مخفیسازی خطاها، چون اطلاعات دایرکتوری و مسیر فایلها را به کاربران نمایش میدهد.
پیشنیازهای اجرا
دسترسی به فایل wp-config.php.
نحوه تست و اطمینان از عملکرد
صفحهای که دچار مشکل است را رفرش کنید تا متن دقیق خطای PHP با شماره سطر و مسیر فایل نمایان شود.
نحوه بازگردانی سریع (Rollback)
مقدار را دوباره به false برگردانید.
خطاهای رایج و راهحل رفع
تعریف دوگانه این ثابت در فایل wp-config.php که خطای PHP Notice: Constant already defined تولید میکند.
ملاحظات و نکات امنیتی
هرگز در محیط زنده WP_DEBUG را با نمایش عمومی خطاها روشن نگذارید، زیرا مسیر فایلهای سیستمی را لو میدهد.
تاثیر بر سرعت و پرفورمنس
تأثیر اندک روی سرعت دارد اما حجم زیادی لاگ موقت تولید میکند.