【理论】
在很多情况下,你需要设置程序的某些行为,这时你就需要使用配置变量。在Flask中,配置变量就是一些大写形式的Python变量,
你也可以称之为配置参数或配置键。使用统一的配置变量可以避免在程序中以硬编码的形式设置程序。
在一个项目中,你会用到许多配置,Flask提供的配置,扩展(比如flask-sqlalchemy,flask-mail)提供的配置,还有程序特定的配置。
和平时使用的变量不同,这些配置变量都通过Flask对象的app.config属性作为统一的接口来设置和获取,它指向的Config类实际上是字典的的子类,
所以你可以像操作其它字典一样操作它。
当我们创建1个Flask对象(也就是app),就可以通过app.config来查看这个app的所有配置变量
from flask import Flask
app=Flask(__name__) print(type(app.config))
<class 'flask.config.Config'>#app.config的类型 print(app.config)#app.config 以键值对的形式 保存app的配置信息
<Config {'ENV': 'production', 'DEBUG': False, 'TESTING': False, 'PROPAGATE_EXCEPTIONS': None, 'PRESERVE_CONTEXT_ON_EXCEPTION': None, 'SECRET_KEY': None, 'PERMANENT_SESSION_LIFETIME': datetime.timedelta(days=31), 'USE_X_SENDFILE': False, 'SERVER_NAME': None, 'APPLICATION_ROOT': '/', 'SESSION_COOKIE_NAME': 'session', 'SESSION_COOKIE_DOMAIN': None, 'SESSION_COOKIE_PATH': None, 'SESSION_COOKIE_HTTPONLY': True, 'SESSION_COOKIE_SECURE': False, 'SESSION_COOKIE_SAMESITE': None, 'SESSION_REFRESH_EACH_REQUEST': True, 'MAX_CONTENT_LENGTH': None, 'SEND_FILE_MAX_AGE_DEFAULT': datetime.timedelta(seconds=43200), 'TRAP_BAD_REQUEST_ERRORS': None, 'TRAP_HTTP_EXCEPTIONS': False, 'EXPLAIN_TEMPLATE_LOADING': False, 'PREFERRED_URL_SCHEME': 'http', 'JSON_AS_ASCII': True, 'JSON_SORT_KEYS': True, 'JSONIFY_PRETTYPRINT_REGULAR': False, 'JSONIFY_MIMETYPE': 'application/json', 'TEMPLATES_AUTO_RELOAD': None, 'MAX_COOKIE_SIZE': 4093}>
常用配置及含义:
ENV:测试环境
production:生产环境,development:开发环境
DEBUG:是否开启debug模式
SECRET_KEY:密钥字符串
JSON_AS_ASCII:是否以ascii编码展示响应报文
JSONIFY_MIMETYPE:响应报文类型
值得注意的是:
如果响应报文含中文,JSON_AS_ASCII的值为False,JSONIFY_MIMETYPE值为"application/json;charset=utf-8",
否则响应报文中的中文会显示乱码
JSON_AS_ASCII =False
JSONIFY_MIMETYPE = "application/json;charset=utf-8"
【实践】
Flask提供了很多种方式来加载配置。比如,你可以像在字典中添加一个键值对一样来设置一个配置:
app.config['ADMIN_NAME']='Peter'
注意:配置的名称必须是全大写形式,小写的变量将不会被读取
除此之外,还可以通过把配置变量存储在单独的Python脚本、JSON格式的文件或是Python类中,config对象提供了相应的方法来导入配置。
和操作字典一样,读取一个配置就是从config字典里通过将配置的名称作为键读取对应的值:
value=app.config['ADMIN_NAME']
注意:某些扩展需要读取配置值来完成初始化操作,比如Flask-Mail,因此我们应该尽量将加载配置的操作提前,最好在程序实例app创建后就加载配置。
下面将逐一演示各种配置方式,及其效果
目录结构:
通过 键值对 配置app.config:
from flask import Flask
app =Flask(__name__)
print('配置前',app.config.get('FLASK_ENV'))
#使用键值对配置app环境变量
app.config['FLASK_ENV']='ABC'
print('配置后',app.config.get('FLASK_ENV')) #------运行结果----------------
配置前 None
配置后 ABC
使用update()方法可以一次加载多个值:
from flask import Flask
app =Flask(__name__) print('配置前',app.config.get('FLASK_ENV'))
#使用 update()方法可以一次加载多个值
app.config.update(
FLASK_ENV='ABC',
AAAA=123456
)
print('配置后',app.config.get('FLASK_ENV'))
print('配置后',app.config.get('AAAA')) #------运行结果----------------
配置前 None
配置后 ABC
配置后 123456
通过 json文件 配置app.config:app.config.from_json
settings.json文件内容如下:
{
"FLASK_ENV":"json"
}
代码示例:
from flask import Flask
app =Flask(__name__) import os
basedir = os.path.abspath(os.path.dirname(__file__))
jsondir =os.path.join(basedir,'settings.json') print('配置前',app.config.get('FLASK_ENV'))
#使用 json文件 配置app环境变量
app.config.from_json(jsondir)
print('配置后',app.config.get('FLASK_ENV')) #------运行结果---------------- 配置前 None
配置后 json
通过 字典 配置app.config: app.config.from_mapping
代码示例:
from flask import Flask
app =Flask(__name__) configDict={
'FLASK_ENV':'dictConfig'
} print('配置前',app.config.get('FLASK_ENV'))
#使用 json文件 配置app环境变量
app.config.from_mapping(configDict)
print('配置后',app.config.get('FLASK_ENV')) #------运行结果----------------
配置前 None
配置后 dictConfig
通过 python文件 配置app.config:
settings.py文件中内容如下:
py文件中的变量名将作为 app.config配置的key,变量值作为app.config[key]的value
FLASK_ENV='pyConfig'
代码示例:
from flask import Flask
app =Flask(__name__) print('配置前',app.config.get('FLASK_ENV'))
#使用 json文件 配置app环境变量
app.config.from_pyfile('settings.py')
print('配置后',app.config.get('FLASK_ENV')) #------运行结果----------------
配置前 None
配置后 pyConfig
通过 配置类 配置app.config:
classConfig.py定义了配置类BaseConfig
类中的属性作为 app.config的key,类中的属性值作为app.config[key]的value
class BaseConfig(object):
FLASK_ENV='objectConfig'
代码示例:
from flask import Flask
app =Flask(__name__) from demoConfig.classConfig import BaseConfig
objConfig=BaseConfig() print('配置前',app.config.get('FLASK_ENV'))
#使用 json文件 配置app环境变量
app.config.from_object(objConfig)
print('配置后',app.config.get('FLASK_ENV')) #------运行结果----------------
配置前 None
配置后 objectConfig