نوشته‌ها

رفع خطای سفید شدن صفحه در وردپرس؛ آموزش کامل

رفع خطای سفید شدن صفحه در وردپرس؛ آموزش کامل

رفع خطای سفید شدن صفحه در وردپرس؛ آموزش کامل

خطای سفید شدن صفحه در وردپرس یا همان White Screen of Death (WSOD) یکی از مشکلات رایج و آزاردهنده‌ای است که ممکن است باعث شود صفحه اصلی سایت، پیشخوان وردپرس یا حتی یک بخش خاص از سایت کاملاً سفید نمایش داده شود. در این شرایط معمولاً هیچ پیام خطایی دیده نمی‌شود و کاربر نمی‌داند مشکل از کجاست.

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

خطای سفید شدن صفحه در وردپرس چیست؟

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

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

مهم‌ترین دلایل سفید شدن صفحه وردپرس

قبل از رفع مشکل، بهتر است با دلایل احتمالی آن آشنا شوید:

  • ناسازگاری یک افزونه با وردپرس یا سایر افزونه‌ها
  • مشکل یا خطا در قالب فعال
  • افزایش بیش از حد مصرف حافظه PHP
  • خطای نحوی یا برنامه‌نویسی در فایل‌های PHP
  • ناسازگاری نسخه PHP با قالب یا افزونه
  • ناقص بودن فایل‌های وردپرس
  • به‌روزرسانی ناموفق وردپرس، قالب یا افزونه
  • وجود کد مخرب یا تغییرات غیرمجاز در فایل‌ها
  • مشکل در تنظیمات سرور یا هاست

 رفع خطای سفید شدن صفحه در وردپرس؛ آموزش کامل

 

۱. فعال کردن حالت دیباگ وردپرس

یکی از بهترین روش‌ها برای پیدا کردن علت صفحه سفید، فعال کردن WordPress Debug Mode است. برای این کار باید فایل wp-config.php را ویرایش کنید.

کد زیر را در این فایل قرار دهید یا مقدار آن را تغییر دهید:

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

با این تنظیمات، خطاها در فایل لاگ ثبت می‌شوند و در بسیاری از مواقع می‌توانید علت اصلی مشکل را پیدا کنید.

فایل خطا معمولاً در مسیر زیر ایجاد می‌شود:

/wp-content/debug.log

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

۲. غیرفعال کردن افزونه‌های وردپرس

یکی از رایج‌ترین دلایل سفید شدن صفحه، افزونه ناسازگار است. اگر به پیشخوان دسترسی ندارید، می‌توانید از طریق File Manager هاست یا FTP وارد پوشه زیر شوید:

wp-content/plugins

نام پوشه plugins را موقتاً به چیزی مانند plugins-old تغییر دهید.

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

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

۳. بررسی قالب فعال

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

اگر به پیشخوان دسترسی ندارید، از طریق phpMyAdmin یا روش‌های مدیریتی هاست می‌توان قالب را تغییر داد. همچنین می‌توانید نام پوشه قالب فعال را در مسیر زیر تغییر دهید:

wp-content/themes

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

۴. افزایش حافظه PHP وردپرس

کمبود PHP Memory Limit نیز می‌تواند باعث سفید شدن صفحه شود؛ به‌خصوص در سایت‌هایی که از افزونه‌های سنگین، صفحه‌سازها یا امکانات پیچیده استفاده می‌کنند.

در برخی هاست‌ها می‌توان مقدار حافظه را در فایل wp-config.php افزایش داد:

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

البته مقدار قابل استفاده به محدودیت‌های سرور و تنظیمات هاست بستگی دارد. اگر تغییر این مقدار نتیجه نداد، بهتر است تنظیمات PHP هاست نیز بررسی شود.

۵. بررسی نسخه PHP

استفاده از نسخه نامناسب PHP می‌تواند باعث ناسازگاری قالب یا افزونه‌ها شود. اگر بلافاصله پس از تغییر نسخه PHP صفحه سفید شده است، احتمال ناسازگاری بسیار زیاد است.

نسخه PHP را از کنترل‌پنل هاست بررسی کنید و مطمئن شوید قالب و افزونه‌های سایت با آن سازگار هستند. همچنین استفاده از نسخه‌های قدیمی و منسوخ PHP از نظر امنیتی توصیه نمی‌شود.

۶. پاک کردن کش سایت و سرور

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

اگر از افزونه‌های کش، CDN یا سیستم کش سمت سرور استفاده می‌کنید، کش را پاک کنید. همچنین کش مرورگر را نیز پاک کرده و صفحه را در حالت Private/Incognito بررسی کنید.

۷. بررسی فایل‌های اصلی وردپرس

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

توجه: هنگام جایگزینی فایل‌های وردپرس، نباید پوشه wp-content یا فایل wp-config.php را بدون داشتن نسخه پشتیبان بازنویسی کنید.

۸. بررسی فایل .htaccess

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

سپس بررسی کنید آیا مشکل برطرف شده است یا خیر.

۹. بررسی لاگ خطا در هاست

اگر هیچ‌کدام از روش‌های بالا نتیجه نداد، Error Log هاست می‌تواند اطلاعات مهمی درباره علت مشکل ارائه دهد.

در این لاگ‌ها ممکن است خطاهایی مانند موارد زیر مشاهده کنید:

  • Fatal error
  • Allowed memory size exhausted
  • Call to undefined function
  • Cannot redeclare
  • Parse error

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

علت بروز خطای صفحه سفید وردپرس و 9 راه حل برای رفع آن - گنجه بلاگ

اگر فقط یک صفحه سفید است چه کنیم؟

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

در چنین شرایطی ابتدا بررسی کنید آیا صفحه دیگری از سایت به‌درستی باز می‌شود یا خیر. اگر سایر صفحات سالم هستند، لازم نیست تمام افزونه‌ها یا فایل‌های وردپرس را تغییر دهید؛ بهتر است ابتدا همان بخش مشکل‌دار را بررسی کنید.

چگونه از سفید شدن صفحه وردپرس جلوگیری کنیم؟

برای کاهش احتمال بروز این مشکل، چند نکته مهم را رعایت کنید:

  1. قبل از تغییرات مهم از سایت نسخه پشتیبان تهیه کنید.
  2. وردپرس، قالب و افزونه‌ها را به‌روز نگه دارید.
  3. افزونه‌های غیرضروری را حذف کنید.
  4. قالب و افزونه‌ها را از منابع معتبر دریافت کنید.
  5. قبل از تغییر نسخه PHP، سازگاری سایت را بررسی کنید.
  6. منابع هاست و حافظه PHP را متناسب با نیاز سایت انتخاب کنید.
  7. در صورت امکان، تغییرات مهم را ابتدا در محیط آزمایشی انجام دهید.

جمع‌بندی

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

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

اگر با وجود انجام این مراحل همچنان صفحه وردپرس سفید است، بررسی Error Log هاست و خطاهای PHP توسط یک متخصص وردپرس می‌تواند سریع‌تر علت اصلی را مشخص کند.