> For the complete documentation index, see [llms.txt](https://doc.kaliphp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.kaliphp.com/config.md).

# 配置

### 程序配置

程序配置分三块，一块是系统配置，一块是程序配置，一块是数据库配置，读取顺序是：程序配置 > 系统配置

```
config/       系统配置路径
app/config/   程序配置路径
#PB#_config   数据库配置表
```

### 配置文件

```
config/config.php     默认配置
config/autoload.php   系统自动加载类的配置
config/exception.php  系统异常类的配置
config/http.php       HTTP请求基本错误码
config/database.php   数据库链接配置
```

用户可通过`config::instance('config')->get`方法获取，简单例子：

```
// config/session.php
return array(
    'session_name' => 'kali_sessionid'
}

// 程序中获取方式 第一个参数为配置文件名，第二个参数为是否使用别名（默认为true）
config::instance('session')->get('session_name', true);
```

### 环境配置

系统对不同环境的配置是可以做区分的，比如：本机开发环境可以使用`dev`，公共测试环境可以使用`pre`，正式环境可以使用`pub` 

系统配置在`/web/index.php`中

```
// 当前环境 dev pre pub 
defined('SYS_ENV') or define('SYS_ENV', 'dev');
```

当程序调用`config::instance()->get`时，系统会自动查找 `config` 对应的配置文件

```
// 当前环境 dev 会自动查找 config/config_dev.php文件
config::instance('config')->get('test');

// 当前环境 pub 会自动查找 config/database_pub.php文件
config::instance('database')->get('test2');
```

### 别名使用

配置中是支持别名的使用的，在别名两边加上`@`即可，系统默认有个别名 `web`会替换当前路径

```
// config/config.php
return array(
    'path' => '@web@/my-path/'
);

// 返回 'my-path/' 
config::instance('config')->get('path');
```

用户也可以自定义别名，例如：

```
// config->get 之前执行
config::instance('config')->set_alias('time', time());

// config.php
return array(
    'path' => '@web@/my-path/?time=@time@'
);

// 返回 'my-path/?time=1461141347'
config::instance('config')->get('path');

// 返回 '@web@/my-path/?time=@time@'
config::instance('config')->get('path', false);
```

当然如果需要避免别名转义，也可以在`config::instance('config')->get`第二个参数传`false`，就不会执行别名转义了。