本節講解了 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。利用 延遲請求回調模式使得這種情況成為可能。