Flask02--配置文件

一. 配置文件

1. 三種基本配置

# 第一種方式
# app的配置文件全在config字典中，但是有一些常用的，比如debug，會直接提到app這一層
app.debug = True
app.config['DEBUG'] = False


# 第二種方式
'''
# settings.py  注意: settings.py是與配置配置文件的加載文件同一級別
DEBUG = False
'''
app.config.from_pyfile("settings.py")


# 第三種
'''
# mysettings.py 注意: mysettings.py是與配置配置文件的加載文件同一級別
DEBUG = False
class Config(object):
    DEBUG = False
    TESTING = False
    DATABASE_URI = 'sqlite://:memory:'


class ProductionConfig(Config):
    DATABASE_URI = 'mysql://user@localhost/foo'


class DevelopmentConfig(Config):
    DEBUG = False


class TestingConfig(Config):
    DEBUG = True
'''
app.config.from_object("mysettings.DevelopmentConfig")

2. 其它配置

# 提示: 從sys.path中已經存在路徑開始寫
# 提示: settings.py文件默認路徑要放在程序root_path目錄，如果instance_relative_config為True，則就是instance_path目錄（Flask對象init方法的參數）


# 通過環境變量配置: 環境變量的值為python文件名稱名稱，內部調用from_pyfile方法
app.config.from_envvar("環境變量名稱")
#app.config.from_pyfile(os.environ['YOURAPPLICATION_SETTINGS'])


# JSON文件名稱，必須是json格式，因為內部會執行json.loads
app.config.from_json("json文件名稱")


# 字典格式
app.config.from_mapping({'DEBUG': True})

3. 默認配置

# flask中的配置文件是一個flask.config.Config對象（繼承字典）,默認配置為：
{
    '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 異常。因為在調試中，你希望准確地找出異常的原因，這個設置用於在這些情形下調試。
    'EXPLAIN_TEMPLATE_LOADING': False,       # 如果這個值被設置為 True ，你只會得到常規的回溯。
    'PREFERRED_URL_SCHEME': 'http',          # 生成URL的時候如果沒有可用的 URL 模式話將使用這個值
    'JSON_AS_ASCII': True,                   # 默認情況下 Flask 使用 ascii 編碼來序列化對象。如果這個值被設置為 False ， Flask不會將其編碼為 ASCII，並且按原樣輸出，返回它的 unicode 字符串。
    'JSON_SORT_KEYS': True,                  # 比如 jsonfiy 會自動地采用 utf-8 來編碼它然后才進行傳輸。
    
    
    
    'JSONIFY_PRETTYPRINT_REGULAR': True,     # 默認情況下 Flask 按照 JSON 對象的鍵的順序來序來序列化它。
    'JSONIFY_MIMETYPE': 'application/json',  # 這樣做是為了確保鍵的順序不會受到字典的哈希種子的影響，從而返回的值每次都是一致的，不會造成無用的額外 HTTP 緩存。
    'TEMPLATES_AUTO_RELOAD': None,           # 你可以通過修改這個配置的值來覆蓋默認的操作。但這是不被推薦的做法因為這個默認的行為可能會給你在性能的代價上帶來改善。
}