Flask第八章：Flask之flask实例化配置以及flask对象配置

Posted 2021-02-01 zhangjunkang

Flask之flask实例化配置以及flask对象配置

flask是一个非常灵活且短小精干的web框架，那么灵活性从什么地方体现呢？

一、flask实例化配置

有一个神奇的东西叫flask配置，这个东西要怎么用呢？它能给我们带来怎么样的方便呢？

首先展示一下：

from flask import Flask

app = Flask(__name__)  # type:Flask
app.config["DEBUG"] = True

这句app.config["DRBUG"]=True可以实现的功能可刺激了，代码只要发生改变，自动重启Flaks程序(app.run)，在控制台打印的信息非常全面

以上两个功能就是传说中的DEBUG模式(调试模式)

Flask的配置就是在app.config中添加一个键值对，但是存进去的键必须是config中应该存在的，如果不存在的话，它会默认无用，就这么放着。

那么，config中有多少有用的key呢？

{
    ‘DEBUG‘: False,  # 是否开启Debug模式
    ‘TESTING‘: False,  # 是否开启测试模式
    ‘PROPAGATE_EXCEPTIONS‘: None,  # 异常传播(是否在控制台打印LOG) 当Debug或者testing开启后,自动为True
    ‘PRESERVE_CONTEXT_ON_EXCEPTION‘: None,  # 一两句话说不清楚,一般不用它
    ‘SECRET_KEY‘: None,  # 之前遇到过,在启用Session的时候,一定要有它
    ‘PERMANENT_SESSION_LIFETIME‘: 31,  # days , Session的生命周期(天)默认31天
    ‘USE_X_SENDFILE‘: False,  # 是否弃用 x_sendfile
    ‘LOGGER_NAME‘: None,  # 日志记录器的名称
    ‘LOGGER_HANDLER_POLICY‘: ‘always‘,
    ‘SERVER_NAME‘: None,  # 服务访问域名
    ‘APPLICATION_ROOT‘: None,  # 项目的完整路径
    ‘SESSION_COOKIE_NAME‘: ‘session‘,  # 在cookies中存放session加密字符串的名字
    ‘SESSION_COOKIE_DOMAIN‘: None,  # 在哪个域名下会产生session记录在cookies中
    ‘SESSION_COOKIE_PATH‘: None,  # cookies的路径
    ‘SESSION_COOKIE_HTTPONLY‘: True,  # 控制 cookie 是否应被设置 httponly 的标志，
    ‘SESSION_COOKIE_SECURE‘: False,  # 控制 cookie 是否应被设置安全标志
    ‘SESSION_REFRESH_EACH_REQUEST‘: True,  # 这个标志控制永久会话如何刷新
    ‘MAX_CONTENT_LENGTH‘: None,  # 如果设置为字节数， Flask 会拒绝内容长度大于此值的请求进入，并返回一个 413 状态码
    ‘SEND_FILE_MAX_AGE_DEFAULT‘: 12,  # hours 默认缓存控制的最大期限
    ‘TRAP_BAD_REQUEST_ERRORS‘: False,
    # 如果这个值被设置为 True ，Flask不会执行 HTTP 异常的错误处理，而是像对待其它异常一样，
    # 通过异常栈让它冒泡地抛出。这对于需要找出 HTTP 异常源头的可怕调试情形是有用的。
    ‘TRAP_HTTP_EXCEPTIONS‘: False,
    # Werkzeug 处理请求中的特定数据的内部数据结构会抛出同样也是“错误的请求”异常的特殊的 key errors 。
    # 同样地，为了保持一致，许多操作可以显式地抛出 BadRequest 异常。
    # 因为在调试中，你希望准确地找出异常的原因，这个设置用于在这些情形下调试。
    # 如果这个值被设置为 True ，你只会得到常规的回溯。
    ‘EXPLAIN_TEMPLATE_LOADING‘: False,
    ‘PREFERRED_URL_SCHEME‘: ‘http‘,  # 生成URL的时候如果没有可用的 URL 模式话将使用这个值
    ‘JSON_AS_ASCII‘: True,
    # 默认情况下 Flask 使用 ascii 编码来序列化对象。如果这个值被设置为 False ，
    # Flask不会将其编码为 ASCII，并且按原样输出，返回它的 unicode 字符串。
    # 比如 jsonfiy 会自动地采用 utf-8 来编码它然后才进行传输。
    ‘JSON_SORT_KEYS‘: True,
    #默认情况下 Flask 按照 JSON 对象的键的顺序来序来序列化它。
    # 这样做是为了确保键的顺序不会受到字典的哈希种子的影响，从而返回的值每次都是一致的，不会造成无用的额外 HTTP 缓存。
    # 你可以通过修改这个配置的值来覆盖默认的操作。但这是不被推荐的做法因为这个默认的行为可能会给你在性能的代价上带来改善。
    ‘JSONIFY_PRETTYPRINT_REGULAR‘: True,
    ‘JSONIFY_MIMETYPE‘: ‘application/json‘,
    ‘TEMPLATES_AUTO_RELOAD‘: None,
}

config中的key

以上这些key都可以被改写，当然他们也都是有默认值存在的，如果没有特殊情况，不要改写它的默认值。

修改配置的方式大约有两种：

1.直接对app.config进行修改：

app.config["DEBUG"] = True

2.使用类的方式导入：

首先要有一个settings.py的文件

class FlaskDebug(object):
    DEBUG = True
    SECRET_KEY = "DEBUGmoshidesecret_key"
    PERMANENT_SESSION_LIFETIME = 7
    SESSION_COOKIE_NAME = "debug_session"

然后我们在Flask的启动文件中就可以这么写：

from flask import Flask
from settings import FlaskDebug

app = Flask(__name__)  # type:Flask
app.config.from_object("FlaskDebug")

这叫做类导入配置

重点记忆的有：

1.template_folder="temp" 默认模板路径 templates
2.static_folder="static", 默认静态文件路径 static
3.static_url_path="/static" 访问静态文件路由地址 默认是"/"+static_folder

4.static_host=None 指定静态文件服务器地址
5.host_matching = False,  # 如果不是特别需要的话,慎用,否则所有的route 都需要host=""的参数
6.subdomain_matching = False,  #理论上来说是用来限制SERVER_NAME子域名的,但是目前还没有感觉出来区别在哪里 
7.instance_path = None,  # 指向另一个Flask实例的路径
8.instance_relative_config = False  # 是否加载另一个实例的配置
9.root_path = None  # 主模块所在的目录的绝对路径,默认项目目录

 

 

二、flask对象配置

这是针对一个已经实例化的app进行的配置

‘DEBUG‘: False,  # 是否开启Debug模式
‘TESTING‘: False,  # 是否开启测试模式
‘SECRET_KEY‘: None # 在启用Flask内置Session的时候/开启flash,一定要有它
‘PERMANENT_SESSION_LIFETIME‘: 31,  # days , Session的生命周期(天)默认31天
‘SESSION_COOKIE_NAME‘: ‘session‘,  # 在cookies中存放session加密字符串的名字