系统默认的配置文件目录就是应用目录(APP_PATH),也就是默认的application下面,并分为
应用配置
(整个应用有效)和模块配置
(仅针对该模块有效)。
├─application 应用目录
│ ├─config.php 应用配置文件
│ ├─database.php 数据库配置文件
│ ├─route.php 路由配置文件
│ ├─index index模块配置文件目录
│ │ ├─config.php index模块配置文件
│ │ └─database.php index模块数据库配置文件
// 定义配置文件目录和应用目录同级 __DIR__:当前文件所在的目录
define('CONF_PATH', __DIR__.'/../config/');
修改后,如下:
├─application 应用目录
├─config 配置目录
│ ├─config.php 应用配置文件
│ ├─database.php 数据库配置文件
│ ├─route.php 路由配置文件
│ ├─index index模块配置文件目录
│ │ ├─config.php index模块配置文件
│ │ └─database.php index模块数据库配置文件
ThinkPHP支持多种格式的配置格式,但最终都是解析为PHP数组的方式。
返回PHP数组
是默认的配置格式,例如:
//项目配置文件
return [
// 默认模块名
'default_module' => 'index',
// 默认控制器名
'default_controller' => 'Index',
// 默认操作名
'default_action' => 'index',
//更多配置参数
//...
];
配置参数名不区分大小写(因为无论大小写定义都会转换成小写),新版的建议是使用小写定义配置参数的规范。
还可以在配置文件中可以使用二维数组来配置更多的信息,例如:
//项目配置文件
return [
'cache' => [
'type' => 'File',
'path' => CACHE_PATH,
'prefix' => '',
'expire' => 0,
],
];
默认方式为PHP数组方式定义配置文件,你可以在入口文件定义CONF_EXT
常量来更改为其它的配置类型:
// 更改配置格式为ini格式
define('CONF_EXT', '.ini');
配置后,会自动解析支持的配置类型,包括.ini
、.xml
、.json
和 .php
在内的格式支持。
配置参数支持二级,例如,下面是一个二级配置的设置和读取示例:
$config = [
'user' => [
'type' => 1,
'name' => 'thinkphp',
],
'db' => [
'type' => 'mysql',
'user' => 'root',
'password' => '',
],
];
// 设置配置参数
Config::set($config);
// 读取二级配置参数
echo Config::get('user.type');
// 或者使用助手函数
echo config('user.type');
在ThinkPHP中,一般来说应用的配置文件是自动加载的,加载的顺序是:
惯例配置->应用配置->扩展配置->场景配置->模块配置->动态配置
以上是配置文件的加载顺序,因为后面的配置会覆盖之前的同名配置
(在没有生效的前提下),所以配置的优先顺序从右到左
。
对常用得我参数做配置
,在thinkphp中内置了一个惯例配置(thinkphp/convention.php
)。
应用初始化
的时候,首先
会加载的配置文件
,位于application\cnfig.php
;
扩展配置文件是由extra_config_list配置参数定义的额外的配置文件,默认
会加载database
和validate
两个扩展配置文件。
V5.0.1开始,取消了该配置参数,扩展配置文件
直接放入application/extra目录会自动加载
。
每个应用都可以在不同的情况下设置自己的状态(或者称之为应用场景),并且加载不同的配置文件。
Config::load('配置文件名');
parse
方法来导入:Config::parse(APP_PATH.'my_config.ini','ini');
Config::parse(APP_PATH.'my_config.xml','xml');
设置完配置参数后,就可以使用get
来读取了:
echo Config::get("配置参数");
系统定义了一个助手函数,也可以读取配置,可简化以上操作:
echo config("配置参数");
读取所有的配置参数:
dump(Config::get());
//或者dump(config());
thinkphp
还提供了一个dump()
提供给开发者在浏览器中可友好的变量输出。
判断某个参数是否存在:
Config::has("配置参数");
//或者 config("?配置参数")
如果需要读取二级配置,可以使用:
echo Config::get("配置参数.二级参数");
echo config("配置参数.二级参数");
使用set
方法设置参数:
Config::set("配置参数","配置值");
//或者使用助手函数
config("配置参数","配置值");
也可进行批量设置:
Config::set([
'配置参数1' => '配置值1',
'配置参数2' => '配置值2'
]);
config([
'配置参数1' => '配置值1',
'配置参数2' => '配置值2'
]);
版本要求V5.0.1
5.0.1以上版本支持自动读取扩展配置文件(extra_config_list配置参数废弃),只需要将扩展配置文件放入application/extra目录,即可自动读取。
自动读取的配置文件都是二级配置参数,一级配置名称就是扩展配置的文件名。
模块也可以支持自己的扩展配置文件,只需要放入 application/模块名/extra
下面就可以自动加载
。
系统默认加载的独立配置文件不在此列,包括:
文件名 | 描述 |
---|---|
config | 应用或者模块配置文件 |
database | 数据库配置文件 |
tags | 场景配置文件 |
场景名 | 应用场景配置文件 |
如果你更改了
CONF_PATH
,那么扩展配置文件目录应该是CONF_PATH/extra
,模块配置目录则变成CONF_PATH/module/
,模块的扩展配置目录则变成CONF_PATH/module/extra
。
defined('CONF_PATH') or define('CONF_PATH', APP_PATH); // 配置文件目录
配置参数支持作用域的概念,默认情况下,所有参数都在同一个系统默认作用域下面。如果你的配置参数需要用于不同的项目或者相互隔离,那么就可以使用作用域功能,作用域的作用好比是配置参数的命名空间一样。
可以使用range()
切换作用域:
Config::range('test');
ThinkPHP5.0支持使用环境变量配置。
可以在根路径下的.env
配置文件中采用ini
的方式进行配置。
获取环境变量:
Env::get('database.username');
Env::get('database.password');
// 同时下面的方式也可以获取
Env::get('database_username');
Env::get('database_password');
可以支持默认值,例如:
// 获取环境变量 如果不存在则使用默认值root
Env::get('database.username','root');