ThinkPHP慣例設定檔詳解，_PHP教程

ThinkPHP慣例設定檔詳解，

ThinkPHP的系統內建有一個慣例設定檔（位於系統目錄下面的Conf\convention.php），按照大多數的使用對常用參數進行了預設配置。本文對慣例設定檔作出注釋詳解如下，供大家參考：

<?php/**+------------------------------------------------------------------------------* ThinkPHP慣例設定檔* 該檔案請不要修改，如果要覆蓋慣例配置的值，可在項目設定檔中設定和慣例不符的配置項* 配置名稱大小寫任意，系統會統一轉換成小寫* 所有配置參數都可以在生效前動態改變+------------------------------------------------------------------------------* @category Think* @package Common* @version $Id$+------------------------------------------------------------------------------*/if (!defined('THINK_PATH')) exit();return array(/* 項目設定 */'APP_DEBUG'   => false, // 是否開啟偵錯模式'APP_DOMAIN_DEPLOY'   => false,  // 是否使用獨立網域名稱部署項目'APP_PLUGIN_ON'     => false,  // 是否開啟外掛程式機制'APP_FILE_CASE'     => false,  // 是否檢查檔案的大小寫 對Windows平台有效'APP_GROUP_DEPR'    => '.',   // 模組分組之間的分割符'APP_GROUP_LIST'    => '',   // 項目分組設定,多個組之間用逗號分隔,例如'Home,Admin''APP_AUTOLOAD_REG'   => false,  // 是否開啟SPL_AUTOLOAD_REGISTER'APP_AUTOLOAD_PATH'   => 'Think.Util.',// __autoLoad 機制額外檢測路徑設定,注意搜尋順序'APP_CONFIG_LIST'    => array('taglibs','routes','tags','htmls','modules','actions'),// 項目額外需要載入的配置列表，預設包括：taglibs(標籤庫定義),routes(路由定義),tags(標籤定義),(htmls)靜態緩衝定義, modules(擴充模組),actions(擴充操作)/* Cookie設定 */'COOKIE_EXPIRE'     => 3600,  // Coodie有效期間'COOKIE_DOMAIN'     => '',   // Cookie有效網域名稱'COOKIE_PATH'      => '/',   // Cookie路徑'COOKIE_PREFIX'     => '',   // Cookie首碼 避免衝突/* 預設設定 */'DEFAULT_APP'      => '@',   // 預設項目名稱，@表示當前項目'DEFAULT_GROUP'     => 'Home', // 預設分組'DEFAULT_MODULE'    => 'Index', // 預設模組名稱'DEFAULT_ACTION'    => 'index', // 預設操作名稱'DEFAULT_CHARSET'    => 'utf-8', // 預設輸出編碼'DEFAULT_TIMEZONE'   => 'PRC', // 預設時區'DEFAULT_AJAX_RETURN'  => 'JSON', // 預設AJAX 資料返回格式,可選JSON XML ...'DEFAULT_THEME'  => 'default', // 預設範本主題名稱'DEFAULT_LANG'     => 'zh-cn', // 預設語言/* 資料庫設定 */'DB_TYPE'        => 'mysql',   // 資料庫類型'DB_HOST'        => 'localhost', // 伺服器位址'DB_NAME'        => '',     // 資料庫名'DB_USER'        => 'root',   // 使用者名稱'DB_PWD'        => '',     // 密碼'DB_PORT'        => 3306,    // 連接埠'DB_PREFIX'       => 'think_',  // 資料庫表首碼'DB_SUFFIX'       => '',     // 資料庫表尾碼'DB_FIELDTYPE_CHECK'  => false,    // 是否進列欄位類型檢查'DB_FIELDS_CACHE'    => true,    // 啟用欄位緩衝'DB_CHARSET'      => 'utf8',   // 資料庫編碼預設採用utf8'DB_DEPLOY_TYPE'    => 0, // 資料庫部署方式:0 集中式(單一伺服器),1 分布式(主從伺服器)'DB_RW_SEPARATE'    => false,    // 資料庫讀寫是否分離 主從式有效/* 資料緩衝設定 */'DATA_CACHE_TIME'  => -1,   // 資料緩衝有效期間'DATA_CACHE_COMPRESS'  => false,  // 資料緩衝是否壓縮緩衝'DATA_CACHE_CHECK'  => false,  // 資料緩衝是否校正緩衝'DATA_CACHE_TYPE'  => 'File', // 資料緩衝類型,支援:File|Db|Apc|Memcache|Shmop|Sqlite| Xcache|Apachenote|Eaccelerator'DATA_CACHE_PATH'    => TEMP_PATH,// 緩衝路徑設定 (僅對File方式緩衝有效)'DATA_CACHE_SUBDIR'  => false,  // 使用子目錄緩衝 (自動根據緩衝標識的雜湊建立子目錄)'DATA_PATH_LEVEL'    => 1,    // 子目錄緩衝層級/* 錯誤設定 */'ERROR_MESSAGE' => '您瀏覽的頁面暫時發生了錯誤！請稍後再試～',//錯誤顯示資訊,非偵錯模式有效'ERROR_PAGE'  => '', // 錯誤定向頁面/* 靜態緩衝設定 */'HTML_CACHE_ON'  => false,  // 預設關閉靜態緩衝'HTML_CACHE_TIME'  => 60,   // 靜態緩衝有效期間'HTML_READ_TYPE'    => 0,    // 靜態緩衝讀取方式 0 readfile 1 redirect'HTML_FILE_SUFFIX'   => '.shtml',// 預設靜態檔案尾碼/* 語言設定 */'LANG_SWITCH_ON'    => false,  // 預設關閉多語言套件功能'LANG_AUTO_DETECT'   => true,  // 自動偵測語言 開啟多語言功能後有效/* 日誌設定 */'LOG_RECORD'      => false,  // 預設不記錄日誌'LOG_FILE_SIZE'     => 2097152, // 記錄檔大小限制'LOG_RECORD_LEVEL'   => array('EMERG','ALERT','CRIT','ERR'),// 允許記錄的記錄層級/* 分頁設定 */'PAGE_ROLLPAGE'     => 5,   // 分頁顯示頁數'PAGE_LISTROWS'     => 20,   // 分頁每頁顯示記錄數/* SESSION設定 */'SESSION_AUTO_START'  => true,  // 是否自動開啟Session// 內建SESSION類可用參數//'SESSION_NAME'     => '',   // Session名稱//'SESSION_PATH'     => '',   // Session儲存路徑//'SESSION_CALLBACK'   => '',   // Session 對象還原序列化時候的回呼函數/* 已耗用時間設定 */'SHOW_RUN_TIME'  => false,  // 已耗用時間顯示'SHOW_ADV_TIME'  => false,  // 顯示詳細的已耗用時間'SHOW_DB_TIMES'  => false,  // 顯示資料庫查詢和寫入次數'SHOW_CACHE_TIMES'  => false,  // 顯示快取作業次數'SHOW_USE_MEM'  => false,  // 顯示記憶體開銷'SHOW_PAGE_TRACE'  => false,  // 顯示頁面Trace資訊 由Trace檔案定義和Action操作賦值'SHOW_ERROR_MSG'    => true,  // 顯示錯誤資訊/* 模板引擎設定 */'TMPL_ENGINE_TYPE'  => 'Think',   // 預設範本引擎 以下設定僅對使用Think模板引擎有效'TMPL_DETECT_THEME'   => false,    // 自動偵測模板主題'TMPL_TEMPLATE_SUFFIX' => '.html',   // 預設範本檔案尾碼'TMPL_CACHFILE_SUFFIX' => '.php',   // 預設範本緩衝尾碼'TMPL_DENY_FUNC_LIST' => 'echo,exit', // 模板引擎禁用函數'TMPL_PARSE_STRING'   => '',     // 模板引擎要自動替換的字串，必須是數組形式。'TMPL_L_DELIM'     => '{',  // 模板引擎普通標籤開始標記'TMPL_R_DELIM'     => '}',  // 模板引擎普通標籤結束標記'TMPL_VAR_IDENTIFY'   => 'array',   // 模板變數識別。留空自動判斷,參數為'obj'則表示對象'TMPL_STRIP_SPACE'   => false,    // 是否去除模板檔案裡面的html空格與換行'TMPL_CACHE_ON'  => true,    // 是否開啟模板編譯緩衝,設為false則每次都會重新編譯'TMPL_CACHE_TIME'  => -1,     // 模板緩衝有效期間 -1 為永久，(以數字為值，單位:秒)'TMPL_ACTION_ERROR'   => 'Public:success', // 預設錯誤跳轉對應的模板檔案'TMPL_ACTION_SUCCESS'  => 'Public:success', // 預設成功跳轉對應的模板檔案'TMPL_TRACE_FILE'    => THINK_PATH.'/Tpl/PageTrace.tpl.php',   // 頁面Trace的模板檔案'TMPL_EXCEPTION_FILE'  => THINK_PATH.'/Tpl/ThinkException.tpl.php',// 異常頁面的模板檔案'TMPL_FILE_DEPR'=>'/', //模板檔案MODULE_NAME與ACTION_NAME之間的分割符，只對項目分組部署有效// Think模板引擎標籤庫相關設定'TAGLIB_BEGIN'     => '<', // 標籤庫標籤開始標記'TAGLIB_END'      => '>', // 標籤庫標籤結束標記'TAGLIB_LOAD'      => true, // 是否使用內建標籤庫之外的其它標籤庫，預設自動檢測'TAGLIB_BUILD_IN'    => 'cx', // 內建標籤庫名稱(標籤使用不必指定標籤庫名稱),以逗號分隔'TAGLIB_PRE_LOAD'    => '',  // 需要額外載入的標籤庫(須指定標籤庫名稱)，多個以逗號分隔'TAG_NESTED_LEVEL'  => 3,  // 標籤嵌套層級'TAG_EXTEND_PARSE'   => '',  // 指定對普通標籤進行擴充定義和解析的函數名稱。/* 表單令牌驗證 */'TOKEN_ON'          =>  true,   // 開啟令牌驗證'TOKEN_NAME'        =>  '__hash__',  // 令牌驗證的表單隱藏欄位名稱'TOKEN_TYPE'         =>  'md5',  // 令牌驗證雜湊規則/* URL設定 */'URL_CASE_INSENSITIVE' => false,  // URL地址是否不區分大小寫'URL_ROUTER_ON'     => false,  // 是否開啟URL路由'URL_DISPATCH_ON'    => true, // 是否啟用Dispatcher'URL_MODEL'   => 1,    // URL訪問模式,選擇性參數0、1、2、3,代表以下四種模式：// 0 (普通模式); 1 (PATHINFO 模式); 2 (REWRITE 模式); 3 (相容模式) 當URL_DISPATCH_ON開啟後有效; 預設為PATHINFO 模式，提供最好的使用者體驗和SEO支援'URL_PATHINFO_MODEL'  => 2,    // PATHINFO 模式,使用數字1、2、3代表以下三種模式:// 1 普通模式(參數沒有順序,例如/m/module/a/action/id/1);// 2 智能模式(系統預設使用的模式，可自動識別模組和操作/module/action/id/1/ 或者 /module,action,id,1/...);// 3 相容模式(通過一個GET變數將PATHINFO傳遞給dispather，預設為s index.php?s=/module/action/id/1)'URL_PATHINFO_DEPR'   => '/', // PATHINFO模式下，各參數之間的分割符號'URL_HTML_SUFFIX'    => '', // URL偽靜態尾碼設定/* 系統變數名稱設定 */'VAR_GROUP'       => 'g',   // 預設分組擷取變數'VAR_MODULE'      => 'm',  // 預設模組擷取變數'VAR_ACTION'      => 'a',  // 預設操作擷取變數'VAR_ROUTER'      => 'r',   // 預設路由擷取變數'VAR_PAGE'       => 'p',  // 預設分頁跳轉變數'VAR_TEMPLATE'     => 't',  // 預設範本切換變數'VAR_LANGUAGE'     => 'l',  // 預設語言切換變數'VAR_AJAX_SUBMIT'    => 'ajax', // 預設的AJAX提交變數'VAR_PATHINFO'     => 's', // PATHINFO 相容模式擷取變數例如 ?s=/module/action/id/1 後面的參數取決於URL_PATHINFO_MODEL 和 URL_PATHINFO_DEPR);

此外，還需注意，由於新版系統架構的改變，部分慣例配置的參數已經分離出來納入了行為擴充的屬性參數，讀者可查閱手冊進一步瞭解。

http://www.bkjia.com/PHPjc/840639.htmlwww.bkjia.comtruehttp://www.bkjia.com/PHPjc/840639.htmlTechArticleThinkPHP慣例設定檔詳解， ThinkPHP的系統內建有一個慣例設定檔（位於系統目錄下面的Conf\convention.php），按照大多數的使用對常用參數進...

