learn

رفع صفحه سفید وردپرس؛ تشخیص خطای PHP، قالب و افزونه

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

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

اطلاعات لازم برای رفع صفحه سفید وردپرس

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

ابتدا Recovery Mode را بررسی کنید

وردپرس در برخی خطاهای بحرانی ایمیلی حاوی لینک حالت بازیابی برای مدیر می‌فرستد. این لینک می‌تواند ورود برای بررسی افزونه یا قالب مشکل‌دار را ممکن کند. لینک را عمومی نکنید. نرسیدن ایمیل به معنی نبود خطای PHP نیست؛ ممکن است ارسال ایمیل نیز در همان خطا مختل شده باشد.

لاگ را بخوانید، خطا را عمومی نکنید

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

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

تعریف موجود را ویرایش کنید، نه اینکه همان ثابت را دوباره اضافه کنید. کد پیش از خط پایان ویرایش wp-config.php قرار می‌گیرد. فایل debug.log ممکن است اطلاعات خصوصی داشته باشد؛ دسترسی عمومی آن را محدود کنید و پس از تشخیص، دیباگ را خاموش کنید.

افزونه و قالب را هدفمند بررسی کنید

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

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

حافظه و آزمون نتیجه

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

مطالعهٔ مرتبط

بازبینی فنی: ۱۳ آبان ۱۴۰۵. تاریخ انتشار اولیه و نشانی قبلی حفظ شده‌اند.

مطالب مرتبط

ارسال نظر

فهرست مطالب