ثبت خطاهای وردپرس در فایل گزارش (WP_DEBUG_LOG)
کدهای زیر را در wp-config.php قرار دهید تا خطاها بیصدا در مسیر `wp-content/debug.log` ذخیره شوند.
مشخصات فنی و شناسنامه کد (Code Information)
بازبینی: 1405/06/29/**
* فعالسازی ثبت مخفیانه خطاها در فایل لاگ اختصاصی
*/
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );کد را کجا قرار دهیم؟ (Placement Guide)
این چهار خط را جایگزین خط پیشفرض define('WP_DEBUG', false); در wp-config.php کنید.
این کد چگونه کار میکند؟ (How it Works)
هسته وردپرس متغیر error_log پیاچپی را روی مسیر wp-content/debug.log تنظیم کرده و همزمان display_errors را خاموش میکند تا هیچ خطایی روی رابط کاربری نقش نبندد.
چه زمانی از این کد استفاده کنیم؟ (Use Cases)
در سایتهای آنلاین که نیاز به رهگیری خطاهای مقطعی، کدهای تخفیف، خطاهای وبهوک یا تراکنشهای ناموفق ووکامرس دارند.
چه زمانی نباید از این کد استفاده کنیم؟ (Anti-patterns)
زمانی که فضای دیسک هاست به شدت پر است و لاگ ممکن است ظرفیت هاست را مصرف کند.
پیشنیازهای اجرا
مجوز دسترسی نوشتن (Write Permission 755/644) برای پوشه wp-content.
نحوه تست و اطمینان از عملکرد
یک صفحه از سایت را باز کنید و سپس فایل /wp-content/debug.log را با FTP بررسی نمایید.
نحوه بازگردانی سریع (Rollback)
مقادیر WP_DEBUG و WP_DEBUG_LOG را به false برگردانید.
خطاهای رایج و راهحل رفع
عدم حفاظت از دسترسی مستقیم به فایل debug.log از طریق مرورگر. حتماً دسترسی به این فایل را با htaccess مسدود کنید.
ملاحظات و نکات امنیتی
فایل debug.log ممکن است حاوی اطلاعات پایگاه داده باشد؛ دسترسی مستقیم به آن باید با htaccess محدود شود.
تاثیر بر سرعت و پرفورمنس
تولید لاگ سربار کمی ایجاد میکند، اما در سرورهای با ترافیک میلیونی باید پس از رفع خطا خاموش شود.
