目录
0.web工作原理 与 flask关系
B/S和C/S架构
- B/S:浏览器/服务器架构(客户端需要更新才行)
- C/S:客户端/服务器架构(刷新页面即可更新)(可能会成为主流)
WEB工作原理
客户端 > 服务器 > python(flask) > 数据库(mysql)
1.安装 Flask
Flask是 web框架,Flask主要包括 Werkzeug(负责业务处理) 和 Jinja2(安全方面) 两个核心函数库,Flask简洁并易于扩展。
pip install flask
import flask
print(flask.__version__)
2.基本框架
@app.route(rule, options) 装饰器告诉 Flask 触发函数 的 路由(URL)。
rule 表示与该函数的URL绑定、
options 要转发给基础Rule对象的参数列表。
from flask import Flask
app = Flask(__name__) # 创建应用实例
# 视图函数(路由)
@app.route("/")
def hello_world():
return "Hello, World!"
if __name__ == '__main__':
app.run(debug = True) # 启动服务
保存为 app.py
。服务启动默认使用5000端口,在浏览器中打开 http://127.0.0.1:5000/ ,可以看到 Hello World! 字样。
app.run(host, port, debug, options)
3.路由 @app.route('')
@app.route('/hello')
def hello_world():
return 'hello world'
4.变量规则
通过把 URL 的一部分标记为 <variable_name>
就可以在 URL 中添加变量,标记的部分会作为关键字参数传递给函数。
from flask import Flask
app = Flask(__name__)
@app.route('/hello/<username>')
def hello(username):
return f'Hello {username}!'
if __name__ == '__main__':
app.run(debug = True)
浏览器中输入http://127.0.0.1:5000/hello/Flask,则在浏览器中的输出如下
Hello Flask!
通过使用 <converter:variable_name>
,可以选择性的加上一个转换器,为变量指定规则。
转换器 | 说明 |
---|---|
string |
(缺省值) 任何不包含斜杠的文本 |
int |
正整数 |
float |
正浮点数 |
path |
比string 多一个功能,可以包含斜杠 |
完整示例:
from flask import Flask
from markupsafe import escape
app = Flask(__name__)
@app.route('/hello/<username>')
def hello(username):
return f'Hello {username}!'
@app.route('/path/<path:path>')
def show_path(path):
return f'path {escape(path)}'
@app.route('/post/<int:post_id>')
def show_post(post_id):
return f'Post {post_id}'
if __name__ == '__main__':
app.run(debug=True)
浏览器输入http://127.0.0.1:5000/integer/56,输出
Integer: 56
浏览器输入http://127.0.0.1:5000/path/tmp/index.html,输出
path: tmp/index.html
5.URL构建
url_for()
用于构建指定函数的 URL。它把函数名称作为第一个参数。它可以接受任意个关键字参数,每个关键字参数对应 URL 中的变量,未知变量 将添加到 URL 中作为查询参数。
from flask import Flask, request, redirect
from flask import url_for
app = Flask(__name__)
@app.route('/')
def index():
return 'index'
@app.route('/login')
def login():
print(f"in login function, request.values: {request.values}")
return 'login'
@app.route('/user/<username>')
def profile(username):
return f'{username}\'s profile'
with app.test_request_context():
print(url_for('index'))
print(url_for('login'))
print(url_for('profile', username='Xuan Yu'))
url_for('login')会生成对应的URL
/
/login
/user/Xuan%20Yu
6.HTTP方法:GET、POST等
方法 | 说明 |
---|---|
GET | 以未加密形式将数据发送到服务器,常见 |
HEAD | 和GET相同,但无响应体 |
POST | 用于将HTML表单数据发送到服务器,POST方法接收的数据不由服务器缓存 |
PUT | 用上传的内容替换目标资源的所有当前表示 |
DELETE | 删除由URL给出的目标资源的所有当前表示 |
默认情况 Flask路由只回应 GET
请求。使用 route()
装饰器的 methods
参数处理不同的 HTTP 方法。
目录结构 templates/welcome.html。
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>HTTP方法</title>
</head>
<body>
<form action = "http://localhost:5000/login" method = "post">
<p>Enter Name:</p>
<p><input type = "text" name = "username" /></p>
<p><input type = "submit" value = "submit" /></p>
</form>
</body>
</html>
flask代码:
from flask import Flask, redirect, url_for, request, render_template
app = Flask(__name__)
@app.route('/')
def index():
return render_template('welcome.html')
@app.route('/welcome/<name>')
def welcome(name):
return f'welcome {name}'
@app.route('/login', methods=['POST', 'GET'])
def login():
if request.method == 'POST':
user = request.form['username']
return redirect(url_for('welcome', name=user))
else:
user = request.args.get('username') # GET方法获取数据
return redirect(url_for('welcome', name=user))
if __name__ == '__main__':
app.run(debug=True)
如果是POST方法,则以下代码从表单数据获得的“username”参数的值:
user = request.form['username']
如果是GET方法,则通过以下代码从表单数据获得的“username”参数的值:
user = request.args.get('username')
args
是包含表单参数列表的字典对象,与’username’参数对应的值将传递到/welcome
URL中
/login?username=XuanYu
7.渲染模板 render_template()
目录结构 templates/render_template.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>render_template</title>
</head>
<body>
<h2>渲染模板演示</h2>
{
{ my_int }}
<br>
{
{ my_str }}
<br>
{
{ my_list }}
<br>
{
{ my_dict }}
<hr>
<h2>列表数据获取</h2>
{
{ my_list[0] }}
<br>
{
{ my_list.1 }}
<hr>
<h2>字典数据获取</h2>
{
{ my_dict['name'] }}
<br>
{
{ my_dict.age }}
<hr>
<h2>算术运算</h2>
{
{ my_list.0 + 10 }}
<br>
{
{ my_list[0] + my_list.1 }}
</body>
</html>
flask代码如下:
from flask import Flask, render_template
app = Flask(__name__)
@app.route('/')
def index():
int_ = 1024
str_ = 'Hello World!'
list_ = [1, 2, 3, 4, 5]
dict_ = {'name': 'Kint', 'age': 23}
# render_template方法:渲染模板
# 参数1: 模板名称 参数n: 传到模板里的数据
return render_template('render_template.html', my_int=int_, my_str=str_, my_list=list_, my_dict=dict_)
if __name__ == '__main__':
app.run(debug=True)
Flask 是使用 Jinja2 模板引擎来渲染模板,官方 Jinja2 模板文档。
8.Request对象
目录文件 templates/Request.html:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Request</title>
</head>
<body>
<form action="/login?a=1&b=2" method="post">
<p>账号: <input type="text" name="username"></p>
<p>密码: <input type="password" name="password"></p>
<input type="submit">
</form>
</body>
</html>
flask代码:
from flask import Flask, request, render_template
import json
app = Flask(__name__)
@app.route('/')
def index():
return render_template("Request.html")
@app.route('/login', methods=["GET", "POST"])
def login():
print('request.method:\n', request.method)
print('request.data:\n', request.data)
print('request.request.args:\n', request.args)
print("request.request.args.get('b'):\n", request.args.get('c'))
print('request.form:\n', request.form)
print("request.request.form.get('password'):\n", request.form.get('password'))
print('request.values:\n', request.values)
print('request.json:\n', request.json)
print('request.cookies:\n', request.cookies)
print('request.headers:\n', request.headers)
return json.dumps(request.form) # 将MultiDict数据处理为JSON数据
if __name__ == '__main__':
app.run(debug=True)
在获取MultiDict的值时,推荐使用request.form.get(key)而不直接使用request.form[key],前一种方式可以避免关键词缺失而导致的KeyError。
获取各种路径,URL为http://127.0.0.1:5000/login?a=1&b=2
print('url: ', request.url)
print('base_url: ', request.base_url)print('host_url: ', request.host_url)
print('path: ', request.path)
print('full_path: ', request.full_path)
print('host: ', request.host)
输出:
url: http://127.0.0.1:5000/login?a=1&b=2
base_url: http://127.0.0.1:5000/loginhost_url: http://127.0.0.1:5000/
path: /login
full_path: /login?a=1&b=2
host: 127.0.0.1:5000
9.Cookie
Flask中Cookie的处理步骤为:
- 使用Response对象的set_cookie()方法设置cookie
- 通过request.cookies的方式获取cookies,返回的是一个字典
- 使用Response对象的delete_cookie()方法设置cookie
templates文件夹下get_cookie.html:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>获取cookie</title>
</head>
<body>
<h2>在服务端获取cookie: <b>{
{cookie}}</b></h2>
</body>
</html>
templates文件夹下show_cookie_by_JQuery.html:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>设置cookie</title>
<script src="../static/jquery-3.6.0.js" type="text/javascript" charset="utf-8"></script>
</head>
<body>
<h2>在服务端设置cookie</h2>
<h2>在客户端通过JQuery读取cookie: <b id='cookie'></b></h2>
</body>
<script>
$('#cookie').text(document.cookie);
</script>
</html>
flask代下:
from flask import Flask, request, Response, render_template, make_response, redirect, url_for
app = Flask(__name__)
@app.route('/')
def index():
# 重定向响应的URL
return redirect(url_for('set_cookie'))
# 设置cookie
@app.route('/set_cookie')
def set_cookie():
html = render_template('show_cookie_by_JQuery.html')
response = make_response(html) # 设置响应体
# response = Response(html)
response.set_cookie('user', 'Kint')
return response
# 获取cookie
@app.route('/get_cookie')
def get_cookie():
# 获取关键字为user对应cookie的值
cookie = request.cookies.get('user')
print(cookie)
return render_template('get_cookie.html', cookie=cookie)
# 删除cookie
@app.route('/del_cookie')
def del_cookie():
html = render_template('show_cookie_by_JQuery.html')
response = Response(html)
response.delete_cookie('user')
return response
if __name__ == '__main__':
app.run(debug=True)
在set_cookie()函数中,首先渲染模板文件show_cookie_by_JQuery.html,通过make_response()方法设置响应体并返回Response对象,然后设置cookie。两种写法作用相同:
response = make_response(html) # 设置响应体
response = Response(html)
10.会话Session
与Cookie不同,Session数据存储在服务器上,用来存储用户的信息 (例如登录状态、用户名称)。Session 有一个唯一标识 ID,对应一个用户,在服务端使用 ID 可以查找到对应用户的数据,故Flask应用程序需要一个定义的密钥 SECRET_KEY。
简单实现判断用户是否登录功能:
from flask import Flask, redirect, url_for, request, session
app = Flask(__name__)
app.secret_key = 'abc'
@app.route('/')
def index():
if 'user' in session:
# 获取会话中的用户信息
user = session.get('user')
return '登录用户是:' + user + '<br>' + "<b><a href = '/logout'>点击这里注销</a></b>"
return "<h3>暂未登录</h3><br>" + "<a href = '/login'></b>点击这里登录</b></a>"
@app.route('/login', methods=['GET', 'POST'])
def login():
if request.method == 'POST':
# 设置会话中的用户信息
session['user'] = request.form['user']
return redirect(url_for('index'))
return '''
<form action="" method="post">
<p><input type="text" name="user"/></p>
<p><input type="submit" value="登录"/></p>
</form>
'''
@app.route('/logout')
def logout():
# 删除会话中的用户信息
session.pop('user')
return redirect(url_for('index'))
if __name__ == '__main__':
app.run(debug=True)
case1.上传表单
/app.py
/templates
/login.html
/result.html
app.py:
from flask import Flask, render_template, request
app = Flask(__name__)
@app.route('/')
def student():
return render_template('login.html')
@app.route('/result',methods = ['POST', 'GET'])
def result():
if request.method == 'POST':
result = request.form #拿到前端传输的表单数据
return render_template("result.html",result = result)
if __name__ == '__main__':
app.run(debug = True)
templates / login.html:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>case1.上传表单数据—登录页面</title>
</head>
<body>
<form action="http://localhost:5000/result" method="POST">
<p>Name <input type = "text" name = "Name" /></p>
<p>Email <input type = "text" name = "Email" /></p>
<p><input type = "submit" value = "submit" /></p>
</form>
</body>
</html>
template / result.html:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>case1.上传表单数据</title>
</head>
<body>
<table border = 1>
{% for key, value in result.items() %}
<tr>
<th> {
{ key }} </th>
<td> {
{ value }}</td>
</tr>
{% endfor %}
</table>
</body>
</html>
case2.下载上传
/app.py
/templates
/index.html
/upload.html
/upload
/download_sample.txt
app.py:
from flask import Flask, render_template, request, send_from_directory
from werkzeug.utils import secure_filename
import os
app = Flask(__name__)
app.config['UPLOAD_FOLDER'] = 'upload/'
# 上传文件大小限制为16M,如果超过会抛出异常
app.config['MAX_CONTENT_LENGTH'] = 16 * 1000 * 1000
@app.route('/')
def upload_file():
return render_template('index.html')
@app.route('/upload', methods=['GET', 'POST'])
def upload():
if request.method == 'POST':
f = request.files['file']
print(request.files)
# secure_filename检查客户端上传的文件名,确保安全,注意文件名称不要全中文!!!
f.save(os.path.join(app.config['UPLOAD_FOLDER'], secure_filename(f.filename)))
return render_template('upload.html')
else:
return render_template('index.html')
@app.route('/download/<filename>', methods=['GET', 'POST'])
def download(filename):
# as_attachment=True 表示文件作为附件下载
return send_from_directory('./upload', filename, as_attachment=True)
if __name__ == '__main__':
app.run(debug=True)
在upload函数中,f.save的作用是将文件保存到指定路径中。在使用secure_filename检验上传文件名称时,注意名称尽量为英文!
在download函数中,send_from_directory方法将upload目录下的指定文件发送到客户端,as_attachment=True表示文件作为附件下载。
在templates文件夹下创建index.html文件,代码如下:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>实例2.上传下载文件</title>
</head>
<body>
<h3>上传文件</h3>
<form action="http://localhost:5000/upload" method="POST" enctype="multipart/form-data">
<input type="file" name="file" />
<input type="submit" value="提交" />
</form>
<h3>下载文件</h3>
<a href="/download/download_sample.txt">download_sample.txt</a>
</body>
</html>
templates / upload.html:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>case2.上传成功页面</title>
</head>
<body>
<h3>文件上传成功!</h3>
</body>
</html>