CONFIG ו-CONFIG_USER

כל אתר WizzoCMS מגדיר מחלקה בשם CONFIG_USER ב-index.php שלו, ורק אחר כך טוען את הליבה. הליבה מרחיבה אותה במחלקה CONFIG (class CONFIG extends CONFIG_USER), ולכן כל מפתח נקרא בקוד כ-CONFIG::$key. בדף הזה: כל מפתח שהליבה קוראת, מה הסוג שלו, מי משתמש בו ומה קורה כשהוא חסר, וגם שתי המתודות הציבוריות של CONFIG. הדף מציג שמות מפתחות והסבר בלבד, בלי ערכי סודות.

איך ההגדרה נטענת#

הליבה לא מגדירה ברירות מחדל. CONFIG_USER נמצאת באתר ולא בליבה, ולכן "ברירת מחדל" בטבלאות למטה היא תמיד "מוגדר באתר". כך נראה סדר הדברים ב-core.php:

1. glob(collections/*.php) טוען את כל המחלקות, כולל CONFIG.
2. CONFIG::preinit() מחשבת פרוטוקול, נתיב בסיס ונתיבים מוחלטים לתיקיות.
3. MISC::cli_check() מטפלת בהרצה משורת פקודה (cron).
4. CONFIG::init() מחברת את הפלטפורמה ומחשבת את כתובות האתר והשפה.

מפתחות ששייכים לאתר (CONFIG_USER)#

נתיבים ותיקיות#

מסד נתונים#

ניתוב, ניהול ותבניות#

מטמון, קבצים ומדיה#

פרטי האחסון המלאים, כולל אישורי S3 שנשמרים ב-MISC::$GLOBALS ולא ב-CONFIG, ב-STORAGE.

דואר#

ראו דואר לשליחה ולתור.

מצב הסוואה#

ראו מצב הסוואה.

מפתחות נגזרים: אסור להגדיר אותם#

CONFIG מצהירה בעצמה על המאפיינים האלה בלבד, והליבה ממלאת אותם. הגדרה שלהם ב-CONFIG_USER לא תועיל: הערך נדרס ב-preinit() או ב-init().

CONFIG::preinit()#

public static function preinit()

קוראת core.php לפני כל דבר אחר, ללא פרמטרים וללא ערך החזרה.

מה היא עושה, לפי הסדר:

1. קובעת את אזור הזמן Asia/Jerusalem עם date_default_timezone_set().
2. קובעת את CONFIG::$protocol: "https" בהרצה משורת פקודה, ובבקשת רשת "https" רק כש-$_SERVER["HTTPS"] == "on", אחרת "http".
3. מחשבת את CONFIG::$base_path כתיקייה של סקריפט הכניסה (הקובץ התחתון ב-debug_backtrace()).
4. ממירה את models_folder ואת cache_folder לנתיבים מוחלטים. ערך שמכיל ../ עובר realpath() ביחס ל-base_path, וערך אחר מקבל base_path . '/' בהתחלה.

CONFIG::init()#

public static function init()

נקראת מ-core.php אחרי MISC::cli_check(), ומ-MISC::cli_check() עצמה בהרצת cron (אחרי שהיא מאפסת את SERVER_NAME ואת HTTP_HOST). אין פרמטרים ואין ערך החזרה.

מה היא עושה, לפי הסדר:

1. מחשבת את db_fullprefix מ-db_prefix.
2. טוענת את טבלת הפלטפורמות: cache_engine::get("platforms", fn, 24*30, false), כלומר SELECT * FROM CRM_platforms ממופה לפי domain, ונשמר 720 שעות ($in_platform = false, כי המפתח משותף לכל הפלטפורמות).
3. בוחרת את platform_data: שורה שה-domain שלה שווה ל-$_SERVER['SERVER_NAME'].
4. אם אין התאמה, עוברת על הפלטפורמות ובודקת את allowed_domains (רשימה שמפורקת עם MISC::bgl_explode) יחד עם ה-domain של אותה פלטפורמה. התאמה קובעת את הפלטפורמה וגם את env_url לכתובת הדומיין שביקשו.
5. אם עדיין אין התאמה, לוקחת את השורה הראשונה בטבלה.
6. ממלאת את site_url, original_site_url, base_domain, env_url ו-lang (ראו את טבלת המפתחות הנגזרים).

// אחרי core.php אפשר לקרוא את התוצאה
CONFIG::$site_url;                    // "https://example.com/"
CONFIG::$platform_data["domain"];     // example.com
CONFIG::$lang;                        // מזהה הפלטפורמה

דוגמה: CONFIG_USER מינימלי#

הערכים כאן הם מציין מקום. את הערכים האמיתיים מקבלים מהסביבה, ולא שומרים אותם במאגר.

<?php
class CONFIG_USER
{
    // נתיבים
    static $core_path      = __DIR__ . "/system/core";
    static $cache_folder   = "cache";
    static $models_folder  = "application/models";

    // מסד נתונים
    static $db_type        = "PDO";
    static $db_host        = "127.0.0.1";
    static $db_dbname      = "site_db";
    static $db_user        = "site_user";
    static $db_password    = "CHANGE_ME";
    static $db_prefix      = "CRM";

    // ניתוב ותבניות (admin_url יחסי, בלי לוכסן בהתחלה)
    static $admin_url           = "wizzocms";
    static $default_module      = "home";
    static $ignore_domain_check = false;
    static $use_smarty          = true;
    static $minify_html         = true;

    // מטמון, אחסון ודואר
    static $allow_cache    = true;
    static $storage_remote = "local";
    static $mail_queue     = true;
    static $mail_is_smtp   = false;
}

require __DIR__ . "/system/core/core.php";

הדוגמה כוללת את כל המפתחות שהליבה קוראת בלי הגנה בנתיב בקשה רגיל. מפתחות ה-SMTP, ה-FTP וההסוואה מתווספים רק כשמפעילים את התכונה שלהם.

ראו גם#

• קונפיגורציה
• מבנה האתר
• DB
• STORAGE
• מטמון
• פלטפורמות ורב-לשוניות
• דואר
• מצב הסוואה