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

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

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

در این مقاله از فرتاک سرور روش‌های عملی برای فعال‌سازی دیباگ در وردپرس را به شما آموزش خواهیم داد. همچنین بهترین شیوه‌ها برای دیباگ وردپرس را ارائه خواهیم کرد تا عملکرد سایت شما بهینه‌تر شود

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

چگونه دیباگ وردپرس را فعال کنیم؟

برای فعال کردن دیباگ در وردپرس، باید چند مرحله ساده را دنبال کنید. اولین قدم برای فعال کردن دیباگ، ویرایش فایل wp-config.php است که در ریشه نصب وردپرس شما قرار دارد. برای این کار:

ابتدا به کمک آموزش ورود به سی پنل وارد هاست خود شوید. (در این آموزش از کنترل پنل سی پنل استفاده می شود). بر روی file manager کلیک کنید.

در manage  File در مسیر روت سایت (در صورتی که سایت اصلی می باشد می بایست public_html را انتخاب نمایید.)

فایل wp-config.php را پیدا کرده و بر روی آن راست کلیک و سپس گزینه Edit را انتخاب کنید. جهت درج کدهای دیباگ می توانید از ویرایشگر سی پنل استفاده نموده و فایل خود را ویرایش کنید.

در پاپ آپ ظاهر شده مجدد بر روی Edit کلیک کنید. قطعه کد زیر را در این فایل اضافه کنید.

define('WP_DEBUG', true);

در صورتی که این قطعه کد از قبل وجود داشت بررسی کنید که روی حالت true قرار داشته باشد. در صورت درج عبارت false حالت دیباگ وردپرس غیرفعال خواهد شد.

کد های دیباگ باید قبل از کامنت /* That’s all, stop editing! Happy blogging. */ در فایل wp-config.php درج شود.

پس از اضافه کردن کدهای مورد نظر، فایل wp-config.php را ذخیره کنید و از ویرایشگر خارج شوید.

روش عیب یابی سایت وردپرسی

پس از فعال کردن دیباگ وردپرس اگر مشکلی در سایت شما وجود داشته باشد، خطاها و هشدارها در فایل debug.log ثبت خواهند شد. برای مشاهده این فایل در مسیر نصب وردپرس به پوشه wp-content بروید.

فایل debug.log را باز کنید تا جزئیات خطاها را مشاهده کنید.

در این خصوص تغییراتی در ارتباط با دیتابیس ایجاد نموده ایم تا خطا در این فایل درج شود.

نکات مهم: پس از رفع مشکلات، حتماً دیباگ را غیرفعال کنید. برای این کار کافی است مقدار true را به false تغییر دهید:

define('WP_DEBUG', false);

لطفاً توجه داشته باشید که آدرس فایل debug.log به نحوه تنظیمات سایت شما بستگی دارد. به عنوان مثال، اگر سایت شما در یک زیرشاخه نصب شده باشد، آدرس اصلی ممکن است به این صورت باشد:

https://yoursitename.com/your-subdirectory-name/wp-content/debug.log

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

اهمیت بررسی فایل‌های لاگ سرور

• بررسی این فایل‌ها می‌تواند به شناسایی مشکلاتی که در سطح سرور رخ می‌دهند کمک کند.
• سرورهای وب معمولاً فایل‌های لاگی دارند که می‌توانند اطلاعات مفیدی درباره خطاها ارائه دهند.

در ادامه به چند روش فعال سازی دیباگ وردپرس اشاره می کنیم.

انواع debug وردپرس

در وردپرس، دیباگ به چندین روش و ابزار مختلف انجام می‌شود. در ادامه به معرفی انواع مختلف دیباگ در وردپرس می‌پردازیم:

• ثابت‌های دیباگ در PHP
• استفاده از تابع دیباگ
• دو افزونه دیباگ محبوب
• استفاده از Xdebug
• بررسی فایل‌های لاگ سرور
• بررسی تنظیمات PHP

ثابت‌های دیباگ وردپرس در PHP

ثابت‌های دیباگ در PHP ابزارهای مفیدی هستند که به توسعه‌دهندگان کمک می‌کنند تا خطاها و مشکلات را شناسایی و رفع کنند. در زیر به مهم‌ترین ثابت‌های دیباگ در PHP اشاره می‌کنیم:

ثابت WP_DEBUG

 ثابت WP_DEBUG در وردپرس یک ابزار مهم برای توسعه‌دهندگان است که به آن‌ها کمک می‌کند تا خطاها و هشدارهای موجود در کد را شناسایی کنند.

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

define('WP_DEBUG', true);

ثابت WP_DEBUG_LOG

ثابت WP_DEBUG_LOG در وردپرس به شما این امکان را می‌دهد که خطاها و هشدارهای موجود در سایت خود را در یک فایل لاگ ذخیره کنید. وقتی این ثابت را به true تنظیم می‌کنید، اطلاعات مربوط به اشکالات به جای نمایش در صفحه، در فایلی به نام debug.log در پوشه wp-content ذخیره می‌شود.

این کار به توسعه‌دهندگان کمک می‌کند تا بدون مزاحمت برای کاربران، مشکلات را شناسایی و رفع کنند. در نتیجه، می‌توانید به راحتی به تاریخچه خطاها دسترسی داشته باشید و سایت خود را بهبود ببخشید.

define( 'WP_DEBUG_LOG', true );

ثابت WP_DEBUG_DISPLAY

ثابت WP_DEBUG_DISPLAY در وردپرس تعیین می‌کند که آیا خطاها و هشدارها به صورت مستقیم روی صفحه نمایش داده شوند یا خیر. وقتی این ثابت را به true تنظیم می‌کنید ، هر گونه خطا در سایت به کاربران نشان داده می‌شود که ممکن است تجربه کاربری را تحت تأثیر قرار دهد.

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

define( 'WP_DEBUG_DISPLAY', false );

ثابت SCRIPT_DEBUG

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

define( 'SCRIPT_DEBUG', true );

ثابت SAVEQUERIES

ثابت SAVEQUERIES در وردپرس به شما این امکان را می‌دهد که تمام درخواست‌های پایگاه داده‌ای که در طول بارگذاری یک صفحه انجام می‌شود را ذخیره کنید.

وقتی این ثابت را بر روی true تنظیم کنید، تمامی کوئری‌های پایگاه داده ذخیره می‌شوند و شما می‌توانید آرایه $wpdb->queries را برای مشاهده و بررسی کوئری‌ها چاپ کنید.

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

define( 'SAVEQUERIES', true );

این ثابت‌ها ابزارهای قدرتمندی برای شناسایی و رفع مشکلات در برنامه‌نویسی PHP هستند و استفاده صحیح از آن‌ها می‌تواند به بهبود عملکرد و کیفیت کد کمک کند.

استفاده از توابع دیباگ

• error_log (): می‌توانید از این تابع برای ثبت پیام‌ها یا متغیرها در فایل لاگ PHP استفاده کنید.
• var_dump(): برای نمایش محتوای متغیرها و آرایه‌ها.

افزونه‌های دیباگ

• Query Monitor: افزونه‌ای قدرتمند که اطلاعات دقیقی درباره کوئری‌های پایگاه داده، زمان بارگذاری، و خطاها ارائه می‌دهد.
• Debug Bar: نوار دیباگی به نوار ابزار مدیریت اضافه می‌کند و اطلاعاتی درباره خطاها و کوئری‌ها نمایش می‌دهد.

استفاده از Xdebug

• Xdebug یک افزونه PHP است که به شما اجازه می‌دهد تا به‌طور موثری کد PHP را دیباگ کنید.
• با استفاده از Xdebug می‌توانید نقاط توقف (breakpoints) تعیین کنید و متغیرها را بررسی کنید..

بررسی تنظیمات PHP

• اطمینان حاصل کنید که تنظیمات PHP به‌درستی پیکربندی شده‌اند.
• می‌توانید با استفاده از تابع phpinfo() اطلاعات مربوط به نسخه PHP و تنظیمات آن را مشاهده کنید.

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

امیدواریم این مقاله برای شما مفید بوده باشد و بتوانید با فعال سازی دیباگ وردپرس و بررسی فایل ارور لاگ سایت وردپرسی خود مشکلات وب‌سایت را به راحتی شناسایی و رفع کنید!

بدانید صاحبان وبسایت های وردپرسی بهتر است از هاست وردپرس استفاده کنند که بیشترین سازگاری را با این CMS دارد و شاهد کمترین خاطاها خواهند بود چراکه این هاست مطابق با نیازهای سایت های وردپرسی کانفیگ شده است.