本節講解了 flask 的請求,如果想在沒有請求的情況下獲取上下文,可以使用test_request_context()
或者request_context()
,從request
對象的form
中可以獲取表單的數據,args
中可以獲取 URL 中的參數,files
可以獲取上傳的文件,cookies
可以操作cookie
。
==============================
首先你需要從 flask 模塊中導入request
:
from flask import request
當前請求的方法可以用method
屬性來訪問。你可以用form
屬性來訪問表單數據 (數據在 POST
或者PUT
中傳輸)。這裏是上面提及到的兩種屬性的完整的例子,請重新修改hello.py
文件爲:
@app.route('/login', methods=['POST', 'GET'])
def login():
error = None
if request.method == 'POST':
if valid_login(request.form['username'],
request.form['password']):
return log_the_user_in(request.form['username'])
else:
error = 'Invalid username/password'
# 當請求形式爲“GET”或者認證失敗則執行以下代碼
return render_template('login.html', error=error)
如果在form
屬性中不存在上述鍵值會發生些什麼?在這種情況下會觸發一個特別的KeyError
。你可以像捕獲標準的KeyError
一樣來捕獲它,如果你不這樣去做,會顯示一個HTTP 400 Bad Request
錯誤頁面。所以很多情況下你不需要處理這個問題。
你可以用args
屬性來接收在URL ( ?key=value )
中提交的參數:
searchword = request.args.get('key', '')
我們推薦使用get
來訪問 URL 參數或捕獲KeyError
,因爲用戶可能會修改 URL, 向他們顯示一個400 bad request
頁面不是用戶友好的。
========================
你能夠很容易地用 Flask 處理文件上傳。只要確保在你的 HTML 表單中不要忘記設置屬性enctype="multipart/form-data"
,否則瀏覽器將不會傳送文件。
上傳的文件是存儲在內存或者文件系統上一個臨時位置。你可以通過請求對象中files
屬性訪問這些文件。每個上傳的文件都會存儲在這個屬性字典裏。它表現得像一個標準的 Python file
對象,但是它同樣具有save()
方法,該方法允許你存儲文件在服務器的文件系統上。
下面是一個簡單的例子用來演示提交文件到服務器上:
from flask import request
@app.route('/upload', methods=['GET', 'POST'])
def upload_file():
if request.method == 'POST':
f = request.files['the_file']
f.save('/var/www/uploads/uploaded_file.txt')
...
如果你想要知道在上傳到你的應用之前在客戶端的文件名稱,你可以訪問filename
屬性。但請記住永遠不要信任這個值,因爲這個值可以僞造。如果你想要使用客戶端的文件名來在服務器上存儲文件,把它傳遞到Werkzeug
提供給你的secure_filename()
函數:
from flask import request
from werkzeug import secure_filename
@app.route('/upload', methods=['GET', 'POST'])
def upload_file():
if request.method == 'POST':
f = request.files['the_file']
f.save('/var/www/uploads/' + secure_filename(f.filename))
...
3.1.4 Cookies
你可以用cookies
屬性來訪問cookies
。你能夠用響應對象的set_cookie
來設置cookies
。請求對象中的cookies
屬性是一個客戶端發送所有的cookies
的字典。
如果你要使用會話(sessions
),請不要直接使用cookies
,相反,請用 Flask 中的會話,Flask 已經在cookies
上增加了一些安全細節;關於更多seesions
和cookies
的區別與聯繫,請參見施楊出品的博客。
讀取 cookies:
from flask import request
@app.route('/')
def index():
username = request.cookies.get('username')
# 注意這裏引用cookies字典的鍵值對是使用cookies.get(key)
# 而不是cookies[key],這是防止該字典不存在時報錯"keyerror"
存儲 cookies:
from flask import make_response
@app.route('/')
def index():
resp = make_response(render_template(...))
resp.set_cookie('username', 'the username')
return resp
注意cookies
是在響應對象中被設置。由於通常只是從視圖函數返回字符串, Flask 會將其轉換爲響應對象。如果你要顯式地這麼做,你可以使用 make_response()
函數接着修改它。
有時候你可能要在響應對象不存在的地方設置cookie
。利用 延遲請求回調模式使得這種情況成爲可能。