提供了编程的基础技术教程

zl程序教程

您现在的位置是：首页 >  其他

当前栏目

Flask快速入门

入门 快速 Flask
2023-09-11 14:19:20 时间

Flask是一个Python实现的Web开发框架, Flask的设计思想为核心尽可能的微小和专能,扩展功能则由独立模块灵活实现.

Flask应用基于jinja2模板引擎和werkzeug WSGI工具集, 若有需要可以阅读它们的文档.

可以使用pip安装flask;

pip install flask

Hello World

首先来让服务器打个招呼:

from flask import Flask

app = Flask('hello')

@app.route('/hello/')
def hello():
    return 'Hello World!'

app.run(port=8080, debug=True)

运行这段脚本, 访问localhost:8080/hello/则可以看到来自服务器的Hello World信息.

@app.route('/hello/')修饰器用于绑定url和处理函数, 可以将多个url绑定到一个函数上:

@app.route('/hello/')
@app.route('/')
def hello():
    return 'Hello World!'

Flask建议使用像/hello/这样两边含有斜线的url, 这样当访问/hello时会自动重定向到/hello/.

而@app.route('/hello')不会对/hello/请求进行响应.

app.run(port=8080, debug=True)用于启动app, port指定监听的端口.

app的参数还可以直接设置:

app.port = 8080
app.run()

debug模式下, 当脚本改变时服务器会自动重启.在需要fork的环境下debug模式无法使用, 即不能用于生产环境下.

编写响应函数

响应函数的返回值将生成response返回给客户端, 上文已经展示用str作为响应.

使用模板

Flask使用jinja2模板引擎, 可以使用模板作为响应:

from flask import render_template

@app.route('/template/')
def show_template():
    return render_template('template.html', name='finley')

默认模板文件存放在工作目录的templates子目录下.

使用符合jinja2规则的模板:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Template</title>
</head>
<body>
    {{ name }}
</body>
</html>

视图函数的返回值会被自动转换为一个响应对象,Flask 把返回值转换为响应对象的规则为:

  1. 合法的响应对象会被直接返回.

  2. 若返回的是一个字符串，响应对象会用字符串数据和默认参数创建。

  3. 若返回的是一个元组，则必须是 (response, status, headers) 的形式，且至少包含一个元素. status 值会覆盖状态代码， headers 可以是一个列表或字典，作为额外的消息标头值.

  4. 若上述条件均不满足， Flask 会假设返回值是一个合法的 WSGI 应用程序，并转换为一个请求对象.

使用静态文件

静态文件存放在static子目录下, 使用'/static'+文件名进行访问, 或者使用url_for来获得静态文件url:

url_for('static', filename='jquery.js')

进行重定向

使用redirect可以将请求重定向到指定url:

from flask import redirect, url_for

@app.route('/index/')
def index():
    return redirect(url_for('static', filename='index.html'))

redirect(url, code=302)默认使用302(临时重定向)作为状态码, 也支持其它3开头的状态码: 303, 305, 307.

获得请求参数

获得url匹配

@app.route()可以将url中匹配的字符串当做位置参数传入响应函数:

@app.route('/user/<username>/')
def user_info(username):
    return 'hello, %s' % username

若访问/user/finley/, 响应函数user_info会得到值为'finley'的位置参数.

获得query参数

其它包含在HTTP请求中的参数我们需要导入request对象:

from flask import request

在全局request对象中获得query参数:

@app.route('/query/')
def query():
    return request.args.get('query')

获得表单与头部参数

在request.form中获得表单提交的参数:

@app.route('/do-login/', methods=['POST'])
def do_login():
    if request.method == 'POST':
        username = request.form['username']
        password = request.form['password']
        return '%s , login success' % username
    else:
        return 'Please use POST method'

@app.route的methodes参数指定了允许的HTTP方法, 默认仅允许'GET'.

我们可以在request.headers中获得包含在头部的参数:

request.headers['ACCEPT_LANGUAGE']

当然也可以添加或修改headers.

注意上述语句获得的头部参数实际是'HTTP_ACCEPT_LANGUAGE'.

文件上传

app.config是一个可以自定义配置的字典, 我们在里面写入上传文件的保存目录:

app.config['UPLOAD_FOLDER'] = os.path.join(os.path.dirname(__file__), "upload")

编写上传文件的表单记得设置enctype="multipart/form-data":

    <form action="/do-upload/" method="post" enctype="multipart/form-data">
        <input type="file" name="filename">
        <input type="submit" value="submit">
    </form>

从request.files中获得文件信息, 并使用save方法保存:

from werkzeug.utils import secure_filename

@app.route('/do-upload/', methods=['POST'])
def do_upload():
    if request.method == 'POST':
        f = request.files['filename']
        f.save(os.path.join(app.config['UPLOAD_FOLDER'], secure_filename(f.filename)))
        return 'upload success'
    else:
        return 'Please use POST method'

secure_filename方法可以处理文件名中的非法字符和转义字符返回合法文件名.

session与cookie

使用request可以很方便地获得cookie:

token = request.cookies.get('token')

上文中的响应函数返回值均被Flask转换为response对象, 然而cookie需要设置在response对象上所以我们需要自行建立响应对象:

from flask import make_response

@app.route('/auth/<redirect_uri>')
def auth(redirect_uri):
	response = make_response(redirect(redirect_uri))
    uid = request.cookies.get('uid')
    token = authen(uid)
   	response.set_cookie('token', token)
    return response

session

与cookie将数据保存在客户端不同, session将数据保存在服务端并使用加密的cookie识别客户端身份.

若要使用session首先要为app设置secret_key用来签名:

app.secret_key = 'thisGGisRRa12secret'

session的是一个保存了相关参数的字典, 可以方便的进行操作:

session['last_login'] = time()
last_login = session['last_login']
session.pop('last_login')

参考资料:

相关文章