404, 503 ושגיאות

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

מה גורם ל-404#

הניתוב (ניתוב) לא יודע מראש אם עמוד קיים. הוא מנתח את הכתובת לבקר ולמתודה, ו-MODULE::get_html מחליט. הוא מחזיר את המחרוזת "ERRORPAGE" (ואז מופעלת MODULE::errorpage()) באחד המקרים האלה:

המקרה האחרון הוא הדרך הנכונה לעשות 404 מתוך בקר: לא header(...) ולא die, אלא return "ERRORPAGE", ואז הליבה מציגה את עמוד ה-404 של האתר בתוך ה-theme כרגיל.

מה עושה MODULE::errorpage()#

errorpage()
  1. DB::had_error()?   כן  -> MISC::service_unavailable(...)  = 503, ונגמר
  2. ROUTER::parse_friendly_url("404")   מנתב מחדש אל כתובת 404
       - שולח HTTP 404 ומסמן PAGE::$is_404 = true
  3. PAGE::$cache_this_page = false      עמוד 404 לא נשמר במטמון העמודים
  4. אם המודול של עמוד ה-404 פעיל והמתודה קיימת: מריץ אותה ומחזיר את התוצאה
  5. אחרת: מחזיר <h1>404 - Page not found</h1>

כלומר כותרת ה-HTTP 404 נשלחת בשלב 2, אחרי שכבר נבחר שהעמוד לא קיים, והעמוד שמוצג בשלב 4 הוא תוצר רגיל של בקר, עטוף ב-theme של האתר (PAGE::$is_404 זמין ל-theme או לקוד שרוצה להתאים את התצוגה).

הגדרת עמוד 404 משלכם#

עמוד ה-404 הוא כלל seoUrl רגיל עם sysname = '404'. ה-pageurl שלו הוא <module>/<method>, והמודול חייב להיות פעיל ב-CRM_modules, כי errorpage() בודקת זאת לפני שהיא מריצה אותו.

INSERT INTO CRM_seoUrl (sysname, pageurl, regularexp, ord)
VALUES ('404', 'errors/not_found', 0, 0);

הבקר, application/controllers/errors.php:

<?php
class errors extends bgl_controller
{
	public function not_found()
	{
		SEO::set("title", "העמוד לא נמצא");
		PAGE::$robots = "NOINDEX, FOLLOW";

		return $this->view("errors/not_found");   // application/views/errors/not_found.tpl
	}
}

אחרי הוספת הבקר מפעילים אותו ב-CRM_modules (או בפאנל המודולים) ומנקים את מטמון modules, ראו בקרים. את הכלל אפשר גם להוסיף מפאנל {admin}/Seo (כתובות SEO).

אם לא הגדרתם כלל 404, המסך הוא ה-<h1>404 - Page not found</h1> הגולמי, בתוך ה-theme של האתר, וסטטוס 404 נשלח כרגיל.

503 במקום 404: כשבסיס הנתונים נכשל#

הניתוב תלוי בשתי טבלאות מהמסד: seoUrl ו-modules. שאילתה שנכשלת מחזירה תוצאה ריקה ולא שגיאה, ולכן מסד עמוס ריקן את modules, וכל עמוד תקין נראה "לא קיים". כדי שזה לא ייחשב ל-404 (שמוחק את העמוד מגוגל), הליבה סופרת כשלים בבקשה: DB::$error_count עולה על כל שאילתה שנכשלה, ו-DB::had_error() מחזיר true אם נספר אחד.

MODULE::errorpage() בודקת את זה ראשונה: אם הייתה שגיאת מסד בבקשה הנוכחית, היא קוראת ל-MISC::service_unavailable($reason = "", $retry_after = 120):

באותה דרך, כשל בחיבור למסד (PDO, mysql או pg) קורא ישירות ל-MISC::service_unavailable. ב-CLI (php_sapi_name() === "cli") הפונקציה כותבת את הסיבה ל-STDERR ויוצאת עם קוד 1 במקום לשלוח כותרות.

אפשר לקרוא לה גם מהקוד שלכם, כשאתם יודעים שהכשל הוא תשתיתי:

$rows = DB::query("products", ["active" => 1])->get_all();
if (DB::had_error()) MISC::service_unavailable("products query failed: " . DB::$last_error, 60);

המטמון עצמו מוגן באותו עיקרון: cache_engine::get לא שומר ערך שחושב בזמן שנספרה שגיאת מסד (מטמון).

שאר מצבי הכשל#

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

ראו גם#

• ניתוב ו-כתובות SEO: איך הכתובת נפתרת ואיך מוגדר כלל 404.
• בקרים: הפעלת מודול והחזרת "ERRORPAGE".
• מעקב ניתוב: הצגת שלבי MODULE → ERRORPAGE ו-errorpage() → re-route.
• קודי שגיאה ו-אבחון.