ניפוי שגיאות (דיבאג) ב-WordPress

ניפוי שגיאות (או בלועזית debugging) הינו תהליך בסיסי ובלתי נפרד בעבודה עם קוד, בין אם בתהליך הכתיבה ובין אם בתהליך ה-QA, כאמור וורדפרס מספקת לנו מספר כלים אשר יאפשרו לנו לבצע ניפוי שגיאות בצורה הטובה ביותר.

לרוב מפתחי תבניות ותוספי וורדפרס מכירים את WP_DEBUG אשר קיים בקובץ wp-config.php, שם הוא מוגדר בברירת מחדל כ-false אשר מתפרש בעצם למצב שוורדפרס לא תציג שגיאות או מידע חיוני על מנת להגן על בעל האתר.

הפעלת ניפוי שגיאות

בתור התחלה הדבר הכי בסיסי שיש לעשות הוא להפעיל את מצב ניפוי השגיאות, שלב זה הוא שלב מהיר וקליל אשר מצריך מאיתנו להיכנס לקובץ wp-config.php לחפש את הקוד הבא:

define( 'WP_DEBUG', false );

ולהחליף אותו בקוד הבא:

define( 'WP_DEBUG', true );

ניפוי שגיאות לקובץ

הרבה לא מכירים אך ניתן להפעיל את היכולת של וורדפרס לשמור את השגיאות שנוצרות לקובץ בשם debug.log אשר יושב בתיקיית wp-content. אפשרות זאת מאוד שימושית מכיוון שהיא מאפשרת לנו לעקוב אחרי היסטוריה של תקלות, בחינה של תקלות חוזרות, ומאפשרת לנו אפילו לבחון אילו תקלות התרחשו תוך כדי ביצוע קריאות AJAX.

על מנת להפעיל את האפשרות של שמירת שגיאות לקובץ, יש להוסיף את הקוד הבא לקובץ wp-config.php:

define( 'WP_DEBUG_LOG', true );

הצגת שגיאות על המסך

הצגת שגיאות בוורדפרס מופעלת כברירת מחדל כאשר מופעל מצב ניפוי שגיאות, דבר אשר יגרום לוורדפרס לזרוק את השגיאות הנוצרות למסך בעת טעינת העמוד, דבר אשר יכול לשבור את מראה האתר ואף לחשוף מידע רגיש אודות השרת והאתר, לכן כאשר עובדים במצב ניפוי שגיאות, מומלץ להגדיר את ערך זה כך שהוא לא יציג שגיאות על המסך (מעולה כאשר משתמשים בקובץ על מנת לשמור את השגיאות).

על מנת לכבות את מצב הדפסת השגיאות על המסך, יש להוסיף את הקוד הבא לקובץ wp-config.php:

define( 'WP_DEBUG_DISPLAY', false );

ניפוי שגיאות בקבצי JavaScript

בברירת המחדל, וורדפרס משתמשת בקבצי JavaScript ו-CSS דחוסים על מנת לחסוך בתעבורה ולאפשר טעינה מהירה של העמוד. אך כאשר ישנן שגיאות JavaScript ואנחנו מעוניינים לדעת באיזה שורה מתרחשת השגיאה, מומלץ להפעיל את ניפוי שגיאות בקבצי JavaScript, כך נוכל לדעת את המיקום המדוייק של השורה הסוררת.

חשוב להבין כי שורה זאת מתייחסת אך ורק לקבצי הליבה של וורדפרס ולא לקבצים של תבנית או של תוספים (אלא אם כן, מפתחי התבניות או התוסף השתמשו בקבוע (constant) זה על מנת להרחיב את "חווית ניפוי השגיאות".

על מנת להפעיל את מצב ניפוי השגיאות בקבצי הליבה, יש להוסיף את הקוד הבא לקובץ wp-config.php:

define( 'SCRIPT_DEBUG', true );

ניפוי שגיאות בשאילתות SQL

כאשר אנחנו עובדים על קוד או כאשר אנחנו מקבלים תוצאות אחרות ממה שאנחנו מצפים להם כאשר מדפדפים בדפי האתר, מומלץ להשתמש באופציה של ניפוי שגיאות בשאילתות SQL. שימוש באפשרות זאת שומרת את כל השאילתות אשר וורדפרס מבצעת במערך (array) אשר אותו ניתן להדפיס בעת הצורך.

על מנת להפעיל את מצב ניפוי השגיאות בשאילתות SQL, יש להוסיף את הקוד הבא לקובץ wp-config.php:

define( 'SAVEQUERIES', true );

כאשר אפשרות זאת מופעלת, וורדפרס שומרת את השאילתות במערך אשר אליו ניתן לגשת ע"י הדפסה של המשתנה $wpdb->queries.

סיכום

ניפוי שגיאות הוא חלק חשוב ומומלץ לבצע אותו לפני שמשחררים תוסף או תבנית או לפני העלאת האתר שלנו, יש לשים לב כי אף אחד משורות שרשמנו כאן לא יעבדו במידה ולא נאפשר את מצב ניפוי השגיאות. כמובן לא לשכוח לכבות את מצב ניפוי השגיאות לפני העלאת האתר על מנת לא לחשוף מידע רגיש.

בהצלחה!