flask配置详解

直接修改config对象

flask会有一个可用的配置对象保存着载入的配置值: Flask 对象的 **config **属性,这是 Flask 自己放置特定配置值的地方，也是扩展可以存储配置值的地方。但是，你也可以把自己的配置保存到这个对象里

app = Flask(__name__)

app.config['DEBUG'] = True

你可以使update()方法来一次性更新多个键:

app.config.update(

    DEBUG=True,

    SECRET_KEY='...'

)

从文件配置

from_object()

接收的参数为string或类，该类的属性名称必须为大写

原理解析

from_object用法

app.config.from_object(config[config_name])

app.config属性由make_config方法获得

app.py

self.config = self.make_config(instance_relative_config)   # 395

我们看看make_config方法都做了什么:

config.py

def make_config(self, instance_relative=False):  # 652

        root_path = self.root_path

        if instance_relative:

            root_path = self.instance_path

        defaults = dict(self.default_config)

        defaults['ENV'] = get_env()

        defaults['DEBUG'] = get_debug_flag()

        return self.config_class(root_path, defaults)

app.py

config_class = Config # 207

config.py

class Config(dict):   # 40

	xxx

由源代码可知该方法返回了一个config_class,config_class即Config类，也就是说app.config是Config类生成的对象，这个对象的root_path为self.root_path,defaults为dict(self, default_config)。我们再看看他们的值

app.py

root_path = None   #351

default_config = ImmutableDict({      # 281

        'ENV':                                  None,

        'DEBUG':                                None,

        'TESTING':                              False,

        'PROPAGATE_EXCEPTIONS':                 None,

        'PRESERVE_CONTEXT_ON_EXCEPTION':        None,

        'SECRET_KEY':                           None,

        'PERMANENT_SESSION_LIFETIME':           timedelta(days=31),

        'USE_X_SENDFILE':                       False,

        'SERVER_NAME':                          None,

        'APPLICATION_ROOT':                     '/',

        'SESSION_COOKIE_NAME':                  'session',

        'SESSION_COOKIE_DOMAIN':                None,

        ...

    })

root_path默认为None(当我们指定instance_relative_config=True的时候，root_path=instance_path,这个和实例文件夹的配置有关，稍后再讲)，default_config是继承(多继承)了dict类的实例，其中的值就是我们默认的配置值，这些配置项在flask初始化的时候就会读取，我们修改的也是这些配置项，这就是为什么修改的配置对象的 key必须要大写的原因。

我们看看from_object做了什么：

config.py

def from_object(self, obj):   # 141

        if isinstance(obj, string_types):

            obj = import_string(obj)

        for key in dir(obj):

            if key.isupper():

                self[key] = getattr(obj, key)

对string类型的对象进行了一些处理，最后更改指定key的value,即default_config中的值

from_object 用法

config.py

class Config(object):

    DEBUG = False

    TESTING = False

    DATABASE_URI = 'sqlite://:memory:'

class ProductionConfig(Config):

    DATABASE_URI = 'mysql://user@localhost/foo'

class DevelopmentConfig(Config):

    DEBUG = True

class TestingConfig(Config):

    TESTING = True

config = {

    'development': DevelopmentConfig,

    'test': TestingConfig,

    'production': ProductionConfig,

    'default': DevelopmentConfig

}

from config import config

app.config.from_object(config['default'])

from_pyfile()

在 Flask 0.8 中，引入了 Flask.instance_path 并提出了“实例文件夹” 的新概念。实例文件夹为不使用版本控制和特定的部署而设计。这是放置运行时更改的文件和配置文件的最佳位置
你可以在创建 Flask 应用时显式地提供实例文件夹的路径
```
app = Flask(__name__, instance_path='/path/to/instance/folder')
```
如果instance_path 参数没有赋值，会使用下面默认的位置
```
/myapp.py

/instance
```
配置 Flask 来从模块预载入配置并覆盖配置文件夹中配置文件的完整例子

app = Flask(__name__, instance_relative_config=True)     # 从相对实例文件夹读取配置开关

app.config.from_object('yourapplication.default_settings')   # 预载入配置

app.config.from_pyfile('application.cfg', silent=True)		  # 覆盖原配置

application.cfg位于instance文件夹下

直接读取实例文件夹中配置的方法

filename = os.path.join(app.instance_path, 'application.cfg')   # 方法1

with open(filename) as f:

    config = f.read()

# or via open_instance_resource:

with app.open_instance_resource('application.cfg') as f:      # 方法2

    config = f.read()

from_envvar()
- Flask给我们提供了根据环境变量选择一个配置文件的能力。这意味着我们可以在我们的版本库中有多个配置文件，并总是能根据具体环境，加载到对的那个
- app.config.from_envvar(‘APP_CONFIG_FILE’)将加载由环境变量APP_CONFIG_FILE指定的文件。这个环境变量的值应该是一个配置文件的绝对路径
```
APP_CONFIG_FILE=/var/www/yourapp/config/production.py
```

综合应用

app = Flask(__name__, instance_relative_config=True)

app.config.from_object('config.default')

app.config.from_pyfile('config.py')   # 从instance文件夹中加载配置

app.config.from_envvar('APP_CONFIG_FILE')

config.py为公用配置项
envvar控制不同环境变量的不同配置项，flask能根据具体环境，加载到对应的配置文件

结语
- 一个简单的应用仅需一个配置文件:config.py或配置对象
- instance文件夹可以用来改变特定环境下的程序配置。
- 应对复杂的，基于环境的配置，我们可以结合环境变量和app.config.from_envvar()来使用