شنبه تا چهارشنبه، ۹ تا ۱۸. پشتیبانی فنی ۲۴ ساعته تا ۷ روز پولتان برمی‌گردد انتقال رایگان سایت، بدون قطعی
تازه‌ترین نوشته‌هابلاگتازه‌ترین نوشته‌ها
وردپرس

صفحهٔ سفید در وردپرس — پیدا کردن علت، نه حدس زدنش

صفحهٔ سفید یعنی PHP خطا داده و وردپرس آن را پنهان کرده. دو خط تنظیم، خطا را نشان می‌دهد و بعدش کار ساده است.

صفحهٔ سفید بدون هیچ پیامی، ترسناک‌ترین حالت است چون هیچ سرنخی نمی‌دهد. ولی معنایش دقیق است: PHP با خطای مرگبار متوقف شده، و وردپرس تنظیم شده که خطا را به کاربر نشان ندهد.

پس کار اول، حدس زدن علت نیست — نشان دادن خطا است.

۱. خطا را روشن کنید

در File Manager فایل wp-config.php را باز کنید و این سه خط را اضافه کنید، بالای خطی که نوشته That's all, stop editing!:

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

اگر خط define( 'WP_DEBUG', false ); از قبل هست، همان را به true عوض کنید.

توجه کنید که WP_DEBUG_DISPLAY را روی false گذاشته‌ایم. یعنی خطا در صفحه نمایش داده نمی‌شود — به فایل نوشته می‌شود. این عمدی است: صفحهٔ خطا برای بازدیدکننده‌ها مسیر فایل‌های سرور و نام جدول‌ها را لو می‌دهد.

حالا صفحه را یک‌بار باز کنید، بعد این فایل را بخوانید:

wp-content/debug.log

آخرین خط‌هایش، خطا را با نام فایل و شمارهٔ خط می‌گویند.

۲. خطا را بخوانید

بیشتر خطاها یکی از این چهار شکل‌اند:

Allowed memory size of ... exhausted

حافظهٔ PHP تمام شده. این خط را به wp-config.php اضافه کنید:

define( 'WP_MEMORY_LIMIT', '256M' );

اگر اثر نکرد، محدودیت سمت سرور است. در cPanel از MultiPHP INI Editor مقدار memory_limit را بالا ببرید.

Maximum execution time exceeded

یک عملیات بیش از حد مجاز طول کشیده. در MultiPHP INI Editor مقدار max_execution_time را بالا ببرید.

ولی این را هم بپرسید: چه چیزی این‌قدر طول می‌کشد؟ معمولاً یک افزونه است که کار سنگینی در هر بارگذاری انجام می‌دهد. بالا بردن محدودیت، نشانه را پنهان می‌کند.

Fatal error: Uncaught Error: Call to undefined function ...

کدی تابعی را صدا زده که وجود ندارد. تقریباً همیشه یکی از این دو:

  • نسخهٔ PHP ناسازگار — افزونه یا قالب برای نسخهٔ دیگری نوشته شده. در MultiPHP Manager نسخه را عوض کنید.
  • افزونه‌ای نیمه‌به‌روز شده — فایل‌هایش ناقص آپلود شده‌اند.

نام فایل در پیام خطا می‌گوید کدام افزونه یا قالب است.

Fatal error: ... in /wp-content/plugins/نام-افزونه/...

مستقیم‌ترین حالت. همان افزونه مسئول است. برو به قدم ۳.

۳. افزونهٔ مقصر را خاموش کنید

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

اگر پیشخوان هم سفید است، از File Manager:

  1. به wp-content/plugins/ بروید.
  2. پوشهٔ افزونه را پیدا کنید.
  3. نامش را عوض کنید — مثلاً نام-افزونه به نام-افزونه-OFF.

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

اگر نمی‌دانید کدام افزونه است، نام کل پوشهٔ plugins را به plugins-OFF عوض کنید. این همهٔ افزونه‌ها را یک‌جا خاموش می‌کند. اگر سایت برگشت، نام را برگردانید و بعد یکی‌یکی پوشه‌ها را تغییر نام دهید تا مقصر پیدا شود.

۴. اگر قالب مقصر است

اگر خطا به wp-content/themes/ اشاره می‌کند، همان روش را روی پوشهٔ قالب اعمال کنید — ولی اینجا یک شرط هست: باید یک قالب دیگر روی سایت نصب باشد. وردپرس وقتی قالب فعال را پیدا نکند، به قالب پیش‌فرض برمی‌گردد؛ اگر هیچ قالبی نباشد، همان صفحهٔ سفید می‌ماند.

برای همین، یکی از قالب‌های پیش‌فرض وردپرس را همیشه نصب نگه دارید، حتی اگر استفاده نمی‌کنید.

۵. بعد از رفع، دیباگ را خاموش کنید

این مهم است و معمولاً فراموش می‌شود. آن سه خط را به این شکل درآورید:

define( 'WP_DEBUG', false );

و فایل wp-content/debug.log را حذف کنید. این فایل مسیرهای سرور و بخشی از کوئری‌ها را در خودش دارد و با آدرس مستقیم برای همه قابل خواندن است.

اگر debug.log ساخته نشد

دو احتمال:

  • دسترسی نوشتن روی پوشهٔ wp-content نیست. در File Manager دسترسی‌اش را ۷۵۵ بگذارید.
  • خطا پیش از خواندن wp-config.php رخ داده — مثلاً خطای نحوی در خود wp-config.php. در آن حالت، لاگ خطای سرور را ببینید: در cPanel بخش Errors یا فایل error_log در ریشهٔ سایت.

یک حالت خاص: سفید شدن بعد از ویرایش فایل

اگر صفحهٔ سفید درست بعد از این آمد که فایلی را ویرایش کردید، تقریباً قطعاً خطای نحوی است — یک پرانتز یا نقطه‌ویرگول جا افتاده. تغییرتان را برگردانید.

و یک نکته برای بار بعد: قبل از ویرایش هر فایل PHP، یک کپی از آن بگیرید. در File Manager گزینهٔ Copy یک ثانیه طول می‌کشد و بازگشت را بی‌دردسر می‌کند.

این نوشته کمکتان کرد؟ نه، هنوز سوال دارم

نوشته‌های مرتبط