ניתוב (ROUTER)

כל בקשה שמגיעה ל-index.php עוברת דרך המחלקה ROUTER (system/collections/ROUTER.php). היא לא מריצה קוד של אתר: היא רק קוראת את הכתובת ומכניסה ל-$_GET את המפתחות module, pname, id (או sys_controller לקונטרולר מערכת), וקובעת אם הבקשה היא client או admin. אחריה MODULE::get_html() טוען את הקונטרולר ומריץ את המתודה. בעמוד הזה מתואר הסדר המדויק של ההחלטות, כדי שתדעו לצפות איך כתובת תתפרש לפני שאתם כותבים קונטרולר.

system/ בעמוד הזה הוא תיקיית הליבה הפרוסה (api/core בריפו), ו-{admin} הוא CONFIG::$admin_url.

איפה הניתוב רץ#

PAGE::load($_SERVER['REQUEST_URI']) מאפס את PAGE, מאתחל PARAMS ו-SEO, וקורא ל-ROUTER::parse_friendly_url($url). בסיום הוא בודק הפניות 301 (ROUTER::redirections(), ראו הפניות 301) וטוען את application/includes. התמונה המלאה של מחזור הבקשה נמצאת ב-מחזור חיי בקשה.

מה ROUTER מחזיר: מפתחות ב-$_GET#

parse_friendly_url לא מחזיר ערך. התוצאה היא מצב גלובלי:

ל-pname ריק, MODULE::get_html מחליף ל-index.

סדר ההחלטות#

הבדיקות רצות לפי הסדר הזה, והראשונה שמתאימה מכריעה. רובן מסתיימות ב-return (ללא ה-seoUrl), חלקן מגישות קובץ ויוצאות.

פירוק כתובת של אתר#

אחרי שה-seoUrl החליט מה "הנתיב הפנימי" (או שלא נמצאה התאמה והכתובת עצמה היא הנתיב), הנתיב מפורק ב-regex לפי הסדר. קודם system/..., ואחר כך מודול רגיל:

כל מה שלא מתאים (למשל // באמצע הכתובת) מגיע ל-die("router error").

פרמטרים: id, pname ומחרוזת השאילתה#

קונטרולר קורא את הפרמטרים ישירות מ-$_GET. אין הזרקת ארגומנטים למתודה.

<?php
// application/controllers/news.php
// GET /news/12            -> index()   עם $_GET["id"] = "12"
// GET /news/archive       -> archive()
// GET /news/item/12       -> item()    עם $_GET["id"] = "12"
class news extends wz_controller
{
    function index()
    {
        $id = (int)($_GET["id"] ?? 0);   // תמיד המירו: הערך מגיע כמחרוזת
        if ($id === 0) return $this->view("news/list");

        $row = DB::query("news", ["id" => $id])->get_row();
        if (!$row) return "ERRORPAGE";   // הופך ל-404 (ראו שגיאות)
        return $this->view("news/item", ["row" => $row]);
    }

    function archive() { return $this->view("news/archive"); }

    function item() { return $this->index(); }
}

$_GET מוחלף, לא ממוזג#

כשבכתובת יש ?, הניתוב מבצע $_GET = $arrget: המערך שנבנה מה-REQUEST_URI מחליף את מה ש-PHP בנה. התוצאה בדרך כלל זהה, אבל שני הבדלים חשובים:

• הפיצול הוא explode("?", $url) בלי הגבלה, ולכן אם יש בכתובת שני סימני ?, רק החלק שבין הראשון לשני נקרא.
• פרמטרי מעקב ידועים (utm_*, gclid, fbclid ועוד, הרשימה ב-cache_engine::$tracking_params) מוסרים מה-REQUEST_URI לפני הניתוב, בשביל מטמון העמודים. הניתוב מחזיר אותם ל-$_GET מהמקור, כך שהם זמינים לקוד שלכם.

פרמטרים שה-seoUrl מוסיף דרך ? בנתיב הפנימי (למשל pageurl = news/item?lang=en) ממוזגים לתוך $_GET ודורסים מפתח באותו שם.

pmode: תשובה בלי עטיפת HTML#

אם $_GET["pmode"] הוא empg או inner, PAGE::output() לא עוטף את הפלט ב-theme וב-<html>: מוחזר רק מה שהקונטרולר החזיר. כך נכתבים נתיבי JSON וקבצים, למשל /news/feed?pmode=empg. (ב-PAGE::output נשלחות גם כותרות scripts ו-scripts_ver עם רשימת הנכסים.)

ה-API הציבורי של ROUTER#

הכתובת הידידותית לרשומה (כשיש seoUrl) נוצרת כך:

$url = ROUTER::get_by_url("news/item?id=" . (int)$row["id"]);   // "my-news-title" או הנתיב עצמו
echo "<a href=\"/" . htmlspecialchars($url) . "\">" . htmlspecialchars($row["title"]) . "</a>";

ראו גם#

• כתובות ידידותיות (seoUrl): מיפוי כתובות לנתיבים פנימיים, כולל regex
• קונטרולרים של אתר ו-קונטרולרי מערכת
• דיבוג ניתוב: ?__router_trace=1
• 404, 503 ושגיאות
• ROUTER ו-MODULE (רפרנס)