python flask web开发入门与项目实战 pdf,Flask Web开发:基于Python的Web应用开发实战
本文详细解释了Python如何使用Web框架Flask开发项目,并通过示例代码详细介绍。对大家的学习或者工作都有一定的参考价值,有需要的朋友可以参考一下。
一.导言二安装三。从Hello World 3.1 Hello World3.2修改Flask的配置3.3调试模式3.4绑定IP和端口3.5本节源代码四、获取url参数4.1建立Flask项目4.2列出所有URL参数4.3获取一个指定参数4.4如何处理多值4.5本节源代码5。获取POST方法传输的数据5.1建立Flask项目5.2查看POST数据内容5.3分析POST数据5.4本节源代码6、以及对JSON数据的处理和响应6.1建立Flask项目6.2处理JSON格式的请求数据6.3响应JSON- Scheme 16.4响应JSON- Scheme 26.5本节源代码7。上传文件7.1建立Flask项目7.2上传文件7.3本节源代码8、Restful URL8.1建立Flask项目8.2编写代码8.3转换类型8.4一个有趣的用法8.5编写转换器8.6本节源代码9。使用url_for生成链接9.1建立Flask项目9.2编写代码9.3本节源代码10、使用redirect重定向URL 10.1构建Flask项目10.2编写代码10.3。本节XI源代码。使用Jinja2模板引擎构建Flask项目11.1 11.2创建并编辑hello world/templates/default . html 11.4编辑helloworld/Server.py11.5运行并测试11.6本节源代码12、对自定义404等错误的响应12.1示例1:简单介绍12.2示例2:自定义错误页面12.3本节源代码13.1用户会话13.1构建Flask项目13.2编辑HelloWorld/The含义使用Cookie14.1建立Flask项目14.2代码14.3运行和测试14.4本节源代码XV、Flash flashing系统15.1建立Flask项目15.2编写HelloWorld/server.py15.3效果15.4高级用法15.5获取模板文件中Flash的内容15.6本节源代码
目录
Flask是一个轻量级的基于Python的web框架。
本文适合有一定HTML、Python、网络基础的同学阅读。
这份文档中的代码使用 Python 3 运行。
建议在 linux 下实践本教程中命令行操作、执行代码。
二、安装
通过pip3安装Flask即可:
$ sudo pip3 install Flask
进入python交互模式看下Flask的介绍和版本:
$ python3
三、从 Hello World 开始
本节主要内容:使用Flask写一个显示Hello World!的web程序,如何配置、调试Flask。
3.1 Hello World
按照以下命令建立Flask项目HelloWorld:
mkdir HelloWorld
static
和templates
目录是默认配置,其中static
用来存放静态资源,例如图片、js、css文件等。templates
存放模板文件。
我们的网站逻辑基本在server.py文件中,当然,也可以给这个文件起其他的名字。
在server.py中加入以下内容:
from flask import Flask
运行server.py:
$ python3 server.py
打开浏览器访问http://127.0.0.1:5000/,浏览页面上将出现Hello World!
。
终端里会显示下面的信息:
127.0.0.1 - - [16/May/2014 10:29:08] "GET / HTTP/1.1" 200 -
变量app是一个Flask实例,通过下面的方式:
@app.route(/)
当客户端访问/时,将响应hello_world()函数返回的内容。注意,这不是返回Hello World!这么简单,Hello World!只是HTTP响应报文的实体部分,状态码等信息既可以由Flask自动处理,也可以通过编程来制定。
3.2 修改Flask的配置
app = Flask(__name__)
上面的代码中,python内置变量__name__
的值是字符串__main__
。Flask类将这个参数作为程序名称。当然这个是可以自定义的,比如app = Flask("my-app")
。
Flask默认使用static
目录存放静态资源,templates
目录存放模板,这是可以通过设置参数更改的:
app = Flask("my-app", static_folder="path1", template_folder="path2")
更多参数请参考__doc__
:
from flask import Flask
3.3 调试模式
上面的server.py中以app.run()
方式运行,这种方式下,如果服务器端出现错误是不会在客户端显示的。但是在开发环境中,显示错误信息是很有必要的,要显示错误信息,应该以下面的方式运行Flask:
app.run(debug=True)
将debug
设置为True
的另一个好处是,程序启动后,会自动检测源码是否发生变化,若有变化则自动重启程序。这可以帮我们省下很多时间。
3.4 绑定IP和端口
默认情况下,Flask绑定IP为127.0.0.1
,端口为5000
。我们也可以通过下面的方式自定义:
app.run(host=0.0.0.0, port=80, debug=True)
0.0.0.0
代表电脑所有的IP。80
是HTTP网站服务的默认端口。什么是默认?比如,我们访问网站http://www.example.com
,其实是访问的http://www.example.com:80
,只不过:80
可以省略不写。
由于绑定了80端口,需要使用root权限运行server.py。也就是:
$ sudo python3 server.py
3.5 本节源码
https://github.com/letiantian/Learn-Flask/tree/master/flask-demo-001
四、获取 URL 参数
URL参数是出现在url中的键值对,例如http://127.0.0.1:5000/?disp=3中的url参数是{'disp':3}
。
4.1 建立Flask项目
按照以下命令建立Flask项目HelloWorld:
mkdir HelloWorld
4.2 列出所有的url参数
在server.py中添加以下内容:
from flask import Flask, request
在浏览器中访问http://127.0.0.1:5000/?user=Flask&time&p=7&p=8,将显示:
ImmutableMultiDict([(user, Flask), (time, ), (p, 7), (p, 8)])
较新的浏览器也支持直接在url中输入中文(最新的火狐浏览器内部会帮忙将中文转换成符合URL规范的数据),在浏览器中访问http://127.0.0.1:5000/?info=这是爱,,将显示:
ImmutableMultiDict([(info, 这是爱,)])
浏览器传给我们的Flask服务的数据长什么样子呢?可以通过request.full_path
和request.path
来看一下:
from flask import Flask, request
浏览器访问http://127.0.0.1:5000/?info=这是爱,,运行server.py的终端会输出:
1./
2./?info=%E8%BF%99%E6%98%AF%E7%88%B1%EF%BC%8C
4.3 获取某个指定的参数
例如,要获取键info
对应的值,如下修改server.py:
from flask import Flask, request
运行server.py,在浏览器中访问http://127.0.0.1:5000/?info=hello,浏览器将显示:
hello
不过,当我们访问http://127.0.0.1:5000/时候却出现了500错误
为什么为这样?
这是因为没有在URL参数中找到info
。所以request.args.get('info')
返回Python内置的None,而Flask不允许返回None。
解决方法很简单,我们先判断下它是不是None:
from flask import Flask, request
另外一个方法是,设置默认值,也就是取不到数据时用这个值:
from flask import Flask, request
函数request.args.get
的第二个参数用来设置默认值。此时在浏览器访问http://127.0.0.1:5000/,将显示:
hi
4.4 如何处理多值
还记得上面有一次请求是这样的吗?http://127.0.0.1:5000/?user=Flask&time&p=7&p=8,仔细看下,p
有两个值。
如果我们的代码是:
from flask import Flask, request
在浏览器中请求时,我们只会看到7
。如果我们需要把p
的所有值都获取到,该怎么办?
不用get
,用getlist
:
from flask import Flask, request
浏览器输入http://127.0.0.1:5000/?user=Flask&time&p=7&p=8,我们会看到['7', '8']
。
4.5 本节源码
https://github.com/letiantian/Learn-Flask/tree/master/flask-demo-002
五、获取POST方法传送的数据
作为一种HTTP请求方法,POST用于向指定的资源提交要被处理的数据。我们在某网站注册用户、写文章等时候,需要将数据传递到网站服务器中。并不适合将数据放到URL参数中,密码放到URL参数中容易被看到,文章数据又太多,浏览器不一定支持太长长度的URL。这时,一般使用POST方法。
本文使用python的requests库模拟浏览器。
安装方法:
$ sudo pip3 install requests
5.1 建立Flask项目
按照以下命令建立Flask项目HelloWorld:
mkdir HelloWorld
5.2 查看POST数据内容
以用户注册为例子,我们需要向服务器/register
传送用户名name
和密码password
。如下编写HelloWorld/server.py。
from flask import Flask, request
`@app.route(‘/register’, methods=[‘POST’])是指url
/register只接受POST方法。可以根据需要修改
methods`参数,例如如果想要让它同时支持GET和POST,这样写:
@app.route(/register, methods=[GET, POST])
浏览器模拟工具client.py内容如下:
import requests
运行HelloWorld/server.py,然后运行client.py。client.py将输出:
welcome
而HelloWorld/server.py在终端中输出以下调试信息(通过print
输出):
Host: 127.0.0.1:5000
前6行是client.py生成的HTTP请求头,由print(request.headers)
输出。
请求体的数据,我们通过print(request.stream.read())
输出,结果是:
bname=letian&password=123
5.3 解析POST数据
上面,我们看到post的数据内容是:
bname=letian&password=123
我们要想办法把我们要的name、password提取出来,怎么做呢?自己写?不用,Flask已经内置了解析器request.form
。
我们将服务代码改成:
from flask import Flask, request
执行client.py请求数据,服务器代码会在终端输出:
Host: 127.0.0.1:5000
request.form
会自动解析数据。
request.form['name']
和request.form.get('name')
都可以获取name
对应的值。对于request.form.get()
可以为参数default
指定值以作为默认值。所以:
print(request.form.get(nickname, default=little apple))
输出的是默认值
little apple
如果name
有多个值,可以使用request.form.getlist('name')
,该方法将返回一个列表。我们将client.py改一下:
import requests
此时运行client.py,print(request.form.getlist('name'))
将输出:
[uletian, uletian2]
5.4 本节源码
https://github.com/letiantian/Learn-Flask/tree/master/flask-demo-003
六、处理和响应JSON数据
使用 HTTP POST 方法传到网站服务器的数据格式可以有很多种,比如「5. 获取POST方法传送的数据」讲到的name=letian&password=123这种用过&
符号分割的key-value键值对格式。我们也可以用JSON格式、XML格式。相比XML的重量、规范繁琐,JSON显得非常小巧和易用。
6.1 建立Flask项目
按照以下命令建立Flask项目HelloWorld:
mkdir HelloWorld
6.2 处理JSON格式的请求数据
如果POST的数据是JSON格式,request.json会自动将json数据转换成Python类型(字典或者列表)。
编写server.py:
from flask import Flask, request
编写client.py模拟浏览器请求:
import requests
运行server.py,然后运行client.py,client.py会在终端输出:
3
server.py会在终端输出:
Host: 127.0.0.1:5000
注意,请求头中Content-Type
的值是application/json
。
6.3 响应JSON-方案1
响应JSON时,除了要把响应体改成JSON格式,响应头的Content-Type
也要设置为application/json
。
编写server2.py:
from flask import Flask, request, Response
修改后运行。
编写client2.py:
import requests
运行client.py,将显示:
{Content-Type: application/json, Content-Length: 10, Server: Werkzeug/0.14.1 Python/3.6.4, Date: Sat, 07 Jul 2018 05:23:00 GMT}
上面第一段内容是服务器的响应头,第二段内容是响应体,也就是服务器返回的JSON格式数据。
另外,如果需要服务器的HTTP响应头具有更好的可定制性,比如自定义Server
,可以如下修改add()
函数:
@app.route(/add, methods=[POST])
client2.py运行后会输出:
{Content-Type: application/json, Content-Length: 10, Server: python flask, Date: Sat, 07 Jul 2018 05:26:40 GMT}
6.4 响应JSON-方案2
使用 jsonify 工具函数即可。
from flask import Flask, request, jsonify
6.5 本节源码
https://github.com/letiantian/Learn-Flask/tree/master/flask-demo-004
七、上传文件
上传文件,一般也是用POST方法。
7.1 建立Flask项目
按照以下命令建立Flask项目HelloWorld:
mkdir HelloWorld
7.2 上传文件
这一部分的代码参考自How to upload a file to the server in Flask。
我们以上传图片为例:
假设将上传的图片只允许’png’、’jpg’、’jpeg’、’gif’这四种格式,通过url/upload
使用POST上传,上传的图片存放在服务器端的static/uploads
目录下。
首先在项目HelloWorld
中创建目录static/uploads
:
mkdir HelloWorld/static/uploads
werkzeug
库可以判断文件名是否安全,例如防止文件名是../../../a.png
,安装这个库:
$ sudo pip3 install werkzeug
server.py代码:
from flask import Flask, request
app.config
中的config是字典的子类,可以用来设置自有的配置信息,也可以设置自己的配置信息。函数allowed_file(filename)
用来判断filename
是否有后缀以及后缀是否在app.config['ALLOWED_EXTENSIONS']
中。
客户端上传的图片必须以image01
标识。upload_file
是上传文件对应的对象。app.root_path
获取server.py所在目录在文件系统中的绝对路径。upload_file.save(path)
用来将upload_file
保存在服务器的文件系统中,参数最好是绝对路径,否则会报错(网上很多代码都是使用相对路径,但是笔者在使用相对路径时总是报错,说找不到路径)。函数os.path.join()
用来将使用合适的路径分隔符将路径组合起来。
好了,定制客户端client.py:
import requests
运行client.py,当前目录下的Lenna.jpg将上传到服务器。
然后,我们可以在static/uploads中看到文件Lenna.jpg。
要控制上产文件的大小,可以设置请求实体的大小,例如:
app.config[MAX_CONTENT_LENGTH] = 16 * 1024 * 1024 #16MB
不过,在处理上传文件时候,需要使用try:...except:...
。
如果要获取上传文件的内容可以:
file_content = request.files[image].stream.read()
7.3 本节源码
https://github.com/letiantian/Learn-Flask/tree/master/flask-demo-005
八、Restful URL
简单来说,Restful URL可以看做是对 URL 参数的替代。
8.1 建立Flask项目
按照以下命令建立Flask项目HelloWorld:
mkdir HelloWorld
8.2 编写代码
编辑server.py:
from flask import Flask
运行HelloWorld/server.py。使用浏览器访问http://127.0.0.1:5000/user/letian,HelloWorld/server.py将输出:
letian
而访问http://127.0.0.1:5000/user/letian/,响应为404 Not Found。
浏览器访问http://127.0.0.1:5000/user/letian/friends,可以看到:
Hello letian. They are your friends.
HelloWorld/server.py输出:
letian
8.3 转换类型
由上面的示例可以看出,使用 Restful URL 得到的变量默认为str对象。如果我们需要通过分页显示查询结果,那么需要在url中有数字来指定页数。按照上面方法,可以在获取str类型页数变量后,将其转换为int类型。不过,还有更方便的方法,就是用flask内置的转换机制,即在route中指定该如何转换。
新的服务器代码:
from flask import Flask
`@app.route(‘/page/int:num‘)`会将num变量自动转换成int类型。
运行上面的程序,在浏览器中访问http://127.0.0.1:5000/page/1,HelloWorld/server.py将输出如下内容:
1
如果访问的是http://127.0.0.1:5000/page/asd,我们会得到404响应。
在官方资料中,说是有3个默认的转换器:
int accepts integers
看起来够用了。
8.4 一个有趣的用法
如下编写服务器代码:
from flask import Flask
在浏览器中访问http://127.0.0.1:5000/page/11-22,HelloWorld/server.py会输出:
11
8.5 编写转换器
自定义的转换器是一个继承werkzeug.routing.BaseConverter
的类,修改to_python
和to_url
方法即可。to_python
方法用于将url中的变量转换后供被`@app.route包装的函数使用,to_url方法用于flask.url_for`中的参数转换。
下面是一个示例,将HelloWorld/server.py修改如下:
from flask import Flask, url_for
浏览器访问http://127.0.0.1:5000/page/123后,HelloWorld/server.py的输出信息是:
123
8.6 本节源码
https://github.com/letiantian/Learn-Flask/tree/master/flask-demo-006
九、使用url_for生成链接
工具函数url_for
可以让你以软编码的形式生成url,提供开发效率。
9.1 建立Flask项目
按照以下命令建立Flask项目HelloWorld:
mkdir HelloWorld
9.2 编写代码
编辑HelloWorld/server.py:
from flask import Flask, url_for
运行HelloWorld/server.py。然后在浏览器中访问http://127.0.0.1:5000/test,HelloWorld/server.py将输出以下信息:
/
9.3 本节源码
https://github.com/letiantian/Learn-Flask/tree/master/flask-demo-007
十、使用redirect重定向网址
redirect
函数用于重定向,实现机制很简单,就是向客户端(浏览器)发送一个重定向的HTTP报文,浏览器会去访问报文中指定的url。
10.1 建立Flask项目
按照以下命令建立Flask项目HelloWorld:
mkdir HelloWorld
10.2 编写代码
使用redirect
时,给它一个字符串类型的参数就行了。
编辑HelloWorld/server.py:
from flask import Flask, url_for, redirect
运行HelloWorld/server.py,在浏览器中访问http://127.0.0.1:5000/test1,浏览器的url会变成http://127.0.0.1:5000/test2,并显示:
this is test2
10.3 本节源码
https://github.com/letiantian/Learn-Flask/tree/master/flask-demo-008
十一、使用Jinja2模板引擎
模板引擎负责MVC中的V(view,视图)这一部分。Flask默认使用Jinja2模板引擎。
Flask与模板相关的函数有:
flask.render_template(template_name_or_list, **context)
Renders a template from the template folder with the given context.
郑重声明:本文由网友发布,不代表盛行IT的观点,版权归原作者所有,仅为传播更多信息之目的,如有侵权请联系,我们将第一时间修改或删除,多谢。