20.2 配置参考

这里列出了系统的惯例配置和内置系统行为的配置参数列表。

惯例配置

配置名 说明 默认值
应用设置
APP_STATUS 应用调试模式状态 调试模式开启后有效 默认为debug
可扩展 并自动加载对应的配置文件
debug
APP_FILE_CASE 是否检查文件的大小写 对Windows平台有效 false
APP_AUTOLOAD_PATH 自动加载机制的自动搜索路径,注意搜索顺序  
APP_TAGS_ON 系统标签扩展开关 true
APP_SUB_DOMAIN_DEPLOY 是否开启子域名部署 false
APP_SUB_DOMAIN_RULES 子域名部署规则 array()
APP_SUB_DOMAIN_DENY 子域名禁用列表 array()
APP_GROUP_LIST 项目分组设定,多个组之间用逗号分隔  
ACTION_SUFFIX 操作方法后缀  
默认值设置
DEFAULT_APP 默认项目名称,@表示当前项目 @
DEFAULT_LANG 默认语言 zh-cn
DEFAULT_THEME 默认模板主题名称  
DEFAULT_GROUP 默认分组名 Home
DEFAULT_MODULE 默认模块名 Index
DEFAULT_ACTION 默认操作名 index
DEFAULT_CHARSET 默认输出编码 utf-8
DEFAULT_TIMEZONE 默认时区 PRC
DEFAULT_AJAX_RETURN 默认AJAX 数据返回格式,可选JSON XML JSON
DEFAULT_FILTER 默认参数过滤方法 htmlspecialchars
Cookie设置
COOKIE_EXPIRE Coodie有效期(秒) 3600
COOKIE_DOMAIN Cookie有效域名  
COOKIE_PATH Cookie路径 /
COOKIE_PREFIX Cookie前缀 避免冲突  
数据库配置
DB_TYPE 数据库类型 mysql
DB_DSN 数据库连接信息DSN串  
DB_HOST 数据库服务器地址 localhost
DB_NAME 数据库名称  
DB_USER 数据库用户名 root
DB_PWD 数据库用户密码  
DB_PORT 数据库端口  
DB_FIELDS_CACHE 是否开启数据表字段缓存 true
DB_FIELDTYPE_CHECK 是否开启字段类型检查 false
DB_CHARSET 数据库编码 utf8
DB_DEPLOY_TYPE 数据库部署方式 0 集中式 1 分布式 0
DB_RW_SEPARATE 数据库是否需要读写分离 分布式部署下有效 false
DB_MASTER_NUM 设置读写分离后 主服务器数量 1
DB_SLAVE_NO 设置读写分离后 指定从服务器序号(3.1新增)
DB_SQL_BUILD_CACHE 数据库查询的SQL创建缓存 false
DB_SQL_BUILD_QUEUE SQL缓存队列的缓存方式 file
DB_SQL_BUILD_LENGTH SQL缓存的队列长度 20
DB_SQL_LOG 是否开启SQL日志记录(3.1新增) false
数据缓存设置
DATA_CACHE_TIME 数据缓存有效期 0表示永久缓存 0
DATA_CACHE_COMPRESS 数据缓存是否压缩缓存 false
DATA_CACHE_CHECK 数据缓存是否校验缓存 false
DATA_CACHE_TYPE 数据缓存类型 File
DATA_CACHE_PATH 缓存路径设置 (仅对File方式缓存有效) TEMP_PATH
DATA_CACHE_SUBDIR 使用子目录缓存(仅对File方式缓存有效) false
DATA_PATH_LEVEL 子目录缓存级别(仅对File方式缓存有效) 1
错误设置
ERROR_MESSAGE 错误显示信息,部署模式有效  
ERROR_PAGE 错误定向页面,部署模式有效  
SHOW_ERROR_MSG 是否显示错误信息 False
日志设置
LOG_RECORD 是否记录日志信息 false
LOG_TYPE 默认日志记录类型 0 系统 1 邮件 3 文件 4 SAPI 3
LOG_DEST 日志记录目标  
LOG_EXTRA 日志记录额外信息  
LOG_LEVEL 允许记录的日志级别 EMERG,ALERT,CRIT,ERR
LOG_FILE_SIZE 日志文件大小限制(字节 文件方式有效) 2097152
LOG_EXCEPTION_RECORD 是否记录异常信息日志 false
SESSION设置
SESSION_AUTO_START 是否自动开启Session true
SESSION_OPTIONS session 配置数组 array()
SESSION_TYPE session hander类型  
SESSION_PREFIX session 前缀  
VAR_SESSION_ID sessionID的提交变量 session_id
模板引擎设置
TMPL_CONTENT_TYPE 默认模板输出类型 text/html
TMPL_ACTION_ERROR 默认错误跳转对应的模板文件 系统模板目录下的dispatch_jump.tpl
TMPL_ACTION_SUCCESS 默认成功跳转对应的模板文件 同上
TMPL_EXCEPTION_FILE 异常页面的模板文件 系统模板目录下的think_exception.tpl
TMPL_DETECT_THEME 自动侦测模板主题 false
TMPL_TEMPLATE_SUFFIX 默认模板文件后缀 .html
TMPL_FILE_DEPR 模板文件模块与操作之间的分割符,只对项目分组部署有效 /
URL设置
URL_CASE_INSENSITIVE URL是否不区分大小写 false
URL_MODEL URL访问模式支持 0 (普通模式);
1 (PATHINFO 模式);
2 (REWRITE  模式);
3 (兼容模式)
1
URL_PATHINFO_DEPR PATHINFO模式下的参数分割符 /
URL_PATHINFO_FETCH 用于兼容判断PATH_INFO 参数的SERVER替代变量列表 ORIG_PATH_INFO
REDIRECT_PATH_INFO
REDIRECT_URL
URL_HTML_SUFFIX URL伪静态后缀设置  
URL_404_REDIRECT 404跳转页面 部署模式有效(3.1新增)  
URL_PARAMS_BIND URL变量绑定到Action方法参数(3.1新增) true
系统变量名称设置
VAR_GROUP 默认分组获取变量 g
VAR_MODULE 默认模块获取变量 m
VAR_ACTION 默认操作获取变量 a
VAR_AJAX_SUBMIT 默认的AJAX提交变量 ajax
VAR_TEMPLATE 默认模板主题切换变量 t
VAR_PATHINFO 兼容模式获取变量 s
VAR_URL_PARAMS PATHINFOURL参数变量 _URL_
VAR_FILTERS 全局系统变量的默认过滤方法 多个用逗号分割(3.1新增)
OUTPUT_ENCODE 是否开启页面压缩输出(3.1新增) true

行为配置

这里仅仅列出了系统内置的行为扩展的配置参数
配置名 说明 默认值
CheckRoute行为配置
URL_ROUTER_ON 是否开启URL路由 false
URL_ROUTE_RULES 默认路由规则 array()
ContentReplace行为配置
TMPL_PARSE_STRING 模板替换规则 array()
ParseTemplate行为配置
TMPL_ENGINE_TYPE 默认模板引擎 Think
TMPL_CACHFILE_SUFFIX 默认模板缓存后缀 .php
TMPL_DENY_FUNC_LIST 模板引擎禁用函数 echo,exit
TMPL_DENY_PHP 是否禁用PHP原生代码 false
TMPL_L_DELIM 模板引擎普通标签开始标记 {
TMPL_R_DELIM 模板引擎普通标签结束标记 }
TAGLIB_BEGIN 标签库标签开始标记
TAGLIB_END 标签库标签结束标记
TAGLIB_LOAD 是否使用内置标签库之外的其它标签库,默认自动检测 true
TAGLIB_BUILD_IN 内置标签库名称 cx
TAGLIB_PRE_LOAD 需要预先加载的标签库  
TMPL_VAR_IDENTIFY 模板变量识别。留空自动判断 array
TMPL_STRIP_SPACE 是否去除模板文件里面的html空格与换行 true
TMPL_CACHE_ON 是否开启模板编译缓存 true
TMPL_CACHE_TIME 模板缓存有效期 0为永久 0
LAYOUT_ON 是否启用布局 false
LAYOUT_NAME 当前布局名称 layout
TMPL_LAYOUT_ITEM 布局模板的内容替换标识 {__CONTENT__}
ReadHtmlCache行为配置
HTML_CACHE_ON 是否开启静态缓存 false
HTML_CACHE_RULES 静态缓存规则 array()
HTML_CACHE_TIME 静态缓存有效期(秒) 60
HTML_FILE_SUFFIX 静态缓存后缀 .html
ShowPageTrace行为配置
SHOW_PAGE_TRACE 显示页面Trace信息 false
ShowRuntime行为配置
SHOW_RUN_TIME 是否显示运行时间 false
SHOW_ADV_TIME 是否显示详细的运行时间 false
SHOW_DB_TIMES 是否显示数据库查询和写入次数 false
SHOW_CACHE_TIMES 是否显示缓存操作次数 false
SHOW_USE_MEM 是否显示内存开销 false
SHOW_LOAD_FILE 是否显示加载文件数 false
SHOW_FUN_TIMES 是否显示函数调用次数 false
TokenBuild行为配置
TOKEN_ON 是否开启令牌验证 true
TOKEN_NAME 令牌验证的表单隐藏字段名称 __hash__
TOKEN_TYPE 令牌验证哈希规则 md5
TOKEN_RESET 令牌错误后是否重置 true