Flask介绍
Flask 是一款发布于2010年非常流行的 Python Web 框架。
特点
- 微框架、简洁,给开发者提供了很大的扩展性。
- Flask和相应的插件写得很好,用起来很爽。
开发效率非常高,比如使用 SQLAlchemy 的 ORM 操作数据库可以节省开发者大量书写 sql 的时间。 - Flask 的灵活度非常之高,他不会帮你做太多的决策,很多都可以按
照自己的意愿进行更改。
比如:
使用 Flask 开发数据库的时候,具体是使用 SQLAlchemy 还是MongoEngine,选择权完全掌握在你自己的手中。
Flask 本身相当于一个内核,其他几乎所有的功能都要用到扩展(邮
件扩展 Flask-Mail
,用户认证 Flask-Login
,数据库 Flask-SQLAlchemy
),都需要用第三方的扩展来实现。
Flask 没有默认使用的数据库,可以选择 MySQL
,也可以用NoSQL
。
其 WSGI 工具箱采用 Werkzeug
(路由模块),模板引擎则使用Jinja2
。这两个也是 Flask 框架的核心。
扩展
- Flask-SQLalchemy:操作数据库;
- Flask-script:插入脚本;
- Flask-migrate:管理迁移数据库;
- Flask-Session:Session存储方式指定;
- Flask-WTF:表单;
- Flask-Mail:邮件;
- Flask-Bable:提供国际化和本地化支持,翻译;
- Flask-Login:认证用户状态;
- Flask-OpenID:认证;
- Flask-RESTful:开发REST API的工具;
- Flask-Bootstrap:集成前端Twitter Bootstrap框架;
- Flask-Moment:本地化日期和时间;
- Flask-Admin:简单而可扩展的管理接口的框架
文档地址
中文文档
英文文档
Flask的安装
pip install flask
第一个Flask程序
#从flask包中导入Flask类
from flask import Flask
#创建一个Flask对象
app = Flask(__name__)
#@app.route:是一个装饰器
#@app.route('/')就是将url中 / 映射到hello_world
设个视图函数上面
#以后你访问我这个网站的 / 目录的时候 会执行hello_world这个函数,然后将这个函数的返回值返回给浏览器
@app.route('/')
def hello_world():
return '尚学堂' #启动这个WEB服务
if __name__ == '__main__':
#默认为5000端口
app.run() #app.run(port=8000)
启动运行
python helloworld.py
运行方式
通过对象运行
运行程序时,可以指定运行的主机IP地址,端口
app.run(host="0.0.0.0", port=5000) #
127.0.0.1
参数解释
-
host
主机IP地址,可以不传
默认localhost -
port
端口号,可以不传
默认5000
通过Python运行方式运行
app = Flask(__name__)
@app.route("/")
def index():
return "hello world"
if __name__ == '__main__':
app.run()
如果想在同一个局域网下的其他电脑访问自己电脑上的Flask网 站,需要设置 host=‘0.0.0.0’ 才能访问得到
通过Flask自带命令运行
app = Flask(__name__)
@app.route("/")
def index():
return "hello world"
# 程序中不用再写app.run()
$ export FLASK_APP=helloworld
$ flask run
* Running on http://127.0.0.1:5000/
比如
flask run -h 0.0.0.0 -p 8000
命令行下,可以使用使用简写 可以通过 flask run --help 获取帮助
-h, --host TEXT The interfaceto bind to.
-p, --port INTEGER The port tobind to.
--reload / --no-reload Enable ordisable the reloader. By default
the reloaderis active if debug is enabled.
--debugger / --no-debugger Enable ordisable the debugger. By default
--help Show thismessage and exit.
Debug模式与配置参数加载
在代码中制作一个错误
@app.route('/')
def hello_world():
a = 1
b = 0
c = a/b
return 'Hello World!'
if __name__ == '__main__':
app.run()
启动并访问
控制台倒是给出了错误提示信息,但是我们希望在浏览器也能有相应的提示信息
开启Debug模式
运行时传递参数
app.run(debug = True)
通过 app.deubg
参数设置
app.debug = True
app.run()
通过修改配置参数 config
app.config.update(DEBUG=True)
# app.config['DEBUG'] = True
app.run()
通过mapping加载
app.config.from_mapping({'DEBUG':True})
app.run()
通过配置对象设置 config
class Config:
DEBUG = True
app.config.from_object(config)
app.run()
通过配置文件设置 config
config.py
DEBUG = True
config.json
{"DEBUG":"True"}
app.py
app.config.from_pyfile('config.py')
app.config.from_json('config.json')
通过环境变量
DEBUG = True
app.config.from_envvar('DEBUG')
URL与函数的映射(动态路由)
URL路径参数
比如,有一个请求访问的接口地址为 /users/11001 ,其中 11001 实际上为
具体的请求参数,表明请求 11001 号用户的信息。
此时如何从url中提取出 11001 的数据?
@app.route('/users/<user_id>')
def user_info(user_id):
print(type(user_id))
return 'hello user{}'.format(user_id)
其中 <user_id> ,尖括号是固定写法,语法为 , variable 默认的
数据类型是字符串。
如果需要指定类型,则要写成 converter:variable ,其中
converter 就是类型名称,可以有以下几种:
- string:如果没有指定具体的数据类型,那么默认就是使用 string 数据类型。
- int:数据类型只能传递 int 类型。
- float:数据类型只能传递 float 类型。
- path:数据类型和 string 有点类似,都是可以接收任意的字符串,但是 path 可以接收路径,也就
是说可以包含斜杠。 - uuid:数据类型只能接收符合 uuid 的字符串。 uuid 是一个全宇宙都唯一的字符串,一般可以用来作为表的主键。
- any:数据类型可以在一个 url 中指定多个路径。例如:将上面的例子以整型匹配数据,可以如下使用:
@app.route('/users/<int:user_id>') 2 def user_info(user_id):
print(type(user_id))
return f'正在获取 ID {user_id} 的用户信息' 567 @app.route('/users/<int(min=1):user_id>') 8 def user_info(user_id):
print(type(user_id))
return f'hello user {user_id}'
若是数据与设置的类型不能匹配,则会返回 Not Found
自定义转换器
为什么路径参数可以直接识别数据类型?
提示 从 werkzeug.routing 导入 BaseConverter 类 了解底层 int 路径参数底层调用
IntegerConverter 类来作格式判断 float 路径参数底层调用 FloatConverter 类来作格式判断 string
路径参数底层调用 StringConverter 类来作格式判断
如果遇到需要匹配提取 /sms_codes/1688888888 中的手机号数据,Flask内
置的转换器就无法满足需求,此时需要自定义转换器。
定义方法
自定义转换器主要做3步
- 创建转换器类,保存匹配时的正则表达式
from werkzeug.routing import BaseConverter
class MobileConverter(BaseConverter):
"""
手机号格式
"""
regex = r'1[3-9]\d{9}'
regex 名字是固定的
- 将自定义的转换器告知Flask应用
app = Flask(__name__)
# 将自定义转换器添加到转换器字典中,并指定转换器使
用时名字为: mobile
app.url_map.converters['mobile'] =
MobileConverter
- 在使用转换器的地方定义使用
@app.route('/sms_codes/<mobile:mob_num>')
def send_sms_code(mob_num):
return 'send sms code to
{}'.format(mob_num)
to_python
在转换器类中,实现 to_python(self,value) 方法,这个方法的返回值,将会
传递到 view函数中作为参数
to_url
在转换器类中,实现 to_url(self,values) 方法,这个方法的返回值,将会在
调用url_for函数的时候生成符合要求的URL形式。
#需求2:查询多个模块的数据
#传统的思路实现
@app.route('/news_list/<modules>/')
def news_list(modules):
#modules是路径参数
print(modules)
#http://127.0.0.1:5000/news_list/hots+enter/
#需要对modules进行拆分
lm = modules.split('+')
print(lm)
print(lm[0])
print(lm[1])
#拆分后需要去数据库 select * from news
where nmodule= 'hots' ornmoudle= 'enter'
return f'你要查询的模块是:{lm}'
class LiConverter(BaseConverter):
# 1.在转换器类中,实现to_python(self,value)方法,这个方法的返回值,将会传递到 view函数中作为参数。
def to_python(self, value):
return value.split('+') #可以对value进行加工后再返回
# 2.在转换器类中,实现to_url(self,values)方法,这个方法的返回值,将会在调用url_for函数的时候生成符合要求的URL形式。
def to_url(self, value):
# return "hello"
#['hots','enter']---->hots+enter
return "+".join(value)
app.url_map.converters['li']=LiConverter