ThinkPHP惯例配置讲解

分类：PHP时间： 2015年2月18日

ThinkPHP框架是国人开发的优秀PHP框架之一，ThinkPHP文档还有代码注释都是中文的，学习起来非常的顺手。下面主要介绍下ThinkPHP惯例配置讲解（ThinkPHP\Conf\convention.php）框架默认的设置，包括应用相关的配置、PHP cookie和session的设置、ThinkPHP的框架自己的配置、数据库连接和数据缓存配置、日志设置、错误模板的配置、模板引擎的配置和布局的设置、模板标签和系统变量的配置、URL路径的配置。

1、ThinkPHP应用设定 

‘APP_USE_NAMESPACE’ => true, // 应用类库是否使用命名空间

‘APP_SUB_DOMAIN_DEPLOY’ => false, // 是否开启子域名部署

‘APP_SUB_DOMAIN_RULES’ => array(), // 子域名部署规则

‘APP_DOMAIN_SUFFIX’ => ”, // 域名后缀 如果是com.cn net.cn 之类的后缀必须设置

‘ACTION_SUFFIX’ => ”, // 操作方法后缀

‘MULTI_MODULE’ => true, // 是否允许多模块 如果为false 则必须设置 DEFAULT_MODULE

‘MODULE_DENY_LIST’ => array(‘Common’,’Runtime’),

‘CONTROLLER_LEVEL’ => 1,

‘APP_AUTOLOAD_LAYER’ => ‘Controller,Model’, // 自动加载的应用类库层 关闭APP_USE_NAMESPACE后有效

‘APP_AUTOLOAD_PATH’ => ”, // 自动加载的路径 关闭APP_USE_NAMESPACE后有效

2、PHP cookie和session的设置

/* Cookie设置 */

‘COOKIE_EXPIRE’ => 0, // Cookie有效期

‘COOKIE_DOMAIN’ => ”, // Cookie有效域名

‘COOKIE_PATH’ => ‘/’, // Cookie路径

‘COOKIE_PREFIX’ => ”, // Cookie前缀 避免冲突

‘COOKIE_SECURE’ => false, // Cookie安全传输

‘COOKIE_HTTPONLY’ => ”, // Cookie httponly设置

/* SESSION设置 */

‘SESSION_AUTO_START’ => true, // 是否自动开启Session

‘SESSION_OPTIONS’ => array(), // session 配置数组 支持type name id path expire domain 等参数

‘SESSION_TYPE’ => ”, // session hander类型 默认无需设置 除非扩展了session hander驱动

‘SESSION_PREFIX’ => ”, // session 前缀

//’VAR_SESSION_ID’ => ‘session_id’, //sessionID的提交变量

3、ThinkPHP框架自带的配置

‘DEFAULT_M_LAYER’ => ‘Model’, // 默认的模型层名称

‘DEFAULT_C_LAYER’ => ‘Controller’, // 默认的控制器层名称

‘DEFAULT_V_LAYER’ => ‘View’, // 默认的视图层名称

‘DEFAULT_LANG’ => ‘zh-cn’, // 默认语言

‘DEFAULT_THEME’ => ”, // 默认模板主题名称

‘DEFAULT_MODULE’ => ‘Home’, // 默认模块

‘DEFAULT_CONTROLLER’ => ‘Index’, // 默认控制器名称

‘DEFAULT_ACTION’ => ‘index’, // 默认操作名称

‘DEFAULT_CHARSET’ => ‘utf-8′, // 默认输出编码

‘DEFAULT_TIMEZONE’ => ‘PRC’, // 默认时区

‘DEFAULT_AJAX_RETURN’ => ‘JSON’, // 默认AJAX 数据返回格式,可选JSON XML …

‘DEFAULT_JSONP_HANDLER’ => ‘jsonpReturn’, // 默认JSONP格式返回的处理方法

‘DEFAULT_FILTER’ => ‘htmlspecialchars’, // 默认参数过滤方法 用于I函数…

4、ThinkPHP连接数据库设置 

‘DB_TYPE’ => ”, // 数据库类型,目前的数据库包括Mysql、SqlServer、PgSQL、Sqlite、Oracle、Ibase、MongoDB

‘DB_HOST’ => ”, // 服务器地址

‘DB_NAME’ => ”, // 数据库名

‘DB_USER’ => ”, // 用户名

‘DB_PWD’ => ”, // 密码

‘DB_PORT’ => ”, // 端口

‘DB_PREFIX’ => ”, // 数据库表前缀

‘DB_PARAMS’ => array(), // 数据库连接参数

‘DB_DEBUG’ => TRUE, // 数据库调试模式 开启后可以记录SQL日志

‘DB_FIELDS_CACHE’ => true, // 启用字段缓存

‘DB_CHARSET’ => ‘utf8′, // 数据库编码默认采用utf8

‘DB_DEPLOY_TYPE’ => 0, // 数据库部署方式:0 集中式(单一服务器),1 分布式(主从服务器)

‘DB_RW_SEPARATE’ => false, // 数据库读写是否分离 主从式有效

‘DB_MASTER_NUM’ => 1, // 读写分离后 主服务器数量

‘DB_SLAVE_NO’ => ”, // 指定从服务器序号

5、ThinkPHP数据缓存设置

‘DATA_CACHE_TIME’ => 0, // 数据缓存有效期 0表示永久缓存

‘DATA_CACHE_COMPRESS’ => false, // 数据缓存是否压缩缓存

‘DATA_CACHE_CHECK’ => false, // 数据缓存是否校验缓存

‘DATA_CACHE_PREFIX’ => ”, // 缓存前缀

‘DATA_CACHE_TYPE’ => ‘File’, // 数据缓存类型,支持:File|Db|Apc|Memcache|Shmop|Sqlite|Xcache|Apachenote|Eaccelerator

‘DATA_CACHE_PATH’ => TEMP_PATH,// 缓存路径设置 (仅对File方式缓存有效)

‘DATA_CACHE_KEY’ => ”, // 缓存文件KEY (仅对File方式缓存有效)

‘DATA_CACHE_SUBDIR’ => false, // 使用子目录缓存 (自动根据缓存标识的哈希创建子目录)

‘DATA_PATH_LEVEL’ => 1, // 子目录缓存级别

6、ThinkPHP错误设置

‘ERROR_MESSAGE’ => ‘页面错误！请稍后再试～’,//错误显示信息,非调试模式有效

‘ERROR_PAGE’ => ”, // 错误定向页面

‘SHOW_ERROR_MSG’ => false, // 显示错误信息

‘TRACE_MAX_RECORD’ => 100, // 每个级别的错误信息 最大记录数

7、ThinkPHP日志设置

‘LOG_RECORD’ => false, // 默认不记录日志

‘LOG_TYPE’ => ‘File’, // 日志记录类型 默认为文件方式

‘LOG_LEVEL’ => ‘EMERG,ALERT,CRIT,ERR’,// 允许记录的日志级别

‘LOG_FILE_SIZE’ => 2097152, // 日志文件大小限制

‘LOG_EXCEPTION_RECORD’ => false, // 是否记录异常信息日志

8、ThinkPHP 模板引擎设置

‘TMPL_CONTENT_TYPE’ => ‘text/html’, // 默认模板输出类型

‘TMPL_ACTION_ERROR’ => THINK_PATH.’Tpl/dispatch_jump.tpl’, // 默认错误跳转对应的模板文件

‘TMPL_ACTION_SUCCESS’ => THINK_PATH.’Tpl/dispatch_jump.tpl’, // 默认成功跳转对应的模板文件

‘TMPL_EXCEPTION_FILE’ => THINK_PATH.’Tpl/think_exception.tpl’,// 异常页面的模板文件

‘TMPL_DETECT_THEME’ => false, // 自动侦测模板主题

‘TMPL_TEMPLATE_SUFFIX’ => ‘.html’, // 默认模板文件后缀

‘TMPL_FILE_DEPR’ => ‘/’, //模板文件CONTROLLER_NAME与ACTION_NAME之间的分割符

9、ThinkPHP布局设置

‘TMPL_ENGINE_TYPE’ => ‘Think’, // 默认模板引擎 以下设置仅对使用Think模板引擎有效

‘TMPL_CACHFILE_SUFFIX’ => ‘.php’, // 默认模板缓存后缀

‘TMPL_DENY_FUNC_LIST’ => ‘echo,exit’, // 模板引擎禁用函数

‘TMPL_DENY_PHP’ => false, // 默认模板引擎是否禁用PHP原生代码

‘TMPL_L_DELIM’ => ‘{‘, // 模板引擎普通标签开始标记

‘TMPL_R_DELIM’ => ‘}’, // 模板引擎普通标签结束标记

‘TMPL_VAR_IDENTIFY’ => ‘array’, // 模板变量识别。留空自动判断,参数为’obj’则表示对象

‘TMPL_STRIP_SPACE’ => true, // 是否去除模板文件里面的html空格与换行

‘TMPL_CACHE_ON’ => true, // 是否开启模板编译缓存,设为false则每次都会重新编译

‘TMPL_CACHE_PREFIX’ => ”, // 模板缓存前缀标识，可以动态改变

‘TMPL_CACHE_TIME’ => 0, // 模板缓存有效期 0 为永久，(以数字为值，单位:秒)

‘TMPL_LAYOUT_ITEM’ => ‘{__CONTENT__}’, // 布局模板的内容替换标识

‘LAYOUT_ON’ => false, // 是否启用布局

‘LAYOUT_NAME’ => ‘layout’, // 当前布局名称 默认为layout

10、Thinkphp标签库和系统变量的配置

// Think模板引擎标签库相关设定

‘TAGLIB_BEGIN’ => ‘

‘TAGLIB_END’ => ‘>’, // 标签库标签结束标记

‘TAGLIB_LOAD’ => true, // 是否使用内置标签库之外的其它标签库，默认自动检测

‘TAGLIB_BUILD_IN’ => ‘cx’, // 内置标签库名称(标签使用不必指定标签库名称),以逗号分隔 注意解析顺序

‘TAGLIB_PRE_LOAD’ => ”, // 需要额外加载的标签库(须指定标签库名称)，多个以逗号分隔

/* 系统变量名称设置 */

‘VAR_MODULE’ => ‘m’, // 默认模块获取变量

‘VAR_ADDON’ => ‘addon’, // 默认的插件控制器命名空间变量

‘VAR_CONTROLLER’ => ‘c’, // 默认控制器获取变量

‘VAR_ACTION’ => ‘a’, // 默认操作获取变量

‘VAR_AJAX_SUBMIT’ => ‘ajax’, // 默认的AJAX提交变量

‘VAR_JSONP_HANDLER’ => ‘callback’,

‘VAR_PATHINFO’ => ‘s’, // 兼容模式PATHINFO获取变量例如 ?s=/module/action/id/1 后面的参数取决于URL_PATHINFO_DEPR

‘VAR_TEMPLATE’ => ‘t’, // 默认模板切换变量

‘VAR_AUTO_STRING’ => false, // 输入变量是否自动强制转换为字符串 如果开启则数组变量需要手动传入变量修饰符获取变量

‘HTTP_CACHE_CONTROL’ => ‘private’, // 网页缓存控制

‘CHECK_APP_DIR’ => true, // 是否检查应用目录是否创建

‘FILE_UPLOAD_TYPE’ => ‘Local’, // 文件上传方式

‘DATA_CRYPT_TYPE’ => ‘Think’, // 数据加密方式

11、 URL设置 

‘URL_CASE_INSENSITIVE’ => true, // 默认false 表示URL区分大小写 true则表示不区分大小写

‘URL_MODEL’ => 1, // URL访问模式,可选参数0、1、2、3,代表以下四种模式：

// 0 (普通模式); 1 (PATHINFO 模式); 2 (REWRITE 模式); 3 (兼容模式) 默认为PATHINFO 模式

‘URL_PATHINFO_DEPR’ => ‘/’, // PATHINFO模式下，各参数之间的分割符号

‘URL_PATHINFO_FETCH’ => ‘ORIG_PATH_INFO,REDIRECT_PATH_INFO,REDIRECT_URL’, // 用于兼容判断PATH_INFO 参数的SERVER替代变量列表

‘URL_REQUEST_URI’ => ‘REQUEST_URI’, // 获取当前页面地址的系统变量 默认为REQUEST_URI

‘URL_HTML_SUFFIX’ => ‘html’, // URL伪静态后缀设置

‘URL_DENY_SUFFIX’ => ‘ico|png|gif|jpg’, // URL禁止访问的后缀设置

‘URL_PARAMS_BIND’ => true, // URL变量绑定到Action方法参数

‘URL_PARAMS_BIND_TYPE’ => 0, // URL变量绑定的类型 0 按变量名绑定 1 按变量顺序绑定

‘URL_PARAMS_FILTER’ => false, // URL变量绑定过滤

‘URL_PARAMS_FILTER_TYPE’=> ”, // URL变量绑定过滤方法 如果为空 调用DEFAULT_FILTER

‘URL_ROUTER_ON’ => false, // 是否开启URL路由

‘URL_ROUTE_RULES’ => array(), // 默认路由规则 针对模块

‘URL_MAP_RULES’ => array(), // URL映射定义规则