相关推荐recommended
Flask框架上传和下载文件
作者:mmseoamin日期:2024-01-19

1、Flask上传文件

上传文件步骤:

1. 在模版html中,表单需要指定 enctype='multipart/form-data' 才能上传文件。

2. 在后台如果想要获取上传的文件,那么应该使用 request.files.get('文件名') 来获取。

3. 保存文件之前,先要使用 werkzeug.utils.secure_filename 来对上传上来的文件名进行一个过滤。能保证不会有安全问题。

4. 获取到上传上来的文件后,使用 文件对象.save(路径) 方法来保存文件。路径=完整路径=路径名+文件名

示例代码:

main.py

from flask import Flask, render_template, request
from werkzeug.utils import secure_filename
import os
app = Flask(__name__)
UPLOAD_PATH = os.path.join(os.path.dirname(__file__), 'images')
@app.route('/')
def index():
    return 'Hello! '
@app.route('/upload/', methods=['GET', 'POST'])
def upload():
    if request.method == 'GET':
        return render_template('upload.html')
    else:
        img_file = request.files.get('pic')
        file_name = img_file.filename
        # 文件名的安全转换
        filename = secure_filename(file_name)
        # 保存文件
        img_file.save(os.path.join(UPLOAD_PATH, filename))
        return '上传文件成功!'
if __name__ == '__main__':
    app.run(debug=True)

upload.html




    
    
    
    Document


    
上传文件:

运行结果:

Flask框架上传和下载文件,第1张

Flask框架上传和下载文件,第2张

Flask框架上传和下载文件,第3张

系统路径中生成的文件:

Flask框架上传和下载文件,第4张

2、Flask下载文件

2.1 send_from_directory方法

从服务器上读取文件,应该定义一个url与视图函数,来获取指定的文件。

在这个视图函数中,使用 send_from_directory(文件的目录,文件名) 来获取。

send_from_direction函数底层实现:

def send_from_directory(directory, filename, **options):
    """Send a file from a given directory with :func:`send_file`.  This
    is a secure way to quickly expose static files from an upload folder
    or something similar.
    Example usage::
        @app.route('/uploads/')
        def download_file(filename):
            return send_from_directory(app.config['UPLOAD_FOLDER'],
                                       filename, as_attachment=True)
    .. admonition:: Sending files and Performance
       It is strongly recommended to activate either ``X-Sendfile`` support in
       your webserver or (if no authentication happens) to tell the webserver
       to serve files for the given path on its own without calling into the
       web application for improved performance.
    .. versionadded:: 0.5
    :param directory: the directory where all the files are stored.
    :param filename: the filename relative to that directory to
                     download.
    :param options: optional keyword arguments that are directly
                    forwarded to :func:`send_file`.
    """
    filename = fspath(filename)
    directory = fspath(directory)
    filename = safe_join(directory, filename)
    if not os.path.isabs(filename):
        filename = os.path.join(current_app.root_path, filename)
    try:
        if not os.path.isfile(filename):
            raise NotFound()
    except (TypeError, ValueError):
        raise BadRequest()
    options.setdefault("conditional", True)
    return send_file(filename, **options)

示例代码:

目前服务器中存在的文件:

Flask框架上传和下载文件,第5张

from flask import Flask, send_from_directory
import os
app = Flask(__name__)
UPLOAD_PATH = os.path.join(os.path.dirname(__file__), 'images')
@app.route('/download//')
def download_file(filename):
    return send_from_directory(UPLOAD_PATH, filename)
    # return send_from_directory(UPLOAD_PATH, filename, as_attachment=True)
if __name__ == '__main__':
    app.run(debug=True)

运行结果:

Flask框架上传和下载文件,第6张

当参数as_attachment=True时:

Flask框架上传和下载文件,第7张

2.2 send_file方法

send_file()函数:

def send_file(
    path_or_file: t.Union[os.PathLike, str, t.BinaryIO],
    mimetype: t.Optional[str] = None,
    as_attachment: bool = False,
    download_name: t.Optional[str] = None,
    attachment_filename: t.Optional[str] = None,
    conditional: bool = True,
    etag: t.Union[bool, str] = True,
    add_etags: t.Optional[bool] = None,
    last_modified: t.Optional[t.Union[datetime, int, float]] = None,
    max_age: t.Optional[
        t.Union[int, t.Callable[[t.Optional[str]], t.Optional[int]]]
    ] = None,
    cache_timeout: t.Optional[int] = None,
):

参数解析:

  • path_or_file:要发送的文件的路径,如果给出了相对路径,则相对于当前工作目录。或者,以二进制模式打开的类文件对象。确保将文件指针查找到数据的开头。
  • mimetype:为文件发送的MIME类型。如果没有提供,它将尝试从文件名检测它。
  • as_attachment:指示浏览器应该提供给保存文件而不是显示它。
  • download_name:浏览器保存文件时使用的默认名称。默认为传递的文件名。
  • conditional:基于请求头启用条件响应和范围响应。需要传递一个文件路径和``environ``。
  • etag:计算文件的etag,这需要传递一个文件路径。也可以是字符串来代替。
  • last_modified:发送文件的最后修改时间,单位为秒。如果没有提供,它将尝试从文件路径检测它。
  • max_age:客户端应该缓存文件多长时间,以秒为单位。如果设置,' ' Cache-Control ' '将为' ' public ' ',否则将为' ' no-cache ' '以选择条件缓存。

    注意:

    Flask框架上传和下载文件,第8张

    示例代码:

    import os
    from flask import Flask, send_file, request, render_template, redirect
    from werkzeug.utils import secure_filename
    app = Flask(__name__)
    UPLOAD_FOLDER = 'media'  # 注意:要提前在根目录下新建media文件,否则会报错
    app.config['UPLOAD_FOLDER'] = UPLOAD_FOLDER
    # 判断上传的文件是否是允许的后缀
    def allowed_file(filename):
        return "." in filename and filename.rsplit('.', 1)[1].lower() in set(['txt', 'pdf', 'png', 'jpg', 'jpeg', 'gif'])
    @app.route('/')
    def index():
        return "hello world!"
    @app.route('/generate_file')
    def generate_file():
        with open('./new_file.txt', 'w', encoding='utf-8') as f:
            f.write('我是new_file.txt文件!')
        return "<./new_file.txt>文件已经生成!"
    @app.route('/download')
    def download():
        return send_file('./new_file.txt', as_attachment=True)
    @app.route('/upload', methods=['GET', 'POST'])
    def upload():
        if request.method == 'GET':
            return render_template('upload.html')
        else:
            if "file" not in request.files:
                return redirect(request.url)
            file = request.files.get('file')  # 获取文件
            # 上传空文件(无文件)
            if file.filename == '':
                return redirect(request.url)
            if file and allowed_file(file.filename):
                if not os.path.exists(f'./templates/{UPLOAD_FOLDER}'):
                    os.mkdir(f'./templates/{UPLOAD_FOLDER}')
                filename = secure_filename(file.filename)  # 用这个函数确定文件名称是否是安全 (注意:中文不能识别)
                file.save(os.path.join(app.config['UPLOAD_FOLDER'], filename))  # 保存文件
                return "上传文件成功!"
    if __name__ == '__main__':
        app.run()
    

    下载和上传路径中可以添加用户身份验证:

    import os
    from flask import Flask, send_file, request, render_template, redirect
    from werkzeug.utils import secure_filename
    app = Flask(__name__)
    UPLOAD_FOLDER = 'media'  # 注意:要提前在根目录下新建media文件,否则会报错
    app.config['UPLOAD_FOLDER'] = UPLOAD_FOLDER
    allow_users = ['dgw', 'super_user']
    # 判断上传的文件是否是允许的后缀
    def allowed_file(filename):
        return "." in filename and filename.rsplit('.', 1)[1].lower() in set(['txt', 'pdf', 'png', 'jpg', 'jpeg', 'gif'])
    @app.route('/')
    def index():
        return "hello world!"
    @app.route('/generate_file')
    def generate_file():
        with open('./new_file.txt', 'w', encoding='utf-8') as f:
            f.write('我是new_file.txt文件!')
        return "<./new_file.txt>文件已经生成!"
    @app.route('/download')
    def download():
        user_name = request.args.get('user_name')
        if not user_name:
            return "你没有权限下载文件!"
        if user_name and user_name not in allow_users:
            return "你没有权限下载文件!"
        return send_file('./new_file.txt', as_attachment=True)
    @app.route('/upload/', methods=['GET', 'POST'])
    def upload(user_name):
        if request.method == 'GET':
            if user_name not in allow_users:
                return "您没有权限访问此页面!"
            return render_template('upload.html')
        else:
            if user_name not in allow_users:
                return "您没有权限访问此页面!"
            if "file" not in request.files:
                return redirect(request.url)
            file = request.files.get('file')  # 获取文件
            # 上传空文件(无文件)
            if file.filename == '':
                return redirect(request.url)
            if file and allowed_file(file.filename):
                if not os.path.exists(f'./templates/{UPLOAD_FOLDER}'):
                    os.mkdir(f'./templates/{UPLOAD_FOLDER}')
                filename = secure_filename(file.filename)  # 用这个函数确定文件名称是否是安全 (注意:中文不能识别)
                file.save(os.path.join(app.config['UPLOAD_FOLDER'], filename))  # 保存文件
                return "上传文件成功!"
    if __name__ == '__main__':
        app.run()
    

    upload.html

    
    
    
        
        Upload
    
    
    

    3、Flask-wtf验证上传的文件

    关键点:

    1. 定义验证表单类的时候,对文件类型的字段,需要采用 FileField 这个类型,即wtforms.FileField
    2. 验证器需要从 flask_wtf.file 中导入。 flask_wtf.file.FileRequired 和 flask_wtf.file.FileAllowed
    3. flask_wtf.file.FileRequired 是用来验证文件上传不能为空。
    4. flask_wtf.file.FileAllowed 用来验证上传的文件的后缀名, 如常见图片后缀 .jpg 和.png以及.gif等。
    5. 在视图函数中,需要使用 from werkzeug.datastructures import CombinedMultiDict 来把request.form 与 request.files 来进行合并。
    6. 最后使用 表单验证对象.validate()进行验证。

    示例代码:

    main.py

    from flask import Flask, render_template, request
    from werkzeug.datastructures import CombinedMultiDict
    from werkzeug.utils import secure_filename
    import os
    from formcheck import UpLoadForm
    app = Flask(__name__)
    UPLOAD_PATH = os.path.join(os.path.dirname(__file__), 'images')
    @app.route('/upload/', methods=['GET', 'POST'])
    def upload():
        if request.method == 'GET':
            return render_template('upload.html')
        else:
            form = UpLoadForm(CombinedMultiDict([request.form, request.files]))
            if form.validate():
                img_file = form.pic.data
                file_name = secure_filename(img_file.filename)
                img_file.save(os.path.join(UPLOAD_PATH, file_name))
                return '上传文件成功!'
            else:
                return f'{form.errors}'
    if __name__ == '__main__':
        app.run(debug=True)
    

    formcheck.py

    from wtforms import Form, FileField
    from flask_wtf.file import FileAllowed, FileRequired
    class UpLoadForm(Form):
        pic = FileField(validators=[FileRequired(), FileAllowed(['jpg', 'png', 'gif'])])
    

    upload.py

    
    
    
        
        
        
        Document
    
    
        
    上传文件:

    运行结果:

    Flask框架上传和下载文件,第9张

    Flask框架上传和下载文件,第10张

    Flask框架上传和下载文件,第11张

    Flask框架上传和下载文件,第12张

    Flask框架上传和下载文件,第13张

    Flask框架上传和下载文件,第14张

    参考博文:

    Python Flask 文件下载_flask下载_liyinchi1988的博客-CSDN博客