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,           # 你能夠經過修改這個配置的值來覆蓋默認的操做。但這是不被推薦的作法由於這個默認的行爲可能會給你在性能的代價上帶來改善。
}