ecshop init.php文件分析(轉)

<?php

/**
 * ECSHOP 前臺公用文件
*/
//防止非法調用 defined-判斷常量是否已定義，若是沒返回false
if (!defined('IN_ECS'))
{
    die('Hacking attempt');//die-直接終止程序並輸出
}
//報告全部錯誤
error_reporting(E_ALL);
//若是獲取不到本文件
if (__FILE__ == '')
{
    die('Fatal error code: 0');
}
/*預約義常量
__LINE__       文件中的當前行號。
__FILE__       文件的完整路徑和文件名。
__FUNCTION__   函數名稱（這是 PHP 4.3.0 新加的）。
__CLASS__      類的名稱（這是 PHP 4.3.0 新加的）。
__METHOD__     類的方法名（這是 PHP 5.0.0 新加的）。
*/
/* 取得當前商城所在的根目錄 */
define('ROOT_PATH', str_replace('includes/init.php', '', str_replace('\\', '/', __FILE__)));
//檢測是否已安裝
if (!file_exists(ROOT_PATH . 'data/install.lock') && !file_exists(ROOT_PATH . 'includes/install.lock')
    && !defined('NO_CHECK_INSTALL'))
{
    header("Location: ./install/index.php\n");

    exit;
}

/* 初始化設置 */
@ini_set('memory_limit',          '64M');//ini_set設置php.ini中的設置，memory_limit設定一個腳本所可以申請到的最大內存字節數
@ini_set('session.cache_expire',  180);//指定會話頁面在客戶端cache中的有效期限(分鐘),單位爲分鐘。
@ini_set('session.use_trans_sid', 0);//關閉自動把session id嵌入到web的URL中
@ini_set('session.use_cookies',   1);//容許使用cookie在客戶端保存會話ID
@ini_set('session.auto_start',    0);//在客戶訪問任何頁面時都自動初始化會話，0-禁止
@ini_set('display_errors',        1);//是否顯示錯誤

if (DIRECTORY_SEPARATOR == '\\')//若是裝在windows上（DIRECTORY_SEPARATOR路徑分隔符，linux上就是’/’   windows上是’\’）
{
    @ini_set('include_path', '.;' . ROOT_PATH);//include目錄爲當前目錄和網站根目錄，windows下用';'分隔
}
else
{
    @ini_set('include_path', '.:' . ROOT_PATH);//include目錄爲當前目錄和網站根目錄，linux下用':'分隔
}

require(ROOT_PATH . 'data/config.php');//包含配置文件（數據庫相關）

if (defined('DEBUG_MODE') == false)//若是常量DEBUG_MODE沒有定義則定義爲0，DEBUG_MODE用於設置ecshp的使用模式
{
    define('DEBUG_MODE', 0);
}
//設定用於全部日期時間函數的默認時區
if (PHP_VERSION >= '5.1' && !empty($timezone))
{
    date_default_timezone_set($timezone);//date_default_timezone_set 設置時區
}
//$_SERVER['PHP_SELF']返回當前頁面，獲取$_SERVER['PHP_SELF']最好用htmlspecialchars過濾一下，存在XSS漏洞
$php_self = isset($_SERVER['PHP_SELF']) ? $_SERVER['PHP_SELF'] : $_SERVER['SCRIPT_NAME'];
if ('/' == substr($php_self, -1))//若是是"/"結尾，則加上index.php
{
    $php_self .= 'index.php';
}
define('PHP_SELF', $php_self);//放入常量

require(ROOT_PATH . 'includes/inc_constant.php');//包含預約義常量文件
require(ROOT_PATH . 'includes/cls_ecshop.php');//基礎類 文件
require(ROOT_PATH . 'includes/cls_error.php');//錯誤類 文件
require(ROOT_PATH . 'includes/lib_time.php');//時間函數
require(ROOT_PATH . 'includes/lib_base.php');//基礎函數庫
require(ROOT_PATH . 'includes/lib_common.php');//基礎函數庫
require(ROOT_PATH . 'includes/lib_main.php');//公用函數庫
require(ROOT_PATH . 'includes/lib_insert.php');//動態內容函數庫
require(ROOT_PATH . 'includes/lib_goods.php');//商品相關函數庫
require(ROOT_PATH . 'includes/lib_article.php');//文章及文章分類相關函數庫

/* 對用戶傳入的變量進行轉義操做。*/
if (!get_magic_quotes_gpc())
{
    if (!empty($_GET))
    {
        $_GET  = addslashes_deep($_GET);
    }
    if (!empty($_POST))
    {
        $_POST = addslashes_deep($_POST);
    }

    $_COOKIE   = addslashes_deep($_COOKIE);
    $_REQUEST  = addslashes_deep($_REQUEST);
}

/* 建立 ECSHOP 對象 */
$ecs = new ECS($db_name, $prefix);//參數說明：數據庫名 表前綴
define('DATA_DIR', $ecs->data_dir());//數據目錄
define('IMAGE_DIR', $ecs->image_dir());//圖片目錄

/* 初始化數據庫類 */
require(ROOT_PATH . 'includes/cls_mysql.php'); 
$db = new cls_mysql($db_host, $db_user, $db_pass, $db_name);
/* 設置不容許進行緩存的表 */
$db->set_disable_cache_tables(array($ecs->table('sessions'), $ecs->table('sessions_data'), $ecs->table('cart')));
$db_host = $db_user = $db_pass = $db_name = NULL;

/* 建立錯誤處理對象 */
$err = new ecs_error('message.dwt');

/* 載入系統參數 */
$_CFG = load_config(); //載入配置信息函數在lib_common.php

/* 載入語言文件 */
require(ROOT_PATH . 'languages/' . $_CFG['lang'] . '/common.php');

if ($_CFG['shop_closed'] == 1)
{
    /* 商店關閉了，輸出關閉的消息 */
    header('Content-type: text/html; charset='.EC_CHARSET);

    die('<div style="margin: 150px; text-align: center; font-size: 14px"><p>' . $_LANG['shop_closed'] . '</p><p>' . $_CFG['close_comment'] . '</p></div>');
}

//判斷是否爲搜索引擎蜘蛛  函數在lib_main.php
if (is_spider())
{
    /* 若是是蜘蛛的訪問，那麼默認爲訪客方式，而且不記錄到日誌中 */
    if (!defined('INIT_NO_USERS'))
    {
        define('INIT_NO_USERS', true);
        /* 整合UC後，若是是蜘蛛訪問，初始化UC須要的常量 */
        if($_CFG['integrate_code'] == 'ucenter')
        {
             $user = & init_users();
        }
    }
    $_SESSION = array();
    $_SESSION['user_id']     = 0;
    $_SESSION['user_name']   = '';
    $_SESSION['email']       = '';
    $_SESSION['user_rank']   = 0;
    $_SESSION['discount']    = 1.00;
}
//非搜索引擎蜘蛛，記錄session
if (!defined('INIT_NO_USERS'))
{
    /* 初始化session */
    include(ROOT_PATH . 'includes/cls_session.php');

    $sess = new cls_session($db, $ecs->table('sessions'), $ecs->table('sessions_data'));

    define('SESS_ID', $sess->get_session_id());
}
//若是使用Smarty
if (!defined('INIT_NO_SMARTY'))
{
    header('Cache-control: private');
    header('Content-type: text/html; charset='.EC_CHARSET);

    /* 建立 Smarty 對象。*/
    require(ROOT_PATH . 'includes/cls_template.php');
    $smarty = new cls_template;

    $smarty->cache_lifetime = $_CFG['cache_time'];//緩存時間
    $smarty->template_dir   = ROOT_PATH . 'themes/' . $_CFG['template'];//模板所在
    $smarty->cache_dir      = ROOT_PATH . 'temp/caches';//緩存所在
    $smarty->compile_dir    = ROOT_PATH . 'temp/compiled';//模板編譯後的文件所在

    if ((DEBUG_MODE & 2) == 2)//若是常量DEBUG_MODE值爲 二、三、六、7.時
    {
        $smarty->direct_output = true; //不使用緩存直接輸出
        $smarty->force_compile = true; //強行編譯
    }
    else
    {
        $smarty->direct_output = false;
        $smarty->force_compile = false;
    }

    $smarty->assign('lang', $_LANG);
    $smarty->assign('ecs_charset', EC_CHARSET);
    if (!empty($_CFG['stylename']))//若是本身定義樣式文件就用本身的
    {
        $smarty->assign('ecs_css_path', 'themes/' . $_CFG['template'] . '/style_' . $_CFG['stylename'] . '.css');
    }
    else
    {
        $smarty->assign('ecs_css_path', 'themes/' . $_CFG['template'] . '/style.css');
    }

}
//非搜索引擎爬蟲，記錄用戶信息
if (!defined('INIT_NO_USERS'))
{
    /* 會員信息  初始化會員數據 lib_common.php */ 
    $user =& init_users();

    if (!isset($_SESSION['user_id']))
    {
        /* 獲取投放站點的名稱 */
        $site_name = isset($_GET['from'])   ? $_GET['from'] : addslashes($_LANG['self_site']);
        $from_ad   = !empty($_GET['ad_id']) ? intval($_GET['ad_id']) : 0;

        $_SESSION['from_ad'] = $from_ad; // 用戶點擊的廣告ID
        $_SESSION['referer'] = stripslashes($site_name); // 用戶來源

        unset($site_name);

        if (!defined('INGORE_VISIT_STATS'))
        {
            visit_stats();
        }
    }

    if (empty($_SESSION['user_id']))
    {
        if ($user->get_cookie())
        {
            /* 若是會員已經登陸而且尚未得到會員的賬戶餘額、積分以及優惠券 */
            if ($_SESSION['user_id'] > 0)
            {
                update_user_info();
            }
        }
        else
        {
            $_SESSION['user_id']     = 0;
            $_SESSION['user_name']   = '';
            $_SESSION['email']       = '';
            $_SESSION['user_rank']   = 0;
            $_SESSION['discount']    = 1.00;
            if (!isset($_SESSION['login_fail']))
            {
                $_SESSION['login_fail'] = 0;
            }
        }
    }

    /* 設置推薦會員 */
    if (isset($_GET['u']))
    {
        set_affiliate();
    }
    if (isset($smarty))
    {
        $smarty->assign('ecs_session', $_SESSION);
    }
}

if ((DEBUG_MODE & 1) == 1)//若是常量DEBUG_MODE值爲 一、三、五、7.時
{
    error_reporting(E_ALL);//報告所有錯誤
}
else
{
    error_reporting(E_ALL ^ E_NOTICE); //報告除E_NOTICE之外的全部錯誤
}
if ((DEBUG_MODE & 4) == 4)//若是常量DEBUG_MODE值爲 四、五、六、7.時，調試程序
{
    include(ROOT_PATH . 'includes/lib.debug.php');//
}

/* 判斷是否支持 Gzip 模式  若是使用SMARTY同時設置了網頁壓縮，則啓用壓縮 */
if (!defined('INIT_NO_SMARTY') && gzip_enabled())
{
    ob_start('ob_gzhandler');//壓縮後放入緩衝區
}
else
{
    ob_start();//打開緩衝區，把下面要顯示的內容先緩在服務器
}
/*
ob_start相關函數了解：
、Flush：刷新緩衝區的內容，輸出。
函數格式：flush()
說明：這個函數常常使用，效率很高。
、ob_start ：打開輸出緩衝區
函數格式：void ob_start(void)
說明：當緩衝區激活時，全部來自PHP程序的非文件頭信息均不會發送，而是保存在內部緩衝區。爲了輸出緩衝區的內容，能夠使用ob_end_flush()或flush()輸出緩衝區的內容。
 、ob_get_contents ：返回內部緩衝區的內容。
使用方法：string ob_get_contents(void)
說明：這個函數會返回當前緩衝區中的內容，若是輸出緩衝區沒有激活，則返回 FALSE 。
、ob_get_length：返回內部緩衝區的長度。
使用方法：int ob_get_length(void)
說明：這個函數會返回當前緩衝區中的長度；和ob_get_contents同樣，若是輸出緩衝區沒有激活。則返回 FALSE。
、ob_end_flush ：發送內部緩衝區的內容到瀏覽器，而且關閉輸出緩衝區。
使用方法：void ob_end_flush(void)
說明：這個函數發送輸出緩衝區的內容（若是有的話）。
、ob_end_clean：刪除內部緩衝區的內容，而且關閉內部緩衝區
使用方法：void ob_end_clean(void)
說明：這個函數不會輸出內部緩衝區的內容而是把它刪除！
、ob_implicit_flush：打開或關閉絕對刷新
使用方法：void ob_implicit_flush ([int flag])
說明：使用過Perl的人都知道$|=x的意義，這個字符串能夠打開/關閉緩衝區，而ob_implicit_flush函數也和那個同樣，默認爲關閉緩衝區，打開絕對輸出後，每一個腳本輸出都直接發送到瀏覽器，再也不須要調用 flush()
*/
?>