Document

Flask开发网页步骤详解

2023-07-01
dfer
493
flask python 后端

文章目录

Flask路由和视图函数
Flask变量规则
如何动态构建特定函数的URL
Flask get 和 post 方法
通过Html表单发送Post请求
Flask 模板
Jinja2 基本使用
- 1.变量名
- 2.控制语句
Flask用户表单输入数据后端通过form获取数据
Flask 的 args 获取数据
Flask 的Cookies 获取数据及代码实现
Flask 文件上传及实战
Flask 上传文件名含有中文处理方法
Flask 文件下载及含有中文名文件下载注意事项

Flask路由和视图函数

在Flask中，路由（Route）和视图函数（View Function）是实现Web应用程序的核心概念。

路由是指根据URL路径来确定如何处理用户请求的机制。通过路由，你可以将不同的URL路径映射到不同的视图函数上，从而实现对不同页面或功能的处理。

视图函数是处理用户请求的函数，它接收并处理用户发送的请求，并返回相应的响应结果。视图函数可以包含任意的业务逻辑，比如从数据库中获取数据、处理用户输入、渲染模板等。

在Flask中，通过装饰器来定义路由和关联的视图函数。常用的装饰器有@app.route()，用于指定路由规则和HTTP请求方法。

下面是一个示例，展示如何定义路由和关联的视图函数：

from flask import Flask

app = Flask(__name__)

@app.route('/')  # 定义根路径的路由
def index():
    return 'Hello, World!'

@app.route('/about')  # 定义/about路径的路由
def about():
    return 'About page'

if __name__ == '__main__':
    app.run()

在上面的例子中，我们首先创建了一个Flask应用对象，并定义了两个路由，分别映射到根路径'/'和'/about'。@app.route()装饰器用于指定路由规则，其中参数是URL路径。接下来，我们定义了两个视图函数index()和about()，分别与对应的路由关联。这些视图函数接收请求并返回响应结果。

当访问根路径'/'时，Flask会调用index()视图函数，并返回Hello, World!。当访问'/about'路径时，Flask会调用about()视图函数，并返回About page。

通过定义不同的路由和视图函数，你可以构建出复杂的Web应用程序，处理不同的URL请求，并返回相应的结果。

Flask变量规则

在Flask中，可以使用变量规则（Variable Rules）来定义动态的URL路径。变量规则允许将特定部分的URL路径作为参数传递给视图函数，从而实现根据不同参数处理请求的功能。

在路由定义中，可以使用<variable>的形式来指定变量规则，并将其作为参数传递给对应的视图函数。

下面是一个示例，展示如何使用变量规则：

from flask import Flask

app = Flask(__name__)

@app.route('/user/<username>')  # 定义带有变量规则的路由
def show_user(username):
    return f'User: {username}'

@app.route('/post/<int:post_id>')  # 定义带有类型转换的变量规则
def show_post(post_id):
    return f'Post ID: {post_id}'

if __name__ == '__main__':
    app.run()

在上面的例子中，我们定义了两个带有变量规则的路由。第一个路由'/user/<username>'中的<username>表示一个变量规则，它会匹配URL路径中的任意字符串，并将该字符串作为参数传递给show_user()视图函数。视图函数根据传入的username参数返回相应的结果。

第二个路由'/post/<int:post_id>'中的<int:post_id>表示一个带有类型转换的变量规则，它会匹配URL路径中的整数，并将该整数作为参数传递给show_post()视图函数。这里使用了类型转换器int，确保传递给视图函数的参数是整数类型。

当访问/user/john时，Flask会调用show_user()视图函数，并将username参数设置为'john'，返回结果为User: john。当访问/post/123时，Flask会调用show_post()视图函数，并将post_id参数设置为123，返回结果为Post ID: 123。

如何动态构建特定函数的URL

在访问某个URL时，如果访问用户是管理员，那么自动跳转到管理员界面；如果是访客，那么自动跳转到访客界面

在Flask中，可以使用url_for()函数来动态构建特定函数的URL。url_for()函数接受函数名作为参数，并返回与该函数关联的URL路径。

下面是一个示例，展示如何使用url_for()函数动态构建特定函数的URL：

from flask import Flask, url_for

app = Flask(__name__)

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

@app.route('/user/<username>')
def show_user(username):
    return f'User: {username}'

@app.route('/post/<int:post_id>')
def show_post(post_id):
    return f'Post ID: {post_id}'

if __name__ == '__main__':
    with app.test_request_context():
        print(url_for('index'))  # 输出: /
        print(url_for('show_user', username='john'))  # 输出: /user/john
        print(url_for('show_post', post_id=123))  # 输出: /post/123

在上面的例子中，我们定义了三个路由函数index()、show_user()和show_post()。在主函数中，我们使用url_for()函数来动态构建特定函数的URL。通过传递函数名作为参数，并根据需要提供关键字参数，url_for()函数会根据定义的路由规则生成对应的URL路径。

url_for('index')会返回根路径的URL路径'/'，url_for('show_user', username='john')会返回'/user/john'，url_for('show_post', post_id=123)会返回'/post/123'。

注意，在使用url_for()函数之前，需要先创建一个测试请求上下文（test request context），以便Flask能够正确地生成URL路径。

通过使用url_for()函数，你可以避免在代码中硬编码URL路径，而是动态生成与特定函数关联的URL。这样可以使代码更加灵活和可维护，尤其在处理带有变量规则的URL路径时尤为方便。

Flask get 和 post 方法

在Flask中，GET和POST是HTTP协议中常用的两种请求方法，用于在客户端（浏览器）和服务器之间进行数据交互。

GET方法用于从服务器获取数据，它将请求的数据附加在URL的查询字符串中，并通过URL发送给服务器。GET请求通常用于获取或检索数据，不应该对服务器状态进行修改。

在Flask中，可以使用@app.route()装饰器指定路由和关联的视图函数，并通过方法参数指定允许的请求方法。默认情况下，路由处理GET请求。

下面是一个示例，展示如何在Flask中使用GET方法：

from flask import Flask, request

app = Flask(__name__)

@app.route('/hello', methods=['GET'])
def hello():
    name = request.args.get('name')
    return f'Hello, {name}!'

if __name__ == '__main__':
    app.run()

在上面的例子中，我们定义了一个路由/hello，并通过methods参数指定该路由只处理GET请求。在hello()视图函数中，我们使用request.args.get('name')获取名为name的查询参数的值，并返回相应的响应结果。

POST方法用于向服务器提交数据，它将请求的数据包含在请求体中，并通过HTTP请求发送给服务器。POST请求通常用于创建、更新或提交数据，可以对服务器状态进行修改。

在Flask中，可以使用methods参数来指定允许的请求方法，包括POST方法。同时，需要使用request对象来获取POST请求的数据。

下面是一个示例，展示如何在Flask中使用POST方法：

from flask import Flask, request

app = Flask(__name__)

@app.route('/login', methods=['POST'])
def login():
    username = request.form['username']
    password = request.form['password']
    # 进行身份验证等操作
    return f'Welcome, {username}!'

if __name__ == '__main__':
    app.run()

在上面的例子中，我们定义了一个路由/login，并通过methods参数指定该路由只处理POST请求。在login()视图函数中，我们使用request.form['username']和request.form['password']获取通过表单提交的用户名和密码，并进行相应的处理，比如进行身份验证。

通过Html表单发送Post请求

在Flask中，可以使用HTML表单来发送POST请求到服务器。HTML表单提供了一种方便的方式，让用户输入数据并将其提交到服务器。

下面是一个示例，展示如何通过HTML表单发送POST请求到Flask服务器：

from flask import Flask, render_template, request

app = Flask(__name__)

@app.route('/login', methods=['GET', 'POST'])
def login():
    if request.method == 'POST':
        username = request.form['username']
        password = request.form['password']
        # 进行身份验证等操作
        return f'Welcome, {username}!'
    else:
        return render_template('login.html')

if __name__ == '__main__':
    app.run()

在上面的例子中，我们定义了一个路由/login，并通过methods参数指定该路由处理GET和POST请求。当收到POST请求时，我们从request.form中获取通过表单提交的用户名和密码，并进行相应的处理。当收到GET请求时，我们渲染了一个名为login.html的模板，并将其作为响应返回。

接下来，我们创建一个名为login.html的模板文件，其中包含一个HTML表单：

<!DOCTYPE html>
<html>
  <body>
    <h2>Login</h2>
    <form method="POST" action="/login">
      <label for="username">Username:</label><br>
      <input type="text" id="username" name="username"><br>
      <label for="password">Password:</label><br>
      <input type="password" id="password" name="password"><br><br>
      <input type="submit" value="Submit">
    </form>
  </body>
</html>

在上面的模板中，我们使用<form>标签定义了一个表单，设置了method="POST"表示将数据通过POST请求提交到服务器的/login路径。<input>标签用于接收用户的输入，name属性指定了字段的名称，服务器通过该名称来获取表单数据。

当用户在表单中填写完用户名和密码后，点击Submit按钮，表单会以POST请求的方式提交到服务器的/login路径，Flask会调用login()视图函数进行处理。

通过使用HTML表单和Flask的路由和视图函数，你可以实现与用户的交互，并通过POST请求将数据发送到服务器进行处理。

Flask 模板

在Flask中，模板引擎被用于动态生成HTML页面，使开发者能够将动态数据和静态页面内容结合起来。Flask默认使用Jinja2作为模板引擎。

以下是使用Flask模板的基本步骤：

创建一个名为templates的文件夹，用于存放模板文件。这个文件夹需要与主Python文件处于同一级目录下。
在模板文件夹中创建一个模板文件，使用.html或.jinja作为文件扩展名。例如，创建一个名为index.html的模板文件。
在主Python文件中使用render_template()函数来渲染模板并返回给客户端。

下面是一个示例，展示如何使用Flask模板：

创建一个名为templates的文件夹，并在其中创建一个名为index.html的模板文件：

<!-- templates/index.html -->
<!DOCTYPE html>
<html>
  <body>
    <h1>Hello, {{ name }}!</h1>
  </body>
</html>

在主Python文件中，使用render_template()函数渲染模板并返回给客户端：

from flask import Flask, render_template

app = Flask(__name__)

@app.route('/')
def index():
    return render_template('index.html', name='John')

if __name__ == '__main__':
    app.run()

在上面的例子中，我们创建了一个简单的模板文件index.html，其中包含一个<h1>标签，使用双花括号{{ }}来表示要插入的动态数据。在主Python文件的index()视图函数中，我们调用render_template()函数来渲染模板index.html，并将动态数据name设置为'John'。最后，返回渲染后的模板给客户端。

Flask会自动查找templates文件夹下与指定模板名称相匹配的模板文件，并将其中的动态数据进行替换。在这个例子中，{{ name }}会被替换为'John'，生成的HTML页面会被返回给客户端。

Jinja2 基本使用

1.变量名

在Jinja2中，可以使用变量名来引用和显示动态数据。变量名以两个花括号{{ }}包围。

以下是使用变量名的示例：

<!DOCTYPE html>
<html>
  <body>
    <h1>Hello, {{ name }}!</h1>
  </body>
</html>

在上面的例子中，{{ name }}是一个变量名，它将被实际的值替换。在渲染模板时，需要将实际的值传递给模板引擎。

例如，在Flask中，可以使用render_template()函数来渲染模板并传递变量值：

from flask import Flask, render_template

app = Flask(__name__)

@app.route('/')
def index():
    name = 'John'
    return render_template('index.html', name=name)

if __name__ == '__main__':
    app.run()

在上面的例子中，name变量的值为'John'，通过render_template()函数将该值传递给模板。在模板中，{{ name }}会被替换为'John'。

2.控制语句

在Jinja2中，控制语句用于实现条件判断、循环和其他逻辑控制。Jinja2支持以下几种常用的控制语句：

条件判断语句（if语句）：
```
{% if condition %}
  
{% else %}
  
{% endif %}
```
在上述代码中，condition是一个布尔表达式，如果为真，则执行if代码块；否则，执行else代码块。
循环语句（for循环）：
```
{% for item in sequence %}
  
{% endfor %}
```
在上述代码中，sequence是一个可迭代对象，item是当前迭代的元素，可以在循环体中使用。
宏定义（macro）：
```
{% macro name(arg1, arg2, ...) %}
  
{% endmacro %}
```
在上述代码中，name是宏的名称，arg1, arg2, ...是宏的参数。宏定义允许你创建可重用的代码块，可以在模板中多次调用。

这些控制语句可以嵌套使用，使你能够编写更复杂的逻辑控制。同时，Jinja2还提供了一些过滤器（filters）和函数，用于对变量进行处理和操作，进一步增强模板的灵活性和功能性。

以下是一个使用Jinja2控制语句的示例，展示了条件判断和循环的用法：

<!DOCTYPE html>
<html>
  <body>
    {% if user %}
      <h1>Welcome, {{ user }}!</h1>
    {% else %}
      <h1>Unknown User</h1>
    {% endif %}

    <ul>
      {% for item in items %}
        <li>{{ item }}</li>
      {% endfor %}
    </ul>
  </body>
</html>

在上述示例中，使用if语句根据user变量的值进行条件判断，显示不同的欢迎消息。然后，使用for循环遍历items列表，将每个元素显示为一个列表项。

Flask用户表单输入数据后端通过form获取数据

在Flask中，可以使用request.form对象来获取通过表单提交的数据。request.form是一个字典对象，其中包含了表单中所有字段的数据。

以下是一个示例，展示如何在Flask中通过request.form获取表单数据：

from flask import Flask, render_template, request

app = Flask(__name__)

@app.route('/submit', methods=['POST'])
def submit():
    username = request.form['username']
    password = request.form['password']
    # 进行处理和验证等操作
    return f'Username: {username}, Password: {password}'

if __name__ == '__main__':
    app.run()

在上面的例子中，我们定义了一个路由/submit，并指定该路由处理POST请求。在submit()视图函数中，我们通过request.form来获取表单数据。通过request.form['字段名称']可以获取指定字段的值，其中'字段名称'是表单中字段的名称。

在实际应用中，你可以根据表单的具体字段和需求，通过request.form来获取表单数据，并进行相应的处理和验证操作。

需要注意的是，使用request.form获取表单数据时，要确保请求的方法为POST，并且表单中的字段名称与代码中使用的名称一致。如果字段名称不存在，或者请求方法不是POST，可能会引发KeyError异常。因此，建议在代码中进行适当的错误处理和验证，以确保程序的稳定性和安全性。

Flask 的 args 获取数据

在Flask中，可以使用request.args对象来获取通过URL参数传递的数据。request.args是一个字典对象，其中包含了所有URL参数的键值对。

以下是一个示例，展示如何在Flask中通过request.args获取URL参数的数据：

from flask import Flask, request

app = Flask(__name__)

@app.route('/search')
def search():
    keyword = request.args.get('keyword')
    page = request.args.get('page', default=1, type=int)
    # 进行搜索操作
    return f'Searching for: {keyword}, Page: {page}'

if __name__ == '__main__':
    app.run()

在上面的例子中，我们定义了一个路由/search，并没有指定请求方法，因此默认为GET请求。在search()视图函数中，我们通过request.args.get()方法获取URL参数的值。通过request.args.get('参数名')可以获取指定参数的值，如果参数不存在，则返回None。

在上述代码中，我们获取了名为keyword的URL参数的值，并存储在keyword变量中。同时，我们还获取了名为page的URL参数的值，并指定了默认值1，并将其转换为整数类型。

在实际应用中，你可以根据URL参数的具体需求和名称，通过request.args来获取URL参数的值，并进行相应的操作和处理。

需要注意的是，使用request.args获取URL参数时，要确保请求的方法为GET，并且URL中存在相应的参数。如果参数不存在，或者请求方法不是GET，使用request.args.get()方法会返回指定的默认值或None。同样地，建议在代码中进行适当的错误处理和验证，以确保程序的稳定性和安全性。

Flask 的Cookies 获取数据及代码实现

在Flask中，可以使用request.cookies对象来获取客户端发送的Cookie数据。request.cookies是一个字典对象，其中包含了所有的Cookie键值对。

以下是一个示例，展示如何在Flask中获取Cookie数据：

from flask import Flask, request

app = Flask(__name__)

@app.route('/')
def index():
    username = request.cookies.get('username')
    # 进行处理和操作
    return f'Username: {username}'

if __name__ == '__main__':
    app.run()

在上面的例子中，我们定义了根路由/，并在index()视图函数中使用request.cookies.get()方法来获取名为username的Cookie的值。

需要注意的是，Flask中默认启用了Cookie的安全性设置，会对Cookie进行签名以防止篡改。如果你的Cookie被签名了，可以使用request.cookies.get()方法获取签名后的值，或者使用request.cookies.get('cookie名', signed=False)来获取未签名的值。

在实际应用中，你可以根据具体的Cookie名称，使用request.cookies来获取Cookie数据，并根据需要进行相应的处理和操作。

此外，Flask还提供了设置Cookie的方法，可以使用response.set_cookie()方法来设置Cookie，将数据发送给客户端。通过设置Cookie的值，可以在客户端和服务器之间传递信息。

以下是一个示例，展示如何在Flask中设置Cookie：

from flask import Flask, make_response

app = Flask(__name__)

@app.route('/')
def index():
    response = make_response('Setting a cookie!')
    response.set_cookie('username', 'John')
    return response

if __name__ == '__main__':
    app.run()

在上面的例子中，我们在index()视图函数中使用response.set_cookie()方法来设置名为username的Cookie，其值为John。然后，使用make_response()函数创建响应对象，并将其返回给客户端。

通过使用response.set_cookie()方法，你可以设置具体的Cookie名称和值，并将其发送给客户端。客户端会将该Cookie存储，并在后续的请求中发送给服务器。

需要注意的是，设置Cookie时可以指定一些可选参数，如过期时间、域名、路径、安全性等，以满足具体的需求和安全性要求。

总结起来，使用request.cookies可以在Flask中获取客户端发送的Cookie数据，而使用response.set_cookie()可以在Flask中设置发送给客户端的Cookie数据。这样，你可以在Flask应用程序中实现Cookie的读取和设置，实现更灵活的功能和交互。

Flask 文件上传及实战

在Flask中，可以使用request.files对象来处理文件上传。request.files是一个字典对象，其中包含了通过表单上传的文件。

以下是一个简单的文件上传示例：

from flask import Flask, request, render_template

app = Flask(__name__)

@app.route('/')
def index():
    return render_template('index.html')

@app.route('/upload', methods=['POST'])
def upload():
    file = request.files['file']
    if file:
        filename = file.filename
        file.save(filename)
        return f'File {filename} uploaded successfully.'
    else:
        return 'No file uploaded.'

if __name__ == '__main__':
    app.run()

在上面的示例中，我们首先定义了两个路由。根路由'/'用于展示包含文件上传表单的页面，而'/upload'路由用于处理文件上传。

在上传文件的路由中，我们通过request.files['file']来获取名为file的文件对象。然后，我们可以对文件对象进行各种操作，如获取文件名、保存文件到服务器等。

在上述代码中，我们通过file.save(filename)将上传的文件保存到服务器的当前工作目录中，并返回上传成功的消息。如果没有上传文件，我们会返回一个相应的提示。

需要注意的是，Flask默认允许的最大文件大小为16MB。如果要上传更大的文件，可以在Flask应用程序的配置中进行相应的设置，例如：

app.config['MAX_CONTENT_LENGTH'] = 100 * 1024 * 1024  # 设置为100MB

在HTML模板中，可以使用enctype="multipart/form-data"来指定表单支持文件上传。以下是一个简单的示例：

<!DOCTYPE html>
<html>
  <body>
    <h1>File Upload</h1>
    <form action="/upload" method="post" enctype="multipart/form-data">
      <input type="file" name="file" required>
      <input type="submit" value="Upload">
    </form>
  </body>
</html>

在上述示例中，我们创建了一个包含文件上传的表单，其中enctype="multipart/form-data"用于指定表单支持文件上传。通过<input type="file" name="file" required>，我们创建了一个文件选择输入框。

Flask 上传文件名含有中文处理方法

在处理Flask中上传文件名含有中文的情况时，需要考虑中文编码和文件名的处理方式。下面介绍两种常见的处理方法：

使用secure_filename函数进行文件名安全处理：

Flask提供了一个名为secure_filename的函数，用于将文件名转换为安全的文件名。该函数可以处理中文字符、特殊字符以及文件名的长度限制等问题。

示例代码如下：

from flask import Flask, request
from werkzeug.utils import secure_filename

app = Flask(__name__)

@app.route('/upload', methods=['POST'])
def upload():
    file = request.files['file']
    if file:
        filename = secure_filename(file.filename)
        file.save(filename)
        return f'File {filename} uploaded successfully.'
    else:
        return 'No file uploaded.'

if __name__ == '__main__':
    app.run()

使用secure_filename函数可以确保文件名的安全性，并将其保存到服务器上。

使用Python的UUID生成唯一文件名：

另一种方法是使用Python的UUID模块生成唯一的文件名，以避免文件名冲突。

示例代码如下：

import os
import uuid
from flask import Flask, request

app = Flask(__name__)

@app.route('/upload', methods=['POST'])
def upload():
    file = request.files['file']
    if file:
        filename = str(uuid.uuid4()) + os.path.splitext(file.filename)[1]
        file.save(filename)
        return f'File {filename} uploaded successfully.'
    else:
        return 'No file uploaded.'

if __name__ == '__main__':
    app.run()

在上述代码中，我们使用uuid.uuid4()生成一个唯一的UUID字符串，并将其与文件的扩展名结合起来，作为新的文件名保存到服务器上。

Flask 文件下载及含有中文名文件下载注意事项

在Flask中实现文件下载可以通过发送文件给客户端来实现。当涉及到文件名含有中文的情况时，需要注意字符编码的处理。

以下是一个示例，展示如何在Flask中实现文件下载，并处理含有中文名的文件：

from flask import Flask, send_file

app = Flask(__name__)

@app.route('/download')
def download_file():
    filename = '文件名.txt'  # 含有中文名的文件
    file_path = 'path/to/file/文件名.txt'  # 文件路径

    return send_file(file_path,
                     as_attachment=True,
                     attachment_filename=filename.encode('utf-8').decode('latin-1'))

if __name__ == '__main__':
    app.run()

在上面的示例中，我们定义了一个/download路由，用于实现文件下载。在download_file()视图函数中，我们使用send_file()函数发送文件给客户端。

在发送文件时，我们需要指定文件的路径file_path和文件名filename。对于含有中文名的文件，我们需要进行字符编码的处理。

在attachment_filename参数中，我们使用.encode('utf-8').decode('latin-1')对文件名进行编码转换。这是因为在发送文件名给客户端时，Flask默认使用的是latin-1编码。因此，我们需要先将文件名编码为utf-8，然后再使用latin-1解码，以确保文件名的正确显示和下载。

通过以上处理，Flask应用程序可以实现含有中文名的文件下载功能。注意在具体的应用中，需要根据文件名的编码和需要的展示方式，选择合适的字符编码进行处理，以确保文件名的正确性和兼容性。

另外，需要确保文件路径的正确性和文件的存在性，以避免出现异常和下载失败的情况。在实际应用中，可以根据需要进行错误处理和安全性验证，以确保文件下载的稳定和安全。

上一篇：校园二手信息网站的设

下一篇： RDA5981开发环