چرا سایت وردپرسی بعد از آپدیت سفید شد؟ علت‌ها و راهکارهای عملی رفع صفحه سفید

سفید شدن ناگهانی سایت وردپرسی یا مواجهه با پیام «یک خطای مهم در این وب‌سایت رخ داده است» بلافاصله پس از به‌روزرسانی هسته وردپرس، افزونه‌ها یا قالب، یکی از رایج‌ترین مشکلات مدیران سایت است. این حالت که به اصلاح «صفحه سفید مرگ» (White Screen of Death یا WSOD) نامیده می‌شود، به‌دلیل متوقف شدن اجرای کدهای PHP رخ می‌دهد. در این مقاله به بررسی دقیق علل فنی این اتفاق و ارائه راهکارهای عملی برای بازگرداندن سریع سایت می‌پردازیم.

صفحه سفید مرگ (WSOD) چیست و چرا اتفاق می‌افتد؟

پاسخ کوتاه: صفحه سفید مرگ در وردپرس زمانی ظاهر می‌شود که یک خطای سطح بالای PHP (از نوع Fatal Error یا Memory Exhaustion) رخ دهد و سیستم برای امنیت بیشتر یا به دلیل عدم تنظیم نمایش خطاها، از اجرای ادامه کدها جلوگیری کرده و صفحه‌ای کاملاً خالی یا همراه با یک پیام خطای عمومی به کاربر نشان دهد.

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

۴ دلیل اصلی سفید شدن سایت بعد از آپدیت

به‌طور کلی بیش از ۹۰ درصد دلایل سفید شدن صفحه وردپرس پس از آپدیت، به یکی از چهار عامل زیر مربوط می‌شود:

۱. تداخل افزونه‌ها یا قالب با نسخه جدید وردپرس

اگر افزونه‌ای روی سایت فعال باشد که با نسخه جدید وردپرس سازگار نشده باشد، فراخوانی توابع قدیمی یا تغییریافته باعث بروز خطای عدم وجود تابع (Fatal error: Call to undefined function) می‌شود. این مسئله به‌ویژه زمان به‌روزرسانی‌های اصلی وردپرس (مثلاً از نسخه ۶.۳ به ۶.۴) بسیار شایع است.

۲. عدم هماهنگی نسخه PHP هاست

آپدیت‌های جدید وردپرس و افزونه‌های معتبر معمولاً به نسخه‌های بالاتر PHP (مانند PHP 8.1 یا 8.2) نیاز دارند. اگر هاست شما از نسخه‌های قدیمی مثل PHP 7.4 استفاده کند، یا برعکس، افزونه‌ای قدیمی داشته باشید که روی PHP 8.2 دچار خطای شکستگی کد شود، سایت کاملاً سفید خواهد شد.

۳. کمبود میزان حافظه اختصاصی PHP (Memory Limit)

فرایند به‌روزرسانی به حافظه بیشتری نیاز دارد. اگر میزان memory_limit در فایل تنظیمات PHP سرور کم باشد (مثلاً ۶۴ یا ۱۲۸ مگابایت)، سیستم هنگام آپدیت با خطای اختصاص حافظه (Allowed memory size exhausted) مواجه شده و متوقف می‌شود.

۴. ناقص انجام شدن فرایند به‌روزرسانی (Corrupted Files)

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

جدول تشخیصی: منشأ خطا بر اساس نشانه‌ها

آموزش گام‌به‌گام عیب‌یابی و رفع مشکل

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

برای حل این مشکل نیازی به پاک کردن کامل سایت نیست. مراحل زیر را به ترتیب اجرا کنید:

1. فعال‌سازی حالت عیب‌یابی (WP_DEBUG):
   
   وارد کنترل پنل هاست (cPanel یا DirectAdmin) یا اکانت FTP شوید. به مسیر اصلی نصب وردپرس (public_html) رفته و فایل wp-config.php را ویرایش کنید.
   خط زیر را پیدا کنید:
   define( ‘WP_DEBUG’, false );

   آن را به عبارت زیر تغییر داده و ذخیره کنید:

   define( ‘WP_DEBUG’, true );
   define( ‘WP_DEBUG_LOG’, true );
   define( ‘WP_DEBUG_DISPLAY’, true );

   حالا صفحه سفید سایت را رفرش کنید. به‌جای صفحه سفید، متن خطایی شامل مسیر دقیق فایل و شماره خطای ایجادکننده مشکل ظاهر می‌شود. (مثلاً مسیر یک افزونه خاص در wp-content/plugins/).

2. غیرفعال‌سازی افزونه‌ها بدون دسترسی به مدیریت:
   
   اگر خطای نمایش‌داده‌شده مربوط به یک افزونه مشخص بود یا اصلاً خطایی نمایش داده نشد، به مسیر wp-content در هاست بروید.
   پوشه plugins را به plugins-old تغییر نام دهید. با این کار تمام افزونه‌ها غیرفعال می‌شوند. اگر سایت باز شد، مشکل از افزونه‌ها است. پوشه را به حالت اول بازگردانید و این‌بار پوشه‌های تک‌تک افزونه‌های داخل آن را تغییر نام دهید تا افزونه خرابکار شناسایی شود.
3. افزایش میزان حافظه PHP:
   
   در صورتی که خطا از نوع Allowed memory size exhausted باشد، فایل wp-config.php را باز کرده و کد زیر را قبل از خط /* That's all, stop editing! Happy publishing. */ قرار دهید:
   define( ‘WP_MEMORY_LIMIT’, ‘256M’ );

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

4. تغییر قالب فعال به قالب پیش‌فرض:
   
   به مسیر wp-content/themes بروید. پوشه قالب فعال خود را تغییر نام دهید (مثلاً نام آن را my-theme-old بگذارید). وردپرس به‌طور خودکار به یکی از قالب‌های پیش‌فرض مانند Twenty Twenty-Four سوییچ می‌کند.
5. آپدیت دستی هسته وردپرس (Manual Update):
   
   اگر فرایند آپدیت وردپرس ناقص مانده باشد، آخرین نسخه وردپرس را از سایت رسمی دانلود کرده و فایل زیپ را باز کنید. تمام فایل‌ها و پوشه‌ها به جز پوشه wp-content و فایل wp-config.php را در هاست خود در مسیر اصلی جایگزین (Replace) کنید.

راهکارهای پیشرفته برای جلوگیری از بروز مجدد خطا

برای اینکه سایت شما پس از آپدیت‌های بعدی دچار اختلال نشود، رعایت نکات تخصصی زیر در زیرساخت سایت ضروری است:

• استفاده از محیط Staging (استیجینگ): قبل از آپدیت مستقیم روی سایت اصلی، یک نسخه کپی روی استیجینگ بسازید و آپدیت‌ها را آنجا تست کنید.
• بررسی سازگاری PHP قبل از ارتقا: قبل از تغییر نسخه PHP در cPanel (از بخش Select PHP Version)، مطابقت تمام افزونه‌های کلیدی با نسخه جدید PHP را چک کنید.
• پاکسازی حافظه کش سرور (OPcache): گاهی اوقات بعد از به‌روزرسانی دستی کدهای PHP، سرور به‌دلیل فعال بودن سیستم کشینگ OPcache، کدهای قدیمی را اجرا می‌کند. در صورت امکان از طریق هاست یا افزونه‌های سروری OPcache را یکبار خالی کنید.
• استفاده از ابزارهای آنلاین توسعه: در صورتی که نیاز به بررسی دقیق‌تر منطق برنامه‌نویسی یا کدهای سفارشی سایت دارید، ابزارهای موجود در مجموعه اسنیپت‌های برنامه‌نویسی می‌توانند در تست کدهای کاربردی به شما کمک کنند.

عیب‌یابی سریع (مشکلات خاص)

پرسش‌های متداول