Python Flask Web框架（七）

1. Flask项目实战1

一、Flaskr介绍

这里我们将称我们的博客应用为flaskr，也可以取一个不那么 web 2.0 的名字。基本上我们想要它做如下的事情：

1. 根据配置文件中的认证允许用户登录以及注销。仅仅支持一个用户。
2. 当用户登录后，他们可以添加新的条目，这些条目是由纯文本的标题和 HTML 的正文构成。因为我们信任 用户这里的 HTML 是安全的。
3. 页面倒序显示所有条目（新的条目在前），并且用户登入后可以在此添加新条目。

我们将在这个应用中直接使用 SQLite 3 因为它足够应付这种规模的应用。对更大的应用使用 SQLAlchemy 是十分有意义的，它以一种更智能方式处理数据库连接，允许你一次连接多个不用的关系数据库。 你也可以考虑流行的 NoSQL 数据库，前提是你的数据更适合它们。

这是最终应用的一个截图:

二、创建文件夹

在我们开始之前，让我们为这个应用创建需要的文件夹:

/flaskr
    /static
    /templates

使用如何命令创建以上文件夹：

cd /home/shiyanlou/Code/shiyanlou_cs29
mkdir flaskr
cd flaskr
mkdir static
mkdir templates

flaskr 文件夹不是一个 Python 的包，只是我们放置文件的地方。 在接下来的步骤中我们会直接把数据库模式和主模块放在这个文件夹中。应用的用户可以通过 HTTP 访问static文件夹中的文件。这里也是css和javascript文件的存放位置。Flask 将会在templates文件夹中寻找Jinja2 模版。在本教程后面创建的模板将会在这个文件夹中。

三、数据库模式

首先我们要创建数据库模式。对于这个应用仅一张表就足够了，而且我们只想支持 SQLite ，所以很简单。 只要把下面的内容放入一个名为schema.sql的文件，文件置于刚才创建的 flaskr 文件夹中：

drop table if exists entries;
create table entries (
  id integer primary key autoincrement,
  title string not null,
  text string not null
);

这个模式由一个称为entries的单表构成，在这个表中每行包含一个id，一个title和一个text。id是一个自增的整数而且是主键，其余两个为非空的字符串。

四、应用设置代码

现在我们已经有了数据库模式了，我们可以创建应用的模块了。让我们新建文件名为flaskr.py，并放置于flaskr文件夹中。对于小应用，直接把配置放在主模块里，正如我们现在要做的一样，是可行的。然而一个更干净的解决方案就是单独创建.ini或者.py文件接着加载或者导入里面的值。

在 flaskr.py 中:

# 导入所有的模块
import sqlite3
from flask import Flask, request, session, g, redirect, url_for, abort, render_template, flash

# 配置文件
DATABASE = '/tmp/flaskr.db'
DEBUG = True
SECRET_KEY = 'development key'
USERNAME = 'admin'
PASSWORD = 'default'

下一步我们能够创建真正的应用，接着用同一文件(在flaskr.py 中)中的配置初始化:

# 创建应用
app = Flask(__name__)
app.config.from_object(__name__)

from_object()将会寻找给定的对象(如果它是一个字符串，则会导入它)， 搜寻里面定义的全部大写的变量。在我们的这种情况中，配置文件就是我们上面写的几行代码。 你也可以将他们分别存储到多个文件。

通常，从配置文件中加载配置是一个好的主意。这是可以用from_envvar()所实现的， 可以用它替换上面的from_object()

app.config.from_envvar('FLASKR_SETTINGS', silent=True)

这种方法我们可以设置一个名为FLASKR_SETTINGS的环境变量来设定一个配置文件载入后是否覆盖默认值。 静默开关silent=True告诉 Flask 不去关心这个环境变量键值是否存在。

secret_key是需要为了保持客户端的会话安全。明智地选择该键，使得它难以猜测，最好是尽可能复杂。

调试标志启用或禁用交互式调试。决不让调试模式在生产系统中启动，因为它将允许用户在服务器上执行代码！

我们还添加了一个轻松地连接到指定数据库的方法，这个方法用于在请求时打开一个连接，并且在交互式 Python shell 和脚本中也能使用。这对以后很方便。

def connect_db():
    return sqlite3.connect(app.config['DATABASE'])

最后如果我们想要把那个文件当做独立应用来运行，我们只需在服务器启动文件的末尾添加这一行:

if __name__ == '__main__':
    app.run()

如此我们便可以顺利开始运行这个应用，通过使用如下命令:

python flaskr.py

你将会看到一个信息，信息提示你服务器启动的地址，这个地址你能够访问到的。

当你在浏览器中访问服务器获得一个 404 页面无法找到的错误时，是因为我们还没有任何视图。我们之后再来关注这些。首先我们应该让数据库工作起来。

五、小结

本节讲解了一个简单 flask 项目的搭建，下一节中将创建数据库。

六、练习

请参照文档所讲搭建好项目。