# 配置

阅读此文档,建议对ThinkPHP有基本的了解,TP配置文档 (opens new window)

# 系统配置

TIP

我们基于TP的目录结构,在/config/目录下放置了buildadmin.phpterminal.php文件,这两个文件为BuildAdmin的系统配置文件。

您可以在这两个文件内配置:

  • 允许跨域访问的域名
  • 是否开启前台会员中心
  • 管理员登录重试次数
  • 当拖拽排序两条记录权重相等时的处理方式
  • TOKEN 驱动
  • WEB终端允许执行的命令
  • ....

# 获取系统配置

首先需要在类文件内引入:

use think\facade\Config;

然后就可以使用如下方式获取配置:

// 获取版本号
Config::get('buildadmin.version');

// 获取所有系统配置
Config::get('buildadmin');

// 判断是否存在某个配置
Config::has('template');

// 参数批量设置
Config::set(['name1' => 'value1', 'name2' => 'value2'], 'config');

也可以使用TP助手函数(无需use):

// 获取版本号
config('buildadmin.version');

请注意获取和设置配置时,不仅仅可以获取buildadmin.php文件内的配置,实际上它可以获取/config/目录下的所有配置。

# 站点配置

在站点后台中:常规管理->系统配置可以进行配置的项目,我们称之为站点配置。

  • 站点配置是保存在数据库中的。
  • 站点配置可以在后台可视化的进行修改。
  • 可以随时在后台添加新的站点配置。
  • 管理员添加的配置项,也可以直接在后台删除。

# 获取站点配置

我们封装了全局公共函数get_sys_config()用于获取站点配置。

// 获取所有的站点配置
get_sys_config();

// 获取某一项站点配置,如下为获取站点的名称
get_sys_config('site_name');

// 获取某一个分组的站点配置
get_sys_config('', 'mail');


// 获取多个站点配置时,支持返回简洁的数据(仅返回配置键值对)
get_sys_config('', 'mail', true);
get_sys_config('', '', true);

# 环境配置

可以在站点根目录建立一个.env环境变量文件(生产环境建议忽略),我们已经在根目录提供了一个.env-example文件,重命名即可生效。

若要开启调试,必需在环境配置中进行配置,.env内容如下即可开启:

APP_DEBUG =  true

环境变量不支持数组格式,如果需要使用数组,可以:

[DATABASE]
USERNAME =  root
PASSWORD =  123456

如果要设置没有键的数组,可以:

DATABASE[] =  root
DATABASE[] =  123456

# 获取环境配置

环境变量的获取,不区分大小写。
要使用Env类,必须先引入think\facade\Env

// 获取`APP_DEBUG`,默认值 false
Env::get('APP_DEBUG', false);

// 获取`database.username`,默认值 root
Env::get('database.username', 'root');

更多使用方法,请参考TP官方文档 (opens new window)