> ThinkPHP3.2.3手册 > 配置格式

配置格式

PHP数组定义

thinkphp框架中默认所有配置文件的定义格式均采用返回PHP数组的方式,格式为:

//项目配置文件
return array(
    'DEFAULT_MODULE'     => 'Index', //默认模块
    'URL_MODEL'          => '2', //URL模式
    'session_AUTO_START' => true, //是否开启session
    //更多配置参数
    //...
);

配置参数不区分大小写(因为无论大小写定义都会转换成小写),所以下面的配置等效:

//项目配置文件
return array(
    'default_module'     => 'Index', //默认模块
    'url_model'          => '2', //URL模式
    'session_auto_start' => true, //是否开启session
    //更多配置参数
    //...
);

但是我们建议保持大写定义配置参数的规范。

还可以在配置文件中可以使用二维数组来配置更多的信息,例如:

//项目配置文件
return array(
    'DEFAULT_MODULE'     => 'Index', //默认模块
    'URL_MODEL'          => '2', //URL模式
    'SESSION_AUTO_START' => true, //是否开启session
    'USER_CONFIG'        => array(
        'USER_AUTH' => true,
        'USER_TYPE' => 2,
    ),
    //更多配置参数
    //...
);

需要注意的是,二级参数配置区分大小写,也就说读取确保和定义一致。

其他配置格式支持

也可以采用 yaml/json/xml/ini 以及自定义格式的配置文件支持。

我们可以在应用入口文件中定义应用的配置文件的后缀,例如:

define('CONF_EXT','.ini');

定义后,应用的配置文件(包括模块的配置文件)后缀都统一采用.ini。

无论是什么格式的配置文件,最终都会解析成数组格式。
该配置不会影响框架内部的配置文件加载。

ini格式配置示例:

DEFAULT_MODULE=Index ;默认模块
URL_MODEL=2 ;URL模式
SESSION_AUTO_START=on ;是否开启session

xml格式配置示例:

<config>
<default_module>Index</default_module>
<url_model>2</url_model>
<session_auto_start>1</session_auto_start>
</config>

yaml格式配置示例:

default_module:Index #默认模块
url_model:2 #URL模式
session_auto_start:True #是否开启session

json格式配置示例:

{
"default_module":"Index",
"url_model":2,
"session_auto_start":True
}

除了 yaml/json/xml/ini 格式之外,我们还可以自定义配置格式,定义如下:

define('CONF_EXT','.test'); // 配置自定义配置格式(后缀)
define('CONF_PARSE','parse_test'); // 对应的解析函数

假设我们的自定义配置格式是类似 var1=val1&var2=val2 之类的字符串,那么parse_test定义如下:

function parse_test($str){
    parse_str($str,$config);
    return (array)$config;
}

CONF_PARSE定义的解析函数返回值必须是一个PHP索引数组。

下一篇: