应用设置

一个 Flask 应用是一个 Flask 类的实例。应用的所有东西（例如配置 和 URL ）都会和这个实例一起注册。

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

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

应用工厂

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

  1. $ mkdir flaskr

flaskr/__init__.py

  1. import os
  3. from flask import Flask
  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.     )
  14.     if test_config is None:
  15.         # load the instance config, if it exists, when not testing
  16.         app.config.from_pyfile('config.py', silent=True)
  17.     else:
  18.         # load the test config if passed in
  19.         app.config.from_mapping(test_config)
  21.     # ensure the instance folder exists
  22.     try:
  23.         os.makedirs(app.instance_path)
  24.     except OSError:
  25.         pass
  27.     # a simple page that says hello
  28.     @app.route('/hello')
  29.     def hello():
  30.         return 'Hello, World!'
  32.     return app

create_app 是一个应用工厂函数，后面的教程中会用到。这个看似简单的函 数其实已经做了许多事情。

  1. app = Flask(__name__, instance_relative_config=True) 创建 Flask 实例。

    • __name__ 是当前 Python 模块的名称。应用需要知道在哪里设置路 径，使用 __name__ 是一个方便的方法。

    • instance_relative_config=True 告诉应用配置文件是相对于 instance folder 的相对路径。实例文件 夹在 flaskr 包的外面，用于存放本地数据（例如配置密钥和数据 库），不应当提交到版本控制系统。

  2. app.config.from_mapping() 设置一个应 用的缺省配置：

    • SECRET_KEY 是被 Flask 和扩展用于保证数据安全的。在开发 过程中，为了方便可以设置为 'dev' ，但是在发布的时候应当使用 一个随机值来重载它。

    • DATABASE SQLite 数据库文件存放在路径。它位于 Flask 用于存放 实例的 app.instance_path 之内。下 一节会更详细地学习数据库的东西。

  3. app.config.from_pyfile() 使用 config.py 中的值来重载缺省配置，如果 config.py 存在的话。 例如，当正式部署的时候，用于设置一个正式的 SECRET_KEY 。

    • test_config 也会被传递给工厂，并且会替代实例配置。这样可以 实现测试和开发的配置分离，相互独立。

  4. os.makedirs() 可以确保 app.instance_path 存在。 Flask 不会自 动创建实例文件夹，但是必须确保创建这个文件夹，因为 SQLite 数据库文 件会被保存在里面。

  5. @app.route() 创建一个简单的路由，这样在继续教 程下面的内容前你可以先看看应用如何运行的。它创建了 URL /hello 和一个函数之间的关联。这个函数会返回一个响应，即一个 'Hello, World!' 字符串。

运行应用

现在可以通过使用 flask 命令来运行应用。在终端中告诉 Flask 你的应用 在哪里，然后在开发模式下运行应用。请记住，现在还是应当在最顶层的 flask-tutorial 目录下，不是在 flaskr 包里面。

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

BashCMDPowershell

  1. $ export FLASK_APP=flaskr
  2. $ export FLASK_ENV=development
  3. $ flask run
  1. > set FLASK_APP=flaskr
  2. > set FLASK_ENV=development
  3. > flask run
  1. > $env:FLASK_APP = "flaskr"
  2. > $env: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!
  7. * Debugger PIN: 855-212-761

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

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