آموزش فعال سازی دیباگ وردپرس (حالت اشکال زدایی) با افزونه و بدون افزونه

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

بیشتر بخوانید: بهترین افزونه های دیباگ کردن سایت وردپرسی | افزونه عیب یابی وردپرس

حالت دیباگ مود چیست؟

حالت دیباگ مود (Debug Mode) یک ابزار یا قابلیتی است که در توسعه نرم‌افزار، سیستم‌های عامل، وب‌سایت‌ها و حتی سخت‌افزارها برای عیب‌یابی و اشکال‌زدایی (Debugging) به کار می‌رود. به طور کلی، دیباگ (Debug) به معنای فرآیند پیدا کردن و برطرف کردن خطاها یا “باگ‌ها” (Bugs) در کد یک برنامه یا سیستم است.

حالت دیباگ مود معمولاً ویژگی‌های زیر را فراهم می‌کند:

1. نمایش خطاها و هشدارها: به جای نمایش یک پیام کلی خطا به کاربر نهایی، جزئیات بیشتری از خطاها، هشدارها و اعلان‌های فنی (مانند خطاهای PHP در وردپرس یا اطلاعات لاگ) را به توسعه‌دهنده نشان می‌دهد.
2. امکان بررسی وضعیت داخلی برنامه: در ابزارهای برنامه‌نویسی (Debugger)، این حالت به توسعه‌دهنده اجازه می‌دهد تا اجرای برنامه را به صورت گام به گام (Step-by-step) دنبال کند، مقادیر متغیرها را در زمان اجرا مشاهده کند، و نقاط توقف (Breakpoints) برای متوقف کردن برنامه در یک خط کد خاص تعیین کند.
3. تسهیل ردیابی مشکل: با فراهم کردن اطلاعات دقیق‌تر، به توسعه‌دهنده کمک می‌کند تا دقیقاً متوجه شود که مشکل در کدام قسمت از کد یا سیستم رخ داده است.

مثال: در وردپرس: با فعال کردن WP_DEBUG در فایل wp-config.php، خطاها و هشدارهای PHP در سایت نمایش داده شده یا در یک فایل لاگ ذخیره می‌شوند تا توسعه‌دهنده بتواند مشکلات افزونه‌ها یا قالب‌ها را پیدا کند.

 بیشتر بخوانید: افزونه های هوش مصنوعی در وردپرس | مطالب در مورد هوش مصنوعی

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

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

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

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

آموزش فعال سازی دیباگ در وردپرس

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

بیشتر بخوانید: آموزش افزودن تایید هویت دو مرحله ای وردپرس

1- فعال سازی دیباگ وردپرس با افزونه wp debugging

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

برای انجام اینکار، در ابتدا وارد پیشخوان وردپرس خود شوید و سپس از بخش “افزونه ها” روی گزینه “افزودن” کلیک نمائید. سپس در باکس بالای صفحه نام افزونه را جستجو نمائید.

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

پس از فعال شدن افزونه، از بخش “ابزارها” روی گزینه ” wp debugging” کلیک کنید. سپس کافیست تیک کنار گزینه “Set  WP_DEBUG to true”  را بزنید و در نهایت روی دکمه ذخیره تغییرات کلیک نمائید.

فراموش نکنید که پس از اتمام، حالت اشکال زدایی را غیرفعال کنید.

بیشتر بخوانید: نحوه غیرفعال کردن نظرات در وردپرس | بستن نظرات کاربران در مطالب سایت وردپرسی 

2- فعال سازی خطایاب وردپرس به صورت دستی

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

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

سپس فایل را با استفاده از ویرایشگر کد برای ویرایش فایل باز کنید. شما می توانید از ویرایشگر هایی مانند نوت پد استفاده کنید. حال وارد صفحه ویرایشگر فایل شوید و صفحه را به سمت پایین اسکرول نمائید. سپس کدهای زیر را درست قبل از خط “That’s all, stop editing! Happy publishing” اضافه کنید:

define( 'WP_DEBUG', true);

define( 'WP_DEBUG_LOG', true); 

هنگامی که فایل خود را تغییر دادید، کافی است فایل را مجدداً در سرور خود آپلود نمائید. در واقع شما باید همانند قبل وارد روت هاست خود شوید و سپس فایل فایل اصلی را با این فایل اصلاح شده جایگزین کنید. با انجام این مراحل، حالت اشکال زدایی خود را فعال کرده و یک فایل debug.log ایجاد می کنید که در آن خطاهای شما ذخیره می شود.

برای غیرفعال کردن حالت اشکال زدایی پس از اتمام کار، مراحل فعال کردن را تکرار کنید، فقط این بار، یا به طور کامل کد اضافه شده قبلی را حذف کنید یا آن را به صورت زیر تغییر دهید:

define( 'WP_DEBUG', false);

نکته: مشاهده حالت اشکال زدایی وردپرس

اگر از افزونه برای فعال کردن دیباگ وردپرس استفاده کردید، می توانید نتایج را در پیشخوان وردپرس خود مشاهده کنید. برای اینکار، وارد پنل مدیریتی خود شوید و سپس از بخش افزونه، روی گزینه “مشاهده فایل” کلیک کنید. سپس در آنجا می توانید نتایج خطاها را مشاهده نمائید. همچنین اگر شما از کدنویسی برای فعال کردن debug در وردپرس استفاده کرده اید، نتایج را می توانید از طریق هاست و در مسیر  public_html/wp-content/debug.logمشاهده نمائید.

بیشتر بخوانید: آموزش اضافه کردن Font Awesome به وردپرس | طریقه استفاده از فونت آیکون ها در وردپرس چگونه است؟

معرفی بهترین افزونه های دیباگ وردپرس

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

– افزونه فعال سازی دیباگ وردپرس Debug

همانطور که از نام آن پیداست، Debug یک افزونه رایگان اشکال زدایی وردپرس است که تمام خطاهای وب سایت شما را نشان می دهدد. همچنین به شما این امکان را می دهد تا از فایل wp-config.php خود نسخه پشتیبان تهیه کنید. برخی از ویژگی های این افزونه عبارت است از:

• استفاده ساده و آسان
• فعال کردن گزارش خطا
• فعال سازی اشکال زدایی اسکریپت
• ایجاد فایل لاگ خطا
• نمایش تمام خطاهای وب سایت
• و بسیاری از ویژگی های دیگر

بیشتر بخوانید: چگونه سایت وردپرس خود را در حالت تعمیر و نگهداری قرار دهیم

– افزونه فعال سازی دیباگ وردپرس WP Debugging

اگر می خواهید متوجه شوید که مشکل فایل wp-config.php شما چیست، می توانید افزونه WP Debugging را امتحان کنید. این یک افزونه ساده و رایگان است که پس از نصب و فعال کردن افزونه شروع به نشان دادن گزارش های خطا به شما می کند. برخی از ویژگی های این افزونه عبارت است از:

• نمایش خطاهای اشکال زدایی
• دارای چندین قانون اشکال زدایی
• بازیابی خودکار تنظیمات
• فیلترهای رفع اشکال یکپارچه
• و بسیاری از ویژگی های دیگر

بیشتر بخوانید: ایجاد پیشنهاد شگفت انگیز در ووکامرس

– افزونه فعال سازی دیباگ وردپرس Debug Bar

افزونه Debug Bar یک افزونه خطایاب وردپرس است که یک نوار اشکال زدایی را به پیشخوان وردپرس شما اضافه می کند. در این منوی جدید، لاگ های خطا، حافظه پنهان، پرس و جوها و سایر داده هایی را مشاهده خواهید کرد که برای اشکال زدایی خطاها بسیار مفید هستند. برخی از ویژگی های این افزونه عبارت است از:

• ساده و آسان برای استفاده
• نمایش اطلاعات اشکال زدایی
• ردیابی هشدارهای PHP
• و بسیاری از ویژگی های دیگر

– افزونه فعال کردن دیباگ وردپرس Query Monitor

افزونه Query Monitor یک ابزار ضروری و رایگان برای توسعه‌دهندگان وردپرس است که به عنوان یک پنل ابزار عیب‌یابی (Developer Tools Panel) قدرتمند عمل می‌کند. این افزونه به شما کمک می‌کند تا عملکرد داخلی هر صفحه از سایت وردپرسی خود را زیر نظر بگیرید و گلوگاه‌های عملکرد و خطاها را پیدا کنید.

هدف اصلی این افزونه، فراهم کردن اطلاعات عمیق و فنی در مورد هر بارگذاری صفحه (Page Load) است. با نصب و فعال‌سازی، یک نوار ابزار در بالای پیشخوان وردپرس (و در صورت ورود، در فرانت‌اند سایت) ظاهر می‌شود که خلاصه‌ای از آمار زیر را نمایش می‌دهد:

1. زمان پردازش صفحه (Page Generation Time): مدت زمان کلی لازم برای بارگذاری صفحه.
2. حداکثر مصرف حافظه (Peak Memory Usage): بیشترین میزان استفاده از رم سرور.
3. زمان کوئری‌های دیتابیس (DB Query Time): مدت زمان صرف شده برای اجرای درخواست‌های دیتابیس.
4. تعداد کوئری‌های دیتابیس (Total Queries): تعداد کل درخواست‌های ارسال شده به پایگاه داده.

غیرفعال کردن حالت دیباگ وردپرس

زمانیکه حالت دیباگ وردپرس فعال است سرنخ هایی از خطاهای ایجاد شده در سایت را مشاهده میکنید اما اگر به هر دلیلی تمایل داشتید حالت دیباگ غیر فعال شود کافیست به مسیر نصب وردپرس مراجعه کنید و در فایل فایل wp-config.php به دنبال قطعه کد زیر بگردید:

define( 'WP_DEBUG', false );

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

فعال سازی دیباگ وردپرس باشد یا نباشد؟

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

بیشتر بخوانید: افزونه Captcha Plus | جلوگیری از ربات ها و اسپم در وردپرس | افزونه کپچا پلاس

سوالات متداول پیرامون 

بیشتر بخوانید: افزونه Night Mode | افزودن حالت شب به سایت های وردپرسی

آموزش غیرفعال‌سازی دیباگ در وردپرس به زبان ساده!

آموزش استفاده از WP_DEBUG در وردپرس

جمع بندی: آموزش دیباگ کردن در وردپرس

در طی راه اندازی سایت، قطعاً با انواع خطاهای مختلف در سایت خود مواجه خواهید شد. برخی از این خطاها خیلی سریع و ساده رفع می شوند، اما خطاهایی هم هستند که رفع کردن آنها به این سادگی نیست و شما نمی توانید دلیل اصلی آنها را هم متوجه شوید. در این صورت قابلیت دیباگ وردپرس می تواند به شما در این خصوص کمک کند. در واقع؛ debug در وردپرس به شما کمک می کند تا دلیل خطاهای سایتتان را به سادگی متوجه شوید تا بتوانید آنها را سریعاً رفع نمائید. روش های مختلفی برای انجام اینکار وجود دارد که ما 2 مورد از آنها را به شما توضیح دادیم. امیدوارم این آموزش مورد رضایت شما عزیزان قرار گرفته باشد.

منبع: wpastra