کانفیگ وردپرس (wp-config) wp-config constant پلتفرم: wordpress مبتدی (Easy) سطح ریسک: متوسط (Medium Risk)

فعال کردن حالت عیب‌یابی وردپرس (WP_DEBUG)

تست‌شده و بازبینی‌شده در 1405/06/29 ۵۰۳ بار کپی ۲۰۷۱ مشاهده
پاسخ سریع و خلاصه کاربردی (Quick Answer)

خط `define('WP_DEBUG', false);` را در فایل wp-config.php پیدا کرده و مقدار آن را به `true` تغییر دهید.

مشخصات فنی و شناسنامه کد (Code Information)

بازبینی: 1405/06/29
پلتفرم اجرایی (Platform) wordpress
نوع کد (Code Type) wp-config constant
محل قرارگیری فایل (Location) wp-config.php
سطح دشواری (Difficulty) مبتدی (Easy)
سطح ریسک (Risk Level) متوسط (Medium Risk)
نیاز به بکاپ اولیه؟ بله، حتماً بکاپ بگیرید
سازگاری با وردپرس تمام نسخه‌های وردپرس
سازگاری با ووکامرس و HPOS سازگار
هشدار ایمنی: این تغییر مستقیماً فایل‌های حساس سرور یا دیتابیس را ویرایش می‌کند. حتماً پیش از ذخیره کد از وب‌سایت یا فایل مورد نظر فایل پشتیبان (Backup) تهیه کنید.
|
/**
 * فعال‌سازی حالت اشکال‌زدایی عمومی وردپرس
 */
define( 'WP_DEBUG', true );

کد را کجا قرار دهیم؟ (Placement Guide)

در فایل wp-config.php خط موجود WP_DEBUG را ویرایش کنید.

مسیر فایل: wp-config.php

این کد چگونه کار می‌کند؟ (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 را با نمایش عمومی خطاها روشن نگذارید، زیرا مسیر فایل‌های سیستمی را لو می‌دهد.

تاثیر بر سرعت و پرفورمنس

تأثیر اندک روی سرعت دارد اما حجم زیادی لاگ موقت تولید می‌کند.

پرسش‌های متداول پیرامون این کد (FAQ)

خیر، این کد خطایی ایجاد نمی‌کند بلکه خطاهای مخفی را آشکار می‌سازد.
منابع و مستندات رسمی بررسی‌شده (Official Sources):

سبد خرید شما

0 افزونه

سبد خرید شما خالی است

هنوز محصولی را به سبد خرید اضافه نکرده‌اید. می‌توانید از افزونه‌های اختصاصی ما دیدن فرمایید.

مشاهده فروشگاه افزونه‌ها

ثبت درخواست مشاوره

با تکمیل فرم زیر، کارشناسان فنی بیسکو وب در سریع‌ترین زمان ممکن با شما تماس می‌گیرند.

مشاور
پشتیبانی و مشاوره تخصصی
پاسخگویی سریع کارشناسان
09903336117