نحوه نمایش خطاهای وردپرس
اصولا وقتی در سایت های وردپرسی چیزی درست کار نمی کند، یک خطای PHP در پشت صحنه رخ داده است که روی صفحه قابل مشاهده نیست. این اتفاق ممکن است در هر قالب یا افزونه‌ای رخ دهد. برای اینکه بتوانید ریشه مشکل را پیدا کنید، باید حالت اشکال زدایی وردپرس را فعال کنید
در ادامه این مطلب در سایت تم فارس 2 روش برای فعال کردن حالت اشکال زدایی را آموزش می دهیم پس تا انتها با ما همراه باشید.
روش 1: فعال‌سازی دستی اشکال‌زدایی از طریق فایل wp-config.php
این روش کنترل بیشتری در اختیار شما می‌گذارد و روش رسمی و استاندارد فعال‌سازی اشکال‌زدایی در وردپرس محسوب می‌شود. در این روش باید فایل تنظیمات اصلی وردپرس را ویرایش کنید.
هشدار: فایل wp-config.php شامل تنظیمات مهم سایت از جمله اطلاعات دیتابیس است. هر گونه خطای کوچک در این فایل می‌تواند سایت شما را از دسترس خارج کند. قبل از هر تغییری حتماً از آن نسخه پشتیبان بگیرید.
مراحل کار:
- با استفاده از FTP یا فایل منیجر هاست خود وارد فایل‌های سایت شوید.
اگر از هاست سی پنل استفاده می‌کنید، وارد File Manager شوید و در مسیر public_html فایل wp-config.php را پیدا کنید. کافی است روی آن کلیک راست کرده و گزینه Edit را بزنید. - فایل wp-config.php را در ریشه سایت (محل پوشه‌های wp-content و wp-admin) پیدا کنید.
- یک نسخه پشتیبان از آن دانلود کنید.
- فایل را باز کرده و خط زیر را پیدا کنید:
/* .That's all, stop editing! Happy blogging */
5. قبل از این خط، کدهای زیر را قرار دهید:
؛define('WP_DEBUG', true)
؛define('WP_DEBUG_LOG', true)
؛define('WP_DEBUG_DISPLAY', false)
توضیح عملکرد کدها:
- WP_DEBUG حالت اشکال‌زدایی را فعال می‌کند.
- WP_DEBUG_LOG باعث می‌شود تمام خطاها در فایل debug.log ذخیره شوند.
- WP_DEBUG_DISPLAY مانع نمایش خطاها روی صفحه سایت می‌شود، که برای امنیت سایت بسیار مهم است.
پس از ذخیره فایل و آپلود آن روی سرور، اشکال‌زدایی فعال می‌شود.
اگر هدف شما دیدن خطاها روی صفحه باشد، کافی است مقدار WP_DEBUG_DISPLAY را true قرار دهید. البته این کار روی سایت اصلی توصیه نمی‌شود.
یافتن فایل گزارش خطا
بعد از فعال کردن اشکال‌زدایی و ایجاد دوباره مشکل، وردپرس یک فایل گزارش در این مسیر ایجاد می‌کند:
wp-content/debug.log
این فایل را با یک ویرایشگر متن باز کنید و خطاهای ثبت‌شده را بررسی کنید. این خطاها معمولاً دلیل دقیق مشکل را مشخص می‌کنند، مثل تداخل افزونه‌ها یا خطاهای قالب.
غیرفعال کردن اشکال‌زدایی
برای خاموش کردن حالت اشکال‌زدایی، کافی است مقدار WP_DEBUG را روی false قرار دهید:
;define('WP_DEBUG', false)
این کار باعث می‌شود وردپرس دوباره به حالت عادی برگردد و دیگر خطاها ثبت یا نمایش داده نشوند.
نکته مهم: حالت WP_DEBUG یک ابزار مخصوص توسعه و عیب‌یابی است. فعال نگه‌داشتن آن روی سایت اصلی می‌تواند باعث نمایش پیام‌های خطا به کاربران و حتی افشای اطلاعات حساس سرور شود. بهتر است همیشه روی سایت آزمایشی اشکال‌زدایی انجام دهید، و اگر مجبور بودید روی سایت اصلی فعال کنید، بلافاصله پس از اتمام عیب‌یابی آن را غیرفعال کنید.
روش 2: استفاده از افزونه WP Debugging
دومین روش نحوه فعال کردن نمایش خطا در سایت وردپرسی استفاده از افزونه است و مختص آن افرادی است که با ویرایش فایل ها راحت نیستند. با استفاده از افزونه WP Debugging و انجام مراحل زیر می توانید خطاهای سایت را فعال کنید.
- وارد داشبورد وردپرس شوید.
- به مسیر افزونه‌ها > افزودن افزونه جدید بروید.
- در قسمت جستجو، عبارت WP Debugging را وارد کنید.
- افزونه را نصب و فعال کنید.
با فعال‌سازی افزونه، WP_DEBUG به‌طور خودکار فعال می‌شود و خطاها در یک فایل گزارش ذخیره می‌شوند، بدون اینکه به‌صورت عمومی در سایت نمایش داده شوند. برای مشاهده گزارش خطاها، هنگامی که وارد داشبورد هستید، از منوی بالا گزینه Debug Quick Look را پیدا کرده و View File را انتخاب کنید تا فایل گزارش را ببینید.
همچنین برای غیرفعال کردن حالت اشکال زدایی کافی است افزونه WP Debugging را غیرفعال کنید.
سخن پایانی
فعال‌سازی حالت اشکال‌زدایی در وردپرس یکی از ابزارهای مهم برای پیدا کردن مشکلات سایت و رفع خطاهاست که دو روش استاندارد، یکی دستی از طریق فایل wp-config.php و دیگری با استفاده از افزونه WP Debugging، به شما آموزش داده شد. با رعایت نکات امنیتی و بک آپ گیری، می‌توانید به راحتی مشکلات سایت خود را شناسایی و رفع کنید و اینکه همیشه به یاد داشته باشید که بعد از اتمام کار آن را غیرفعال کنید
به پایان این مطلب آموزشی با موضوع نحوه نمایش خطاهای وردپرس رسیدیم. امیدواریم برای شما مفید بوده باشد و همچنین پیشنهاد میکنیم از سایر مطالب زیر نیز دیدن کنید.
مطالب مرتبط پیشنهادی: