WordPress Tutorial پیشرفته درس آموزشی

دیباگ وردپرس — خواندن و رفع خطاها

وقتی صفحه سفید می‌شود یا رفتاری عجیب دارید، دیباگ درست مسیر را کوتاه می‌کند. ابزارها: WP_DEBUG در wp-config.php (نمایش خطاها فقط در محیط توسعه)، WP_DEBUG_LOG (ثبت در wp-content/debug.log — امن برای پروداکشن)، WP_DEBUG_DISPLAY=false در سایت زنده، و افزونه Query Monitor برای دیدن خطاها، کوئری‌های کند و خطاهای JS در نوار ادمین. عادت درست: در سایت زنده فقط لاگ فعال باشد؛ نمایش خطا برای بازدیدکننده‌ها هم زشت هم امنیتی است.

مراحل قدم‌به‌قدم

  1. ۱

    فعال‌سازی لاگ خطا

    در wp-config.php قبل از /* That's all */ این‌ها را اضافه کنید: define('WP_DEBUG', true); define('WP_DEBUG_LOG', true); define('WP_DEBUG_DISPLAY', false); — خطاها در wp-content/debug.log ثبت می‌شوند.

  2. ۲

    خواندن لاگ

    فایل debug.log را باز کنید؛ خط آخر معمولاً آخرین رویداد است: نوع خطا، فایل، شماره خط — افزونه مقصر معمولاً در مسیر مشخص است.

  3. ۳

    عیب‌یابی افزونه‌ها با خاموشی مرحله‌ای

    اگر لاگ مقصر واضح نبود، همه افزونه‌ها را با wp plugin deactivate --all غیرفعال و یکی‌یکی فعال کنید؛ یا در پنل هاست پوشه plugins را موقتاً تغییرنام دهید.

  4. ۴

    Query Monitor برای عمق

    افزونه Query Monitor را نصب کنید؛ خطاهای PHP، کوئری‌های کند دیتابیس، هوک‌های سنگین و خطاهای JS را در همان صفحه زنده نشان می‌دهد — ابزار استاندارد توسعه‌دهندگان وردپرس.

نکات مهم

  • ◆ بعد از پایان دیباگ، WP_DEBUG را خاموش کنید؛ لاگ مداوم حجم و ریسک می‌سازد.
  • ◆ خطای Allowed memory exhausted معمولاً یعنی افزونه سنگین یا memory_limit کم هاست.
  • ◆ صفحه سفید را با لاگ پیدا کنید، نه با حدس — علت‌ها از نسخه PHP تا افزونه متنوع‌اند.