Flask框架上传和下载文件

1、Flask上传文件

上传文件步骤：

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

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

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

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

示例代码：

main.py

1. from flask import Flask, render_template, request
2. from werkzeug.utils import secure_filename
3. import os
6. app = Flask(__name__)
7. UPLOAD_PATH = os.path.join(os.path.dirname(__file__), 'images')
10. @app.route('/')
11. def index():
12. return 'Hello! '
15. @app.route('/upload/', methods=['GET', 'POST'])
16. def upload():
17. if request.method == 'GET':
18. return render_template('upload.html')
19. else:
20. img_file = request.files.get('pic')
21. file_name = img_file.filename
22. # 文件名的安全转换
23. filename = secure_filename(file_name)
24. # 保存文件
25. img_file.save(os.path.join(UPLOAD_PATH, filename))
26. return '上传文件成功！'
29. if __name__ == '__main__':
30. app.run(debug=True)

upload.html

2. "en">
4. "UTF-8">
5. "X-UA-Compatible" content="IE=edge">
6. "viewport" content="width=device-width, initial-scale=1.0">
10. "/upload/" method="post" enctype="multipart/form-data">
11. 上传文件：<input type="file" name="pic">
    
12. <input type="submit" value="提交">

运行结果：

系统路径中生成的文件：

2、Flask下载文件

2.1 send_from_directory方法

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

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

send_from_direction函数底层实现：

1. def send_from_directory(directory, filename, **options):
2. """Send a file from a given directory with :func:`send_file`. This
3. is a secure way to quickly expose static files from an upload folder
4. or something similar.
6. Example usage::
8. @app.route('/uploads/')
9. def download_file(filename):
10. return send_from_directory(app.config['UPLOAD_FOLDER'],
11. filename, as_attachment=True)
13. .. admonition:: Sending files and Performance
15. It is strongly recommended to activate either ``X-Sendfile`` support in
16. your webserver or (if no authentication happens) to tell the webserver
17. to serve files for the given path on its own without calling into the
18. web application for improved performance.
20. .. versionadded:: 0.5
22. :param directory: the directory where all the files are stored.
23. :param filename: the filename relative to that directory to
24. download.
25. :param options: optional keyword arguments that are directly
26. forwarded to :func:`send_file`.
27. """
28. filename = fspath(filename)
29. directory = fspath(directory)
30. filename = safe_join(directory, filename)
31. if not os.path.isabs(filename):
32. filename = os.path.join(current_app.root_path, filename)
33. try:
34. if not os.path.isfile(filename):
35. raise NotFound()
36. except (TypeError, ValueError):
37. raise BadRequest()
38. options.setdefault("conditional", True)
39. return send_file(filename, **options)

示例代码：

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

1. from flask import Flask, send_from_directory
2. import os
5. app = Flask(__name__)
6. UPLOAD_PATH = os.path.join(os.path.dirname(__file__), 'images')
9. @app.route('/download//')
10. def download_file(filename):
11. return send_from_directory(UPLOAD_PATH, filename)
12. # return send_from_directory(UPLOAD_PATH, filename, as_attachment=True)
15. if __name__ == '__main__':
16. app.run(debug=True)

运行结果：

当参数as_attachment=True时：

2.2 send_file方法

send_file()函数：

1. def send_file(
2. path_or_file: t.Union[os.PathLike, str, t.BinaryIO],
3. mimetype: t.Optional[str] = None,
4. as_attachment: bool = False,
5. download_name: t.Optional[str] = None,
6. attachment_filename: t.Optional[str] = None,
7. conditional: bool = True,
8. etag: t.Union[bool, str] = True,
9. add_etags: t.Optional[bool] = None,
10. last_modified: t.Optional[t.Union[datetime, int, float]] = None,
11. max_age: t.Optional[
12. t.Union[int, t.Callable[[t.Optional[str]], t.Optional[int]]]
13. ] = None,
14. cache_timeout: t.Optional[int] = None,
15. ):

参数解析：

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

注意：

示例代码：

1. import os
2. from flask import Flask, send_file, request, render_template, redirect
3. from werkzeug.utils import secure_filename
5. app = Flask(__name__)
8. UPLOAD_FOLDER = 'media' # 注意：要提前在根目录下新建media文件，否则会报错
9. app.config['UPLOAD_FOLDER'] = UPLOAD_FOLDER
12. # 判断上传的文件是否是允许的后缀
13. def allowed_file(filename):
14. return "." in filename and filename.rsplit('.', 1)[1].lower() in set(['txt', 'pdf', 'png', 'jpg', 'jpeg', 'gif'])
17. @app.route('/')
18. def index():
19. return "hello world!"
22. @app.route('/generate_file')
23. def generate_file():
24. with open('./new_file.txt', 'w', encoding='utf-8') as f:
25. f.write('我是new_file.txt文件！')
26. return "<./new_file.txt>文件已经生成！"
29. @app.route('/download')
30. def download():
31. return send_file('./new_file.txt', as_attachment=True)
34. @app.route('/upload', methods=['GET', 'POST'])
35. def upload():
36. if request.method == 'GET':
37. return render_template('upload.html')
38. else:
39. if "file" not in request.files:
40. return redirect(request.url)
42. file = request.files.get('file') # 获取文件
44. # 上传空文件（无文件）
45. if file.filename == '':
46. return redirect(request.url)
48. if file and allowed_file(file.filename):
49. if not os.path.exists(f'./templates/{UPLOAD_FOLDER}'):
50. os.mkdir(f'./templates/{UPLOAD_FOLDER}')
51. filename = secure_filename(file.filename) # 用这个函数确定文件名称是否是安全 （注意：中文不能识别）
52. file.save(os.path.join(app.config['UPLOAD_FOLDER'], filename)) # 保存文件
53. return "上传文件成功！"
56. if __name__ == '__main__':
57. app.run()

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

1. import os
2. from flask import Flask, send_file, request, render_template, redirect
3. from werkzeug.utils import secure_filename
5. app = Flask(__name__)
8. UPLOAD_FOLDER = 'media' # 注意：要提前在根目录下新建media文件，否则会报错
9. app.config['UPLOAD_FOLDER'] = UPLOAD_FOLDER
10. allow_users = ['dgw', 'super_user']
13. # 判断上传的文件是否是允许的后缀
14. def allowed_file(filename):
15. return "." in filename and filename.rsplit('.', 1)[1].lower() in set(['txt', 'pdf', 'png', 'jpg', 'jpeg', 'gif'])
18. @app.route('/')
19. def index():
20. return "hello world!"
23. @app.route('/generate_file')
24. def generate_file():
25. with open('./new_file.txt', 'w', encoding='utf-8') as f:
26. f.write('我是new_file.txt文件！')
27. return "<./new_file.txt>文件已经生成！"
30. @app.route('/download')
31. def download():
32. user_name = request.args.get('user_name')
33. if not user_name:
34. return "你没有权限下载文件！"
35. if user_name and user_name not in allow_users:
36. return "你没有权限下载文件！"
37. return send_file('./new_file.txt', as_attachment=True)
40. @app.route('/upload/', methods=['GET', 'POST'])
41. def upload(user_name):
42. if request.method == 'GET':
43. if user_name not in allow_users:
44. return "您没有权限访问此页面！"
45. return render_template('upload.html')
46. else:
47. if user_name not in allow_users:
48. return "您没有权限访问此页面！"
50. if "file" not in request.files:
51. return redirect(request.url)
53. file = request.files.get('file') # 获取文件
55. # 上传空文件（无文件）
56. if file.filename == '':
57. return redirect(request.url)
59. if file and allowed_file(file.filename):
60. if not os.path.exists(f'./templates/{UPLOAD_FOLDER}'):
61. os.mkdir(f'./templates/{UPLOAD_FOLDER}')
62. filename = secure_filename(file.filename) # 用这个函数确定文件名称是否是安全 （注意：中文不能识别）
63. file.save(os.path.join(app.config['UPLOAD_FOLDER'], filename)) # 保存文件
64. return "上传文件成功！"
67. if __name__ == '__main__':
68. app.run()

upload.html

1. html>
2. <html lang="en">
3. <head>
4. <meta charset="UTF-8">
5. <title>Uploadtitle>
6. head>
7. <body>
8. <form action="" method="post" enctype="multipart/form-data">
9. <input type="file" name="file">
10. <input type="submit" value="上传">
11. form>
12. body>
13. html>

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

1. from flask import Flask, render_template, request
2. from werkzeug.datastructures import CombinedMultiDict
3. from werkzeug.utils import secure_filename
4. import os
5. from formcheck import UpLoadForm
7. app = Flask(__name__)
8. UPLOAD_PATH = os.path.join(os.path.dirname(__file__), 'images')
11. @app.route('/upload/', methods=['GET', 'POST'])
12. def upload():
13. if request.method == 'GET':
14. return render_template('upload.html')
15. else:
16. form = UpLoadForm(CombinedMultiDict([request.form, request.files]))
17. if form.validate():
18. img_file = form.pic.data
19. file_name = secure_filename(img_file.filename)
20. img_file.save(os.path.join(UPLOAD_PATH, file_name))
21. return '上传文件成功！'
22. else:
23. return f'{form.errors}'
26. if __name__ == '__main__':
27. app.run(debug=True)

formcheck.py

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

upload.py

1. html>
2. <html lang="en">
3. <head>
4. <meta charset="UTF-8">
5. <meta http-equiv="X-UA-Compatible" content="IE=edge">
6. <meta name="viewport" content="width=device-width, initial-scale=1.0">
7. <title>Documenttitle>
8. head>
9. <body>
10. <form action="/upload/" method="post" enctype="multipart/form-data">
11. 上传文件：<input type="file" name="pic"><br>
12. <input type="submit" value="提交">
13. form>
14. body>
15. html>

运行结果：

参考博文：

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