应用设置

一个 Flask 应用是一个 Flask 类的实例。有关应用程序的所有内容(如配置和URL)都将注册到此类中。

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

可以在一个函数内部创建 Flask 实例来代替创建全局实例。此函数称为 应用工厂. 应用程序需要的任何配置、注册和其他设置都将在函数内部进行,然后返回应用程序。

应用工厂

是时候开始编码了!创建 flaskr 文件夹并且文件夹内添加 __init__.py 文件。 __init__.py 有两个作用:一是包含应用工厂;二是 告诉 Python flaskr 文件夹应当视作为一个包。

$ mkdir flaskr
flaskr/__init__.py
import os

from flask import Flask


def create_app(test_config=None):
    # create and configure the app
    app = Flask(__name__, instance_relative_config=True)
    app.config.from_mapping(
        SECRET_KEY='dev',
        DATABASE=os.path.join(app.instance_path, 'flaskr.sqlite'),
    )

    if test_config is None:
        # load the instance config, if it exists, when not testing
        app.config.from_pyfile('config.py', silent=True)
    else:
        # load the test config if passed in
        app.config.from_mapping(test_config)

    # ensure the instance folder exists
    try:
        os.makedirs(app.instance_path)
    except OSError:
        pass

    # a simple page that says hello
    @app.route('/hello')
    def hello():
        return 'Hello, World!'

    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 包裹。

调试模式在页面引发异常时显示交互式调试器,并在您更改代码时重新启动服务器。您可以让它保持运行状态,只需按照教程的要求重新加载浏览器页面即可。

$ flask --app flaskr run --debug

可以将看到类似的输出:

* Serving Flask app "flaskr"
* Debug mode: on
* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
* Restarting with stat
* Debugger is active!
* Debugger PIN: nnn-nnn-nnn

在浏览器中访问http://127.0.0.1:5000/hello,你将看到“hello,world!”。那么恭喜你, Flask 网络应用成功运行了!

如果另一个程序已经在使用端口5000,您将看到 OSError: [Errno 98]OSError: [WinError 10013] 当服务器尝试启动时。看见 地址已在使用中 关于如何处理这件事。

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