# 配置参考
[上一页](# "上一页")[下一页](# "下一页")
这里列出了系统的惯例配置和内置系统行为的配置参数列表。
### 惯例配置
<table border="0" cellspacing="1" cellpadding="0"><tr><th>配置名 </th> <th>说明 </th> <th>默认值 </th> </tr><tr><td colspan="3"><b>应用设置 </b></td> </tr><tr><td>APP_STATUS</td> <td>应用调试模式状态 调试模式开启后有效 默认为debug <br/>可扩展 并自动加载对应的配置文件 </td> <td>debug</td> </tr><tr><td>APP_FILE_CASE</td> <td>是否检查文件的大小写 对Windows平台有效 </td> <td>false</td> </tr><tr><td>APP_AUTOLOAD_PATH</td> <td>自动加载机制的自动搜索路径,注意搜索顺序 </td> <td> </td> </tr><tr><td>APP_TAGS_ON</td> <td>系统标签扩展开关 </td> <td>true</td> </tr><tr><td>APP_SUB_DOMAIN_DEPLOY</td> <td>是否开启子域名部署 </td> <td>false</td> </tr><tr><td>APP_SUB_DOMAIN_RULES</td> <td>子域名部署规则 </td> <td>array()</td> </tr><tr><td>APP_SUB_DOMAIN_DENY</td> <td>子域名禁用列表 </td> <td>array()</td> </tr><tr><td>APP_GROUP_LIST</td> <td>项目分组设定,多个组之间用逗号分隔 </td> <td> </td> </tr><tr><td>ACTION_SUFFIX</td> <td>操作方法后缀 </td> <td> </td> </tr><tr><td colspan="3"><b>默认值设置</b></td> </tr><tr><td>DEFAULT_APP</td> <td>默认项目名称，@表示当前项目 </td> <td>@</td> </tr><tr><td>DEFAULT_LANG</td> <td>默认语言 </td> <td>zh-cn</td> </tr><tr><td>DEFAULT_THEME</td> <td>默认模板主题名称 </td> <td> </td> </tr><tr><td>DEFAULT_GROUP</td> <td>默认分组名 </td> <td>Home</td> </tr><tr><td>DEFAULT_MODULE</td> <td>默认模块名 </td> <td>Index</td> </tr><tr><td>DEFAULT_ACTION</td> <td>默认操作名 </td> <td>index</td> </tr><tr><td>DEFAULT_CHARSET</td> <td>默认输出编码 </td> <td>utf-8</td> </tr><tr><td>DEFAULT_TIMEZONE</td> <td>默认时区 </td> <td>PRC</td> </tr><tr><td>DEFAULT_AJAX_RETURN</td> <td>默认AJAX 数据返回格式,可选JSON XML</td> <td>JSON</td> </tr><tr><td>DEFAULT_FILTER</td> <td>默认参数过滤方法 </td> <td>htmlspecialchars</td> </tr><tr><td colspan="3"><b>Cookie设置</b></td> </tr><tr><td>COOKIE_EXPIRE</td> <td>Coodie有效期（秒） </td> <td>3600</td> </tr><tr><td>COOKIE_DOMAIN</td> <td>Cookie有效域名 </td> <td> </td> </tr><tr><td>COOKIE_PATH</td> <td>Cookie路径 </td> <td>/</td> </tr><tr><td>COOKIE_PREFIX</td> <td>Cookie前缀 避免冲突 </td> <td> </td> </tr><tr><td colspan="3"><b>数据库配置</b></td> </tr><tr><td>DB_TYPE</td> <td>数据库类型 </td> <td>mysql</td> </tr><tr><td>DB_DSN</td> <td>数据库连接信息DSN串 </td> <td> </td> </tr><tr><td>DB_HOST</td> <td>数据库服务器地址 </td> <td>localhost</td> </tr><tr><td>DB_NAME</td> <td>数据库名称 </td> <td> </td> </tr><tr><td>DB_USER</td> <td>数据库用户名 </td> <td>root</td> </tr><tr><td>DB_PWD</td> <td>数据库用户密码 </td> <td> </td> </tr><tr><td>DB_PORT</td> <td>数据库端口 </td> <td> </td> </tr><tr><td>DB_FIELDS_CACHE</td> <td>是否开启数据表字段缓存 </td> <td>true</td> </tr><tr><td>DB_FIELDTYPE_CHECK</td> <td>是否开启字段类型检查 </td> <td>false</td> </tr><tr><td>DB_CHARSET</td> <td>数据库编码 </td> <td>utf8</td> </tr><tr><td>DB_DEPLOY_TYPE</td> <td>数据库部署方式 0 集中式 1 分布式 </td> <td>0</td> </tr><tr><td>DB_RW_SEPARATE</td> <td>数据库是否需要读写分离 分布式部署下有效 </td> <td>false</td> </tr><tr><td>DB_MASTER_NUM</td> <td>设置读写分离后 主服务器数量 </td> <td>1</td> </tr><tr><td>DB_SLAVE_NO</td> <td>设置读写分离后 指定从服务器序号（3.1新增）</td> <td> </td> </tr><tr><td>DB_SQL_BUILD_CACHE</td> <td>数据库查询的SQL创建缓存 </td> <td>false</td> </tr><tr><td>DB_SQL_BUILD_QUEUE</td> <td>SQL缓存队列的缓存方式 </td> <td>file</td> </tr><tr><td>DB_SQL_BUILD_LENGTH</td> <td>SQL缓存的队列长度 </td> <td>20</td> </tr><tr><td>DB_SQL_LOG</td> <td>是否开启SQL日志记录（3.1新增）</td> <td>false</td> </tr><tr><td colspan="3"><b>数据缓存设置</b></td> </tr><tr><td>DATA_CACHE_TIME</td> <td>数据缓存有效期 0表示永久缓存 </td> <td>0</td> </tr><tr><td>DATA_CACHE_COMPRESS</td> <td>数据缓存是否压缩缓存 </td> <td>false</td> </tr><tr><td>DATA_CACHE_CHECK</td> <td>数据缓存是否校验缓存 </td> <td>false</td> </tr><tr><td>DATA_CACHE_TYPE</td> <td>数据缓存类型 </td> <td>File</td> </tr><tr><td>DATA_CACHE_PATH</td> <td>缓存路径设置 (仅对File方式缓存有效)</td> <td>TEMP_PATH</td> </tr><tr><td>DATA_CACHE_SUBDIR</td> <td>使用子目录缓存(仅对File方式缓存有效)</td> <td>false</td> </tr><tr><td>DATA_PATH_LEVEL</td> <td>子目录缓存级别(仅对File方式缓存有效)</td> <td>1</td> </tr><tr><td colspan="3"><b>错误设置</b></td> </tr><tr><td>ERROR_MESSAGE</td> <td>错误显示信息，部署模式有效 </td> <td> </td> </tr><tr><td>ERROR_PAGE</td> <td>错误定向页面，部署模式有效 </td> <td> </td> </tr><tr><td>SHOW_ERROR_MSG</td> <td>是否显示错误信息 </td> <td>False</td> </tr><tr><td colspan="3"><b>日志设置</b></td> </tr><tr><td>LOG_RECORD</td> <td>是否记录日志信息 </td> <td>false</td> </tr><tr><td>LOG_TYPE</td> <td>默认日志记录类型 0 系统 1 邮件 3 文件 4 SAPI</td> <td>3</td> </tr><tr><td>LOG_DEST</td> <td>日志记录目标 </td> <td> </td> </tr><tr><td>LOG_EXTRA</td> <td>日志记录额外信息 </td> <td> </td> </tr><tr><td>LOG_LEVEL</td> <td>允许记录的日志级别 </td> <td>EMERG,ALERT,CRIT,ERR</td> </tr><tr><td>LOG_FILE_SIZE</td> <td>日志文件大小限制（字节 文件方式有效） </td> <td>2097152</td> </tr><tr><td>LOG_EXCEPTION_RECORD</td> <td>是否记录异常信息日志 </td> <td>false</td> </tr><tr><td colspan="3"><b>SESSION设置</b></td> </tr><tr><td>SESSION_AUTO_START</td> <td>是否自动开启Session</td> <td>true</td> </tr><tr><td>SESSION_OPTIONS</td> <td>session 配置数组 </td> <td>array()</td> </tr><tr><td>SESSION_TYPE</td> <td>session hander类型 </td> <td> </td> </tr><tr><td>SESSION_PREFIX</td> <td>session 前缀 </td> <td> </td> </tr><tr><td>VAR_SESSION_ID</td> <td>sessionID的提交变量 </td> <td>session_id</td> </tr><tr><td colspan="3"><b>模板引擎设置</b></td> </tr><tr><td>TMPL_CONTENT_TYPE</td> <td>默认模板输出类型 </td> <td>text/html</td> </tr><tr><td>TMPL_ACTION_ERROR</td> <td>默认错误跳转对应的模板文件 </td> <td>系统模板目录下的dispatch_jump.tpl</td> </tr><tr><td>TMPL_ACTION_SUCCESS</td> <td>默认成功跳转对应的模板文件 </td> <td>同上 </td> </tr><tr><td>TMPL_EXCEPTION_FILE</td> <td>异常页面的模板文件 </td> <td>系统模板目录下的think_exception.tpl</td> </tr><tr><td>TMPL_DETECT_THEME</td> <td>自动侦测模板主题 </td> <td>false</td> </tr><tr><td>TMPL_TEMPLATE_SUFFIX</td> <td>默认模板文件后缀 </td> <td>.html</td> </tr><tr><td>TMPL_FILE_DEPR</td> <td>模板文件模块与操作之间的分割符，只对项目分组部署有效 </td> <td>/</td> </tr><tr><td colspan="3"><b>URL设置</b></td> </tr><tr><td>URL_CASE_INSENSITIVE</td> <td>URL是否不区分大小写 </td> <td>false</td> </tr><tr><td>URL_MODEL</td> <td>URL访问模式支持 0 (普通模式); <br/>1 (PATHINFO 模式); <br/>2 (REWRITE 模式);<br/> 3 (兼容模式)</td> <td>1</td> </tr><tr><td>URL_PATHINFO_DEPR</td> <td>PATHINFO模式下的参数分割符 </td> <td>/</td> </tr><tr><td>URL_PATHINFO_FETCH</td> <td>用于兼容判断PATH_INFO 参数的SERVER替代变量列表 </td> <td>ORIG_PATH_INFO<br/>REDIRECT_PATH_INFO<br/>REDIRECT_URL</td> </tr><tr><td>URL_HTML_SUFFIX</td> <td>URL伪静态后缀设置 </td> <td> </td> </tr><tr><td>URL_404_REDIRECT</td> <td>404跳转页面 部署模式有效（3.1新增）</td> <td> </td> </tr><tr><td>URL_PARAMS_BIND</td> <td>URL变量绑定到Action方法参数（3.1新增）</td> <td>true</td> </tr><tr><td colspan="3"><b>系统变量名称设置</b></td> </tr><tr><td>VAR_GROUP</td> <td>默认分组获取变量 </td> <td>g</td> </tr><tr><td>VAR_MODULE</td> <td>默认模块获取变量 </td> <td>m</td> </tr><tr><td>VAR_ACTION</td> <td>默认操作获取变量 </td> <td>a</td> </tr><tr><td>VAR_AJAX_SUBMIT</td> <td>默认的AJAX提交变量 </td> <td>ajax</td> </tr><tr><td>VAR_TEMPLATE</td> <td>默认模板主题切换变量 </td> <td>t</td> </tr><tr><td>VAR_PATHINFO</td> <td>兼容模式获取变量 </td> <td>s</td> </tr><tr><td>VAR_URL_PARAMS</td> <td>PATHINFOURL参数变量 </td> <td>_URL_</td> </tr><tr><td>VAR_FILTERS</td> <td>全局系统变量的默认过滤方法 多个用逗号分割（3.1新增） </td> <td> </td> </tr><tr><td>OUTPUT_ENCODE</td> <td>是否开启页面压缩输出（3.1新增） </td> <td>true</td> </tr></table>
### 行为配置
这里仅仅列出了系统内置的行为扩展的配置参数
<table border="0" cellspacing="1" cellpadding="0"><tr><th>配置名 </th> <th>说明 </th> <th>默认值 </th> </tr><tr><td colspan="3"><b>CheckRoute行为配置 </b></td> </tr><tr><td>URL_ROUTER_ON</td> <td>是否开启URL路由 </td> <td>false</td> </tr><tr><td>URL_ROUTE_RULES</td> <td>默认路由规则 </td> <td>array()</td> </tr><tr><td colspan="3"><b>ContentReplace行为配置</b> </td> </tr><tr><td>TMPL_PARSE_STRING</td> <td>模板替换规则 </td> <td>array()</td> </tr><tr><td colspan="3"><b>ParseTemplate行为配置 </b></td> </tr><tr><td>TMPL_ENGINE_TYPE</td> <td>默认模板引擎 </td> <td>Think</td> </tr><tr><td>TMPL_CACHFILE_SUFFIX</td> <td>默认模板缓存后缀 </td> <td>.php</td> </tr><tr><td>TMPL_DENY_FUNC_LIST</td> <td>模板引擎禁用函数 </td> <td>echo,exit</td> </tr><tr><td>TMPL_DENY_PHP</td> <td>是否禁用PHP原生代码 </td> <td>false</td> </tr><tr><td>TMPL_L_DELIM</td> <td>模板引擎普通标签开始标记 </td> <td>{</td> </tr><tr><td>TMPL_R_DELIM</td> <td>模板引擎普通标签结束标记 </td> <td>}</td> </tr><tr><td>TAGLIB_BEGIN</td> <td>标签库标签开始标记 </td> <td>< </td> </tr><tr><td>TAGLIB_END</td> <td>标签库标签结束标记 </td> <td>> </td> </tr><tr><td>TAGLIB_LOAD</td> <td>是否使用内置标签库之外的其它标签库，默认自动检测 </td> <td>true</td> </tr><tr><td>TAGLIB_BUILD_IN</td> <td>内置标签库名称 </td> <td>cx</td> </tr><tr><td>TAGLIB_PRE_LOAD</td> <td>需要预先加载的标签库 </td> <td> </td> </tr><tr><td>TMPL_VAR_IDENTIFY</td> <td>模板变量识别。留空自动判断 </td> <td>array</td> </tr><tr><td>TMPL_STRIP_SPACE</td> <td>是否去除模板文件里面的html空格与换行 </td> <td>true</td> </tr><tr><td>TMPL_CACHE_ON</td> <td>是否开启模板编译缓存 </td> <td>true</td> </tr><tr><td>TMPL_CACHE_TIME</td> <td>模板缓存有效期 0为永久 </td> <td>0</td> </tr><tr><td>LAYOUT_ON</td> <td>是否启用布局 </td> <td>false</td> </tr><tr><td>LAYOUT_NAME</td> <td>当前布局名称 </td> <td>layout</td> </tr><tr><td>TMPL_LAYOUT_ITEM</td> <td>布局模板的内容替换标识 </td> <td>{__CONTENT__}</td> </tr><tr><td colspan="3"><b>ReadHtmlCache行为配置</b> </td> </tr><tr><td>HTML_CACHE_ON</td> <td>是否开启静态缓存 </td> <td>false</td> </tr><tr><td>HTML_CACHE_RULES</td> <td>静态缓存规则 </td> <td>array()</td> </tr><tr><td>HTML_CACHE_TIME</td> <td>静态缓存有效期（秒） </td> <td>60</td> </tr><tr><td>HTML_FILE_SUFFIX</td> <td>静态缓存后缀 </td> <td>.html</td> </tr><tr><td colspan="3"><b>ShowPageTrace行为配置</b> </td> </tr><tr><td>SHOW_PAGE_TRACE</td> <td>显示页面Trace信息 </td> <td>false</td> </tr><tr><td colspan="3"><b>ShowRuntime行为配置 </b></td> </tr><tr><td>SHOW_RUN_TIME</td> <td>是否显示运行时间 </td> <td>false</td> </tr><tr><td>SHOW_ADV_TIME</td> <td>是否显示详细的运行时间 </td> <td>false</td> </tr><tr><td>SHOW_DB_TIMES</td> <td>是否显示数据库查询和写入次数 </td> <td>false</td> </tr><tr><td>SHOW_CACHE_TIMES</td> <td>是否显示缓存操作次数 </td> <td>false</td> </tr><tr><td>SHOW_USE_MEM</td> <td>是否显示内存开销 </td> <td>false</td> </tr><tr><td>SHOW_LOAD_FILE</td> <td>是否显示加载文件数 </td> <td>false</td> </tr><tr><td>SHOW_FUN_TIMES</td> <td>是否显示函数调用次数 </td> <td>false</td> </tr><tr><td colspan="3"><b>TokenBuild行为配置 </b></td> </tr><tr><td>TOKEN_ON</td> <td>是否开启令牌验证 </td> <td>true</td> </tr><tr><td>TOKEN_NAME</td> <td>令牌验证的表单隐藏字段名称 </td> <td>__hash__</td> </tr><tr><td>TOKEN_TYPE</td> <td>令牌验证哈希规则 </td> <td>md5</td> </tr><tr><td>TOKEN_RESET</td> <td>令牌错误后是否重置 </td> <td>true</td> </tr></table>
[上一页](# "上一页")[下一页](# "下一页")
- 序言
- 1. 入门
- 1.1 简介
- 1.2 基础概念
- 1.3 获取ThinkPHP
- 1.4 环境要求
- 1.5 许可协议
- 1.6 目录结构
- 1.7 命名规范
- 1.8 MVC分层
- 1.9 CBD架构
- 1.10 特性概述
- 1.11 系统流程
- 1.12 开发流程
- 2. 入口
- 2.1 入口文件
- 2.2 项目目录
- 2.3 部署目录
- 2.4 项目编译
- 2.5 调试模式
- 3. 配置
- 3.1 配置格式
- 3.2 惯例配置
- 3.3 项目配置
- 3.4 调试配置
- 3.5 分组配置
- 3.6 读取配置
- 3.7 动态配置
- 3.8 扩展配置
- 4. 函数和类库
- 4.1 函数库
- 4.2 类库
- 5. 控制器
- 5.1 URL模式
- 5.2 模块和操作
- 5.3 定义控制器
- 5.4 空操作
- 5.5 空模块
- 5.6 模块分组
- 5.7 URL伪静态
- 5.8 URL路由
- 5.9 URL重写
- 5.10 URL生成
- 5.11 URL大小写
- 5.12 前置和后置操作
- 5.13 跨模块调用
- 5.14 页面跳转
- 5.15 重定向
- 5.16 获取系统变量
- 5.17 判断请求类型
- 5.18 获取URL参数
- 5.19 AJAX返回
- 5.20 Action参数绑定
- 5.21 多层控制器支持
- 6. 模型
- 6.1 模型定义
- 6.2 模型实例化
- 6.3 字段定义
- 6.4 数据主键
- 6.5 属性访问
- 6.6 跨库操作
- 6.7 连接数据库
- 6.8 切换数据库
- 6.9 分布式数据库
- 6.10 创建数据
- 6.11 字段映射
- 6.12 连贯操作
- 6.13 CURD操作
- 6.14 ActiveRecord
- 6.15 自动验证
- 6.16 命名范围
- 6.17 自动完成
- 6.18 查询语言
- 6.19 查询锁定
- 6.20 字段排除
- 6.21 事务支持
- 6.22 高级模型
- 6.23 视图模型
- 6.24 关联模型
- 6.25 Mongo模型
- 6.26 动态模型
- 6.27 虚拟模型
- 6.28 多层模型支持
- 7. 视图
- 7.1 模板定义
- 7.2 模板赋值
- 7.3 模板输出
- 7.4 模板替换
- 7.5 获取内容
- 7.6 模板引擎
- 7.7 布局模板
- 8. 模板引擎
- 8.1 变量输出
- 8.2 系统变量
- 8.3 使用函数
- 8.4 默认值输出
- 8.5 使用运算符
- 8.6 内置标签
- 8.7 包含文件
- 8.8 导入文件
- 8.9 Volist标签
- 8.10 Foreach标签
- 8.11 For标签
- 8.12 Switch标签
- 8.13 比较标签
- 8.14 三元运算
- 8.15 范围判断标签
- 8.16 Present标签
- 8.17 Empty标签
- 8.18 Defined标签
- 8.19 Define标签
- 8.20 Assign标签
- 8.21 IF标签
- 8.22 标签嵌套
- 8.23 使用PHP代码
- 8.24 模板布局
- 8.25 模板继承
- 8.26 原样输出
- 8.27 模板注释
- 8.28 引入标签库
- 8.29 修改定界符
- 8.30 避免JS混淆
- 9. 日志
- 9.1 日志级别
- 9.2 记录方式
- 9.3 手动记录
- 10. 错误
- 10.1 异常处理
- 10.2 异常模板
- 10.3 异常显示
- 11. 调试
- 11.1 运行状态
- 11.2 页面Trace
- 11.3 调试方法
- 12. 缓存
- 12.1 缓存方式
- 12.2 动态缓存
- 12.3 缓存队列
- 12.4 快捷缓存
- 12.5 快速缓存
- 12.6 查询缓存
- 12.7 SQL解析缓存
- 12.8 静态缓存
- 13. 扩展
- 13.1 行为扩展
- 13.2 类库扩展
- 13.3 控制器扩展
- 13.4 模型扩展
- 13.5 驱动扩展
- 13.6 Widget扩展
- 13.7 模式扩展
- 13.8 引擎扩展
- 14. 安全
- 14.1 表单令牌
- 14.2 字段类型验证
- 14.3 防止SQL注入
- 14.4 输入过滤
- 14.5 上传安全
- 14.6 防止XSS攻击
- 14.7 其他安全建议
- 14.8 目录安全文件
- 14.9 保护模板文件
- 15. 性能
- 15.1 关闭调试模式
- 15.2 开启缓存
- 15.3 合并字段缓存
- 15.4 优化SQL
- 15.5 替换入口
- 15.6 前端优化
- 16. 部署
- 16.1 PATH_INFO支持
- 16.2 隐藏index.php
- 16.3 二级域名部署
- 16.4 定制错误页面
- 16.5 设置时区
- 17. SAE支持
- 17.1 SAE介绍
- 17.2 获取SAE
- 17.3 SAE开发
- 18. REST支持
- 18.1 REST介绍
- 18.2 REST模式
- 18.3 REST配置
- 18.4 REST路由
- 18.5 REST方法
- 19. 杂项
- 19.1 Session支持
- 19.2 Cookie支持
- 19.3 日期和时间
- 19.4 WML开发
- 19.5 多语言
- 19.6 数据分页
- 19.7 文件上传
- 19.8 验证码
- 19.9 图片添加水印
- 19.10 IP获取和定位
- 20. 附录
- 20.1 常量参考
- 20.2 配置参考
- 20.3 关于升级
- 20.4 大事记
- 鸣谢
- 关于