应用设置¶

    创建一个 Flask 应用最粗暴直接的方法是在代码的最开始创建一个全局Flask 实例。前面的 “Hello, World!” 示例就是这样做的。有的情况下这样做是简单和有效的，但是当项目越来越大的时候就会有些力不从心了。

    可以在一个函数内部创建 实例来代替创建全局实例。这个函数被称为 应用工厂 。所有应用相关的配置、注册和其他设置都会在函数内部完成，然后返回这个应用。

    写代码的时候到了！创建 flaskr 文件夹并且文件夹内添加 文件。 init.py 有两个作用：一是包含应用工厂；二是告诉 Python flaskr 文件夹应当视作为一个包。

    flaskr/init.py

    1. import os
    2.  
    3. from flask import Flask
    4.  
    5.  
    6. def create_app(test_config=None):
    7.     # create and configure the app
    8.     app = Flask(__name__, instance_relative_config=True)
    9.     app.config.from_mapping(
    10.         SECRET_KEY='dev',
    11.         DATABASE=os.path.join(app.instance_path, 'flaskr.sqlite'),
    12.     )
    13.  
    14.     if test_config is None:
    15.         # load the instance config, if it exists, when not testing
    16.     else:
    17.         # load the test config if passed in
    18.         app.config.from_mapping(test_config)
    19.  
    20.     # ensure the instance folder exists
    21.     try:
    22.         os.makedirs(app.instance_path)
    23.     except OSError:
    24.         pass
    25.  
    26.     # a simple page that says hello
    27.     @app.route('/hello')
    28.     def hello():
    29.         return 'Hello, World!'
    30.  
    31.     return app
    • app = Flask(name, instance_relative_config=True) 创建 实例。
      • instance_relative_config=True 告诉应用配置文件是相对于instance folder 的相对路径。实例文件夹在flaskr 包的外面，用于存放本地数据（例如配置密钥和数据库），不应当提交到版本控制系统。
    • 设置一个应用的缺省配置：
      • SECRET_KEY 是被 Flask 和扩展用于保证数据安全的。在开发过程中，为了方便可以设置为 'dev' ，但是在发布的时候应当使用一个随机值来重载它。
      • DATABASE SQLite 数据库文件存放在路径。它位于 Flask 用于存放实例的 之内。下一节会更详细地学习数据库的东西。
    • app.config.from_pyfile() 使用config.py 中的值来重载缺省配置，如果 config.py 存在的话。例如，当正式部署的时候，用于设置一个正式的 SECRET_KEY 。
      • test_config 也会被传递给工厂，并且会替代实例配置。这样可以实现测试和开发的配置分离，相互独立。
    • 可以确保app.instance_path 存在。 Flask 不会自动创建实例文件夹，但是必须确保创建这个文件夹，因为 SQLite 数据库文件会被保存在里面。
    • 创建一个简单的路由，这样在继续教程下面的内容前你可以先看看应用如何运行的。它创建了 URL /hello 和一个函数之间的关联。这个函数会返回一个响应，即一个 'Hello, World!' 字符串。

    运行应用¶

    现在可以通过使用 flask 命令来运行应用。在终端中告诉 Flask 你的应用在哪里，然后在开发模式下运行应用。

    开发模式下，当页面出错的时候会显示一个可以互动的调试器；当你修改代码保存的时候会重启服务器。在学习本教程的过程中，你可以一直让它保持运行，只需要刷新页面就可以了。

    在 Linux and Mac 下：

    在 Windows 下，使用 set 代替 export ：

    1. set FLASK_APP=flaskr
    2. set FLASK_ENV=development
    3. flask run

    可以看到类似如下输出内容：

    1. * Serving Flask app "flaskr"
    2. * Environment: development
    3. * Debug mode: on
    4. * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
    5. * Restarting with stat
    6. * Debugger is active!

    在浏览器中访问 ，就可以看到“Hello, World!” 信息。恭喜你， Flask 网络应用成功运行了！

    下面请阅读 定义和操作数据库 。