ThinkPHP惯例配置文件详解


Posted in PHP onJuly 14, 2014

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

);

此外,还需注意,由于新版系统架构的改变,部分惯例配置的参数已经分离出来纳入了行为扩展的属性参数,读者可查阅手册进一步了解。

PHP 相关文章推荐
PHP开发大型项目的一点经验
Oct 09 PHP
最新用php获取谷歌PR值算法,附上php查询PR值代码示例
Dec 25 PHP
简单谈谈php中ob_flush和flush的区别
Nov 27 PHP
php实现按指定大小等比缩放生成上传图片缩略图的方法
Dec 15 PHP
php魔术函数__call()用法实例分析
Feb 13 PHP
PHP登录验证码的实现与使用方法
Jul 07 PHP
php实现xml转换数组的方法示例
Feb 03 PHP
Laravel框架模板加载,分配变量及简单路由功能示例
Jun 11 PHP
PHP实现断点续传乱序合并文件的方法
Sep 06 PHP
Laravel的Auth验证Token验证使用自定义Redis的例子
Sep 30 PHP
laravel 关联关系遍历数组的例子
Oct 10 PHP
PHP实现基本留言板功能原理与步骤详解
Mar 26 PHP
2014年10个最佳的PHP图像操作库
Jul 14 #PHP
php中的四舍五入函数代码(floor函数、ceil函数、round与intval)
Jul 14 #PHP
mantis安装、配置和使用中的问题小结
Jul 14 #PHP
kohana框架上传文件验证规则写法示例
Jul 14 #PHP
PHP开发框架kohana中处理ajax请求的例子
Jul 14 #PHP
兼容ie6浏览器的php下载文件代码分享
Jul 14 #PHP
国产PHP开发框架myqee新手快速入门教程
Jul 14 #PHP
You might like
生成卡号php代码
2008/04/09 PHP
如何在php中正确的使用json
2013/08/06 PHP
php通过修改header强制图片下载的方法
2015/03/24 PHP
PHP生成图像验证码的方法小结(2种方法)
2016/07/18 PHP
iis 7下安装laravel 5.4环境的方法教程
2017/06/14 PHP
PHP生成加减算法方式的验证码实例
2018/03/12 PHP
php定期拉取数据对比方法实例
2019/09/22 PHP
JavaScript 动态添加表格行 使用模板、标记
2009/10/24 Javascript
javascript奇异的arguments分析
2010/10/20 Javascript
jQuery操作checkbox选择(list/table)
2013/04/07 Javascript
动态载入js提高网页打开速度的方法
2014/07/04 Javascript
基于promise.js实现nodejs的promises库
2014/07/06 NodeJs
jQuery中odd选择器的定义和用法
2014/12/23 Javascript
JavaScript中的变量定义与储存介绍
2014/12/31 Javascript
jQuery使用prepend()方法在元素前添加内容用法实例
2015/03/26 Javascript
Jquery效果大全之制作电脑健康体检得分特效附源码下载
2015/11/02 Javascript
javascript实现tab切换的四种方法
2015/11/05 Javascript
jQuery插件HighCharts绘制简单2D柱状图效果示例【附demo源码】
2017/03/21 jQuery
Vue中保存用户登录状态实例代码
2017/06/07 Javascript
vue 实现 tomato timer(蕃茄钟)实例讲解
2017/07/24 Javascript
vue 数组和对象不能直接赋值情况和解决方法(推荐)
2017/10/25 Javascript
使用vue的v-for生成table并给table加上序号的实例代码
2017/10/27 Javascript
JavaScript 函数用法详解【函数定义、参数、绑定、作用域、闭包等】
2020/05/12 Javascript
[01:13:01]2018DOTA2亚洲邀请赛 4.4 淘汰赛 TNC vs VG 第三场
2018/04/05 DOTA
[41:13]完美世界DOTA2联赛PWL S2 Forest vs Rebirth 第一场 11.20
2020/11/20 DOTA
python之yield表达式学习
2014/09/02 Python
python定向爬取淘宝商品价格
2018/02/27 Python
python将字典列表导出为Excel文件的方法
2019/09/02 Python
Python树莓派学习笔记之UDP传输视频帧操作详解
2019/11/15 Python
python接口自动化如何封装获取常量的类
2019/12/24 Python
如何给Python代码进行加密
2020/01/10 Python
有机童装:Toby Tiger
2018/05/23 全球购物
Hoka One One法国官网:美国专业跑鞋品牌
2018/12/29 全球购物
2014全年工作总结
2014/11/27 职场文书
九年级英语教学反思
2016/02/15 职场文书
李白经典诗之一:全文无一“月”字,却句句有月
2019/07/12 职场文书