Flask 框架基础
Flask 搭建
Flask 1.0 文档
依赖
当安装 Flask 时,以下配套软件会被自动安装。
- Werkzeug 用于实现 WSGI ,应用和服务之间的标准 Python 接口。
- Jinja 用于渲染页面的模板语言。
- MarkupSafe 与 Jinja 共用,在渲染页面时用于避免不可信的输入,防止注入攻击。
- ItsDangerous 保证数据完整性的安全标志数据,用于保护 Flask 的 session cookie.
- Click 是一个命令行应用的框架。用于提供 flask 命令,并允许添加自定义 管理命令。
可选依赖
以下配套软件不会被自动安装。如果安装了,那么 Flask 会检测到这些软件。
- Blinker 为 信号 提供支持。
- SimpleJSON 是一个快速的 JSON 实现,兼容 Python’s json 模块。如果安装 了这个软件,那么会优先使用这个软件来进行 JSON 操作。
- python-dotenv 当运行 flask 命令时为 通过 dotenv 设置环境变量 提供支持。
- Watchdog 为开发服务器提供快速高效的重载。
创建虚拟环境
创建一个项目文件夹,然后创建一个虚拟环境。
mkdir myproject
cd myproject
python -m venv venv
在开始工作前,先要激活相应的虚拟环境。
# Linux 下
. venv/bin/activate
# Windows下
venv\Scripts\activate
安装 Flask
python -m pip install Flask
在Windows平台命令行输入以上命令安装,可能会存在MarkupSafe依赖安装失败的问题,这主要是因为Windows命令行编码与Python中的不一致导致的问题。Windows命令行的默认编码是GBK,而Python3中默认编码是UTF-8,因此可以临时将Windows命令行切换为UTF-8编码
# 切换编码为utf-8
chcp 65001
#手动安装 markupsafe
python -m pip install markupsafe
# 安装完成后,请再次切回GBK。否则将导致以后使用cmd时出现各种奇怪的问题
# Windows系统的默认编码即GBK,请与系统保持一致。
chcp 936
如安装时缓慢或卡住,很可能是网络问题导致的,则建议使用国内源安装
# 使用清华大学的源
python -m pip install Flask -i https://pypi.tuna.tsinghua.edu.cn/simple
测试
- 创建hello.py文件,输入如下内容
from flask import Flask app = Flask(__name__) @app.route('/') def hello_world(): return 'Hello, World!'
- 导出
FLASK_APP
环境变量# Linux 下 export FLASK_APP=hello.py flask run # Windows下 set FLASK_APP=hello.py python -m flask run
- 在浏览器输入以下地址,正常显示Hello, World!
http://localhost:5000/
Flask 的基本使用
路由
应用实例需要知道对每个
URL
的请求要运行哪些对应的函数,所以保存了一个URL
到Python函数之间的映射关系。用于处理URL
和函数之间关系的程序称为路由
在 Flask 应用中定义路由的最简便方式是使用Flask实例提供的 app.route 装饰器。
@app.route('/')
def index():
return 'Hello World!'
使用装饰器并不是唯一的把index()
函数注册为应用根URL
的处理程序的方式。实际上不使用装饰器语法也是可以做到的,我们可以通过调用app.add_url_ rule()
方法实现。该方法最简单的形式是接受3个参数:URL、端点名、视图函数
def index():
return 'Hello World!'
app.add_url_rule('/', 'index', index)
视图函数
像上面代码中的
hello_world()
、index()
这样处理客户端请求的函数被称为视图函数。在浏览器中访问相应的URL
后,会触发服务器执行对应的视图函数。这个函数的返回值称为响应,也就是客户端浏览器接收到的内容。视图函数返回的响应可以是包含 HTML 的字符串,也可以是复杂表单。
当请求的URL
中带有动态参数时,我们可以将视图函数与动态路由结合使用
@app.route('/greet/<name>')
def sayHello(name):
return 'Hello, ' + name
增加以上代码后重新运行服务器,在浏览器输入:
http://localhost:5000/greet/Bob
则浏览器显示Hello, Bob
请求与响应
请求
Flask 从客户端收到请求时,将客户端发送的HTTP请求封装成了请求对象。想让视图函数能够访问请求对象,一种直截了当的方式是将其作为参数传入视图函数,不过这会导致应用中的每个视图函数都多出一个参数。为了避免大量可有可无的参数把视图函数弄得一团糟,Flask 使用上下文临时把某些对象变为全局可访问。
事实上它并不是真正的全局变量,在多线程服务器中,多个线程同时处理不同客户端发送的不同请求时,每个线程看到的请求对象必然不同。Flask 使用上下文让特定的变量在一个线程中全局可访问,与此同时却不会干扰其他线程。
示例代码
# 引入请求对象
from flask import request
@app.route('/')
def index():
user_agent = request.headers.get('User-Agent')
return 'Your browser is' + user_agent
请求对象包含客户端发送的 HTTP请求的全部信息
属性或方法 | 简述 |
---|---|
form | 一个字典,存储请求提交的所有表单字段 |
args | 一个字典,存储通过 URL查询字符串传递的所有参数 |
values | 一个字典,form 和args 的合集 |
cookies | 一个字典,存储请求的所有 cookie |
headers | 一个字典,存储请求的所有 HTTP首部 |
files | 一个字典,存储请求上传的所有文件 |
get_data() | 返回请求主体缓冲的数据 |
get_json() | 返回一个Python字典,包含解析请求主体后得到的 JSON |
blueprint | 处理请求的Flask 蓝本的名称 |
endpoint | 处理请求的Flask端点的名称;Flask把视图函数的名称用作路由端点的名称 |
method | HTTP请求方法,例如 GET 或POST |
scheme | URL方案(http 或https) |
is_secure() | 通过安全的连接(HTTPS)发送请求时返回 True |
host | 请求定义的主机名,如果客户端定义了端口号,还包括端口号 |
path | URL的路径部分 |
query_string | URL的查询字符串部分,返回原始二进制值 |
full_path | URL的路径和查询字符串部分 |
url | 客户端请求的完整URL |
base_url | 同url,但没有查询字符串部分 |
remote_addr | 客户端的IP地址 |
environ | 请求的原始WSGI环境字典 |
响应
Flask 调用视图函数后,会将其返回值作为响应的内容。大多情况下,响应就是一个简单的字符串,作为HTML页面返回给客户端。但 HTTP 协议需要的不仅是作为请求响应的字符串。HTTP 响应中一个很重要的部分是状态码,Flask默认设为 200,表明请求已被成功处理。
Flask有两种方式返回响应,一种是简单的利用多返回值,如下例,第二个参数为状态码
@app.route('/')
def index():
return '<h1>Bad Request</h1>', 400
视图函数还可以返回三个参数,第三个参数是一个由 HTTP 响应头组成的字典。
如果不想使用视图函数的多返回值的方式返回响应,还可以使用另一种方式返回响应,那就是创建一个响应对象,然后让视图函数返回这个响应对象。
from flask import make_response
@app.route('/')
def index():
response = make_response('<h1>This document carries a cookie!</h1>')
response.set_cookie('thiscookie', '666')
return response
响应对象常用属性和方法
属性或方法 | 简述 |
---|---|
status_code | HTTP数字状态码 |
headers | 一个类似字典的对象,包含随响应发送的所有首部 |
set_cookie() | 为响应添加一个cookie |
delete_cookie() | 删除一个cookie |
content_length | 响应主体的长度 |
content_type | 响应主体的媒体类型 |
set_data() | 使用字符串或字节值设定响应 |
get_data() | 获取响应主体 |