מעקב ניתוב (router trace)

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

הפעלה#

מוסיפים __router_trace לכתובת (הערך לא משנה, העיקר שהפרמטר קיים):

https://example.com/news/5?__router_trace=1
https://example.com/some-friendly-url?__router_trace=1

הפאנל מופיע רק לאחד משלושה:

לכל מבקר אחר הפרמטר פשוט לא עושה כלום, והעמוד נראה כרגיל. כך אפשר גם לבדוק מהשרת בלי להתחבר:

curl -s -H "Host: example.com" "http://127.0.0.1/news/5?__router_trace=1" | grep -o "ROUTER TRACE.*" | head

איך הפאנל נראה#

פס קבוע בתחתית החלון (position: fixed, גובה מרבי 45% מהמסך, id="router-trace", dir="ltr") עם כפתור [close] שמסיר אותו. בראשו שורת מצב:

מתחתיה טבלה עם העמודות הבאות, שורה לכל שלב שנרשם, לפי הסדר:

ובתחתיתה final $_GET: ערך $_GET כפי שהוא נראה אחרי הניתוב, כולל module, pname ו-id או sys_controller. זה המקום הכי מהיר לבדוק למה בקר קיבל id ריק.

מילון השלבים#

הסדר בטבלה הוא הסדר שבו ה-ROUTER מנסה כללים (ראו ניתוב). שלב שמסתיים ב-return או die עוצר את הניתוב, ולכן מה שאחריו לא יופיע.

דוגמה: למה /blat נותן 404#

#  stage                          url    matched           note
0  parse_friendly_url ENTER       blat                     REQUEST_URI=/blat?__router_trace=1
1  CLIENT side                    blat                     resolving SEO / controller
2  SEO exact: none                blat                     no plain seoUrl row
3  NO SEO → passthrough           blat                     pageUrl = url (raw url used as route)
4  MODULE module                  blat   ^(x)$             module=blat → (controller must exist, else MODULE sends to 404)
5  MODULE::get_html               blat/index               module='blat' page=index is_system=false
6  MODULE → ERRORPAGE                                      module 'blat' not found/inactive in modules_tbl and no controller file
7  errorpage() → re-route to "404"                         MODULE returned ERRORPAGE; re-entering ROUTER with url="404"

(הטקסט מקוצר, והשלבים אחרי 7 הם ניתוב מחדש לכתובת 404.) שורה 6 היא התשובה: אין בקר בשם blat. אילו היה קובץ application/controllers/blat.php, השורה הייתה module activation prompt (לאדמין) או MODULE → ERRORPAGE ... active in DB but controller file/class missing, והתיקון שונה לגמרי.

קריאה מתוכנית והוספת שלבים#

ROUTER::$trace הוא מערך סטטי, ואפשר לקרוא אותו מכל קוד, גם בלי להפעיל את הפאנל. שלב נרשם בדיוק באותה צורה גם ממקום אחר, למשל מבקר שמחליט לשלוח לעמוד אחר:

ROUTER::trace('MY RULE', [
	'url'   => $slug,
	'match' => 'legacy-product',
	'note'  => 'redirecting to product ' . $id,
]);

המפתחות url, match ו-note אופציונליים. ROUTER::is_trace_on() מחזיר true כשהפרמטר קיים והמבקר מורשה, ושימושי אם רוצים להדפיס עוד מידע דיבוג רק במצב הזה:

if (ROUTER::is_trace_on()) {
	error_log(json_encode(ROUTER::$trace, JSON_UNESCAPED_UNICODE));
}

כל קריאה ל-ROUTER::trace (בשביל מבקר מורשה עם הפרמטר) רושמת פעם אחת פונקציית register_shutdown_function, שמדפיסה את הפאנל בסוף הבקשה.

מלכודות#

ראו גם#

• ניתוב: הסדר המלא שהשלבים כאן משקפים.
• כתובות SEO ו-הפניות: מקורות נפוצים לבלבול בין "הכתובת נפתרה" ל"הכתובת הופנתה".
• 404, 503 ושגיאות ו-בקרי מערכת.
• בדיקות: מקומות נוספים לדיבוג בפיתוח.