ThinkPHP配置项详细注解
这里列出了系统的惯例配置和内置系统行为的配置参数列表。
惯例配置
| 配置名 | 说明 | 默认值 |
|---|---|---|
| 应用设置 | ||
| 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 |
