配置

    当你学习 Flask 的时候，配置看起来很简单。你只要在 config.py 中定义一些变量接着一切就能工作了。当你开始必须要管理生产应用的配置的时候，这些简单性开始消失了。你可能需要保护 API 密钥以及为不同的环境使用不同的配置（例如，开发和生产环境）。在本章节中我们会介绍 Flask 一些先进的功能，它可以使得管理配置容易些。

    一个简单的应用程序可能不会需要任何这些复杂的功能。你可能只需要把 config.py 放在你的仓库/版本库的根目录并且在 app.py 或者 yourapp/init.py 中加载它。

    config.py 文件中应该每行包含一个配置变量赋值。当你的应用程序初始化的时候，在 config.py 中的配置变量用于配置 Flask 和它的扩展并且它们能够通过 字典访问到 — 例如，app.config["DEBUG"]。

    配置的变量可以被 Flask，它的扩展或者你来使用。这个例子中， 每当我们在一封事务性邮件中需要默认的 “发件人” 的时候，我们可以使用 app.config["MAIL_FROM_EMAIL"] — 例如，密码重置。把这些信息放置于一个配置变量中使得以后能够容易地修改它。

    1. # app.py or app/__init__.py
    2. from flask import Flask
    3.  
    4. app = Flask(__name__)
    5. app.config.from_object('config')
    6.  
    7. # Now we can access the configuration variables via app.config["VAR_NAME"].

    Warning

    确保在生产环境中 DEBUG 设置成 。如果保留 DEBUG 为 True，它允许用户在你的服务器上执行任意的 Python。

    有时候你需要定义包含敏感信息的配置变量。我们想要从 config.py 中分离这些变量并且让它们保留在仓库/版本库之外。你可能会隐藏像数据库密码以及 API 密钥的一些敏感信息，或者定义于特定于指定机器的配置变量。为让实现这些要求更加容易些，Flask 提供了一个叫做 instance folders 的功能。实例文件夹是仓库/版本库下的一个子目录并且包含专门为这个应用程序的实例的一个配置文件。我们不希望它提交到版本控制。

    1. config.py
    2. requirements.txt
    3. run.py
    4. instance/
    5.   config.py
    6. yourapp/
    7.   __init__.py
    8.   views.py
    9.   templates/
    10.   static/
    ### 使用实例文件夹 我们使用 app.config.from_pyfile() 来从一个实例文件夹中加载配置变量。当我们调用 Flask() 来创建我们的应用的时候，如果我们设置了 instance_relative_config=True， 将会从 _instance/_ 目录加载指定文件。

    现在我们可以像在 config.py 中那样在 instance/config.py 中定义配置变量。你也应该把你的实例文件夹加入到版本控制系统的忽略列表中。要使用 Git 做到这一点的话，你需要在 .gitignore 新的一行中添加 instance/ 。

    实例文件夹的隐私性成为在其里面定义不想暴露到版本控制的密钥的最佳候选。这些密钥可能包含了你的应用的密钥或者第三方 API 密钥。如果你的应用是开源的或者以后可能会公开的话，这一点特别重要。我们通常要求其他用户或者贡献者使用自己的密钥。

    1. # instance/config.py
    2.  
    3. SECRET_KEY = 'Sm9obiBTY2hyb20ga2lja3MgYXNz'
    4. STRIPE_API_KEY = 'SmFjb2IgS2FwbGFuLU1vc3MgaXMgYSBoZXJv'
    5. SQLALCHEMY_DATABASE_URI= \
    6. "postgresql://user:TWljaGHFgiBCYXJ0b3N6a2lld2ljeiEh@localhost/databasename"
    ### 基于环境的配置 如果在你的生产环境和开发环境中的差异非常小的话，你可能想要使用实例文件夹来处理配置的变化。定义在 _instance/config.py_ 文件中的配置变量能够覆盖 _config.py_ 中的值。你只需要在 app.config.from_object() 后调用 app.config.from_pyfile()。这样用法的好处之一就是在不同的机器上修改你的应用的配置。 
    1. # config.py
    2.  
    3. DEBUG = False
    4. SQLALCHEMY_ECHO = False
    5.  
    6.  
    7. # instance/config.py
    8. DEBUG = True
    9. SQLALCHEMY_ECHO = True

    在生产环境上，我们略去上面 instance/-config.py 中的配置变量，它会退回到定义在 config.py 中的值。

    Note

    • 了解更多关于 Flask-SQLAlchemy 的 配置项。（中文版的位于：）

    实例文件夹不应该出现在版本控制中。这就意味着你将无法跟踪你的实例配置的变化。如果只是一、两个变量这可能不是什么问题，但是如果你在不同的环境上（生产，预升级，开发，等等）配置都有些微调话，你就不会想要存在丢失它们的风险。

    在上面的文件列表中我们有多个不同的配置文件。

    |config/default.py|默认的配置值，可用于所有的环境或者被个人的环境给覆盖。
    |config/development.py|用于开发环境的配置值。这里你可能会指定本地数据库的 URI。
    |config/production.py|用于生产环境的配置值。在这里 DEBUG 一定要设置成 。
    |config/staging.py|根据开发进度，你可能会有一个模拟生产环境，这个文件主要用于这种场景。

    为了决定要加载哪个配置文件，我们会调用 app.config.from_envvar()。

    1.  
    2. app = Flask(__name__, instance_relative_config=True)
    3.  
    4. # Load the default configuration
    5. app.config.from_object('config.default')
    6.  
    7. # Load the configuration from the instance folder
    8. app.config.from_pyfile('config.py')
    9.  
    10. # Load the file specified by the APP_CONFIG_FILE environment variable
    11. # Variables defined here will override those in the default configuration
    12. app.config.from_envvar('APP_CONFIG_FILE')

    环境变量的值应该是配置文件的绝对路径。

    我们如何设置这个环境变量取决于我们运行应用所在的平台。如果我们运行在一个普通的 Linux 服务器上，我们可以编写一个设置环境变量的 shell 脚本并且运行 run.py。

    1. # start.sh
    2.  
    3. APP_CONFIG_FILE=/var/www/yourapp/config/production.py
    4. python run.py

    start.sh 对于每一个环境都是独一无二的，因此它应该被排除在版本控制之外。在 Heroku 上，我们需要使用 Heroku 工具来设置环境变量。这种设置方式也适用于其它的 PaaS 平台。

    • 一个简单的应用程序可能仅仅需要一个配置文件：config.py。
    • 实例文件夹能够帮助我们隐藏敏感的配置值。
    • 实例文件夹能够用于针对每个特定的环境需要改变应用程序的配置的场景。