نمایش خطا در جوملا می‌تواند برای تشخیص صفحهٔ سفید یا اجرای ناقص مفید باشد، اما باید موقت و در محیط کنترل‌شده انجام شود. متن خطا و ردپای اجرا ممکن است مسیر فایل، نام افزونه یا اطلاعات داخلی را آشکار کند. در سایت عمومی، ابتدا لاگ خصوصی سرور و برنامه را بررسی کنید.
تفاوت نمایش خطا در جوملا با لاگ و Debug
Error Reporting سطح گزارش خطا را کنترل می‌کند. Debug System اطلاعات تشخیصی بیشتری تولید می‌کند و با گزینهٔ گزارش خطا یکسان نیست. نمایش خطا روی صفحه و ثبت خطا در فایل نیز دو رفتار متفاوت‌اند؛ تنظیمات خطای PHP این تفاوت را توضیح می‌دهد.
خاموش‌کردن نمایش، علت خطا را برطرف نمی‌کند. همچنین غیرفعال‌کردن کامل گزارش خطا ممکن است دادهٔ لازم برای پیگیری را کم کند. هدف، ثبت اطلاعات لازم بدون افشای آن برای بازدیدکننده است.
تنظیم در مدیریت جوملا
- با کاربر مجاز به System → Global Configuration بروید.
- در زبانهٔ Server، گزینهٔ Error Reporting را پیدا کنید.
- در محیط آزمایشی یا بازهٔ عیب‌یابی کنترل‌شده، Maximum را انتخاب کنید.
- در صورت نیاز به ردپای بیشتر، Debug System را در زبانهٔ System موقتاً فعال کنید.
- ذخیره کنید و فقط عملیاتی را که خطا می‌دهد بازتولید کنید.
System Default تنظیم گزارش را به پیش‌فرض محیط واگذار می‌کند و None گزارش خطا را خاموش می‌کند. این دو گزینه هم‌معنی نیستند. وضعیت امنِ سایت عمومی به تنظیمات مؤثر PHP و نحوهٔ ثبت لاگ نیز وابسته است.
وقتی پنل مدیریت باز نمی‌شود
مسئول مجاز سایت می‌تواند فایل configuration.php در ریشهٔ نصب درست را ویرایش کند. نام فایل و حروف آن را دقیق رعایت کنید. به‌جای عددهای مبهمِ آموزش قدیمی، مقدار مستند را در ویژگی موجود قرار دهید:
public $error_reporting = 'maximum';برای Debug، در صورت نیاز مقدار ویژگی موجود چنین است:
public $debug = true;خط تکراری ایجاد نکنید و نقل‌قول و نقطه‌ویرگول را حفظ کنید. راهنمای خطای جدی جوملا این روش را توضیح می‌دهد. فایل تنظیمات حاوی اطلاعات اتصال است؛ تصویر کامل آن را عمومی منتشر نکنید.
از متن خطا چه چیزی بخوانیم؟
زمان رخداد، نوع خطا، فایل و عملیات ایجادکننده را ثبت کنید. Fatal Error می‌تواند اجرا را متوقف کند، اما Warning، Notice یا Deprecated هم بی‌اهمیت نیستند؛ ممکن است مشکل سازگاری یا رفتار نادرست برنامه را نشان دهند.
وجود نام یک فایل در ردپای اجرا الزاماً ثابت نمی‌کند همان فایل علت اصلی است. تغییر اخیر PHP، افزونه، قالب یا محدودیت منابع را با لاگ تطبیق دهید. افزونه‌های هسته را برای امتحان دسته‌جمعی غیرفعال نکنید.
اگر چیزی نمایش داده نشد یا مشکل حل شد
بعضی خطاها پیش از اجرای تنظیمات جوملا رخ می‌دهند؛ در این حالت لاگ PHP یا وب‌سرور لازم است. خطای نحوی در خود configuration.php هم می‌تواند مانع اعمال تنظیم شود. سطح دسترسی فایل را بی‌دلیل عمومی نکنید.
پس از رفع علت، Debug را خاموش و Error Reporting را به وضعیت عادیِ مناسب محیط برگردانید. در سایت عمومی، نمایش جزئیات PHP باید خاموش و ثبت امن خطا در صورت نیاز فعال باشد. ابزارها و فایل‌های موقت عیب‌یابی را جمع‌آوری و مسیرهای اصلی سایت را بررسی کنید.
مطالعهٔ مرتبط
بازبینی فنی: ۱۳ آبان ۱۴۰۵. تاریخ انتشار اولیه و نشانی قبلی حفظ شده‌اند.
