صفحه سفید جوملا یک نشانه است و علت واحدی ندارد. ممکن است اجرای PHP متوقف شده باشد، قالب خروجی ندهد یا درخواست در لایهٔ سرور خطا بخورد. پیش از تغییر تنظیمات، مشخص کنید مشکل کجا و از چه زمانی شروع شده است.
دامنهٔ مشکل صفحه سفید جوملا را مشخص کنید
آدرس دقیق و زمان رخداد را یادداشت کنید. فقط صفحهٔ اصلی سفید است یا مقاله‌ها و مدیریت هم باز نمی‌شوند؟ وضعیت پاسخ HTTP را بررسی کنید؛ صفحهٔ خالی با پاسخ 200 الزاماً همان مسئلهٔ خطای 500 نیست.
آخرین تغییر را پیدا کنید: ارتقای PHP، نصب افزونه، تغییر قالب، جابه‌جایی سایت یا ویرایش فایل. چند تغییر هم‌زمان انجام ندهید؛ در غیر این صورت معلوم نمی‌شود کدام اقدام علت را برطرف کرده است.
از لاگ شروع کنید، نه ویرایش index.php
لاگ PHP، وب‌سرور و جوملا را در بازهٔ رخداد بخوانید. فایل و خط ذکرشده نقطهٔ شروع بررسی‌اند، اما همیشه علت اصلی در همان فایل نیست. قبل از اشتراک‌گذاری گزارش، اطلاعات محرمانه و مسیرهای غیرضروری را حذف کنید.
در محیط کنترل‌شده می‌توان Error Reporting را موقتاً روی Maximum و در صورت نیاز Debug را فعال کرد. راهنمای رسمی خطای جدی جوملا روش آن را توضیح می‌دهد. در سایت عمومی، ثبت خصوصی خطا بر نمایش جزئیات به بازدیدکننده اولویت دارد.
افزودن کد تصادفی به index.php، استفاده از نقل‌قول فارسی در کد یا مخفی‌کردن Warningها درمان خطا نیست. تغییر مستقیم فایل هسته می‌تواند مشکل جدید ایجاد کند و در به‌روزرسانی بعدی از بین برود.
سازگاری PHP و محدودیت منابع
نسخهٔ PHP را با نیازمندی‌های همان نسخهٔ جوملا و افزونه‌ها تطبیق دهید. نسخهٔ خط فرمان ممکن است با PHP وب متفاوت باشد؛ تنظیم مؤثر سایت را بررسی کنید.
اگر لاگ از کمبود حافظه، پایان زمان اجرا یا پرشدن دیسک خبر می‌دهد، ابتدا علت مصرف یا محدودیت را مشخص کنید. افزایش بی‌حد حافظه و زمان اجرا راه‌حل عمومی نیست. بازگشت موقت PHP نیز فقط به نسخهٔ سازگار و پشتیبانی‌شده و با هماهنگی مسئول محیط انجام شود.
افزونه و قالب را هدفمند بررسی کنید
اگر شواهد به افزونهٔ ثالث تازه‌نصب‌شده اشاره دارد و مدیریت باز می‌شود، همان افزونه را موقتاً غیرفعال و نتیجه را بررسی کنید. کامپوننت هستهٔ com_content یا همهٔ پلاگین‌ها را دسته‌جمعی تغییر نام ندهید.
اگر پنل باز نمی‌شود، مسئول فنی می‌تواند با تطبیق دقیق نوع و شناسهٔ افزونه، روش بازیابی مستند را اجرا کند. ویرایش کورکورانهٔ جدول‌ها یا انتخاب رکورد مشابه، مشکل دیگری می‌سازد.
برای تشخیص قالب، از یک قالب سالم و سازگار با نسخهٔ نصب‌شده استفاده کنید. Protostar مربوط به جوملاهای قدیمی است و انتخاب عمومی برای نسخه‌های جدید نیست. استایل پیش‌فرض و انتساب منوها را جداگانه بررسی کنید؛ ممکن است فقط یک صفحه استایل متفاوتی داشته باشد.
فایل ناقص و قواعد وب‌سرور
پس از ارتقای نیمه‌تمام، وضعیت فایل‌ها و دیتابیس را از مسیر رسمی به‌روزرسانی جوملا بررسی کنید. فایل نسخه‌ای متفاوت را برای تعمیر روی سایت کپی نکنید.
اگر تغییر اخیر مربوط به .htaccess است، قواعد تغییرکرده را با پیکربندی متناسب وب‌سرور مقایسه کنید. خالی‌کردن کامل فایل ممکن است کنترل دسترسی، بازنویسی و ریدایرکت‌های لازم را حذف کند. عیب‌یابی را روی نسخهٔ آزمایشی یا با تغییر محدود و قابل بازگشت انجام دهید.
پس از رفع مشکل
صفحهٔ اصلی، چند مسیر داخلی، ورود مدیریت و فرم‌های مهم را بررسی کنید. تنظیمات تشخیصی و ابزارهای موقت را جمع کنید؛ نمایش عمومی خطا باید خاموش شود. علت و اقدام مؤثر را ثبت کنید تا مشکل با تغییر بعدی دوباره تکرار نشود.
مطالعهٔ مرتبط
بازبینی فنی: ۱۳ آبان ۱۴۰۵. تاریخ انتشار اولیه و نشانی قبلی حفظ شده‌اند.
