配置

Swoft 配置由两部分组成，env 环境配置和 config 应用配置。

• env 一般配置一些和环境相关的一些参数，比如运行模式、资源地址
• config 一般用于配置应用级别的配置以及业务级别的配置

安装

composer require swoft/config

Git仓库

• Github https://github.com/swoft-cloud/swoft-config

环境配置

文件配置

项目根目录配置一个名称为 .env 文件，采用 KV 格式配置，此文件配置的数据，可以加载到内存里面，供业务使用。

APP_DEBUG = 1
SWOFT_DEBUG = 1

系统变量

除文件方式配置外，还可以把一些参数配置到系统变量，系统变量的参数也会加载到内存，供业务使用

如何使用

swoft 提供了函数读取以上两种方式配置的数据。

env(string $key = null, mixed $default = null): mixed

获取一个环境变量的值或所有环境变量参数

• 返回环境变量 key 的值， 如果环境变量 key 不存在则返回默认值。 如果省略 key 参数，则所有环境变量都将作为关联数组 array 返回
• default 默认值，可以使任何类型，也可以是一个 闭包
• 返回值默认做了转换。比如配置 true 字符串，返回的转换成一个 bool 类型

特殊规则

应用配置

bean配置

应用配置数据是由一个bean对象管理的，可以在 app/bean.php 文件设置应用配置参数

return [
    'config'   => [
        'path' => __DIR__ . '/../config',
    ],
];

可配置项：

• path 自定配置文件路径
• base 主文件名称，默认 base (其他文件的数据都会按文件名为key合并到主文件数据中)
• type 配置文件类型，默认 php 同时也支持 yaml 格式
• parser 配置解析器，默认已经配置 php/yaml 解析器。
• env 配置当前环境比如 dev/test/pre/pro

数据格式

配置目录所有配置文件会解析成一个数组，但是不会递归合并数据，只会合并当前目录文件数据，以它的文件名称为数组 key 进行合并数组。 比如 config 目录配置文件如下:

|-- base.php
|-- data.php
`-- pro
    |-- base.php
    `-- data.php

只会解析当前目录文件数据，不会递归解析数据。当前使用 env 配置时，环境目录里面的配置信息会覆盖最外层文件名称相同的数据。提醒：配置文件里面可以使用 env()函数读取环境配置。

• config/base.php

return [
    'key' => 'value'
];

• config/data.php

return [
    'dkey' => [
        'dvalue'
    ],
    'key' => 'value'
];

• config/pro/base.php

return [
    'key' => 'valuePro'
];

• config/pro/data.php

return [
    'dkey' => [
        'dvalue'
    ],
    'key' => 'valuePro'
];

如上配置文件，当不配置 config 的 env 参数，合并的数据格式如下：

return [
    'key' => 'value',
    'data' => [
        'dkey' => [
            'dvalue'
        ],
        'key' => 'value'
    ]
];

当配置 config 对象的 'env' => 'pro' 参数，合并的数据格式如下：

return [
    'key' => 'valuePro',
    'data' => [
        'dkey' => [
            'dvalue'
        ],
        'key' => 'valuePro'
    ]
];

获取配置

框架提全局函数、注解、config 对象多种方式，使用应用配置数据。

函数

全局函数使用 config()

config(string $key = null, mixed $default = null):mixed

• key 配置参数 key，子数组可以使用 . 分割，比如上面的例子 data.dkey 可以获取到 ["dvalue"], 当key=null 获取所有配置参数
• default 默认参数，如果 key 参数不存在，返回默认值，默认值可以是任意类型

注解

通过容器使用注解的方式，注入配置到属性值。

use Swoft\Bean\Annotation\Mapping\Bean;
use Swoft\Config\Annotation\Mapping\Config;

/**
* @Bean()
*/
class Demo
{
    /**
    * @Config("data.dkey")
    */
    private $dvalue = [];
    
    // ...
}

此例子和上面功能一样，都是读取相同的数据，两种不同的方式。

使用注解，一定要保证类是一个bean对象(通过其它注解注入到容器)

对象

如果上面两种方式还不能满足你的业务需求，你可以从容器里面获取配置对象，里面自带很多方式操作配置数据。

$config = \Swoft::getBean('config');

config 对象常用方法

• get(string $key, $default = null) 获取参数
• offsetGet($key) 获取参数
• ….

参与贡献

欢迎参与贡献，您可以

• fork 我们的开发仓库 swoft/component
• 修改代码然后发起 PR
• 关于发起PR的注意事项