6配置
未知
2021-07-04 09:58:03
0

配置目录

单应用模式

对于单应用模式来说,配置文件和目录很简单,根目录下的config目录下面就是所有的配置文件。每个配置文件对应不同的组件,当然你也可以增加自定义的配置文件。

├─config(配置目录)
│  ├─app.php            应用配置
│  ├─cache.php          缓存配置
│  ├─console.php        控制台配置
│  ├─cookie.php         Cookie配置
│  ├─database.php       数据库配置
│  ├─filesystem.php     文件磁盘配置
│  ├─lang.php           多语言配置
│  ├─log.php            日志配置
│  ├─middleware.php     中间件配置
│  ├─route.php          URL和路由配置
│  ├─session.php        Session配置
│  ├─trace.php          Trace配置
│  ├─view.php           视图配置
│  └─ ...               更多配置文件
│  
复制

单应用模式的config目录下的所有配置文件系统都会自动读取,不需要手动加载。如果存在子目录,你可以通过Config类的load方法手动加载,例如:

// 加载config/extra/config.php 配置文件 读取到extra
\think\facade\Config::load('extra/config', 'extra');
复制

多应用模式

在多应用模式下,配置分为全局配置和应用配置。

  • 全局配置config目录下面的文件就是项目的全局配置文件,对所有应用有效。
  • 应用配置:每个应用可以有独立配置文件,相同的配置参数会覆盖全局配置。
├─app(应用目录)
│  ├─app1 (应用1)
│  │   └─config(应用配置)
│  │   	 ├─app.php            应用配置
│  │  	 ├─cache.php          缓存配置
│  │   	 ├─cookie.php         Cookie配置
│  │   	 ├─database.php       数据库配置
│  │  	 ├─lang.php           多语言配置
│  │  	 ├─log.php            日志配置
│  │     ├─route.php          URL和路由配置
│  │   	 ├─session.php        Session配置
│  │ 	 ├─view.php           视图及模板引擎配置
│  │   	 ├─trace.php          Trace配置
│  │ 	 └─ ...               更多配置文件
│  │ 
│  └─ app2... (更多应用)
│
├─config(全局配置)
│  ├─app.php            应用配置
│  ├─cache.php          缓存配置
│  ├─console.php        控制台配置
│  ├─cookie.php         Cookie配置
│  ├─database.php       数据库配置
│  ├─filesystem.php     文件磁盘配置
│  ├─lang.php           多语言配置
│  ├─log.php            日志配置
│  ├─middleware.php     中间件配置
│  ├─route.php          URL和路由配置
│  ├─session.php        Session配置
│  ├─trace.php          Trace配置
│  ├─view.php           视图配置
│  └─ ...               更多配置文件
│  
复制

配置定义

可以直接在相应的全局或应用配置文件中修改或者增加配置参数,如果你要增加额外的配置文件,直接放入配置目录即可(文件名小写)。

除了一级配置外,配置参数名严格区分大小写,建议是使用小写定义配置参数的规范。

由于架构设计原因,下面的配置只能在环境变量中修改。

配置参数 描述
app_debug 应用调试模式
config_ext 配置文件后缀

环境变量定义

可以在应用的根目录下定义一个特殊的.env环境变量文件,用于在开发过程中模拟环境变量配置(该文件建议在服务器部署的时候忽略),.env文件中的配置参数定义格式采用ini方式,例如:

APP_DEBUG =  true
复制

默认安装后的根目录有一个.example.env环境变量示例文件,你可以直接改成.env文件后进行修改。

如果你的部署环境单独配置了环境变量( 环境变量的前缀使用PHP_),那么请删除.env配置文件,避免冲突。

环境变量配置的参数会全部转换为大写,值为 offnofalse 等效于 布尔值false,值为 yesontrue 等效于 布尔值的true

注意,环境变量不支持数组参数,如果需要使用数组参数可以,可以使用

[DATABASE]
USERNAME =  root
PASSWORD =  123456
复制

如果要设置一个没有键值的数组参数,可以使用

PATHINFO_PATH[] =  ORIG_PATH_INFO
PATHINFO_PATH[] =  REDIRECT_PATH_INFO
PATHINFO_PATH[] =  REDIRECT_URL
复制

获取环境变量的值可以使用下面的方式获取:

Env::get('database.username');
Env::get('database.password');
Env::get('PATHINFO_PATH');
复制

要使用Env类,必须先引入think\facade\Env

环境变量的获取不区分大小写

可以支持默认值,例如:

// 获取环境变量 如果不存在则使用默认值root
Env::get('database.username', 'root');
复制

可以直接在配置文件中使用环境变量进行本地环境和服务器的自动配置,例如:

return [
    'hostname'  =>  Env::get('hostname','127.0.0.1'),
];
复制

多环境变量配置支持

V6.0.8+版本开始,可以支持定义多个环境变量配置文件,配置文件命名规范为

.env.example
.env.testing
.env.develop
复制

然后,需要在入口文件中指定部署使用的环境变量名称:

// 执行HTTP应用并响应
$http = (new App())->setEnvName('develop')->http;

$response = $http->run();

$response->send();

$http->end($response);
复制

或者你可以继承App类 然后重载loadEnv方法实现 动态切换环境变量配置。

其它配置格式支持

默认的配置文件都是PHP数组方式,如果你需要使用其它格式的配置文件,你可以通过改变CONFIG_EXT环境变量的方式来更改配置类型。

在应用根目录的.env或者系统环境变量中设置

CONFIG_EXT=".ini"
复制

支持的配置类型包括.ini.xml.json.yaml.php 在内的格式支持,配置后全局或应用配置必须统一使用相同的配置类型。

配置获取

要使用Config类,首先需要在你的类文件中引入

use think\facade\Config;
复制

然后就可以使用下面的方法读取某个配置参数的值:

读取一级配置的所有参数(每个配置文件都是独立的一级配置)

Config::get('app');
Config::get('route');
复制

读取单个配置参数

Config::get('app.app_name');
Config::get('route.url_domain_root');
复制

读取数组配置(理论上支持无限级配置参数读取)

Config::get('database.default.host');
复制

判断是否存在某个设置参数:

Config::has('template');
Config::has('route.route_rule_merge');
复制

参数批量设置

Config类不再支持动态设置某个配置参数,但可以支持批量设置更新配置参数。

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

系统配置文件

下面系统自带的配置文件列表及其作用:

配置文件名 描述
app.php 应用配置
cache.php 缓存配置
console.php 控制台配置
cookie.php Cookie配置
database.php 数据库配置
filesystem.php 磁盘配置
lang.php 多语言配置
log.php 日志配置
middleware.php 中间件配置
route.php 路由和URL配置
session.php Session配置
trace.php 页面Trace配置
view.php 视图配置

具体的配置参数及默认值可以直接查看应用config目录下面的相关文件内容。

如果是多应用模式的话配置文件可能同时存在全局和应用配置文件两个同名文件

使用Yaconf定义

可以支持使用Yaconf统一定义配置,但不支持动态设置。

安装了yaconf扩展之后,项目里面的配置文件不再有效。而且不再区分全局和应用配置。

首先需要安装topthink/think-yaconf扩展,

composer require topthink/think-yaconf
复制

然后在app目录下的provider.php文件中添加:

'think\Config'	=>	'think\Yaconf',
复制

使用setYaconf方法指定Yaconf使用的独立配置文件,例如:

// 建议在应用的公共函数文件中进行设置
think\facade\Config::setYaconf('thinkphp');
复制

设置后,你只需要在thinkphp.ini一个文件里进行项目的配置,而无需分开多个文件,避免和其它项目冲突。

关于Yaconf的安装和配置用法可以参考这里

上一篇:tp6目录结构

下一篇:请求流程

相关内容

MySQL变量类型与用途
MySQL支持多种数据类型,包括数值、字符串、日期和时间等类型,以...
2024-11-20 20:23:37
如何使用MySQL变量进行...
本文详细介绍了MySQL中用户定义变量、系统变量和局部变量的使用方...
2024-11-20 18:46:45
K8s在云服务器上的资源管...
K8s作为开源容器编排系统,在云服务器上实现自动化资源管理,提高运...
2024-11-20 17:23:38
云服务器上Kubernet...
本文介绍了在云服务器上搭建Kubernetes集群的实战过程,包括...
2024-11-20 17:00:41
云服务器上Kubernet...
摘要:本文详解了云服务器上Kubernetes集群的部署方案,包括...
2024-11-20 15:00:48
云上Kubernetes集...
摘要:本文详述了云上Kubernetes集群的部署流程及优化策略,...
2024-11-20 14:46:37

热门资讯

tp6开发规范 命名规范 请理解并尽量遵循以下命名规范,可以减少在开发过程中出现不必要的错误。 ThinkPHP6....
6高级查询 快捷查询 快捷查询方式是 一种多字段相同查询条件 的简化写法,可以进一步简化查询条件的写法,在多个字...
tp6多应用提示控制器不存在:... 第一个情况是没有使用composer安装扩展。 如果要使用多应用模式, 你需要win+r,cmd指针...
6配置 配置目录 单应用模式 对于单应用模式来说,配置文件和目录很简单,根目录下的 config 目录下面就...
6异常处理 和PHP默认的异常处理不同,ThinkPHP抛出的不是单纯的错误信息,而是一个人性化的错误页面。 异...
6swoole 本篇内容主要讲述了最新的 think-swoole 扩展的使用。目前仅支持Linux环境或者MacO...
6助手函数 助手函数 系统为一些常用的操作方法封装了助手函数,便于使用,包含如下: 助手函数 描述 abort ...
6查询表达式 查询表达式 查询表达式支持大部分的SQL查询语法,也是 ThinkPHP 查询语言的精髓,查询表达式...
6路由参数 路由参数 路由分组及规则定义支持指定路由参数,这些参数主要完成路由匹配检测以及后续行为。 路由参数可...
6查询 模型查询和数据库查询方法的区别主要在于,模型中的查询的数据在获取的时候会经过获取器的处理,以及更加对...