thinkphp常量和配置参数

常量参考

预定义常量

常量 说明

URL_COMMON=0 普通模式 URL

URL_PATHINFO=1 PATHINFO URL

URL_REWRITE=2 REWRITE URL

URL_COMPAT=3 兼容模式 URL

HAS_ONE=1 HAS_ONE 关联定义

BELONGS_TO=2 BELONGS_TO 关联定义

HAS_MANY=3 HAS_MANY 关联定义

MANY_TO_MANY=4 MANY_TO_MANY 关联定义

THINK_VERSION 框架版本号

THINK_RELEASE 框架发行日期

这些预定义常量不会随着环境的变化而变化。

1

路径常量

系统和项目的路径常量用于系统默认的目录规范，可以通过重新定义改变，如果不希望定制目录，这些常量一般不需要更改。

常量名 说明 默认值

CORE_PATH 系统核心类库目录 THINK_PATH.'Lib/'

EXTEND_PATH 系统扩展目录 THINK_PATH.'Extend/'

MODE_PATH 模式扩展目录 EXTEND_PATH.'Mode/'

ENGINE_PATH 引擎扩展目录 EXTEND_PATH.'Engine/'

VENDOR_PATH 第三方类库目录 EXTEND_PATH.'Vendor/'

LIBRARY_PATH 系统扩展类库目录 EXTEND_PATH.'Library/'

COMMON_PATH 项目公共目录 APP_PATH.'Common/'

LIB_PATH 项目类库目录 APP_PATH.'Lib/'

RUNTIME_PATH 项目运行时目录 APP_PATH.'Runtime/'

CONF_PATH 项目配置目录 APP_PATH.'Conf/'

LOG_PATH 项目日志目录 RUNTIME_PATH.'Logs/'

CACHE_PATH 项目模板缓存目录 RUNTIME_PATH.'Cache/'

LANG_PATH 项目语言包目录 APP_PATH.'Lang/'

TEMP_PATH 项目缓存目录 RUNTIME_PATH.'Temp/'

DATA_PATH 项目数据目录 RUNTIME_PATH.'Data/'

TMPL_PATH 项目模板目录 APP_PATH.'Tpl/'

HTML_PATH 项目静态缓存目录 APP_PATH.'Html/' 2

系统常量

下面这些系统常量会随着开发环境的改变或者设置的改变而产生变化。

常量名 说明

IS_CGI 是否属于 CGI模式

IS_WIN 是否属于Windows 环境

IS_CLI 是否属于命令行模式

__ROOT__ 网站根目录地址

__APP__ 当前项目（入口文件）地址

__GROUP__ 当前分组的URL地址

__URL__ 当前模块的URL地址

__ACTION__ 当前操作的URL地址

__SELF__ 当前URL地址

__INFO__ 当前的PATH_INFO字符串

__EXT__ 当前URL地址的扩展名

APP_NAME 当前项目名

GROUP_NAME 当前分组名

MODULE_NAME 当前模块名

ACTION_NAME 当前操作名

APP_DEBUG 是否开启调试模式

MODE_NAME 当前模式名称

APP_PATH 当前项目路径

THINK_PATH 系统框架路径

MEMORY_LIMIT_ON 系统内存统计支持

RUNTIME_FILE 项目编译缓存文件名

THEME_NAME 当前主题名称

THEME_PATH 当前模板主题路径

APP_TMPL_PATH 当前模板URL路径

LANG_SET 当前浏览器语言

MAGIC_QUOTES_GPC MAGIC_QUOTES_GPC

NOW_TIME 当前请求时间（3.1新增）

IS_GET 当前是否GET请求（3.1新增）

IS_POST 当前是否POST请求（3.1新增）

IS_PUT 当前是否PUT请求（3.1新增）

IS_DELETE 当前是否DELETE请求（3.1新增）

IS_AJAX 当前是否AJAX请求（3.1新增）

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

惯例配置

配置名 说明 默认值

应用设置

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 系统 3 1 邮件 3 文件 4 SAPI

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_PARAMS_BIND URL变量绑定到Action方法参数（3.1新增） true