python flask框架詳解

更新時間：2021年03月06日 09:20:29 作者：塵世風(fēng)

這篇文章主要介紹了python flask框架詳解,本文給大家介紹的非常詳細，對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值，需要的朋友可以參考下

Flask是一個Python編寫的Web 微框架，讓我們可以使用Python語言快速實現(xiàn)一個網(wǎng)站或Web服務(wù)。本文參考自Flask官方文檔，
英文不好的同學(xué)也可以參考中文文檔

1.安裝flask

pip install flask

2.簡單上手

一個最小的 Flask 應(yīng)用如下:

from flask import Flask
app = Flask(__name__)

@app.route('/')
def hello_world():
 return 'Hello World'

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

代碼解析：
1、首先我們導(dǎo)入了 Flask 類。該類的實例將會成為我們的 WSGI 應(yīng)用。
2、接著我們創(chuàng)建一個該類的實例。第一個參數(shù)是應(yīng)用模塊或者包的名稱。如果你使用一個單一模塊（就像本例），那么應(yīng)當(dāng)使用 name ，因為名稱會根據(jù)這個模塊是按應(yīng)用方式使用還是作為一個模塊導(dǎo)入而發(fā)生變化（可能是 ‘main' ，也可能是實際導(dǎo)入的名稱）。這個參數(shù)是必需的，這樣 Flask 才能知道在哪里可以找到模板和靜態(tài)文件等東西
3、然后我們使用 route() 裝飾器來告訴 Flask 觸發(fā)函數(shù)的 URL 。
4、函數(shù)名稱被用于生成相關(guān)聯(lián)的 URL 。函數(shù)最后返回需要在用戶瀏覽器中顯示的信息。

運行結(jié)果：

* Serving Flask app "flask_demo" (lazy loading)
* Environment: production
WARNING: This is a development server. Do not use it in a production deployment.
Use a production WSGI server instead.
* Debug mode: off
* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)

訪問：http://127.0.0.1:5000/

app.route(rule, options)

rule 參數(shù)表示與該函數(shù)的URL綁定。
options 是要轉(zhuǎn)發(fā)給基礎(chǔ)Rule對象的參數(shù)列表。在上面的示例中，'/ ' URL與hello_world()函數(shù)綁定。因此，當(dāng)在瀏覽器中打開web服務(wù)器的主頁時，將呈現(xiàn)該函數(shù)的輸出。最后，F(xiàn)lask類的run()方法在本地開發(fā)服務(wù)器上運行應(yīng)用程序。

app.run(host, port, debug, options)

所有參數(shù)都是可選的

host：要監(jiān)聽的主機名。默認為127.0.0.1（localhost）。設(shè)置為“0.0.0.0”以使服務(wù)器在外部可用
port ：默認值為5000
debug：默認為false。如果設(shè)置為true，則提供調(diào)試信息，可以自動重載代碼并顯示調(diào)試信息
options：要轉(zhuǎn)發(fā)到底層的Werkzeug服務(wù)器。

2.1 調(diào)試模式

雖然 flask 命令可以方便地啟動一個本地開發(fā)服務(wù)器，但是每次應(yīng)用代碼修改之后都需要手動重啟服務(wù)器。這樣不是很方便， Flask 可以做得更好。如果你打開調(diào)試模式，那么服務(wù)器會在修改應(yīng)用代碼之后自動重啟，并且當(dāng)應(yīng)用出錯時還會提供一個有用的調(diào)試器。
在命令行中，如果需要打開所有開發(fā)功能（包括調(diào)試模式），那么要在運行服務(wù)器之前導(dǎo)出 FLASK_ENV 環(huán)境變量并把其設(shè)置為 development:

$ export FLASK_ENV=development
$ flask run

在代碼中，在運行或?qū)⒄{(diào)試參數(shù)傳遞給run()方法之前，通過將application對象的debug屬性設(shè)置為True來啟用Debug模式。

app.debug = True
app.run()
# 或者
app.run(debug = True)

2.2 綁定IP和端口

默認情況下，F(xiàn)lask綁定IP為127.0.0.1，端口為5000。我們也可以通過下面的方式自定義：

app.run(host='0.0.0.0', port=80, debug=True)

0.0.0.0代表電腦所有的IP。80是HTTP網(wǎng)站服務(wù)的默認端口。什么是默認？比如，我們訪問網(wǎng)站http://www.example.com，其實是訪問的http://www.example.com:80，只不過:80可以省略不寫。

3.Flask 路由

現(xiàn)代Web框架使用路由技術(shù)來幫助用戶記住應(yīng)用程序URL?？梢灾苯釉L問所需的頁面，而無需從主頁導(dǎo)航。

Flask中的route()裝飾器用于將URL綁定到函數(shù)。例如：

@app.route('/hello')
def hello_world():
 return 'hello world'

在這里，URL'/ hello'規(guī)則綁定到hello_world()函數(shù)。因此，如果用戶訪問http://localhost:5000/hello URL，hello_world()函數(shù)的輸出將在瀏覽器中呈現(xiàn)。

application對象的add_url_rule()函數(shù)也可用于將URL與函數(shù)綁定，如上例所示，使用route()裝飾器的目的也由以下表示：

def hello_world():
 return 'hello world'
app.add_url_rule('/', 'hello', hello_world)

4.Flask 變量規(guī)則

通過向規(guī)則參數(shù)添加變量部分，可以動態(tài)構(gòu)建URL。此變量部分標記為 <converter:variable_name>。它作為關(guān)鍵字參數(shù)傳遞給與規(guī)則相關(guān)聯(lián)的函數(shù)。
在以下示例中，route()裝飾器的規(guī)則參數(shù)包含附加到URL'/hello'的<name>。因此，如果在瀏覽器中輸入http://localhost:5000/hello/chenshifeng作為URL，則'chenshifeng'將作為參數(shù)提供給 hello()函數(shù)。

#!/usr/bin/python
# -*- coding: UTF-8 -*-
"""
@author:chenshifeng
@file:flask_demo.py
@time:2021/03/01
"""
from flask import Flask

app = Flask(__name__)

@app.route('/hello/<name>')
def hello_name(name):
 return 'Hello %s!' % name

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

運行，訪問：http://localhost:5000/hello/chenshifeng

除了默認字符串變量部分之外，還可以使用以下轉(zhuǎn)換器構(gòu)建規(guī)則：

轉(zhuǎn)換器	描述
string	（缺省值）接受任何不包含斜杠的文本
int	接受正整數(shù)
float	接受正浮點數(shù)
path	類似 string ，但可以包含斜杠
uuid	接受 UUID 字符串

#!/usr/bin/python
# -*- coding: UTF-8 -*-
"""
@author:chenshifeng
@file:flask_demo.py
@time:2021/03/01
"""
from flask import Flask

app = Flask(__name__)


@app.route('/post/<int:post_id>')
def show_post(post_id):
 # show the post with the given id, the id is an integer
 return 'Post %d' % post_id

@app.route('/path/<path:subpath>')
def show_subpath(subpath):
 # show the subpath after /path/
 return 'Subpath %s' % subpath

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

4.1唯一的 URL / 重定向行為

以下兩條規(guī)則的不同之處在于是否使用尾部的斜杠。:

@app.route('/projects/')
def projects():
 return 'The project page'

@app.route('/about')
def about():
 return 'The about page'

projects 的 URL 是中規(guī)中矩的，尾部有一個斜杠，看起來就如同一個文件夾。訪問一個沒有斜杠結(jié)尾的 URL 時 Flask 會自動進行重定向，幫你在尾部加上一個斜杠。

about 的 URL 沒有尾部斜杠，因此其行為表現(xiàn)與一個文件類似。如果訪問這個 URL 時添加了尾部斜杠就會得到一個 404 錯誤。這樣可以保持 URL 唯一，并幫助搜索引擎避免重復(fù)索引同一頁面。

5.Flask URL構(gòu)建

url_for()函數(shù)對于動態(tài)構(gòu)建特定函數(shù)的URL非常有用。該函數(shù)接受函數(shù)的名稱作為第一個參數(shù)，以及一個或多個關(guān)鍵字參數(shù)，每個參數(shù)對應(yīng)于URL的變量部分。

#!/usr/bin/python
# -*- coding: UTF-8 -*-
"""
@author:chenshifeng
@file:flask_demo.py
@time:2021/03/01
"""
from flask import Flask, redirect, url_for

app = Flask(__name__)

@app.route('/admin')
def hello_admin():
 return 'Hello Admin'

@app.route('/guest/<guest>')
def hello_guest(guest):
 return 'Hello %s as Guest' % guest
@app.route('/user/<name>')
def hello_user(name):
 if name == 'admin':
 return redirect(url_for('hello_admin'))
 else:
 return redirect(url_for('hello_guest', guest=name))
if __name__ == '__main__':
 app.run(debug=True)

redirect函數(shù)用于重定向，實現(xiàn)機制很簡單，就是向客戶端（瀏覽器）發(fā)送一個重定向的HTTP報文，瀏覽器會去訪問報文中指定的url。

運行
打開瀏覽器并輸入URL - http://localhost:5000/user/admin

Hello Admin

在瀏覽器中輸入以下URL - http://localhost:5000/user/mvl

Hello mvl as Guest

6.Flask HTTP方法

Web 應(yīng)用使用不同的 HTTP 方法處理 URL 。當(dāng)你使用 Flask 時，應(yīng)當(dāng)熟悉 HTTP 方法。缺省情況下，一個路由只回應(yīng) GET 請求。可以使用 route() 裝飾器的 methods 參數(shù)來處理不同的 HTTP 方法:

方法	描述
GET	以未加密的形式將數(shù)據(jù)發(fā)送到服務(wù)器，最常見的方法。
HEAD	和GET方法相同，但沒有響應(yīng)體。
POST	用于將HTML表單數(shù)據(jù)發(fā)送到服務(wù)器，POST方法接收的數(shù)據(jù)不由服務(wù)器緩存。
PUT	用上傳的內(nèi)容替換目標資源的所有當(dāng)前表示。
DELETE	刪除由URL給出的目標資源的所有當(dāng)前表示。

默認情況下，F(xiàn)lask路由響應(yīng)GET請求。但是，可以通過為route()裝飾器提供方法參數(shù)來更改此首選項。

為了演示在URL路由中使用POST方法，首先讓我們創(chuàng)建一個HTML表單，并使用POST方法將表單數(shù)據(jù)發(fā)送到URL。
將以下腳本另存為login.html

<html>
 <body>
 
 <form action = "http://localhost:5000/login" method = "post">
 <p>Enter Name:</p>
 <p><input type = "text" name = "nm" /></p>
 <p><input type = "submit" value = "submit" /></p>
 </form>
 
 </body>
</html>

運行以下代碼

from flask import Flask, redirect, url_for, request
app = Flask(__name__)

@app.route('/success/<name>')
def success(name):
 return 'welcome %s' % name

@app.route('/login',methods = ['POST', 'GET'])
def login():
 if request.method == 'POST':
 user = request.form['nm']
 return redirect(url_for('success',name = user))
 else:
 user = request.args.get('nm')
 return redirect(url_for('success',name = user))

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

在瀏覽器中打開login.html，在文本字段中輸入name，然后單擊提交。

表單數(shù)據(jù)將POST到表單標簽的action子句中的URL。

http://localhost/login映射到login()函數(shù)。由于服務(wù)器通過POST方法接收數(shù)據(jù)，因此通過以下步驟獲得從表單數(shù)據(jù)獲得的“nm”參數(shù)的值：
表單數(shù)據(jù)將POST到表單標簽的action子句中的URL。

user = request.form['nm']

它作為變量部分傳遞給'/ success' URL。瀏覽器在窗口中顯示welcome消息。

在login.html中將方法參數(shù)更改為'GET'，然后在瀏覽器中再次打開它。服務(wù)器上接收的數(shù)據(jù)是通過GET方法獲得的。通過以下的步驟獲得'nm'參數(shù)的值：

User = request.args.get('nm')

這里，args是包含表單參數(shù)對及其對應(yīng)值對的列表的字典對象。與'nm'參數(shù)對應(yīng)的值將像之前一樣傳遞到'/ success' URL。

7.Flask 模板

在大型應(yīng)用中,把業(yè)務(wù)邏輯和表現(xiàn)內(nèi)容放在一起,會增加代碼的復(fù)雜度和維護成本.

模板其實是一個包含響應(yīng)文本的文件,其中用占位符(變量)表示動態(tài)部分,告訴模板引擎其具體的值需要從使用的數(shù)據(jù)中獲取
使用真實值替換變量,再返回最終得到的字符串,這個過程稱為'渲染'
Flask 是使用 Jinja2 這個模板引擎來渲染模板

使用模板的好處

視圖函數(shù)只負責(zé)業(yè)務(wù)邏輯和數(shù)據(jù)處理(業(yè)務(wù)邏輯方面)而模板則取到視圖函數(shù)的數(shù)據(jù)結(jié)果進行展示(視圖展示方面)代碼結(jié)構(gòu)清晰,耦合度低

使用 render_template() 方法可以渲染模板，你只要提供模板名稱和需要作為參數(shù)傳遞給模板的變量就行了。
Flask 會在 templates 文件夾內(nèi)尋找模板。因此，如果你的應(yīng)用是一個模塊，那么模板文件夾應(yīng)該在模塊旁邊；如果是一個包，那么就應(yīng)該在包里面：
情形 1 : 一個模塊:

/application.py
/templates
 /hello.html

情形 2 : 一個包:

/application
 /__init__.py
 /templates
 /hello.html

示例代碼：

from flask import Flask, render_template

app = Flask(__name__)

@app.route('/')
def index():
 my_int = 18
 my_str = 'curry'
 my_list = [1, 5, 4, 3, 2]
 my_dict = {
 'name': 'durant',
 'age': 28
 }

 # render_template方法:渲染模板
 # 參數(shù)1: 模板名稱 參數(shù)n: 傳到模板里的數(shù)據(jù)
 return render_template('hello.html',
  my_int=my_int,
  my_str=my_str,
  my_list=my_list,
  my_dict=my_dict)


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

<!DOCTYPE html>
<html lang="en">

<head>
 <meta charset="UTF-8">
 <title>Title</title>
</head>

<body>
 <h2>我是模板</h2>
 {{ my_int }}
 <br>
 {{ my_str }}
 <br>
 {{ my_list }}
 <br>
 {{ my_dict }}
 <hr>
 <h2>模板的list數(shù)據(jù)獲取</h2>
 <hr>
 {{ my_list[0] }}
 <br>
 {{ my_list.1 }}
 <hr>
 <h2>字典數(shù)據(jù)獲取</h2>
 <hr>
 {{ my_dict['name'] }}
 <br>
 {{ my_dict.age }}
 <hr>
 <h2>算術(shù)運算</h2>
 <br>
 {{ my_list.0 + 10 }}
 <br>
 {{ my_list[0] + my_list.1 }}
</body>

</html>

運行效果：

8.Flask 靜態(tài)文件

動態(tài)的 web 應(yīng)用也需要靜態(tài)文件，一般是 CSS 和 JavaScript 文件。理想情況下你的服務(wù)器已經(jīng)配置好了為你的提供靜態(tài)文件的服務(wù)。但是在開發(fā)過程中， Flask 也能做好這項工作。只要在你的包或模塊旁邊創(chuàng)建一個名為 static 的文件夾就行了。靜態(tài)文件位于應(yīng)用的 /static 中。
使用特定的 'static' 端點就可以生成相應(yīng)的 URL

url_for('static', filename='style.css')

這個靜態(tài)文件在文件系統(tǒng)中的位置應(yīng)該是 static/style.css 。

在下面的示例中，在index.html中的HTML按鈕的OnClick事件上調(diào)用hello.js中定義的javascript函數(shù)，該函數(shù)在Flask應(yīng)用程序的“/”URL上呈現(xiàn)。

from flask import Flask, render_template
app = Flask(__name__)

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

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

index.html的HTML腳本如下所示：

<html>

 <head>
 <script type = "text/javascript"
 src = "{{ url_for('static', filename = 'hello.js') }}" ></script>
 </head>

 <body>
 <input type = "button" onclick = "sayHello()" value = "Say Hello" />
 </body>

</html>

Hello.js包含sayHello()函數(shù)。

function sayHello() {
 alert("Hello World")
}

運行效果：

9.Flask Request對象

來自客戶端網(wǎng)頁的數(shù)據(jù)作為全局請求對象發(fā)送到服務(wù)器。為了處理請求數(shù)據(jù)，應(yīng)該從Flask模塊導(dǎo)入。

Request對象的重要屬性如下所列：

form - 它是一個字典對象，包含表單參數(shù)及其值的鍵和值對。
args - 解析查詢字符串的內(nèi)容，它是問號（？）之后的URL的一部分。
Cookies - 保存Cookie名稱和值的字典對象。
files - 與上傳文件有關(guān)的數(shù)據(jù)。
method - 當(dāng)前請求方法

首先，你必須從 flask 模塊導(dǎo)入請求對象:

from flask import request

9.1 Flask 將表單數(shù)據(jù)發(fā)送到模板

我們已經(jīng)看到，可以在 URL 規(guī)則中指定 http 方法。觸發(fā)函數(shù)接收的 Form 數(shù)據(jù)可以以字典對象的形式收集它并將其轉(zhuǎn)發(fā)到模板以在相應(yīng)的網(wǎng)頁上呈現(xiàn)它。

在以下示例中，'/' URL 會呈現(xiàn)具有表單的網(wǎng)頁（student.html）。填入的數(shù)據(jù)會發(fā)布到觸發(fā) result() 函數(shù)的 '/result' URL。

result() 函數(shù)收集字典對象中的 request.form 中存在的表單數(shù)據(jù)，并將其發(fā)送給 result.html。

該模板動態(tài)呈現(xiàn)表單數(shù)據(jù)的 HTML 表格。

下面給出的是應(yīng)用程序的 Python 代碼：

from flask import Flask, render_template, request
app = Flask(__name__)
@app.route('/')
def student():
 return render_template('student.html')


@app.route('/result',methods = ['POST', 'GET'])
def result():
 if request.method == 'POST':
 result = request.form
 return render_template("result.html",result = result)


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

下面給出的是 student.html 的 HTML 腳本。

<!DOCTYPE html>
<html lang="en">
<head>
 <meta charset="UTF-8">
 <title>Title</title>
</head>
<body>
 <form action="http://localhost:5000/result" method="POST">
 <p>Name <input type = "text" name = "Name" /></p>
 <p>Physics <input type = "text" name = "Physics" /></p>
 <p>Chemistry <input type = "text" name = "chemistry" /></p>
 <p>Maths <input type ="text" name = "Mathematics" /></p>
 <p><input type = "submit" value = "submit" /></p>
 </form>
</body>
</html>

下面給出了模板（ result.html ）的代碼：

<!doctype html>
 <table border = 1>
 {% for key, value in result.items() %}
 <tr>
 <th> {{ key }} </th>
 <td> {{ value }}</td>
 </tr>
 {% endfor %}
</table>

運行效果：
運行 Python 腳本，并在瀏覽器中輸入 URL http://localhost:5000/。

當(dāng)點擊提交按鈕時，表單數(shù)據(jù)以 HTML 表格的形式呈現(xiàn)在 result.html 上。

9.2 Flask Cookies

Cookie以文本文件的形式存儲在客戶端的計算機上。其目的是記住和跟蹤與客戶使用相關(guān)的數(shù)據(jù)，以獲得更好的訪問者體驗和網(wǎng)站統(tǒng)計信息。

Request對象包含Cookie的屬性。它是所有cookie變量及其對應(yīng)值的字典對象，客戶端已傳輸。除此之外，cookie還存儲其網(wǎng)站的到期時間，路徑和域名。
在Flask中，對cookie的處理步驟為：

1.設(shè)置cookie：
設(shè)置cookie,默認有效期是臨時cookie,瀏覽器關(guān)閉就失效
可以通過 max_age 設(shè)置有效期，單位是秒

cookie_1 = request.cookies.get("chenshifeng")

2.獲取cookie
獲取cookie，通過request.cookies的方式，返回的是一個字典，可以獲取字典里的相應(yīng)的值

resp = make_response("del success") # 設(shè)置響應(yīng)體
resp.delete_cookie("chenshifeng")

3.刪除cookie
這里的刪除只是讓cookie過期，并不是直接刪除cookie
刪除cookie，通過delete_cookie()的方式，里面是cookie的名字

resp = make_response("del success") # 設(shè)置響應(yīng)體
resp.delete_cookie("chenshifeng")

以下為Flask Cookies的簡單示例：

from flask import Flask, make_response, request

app = Flask(__name__)

@app.route("/set_cookies")
def set_cookie():
 resp = make_response("success")
 resp.set_cookie("chenshifeng", "shifengboy",max_age=3600)
 return resp

@app.route("/get_cookies")
def get_cookie():
 cookie_1 = request.cookies.get("chenshifeng") # 獲取名字為Itcast_1對應(yīng)cookie的值
 return cookie_1

@app.route("/delete_cookies")
def delete_cookie():
 resp = make_response("del success")
 resp.delete_cookie("chenshifeng")

 return resp

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

設(shè)置cookies

運行應(yīng)用程序，在瀏覽器中輸入 127.0.0.1:5000/set_cookies 來設(shè)置cookies，設(shè)置 cookies 的輸出如下所示：

獲取cookie

根據(jù)視圖函數(shù)中相對應(yīng)的路徑，輸入 http://127.0.0.1:5000/get_cookies ，讀回 cookies 的輸出如下所示：

刪除cookie

根據(jù)視圖函數(shù)中相對應(yīng)的路徑，輸入 http://127.0.0.1:5000/delete_cookies ，刪除 cookies 的輸出如下所示：

注意刪除，只是讓 cookie 過期。

10.Flask 會話

與Cookie不同，Session（會話）數(shù)據(jù)存儲在服務(wù)器上。會話是客戶端登錄到服務(wù)器并注銷服務(wù)器的時間間隔。需要在該會話中保存的數(shù)據(jù)會存儲在服務(wù)器上的臨時目錄中。

為每個客戶端的會話分配會話ID。會話數(shù)據(jù)存儲在cookie的頂部，服務(wù)器以加密方式對其進行簽名。對于此加密，F(xiàn)lask應(yīng)用程序需要一個定義的SECRET_KEY。

Session對象也是一個字典對象，包含會話變量和關(guān)聯(lián)值的鍵值對。

例如，要設(shè)置一個'username'會話變量，請使用以下語句：

Session['username'] = 'admin'

要釋放會話變量，請使用pop()方法。

session.pop('username', None)

演示代碼：

from flask import Flask, session, redirect, url_for, request

app = Flask(__name__)

app.secret_key = 'fkdjsafjdkfdlkjfadskjfadskljdsfklj' # 確保設(shè)置應(yīng)用程序的secret_key


@app.route('/')
def index():
 if 'username' in session:
 username = session['username']

 return '登錄用戶名是:' + username + '<br>' + \
  "<b><a href = '/logout'>點擊這里注銷</a></b>"

 return "您暫未登錄， <br><a href = '/login'></b>" + \
  "點擊這里登錄</b></a>"


@app.route('/login', methods=['GET', 'POST'])
def login():
 if request.method == 'POST':
 session['username'] = request.form['username']

 return redirect(url_for('index'))

 return '''

 <form action = "" method = "post">

 <p><input type ="text" name ="username"/></p>

 <p><input type ="submit" value ="登錄"/></p>

 </form>

 '''


@app.route('/logout')
def logout():
 # remove the username from the session if it is there

 session.pop('username', None)

 return redirect(url_for('index'))


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

如何生成一個好的密鑰
生成隨機數(shù)的關(guān)鍵在于一個好的隨機種子，因此一個好的密鑰應(yīng)當(dāng)有足夠的隨機性。操作系統(tǒng)可以有多種方式基于密碼隨機生成器來生成隨機數(shù)據(jù)。使用下面的命令可以快捷的為 Flask.secret_key （或者 SECRET_KEY ）生成值:
$ python -c 'import os; print(os.urandom(16))'
b'_5#y2L"F4Q8z\n\xec]/'

訪問http://127.0.0.1:5000/，只是提示用戶登錄，因為未設(shè)置會話變量'username'。

當(dāng)用戶點擊登錄，瀏覽到“/login”login()視圖函數(shù)時，因為它是通過GET方法調(diào)用的，所以將打開一個登錄表單。

點擊登錄，通過POST方法將表單發(fā)送回'/login'，現(xiàn)在會話變量已設(shè)置。應(yīng)用程序重定向到'/'。此時會話變量'username'被找到。

應(yīng)用程序還包含一個logout()視圖函數(shù)，它會彈出'username'會話變量。因此，'/' URL再次顯示開始頁面。

11.Flask 重定向和錯誤

Flask類有一個redirect()函數(shù)。調(diào)用時，它返回一個響應(yīng)對象，并將用戶重定向到具有指定狀態(tài)代碼的另一個目標位置。

redirect()函數(shù)的原型如下：

Flask.redirect(location, statuscode, response)

在上述函數(shù)中：

location參數(shù)是應(yīng)該重定向響應(yīng)的URL。
statuscode發(fā)送到瀏覽器標頭，默認為302。
response參數(shù)用于實例化響應(yīng)。

以下狀態(tài)代碼已標準化：

HTTP_300_MULTIPLE_CHOICES
HTTP_301_MOVED_PERMANENTLY
HTTP_302_FOUND
HTTP_303_SEE_OTHER
HTTP_304_NOT_MODIFIED
HTTP_305_USE_PROXY
HTTP_306_RESERVED
HTTP_307_TEMPORARY_REDIRECT

默認狀態(tài)代碼為302，表示'found'。
在以下示例中，redirect()函數(shù)用于在登錄嘗試失敗時再次顯示登錄頁面。

from flask import Flask, redirect, url_for, render_template, request

# Initialize the Flask application
app = Flask(__name__)


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


@app.route('/login', methods=['POST', 'GET'])
def login():
 if request.method == 'POST' and request.form['username'] == 'admin':
  return redirect(url_for('success'))
 return redirect(url_for('index'))

@app.route('/success')
def success():
 return 'logged in successfully'

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

下面給出的是 log_in.html的 HTML 腳本。

<!DOCTYPE html>
<html lang="en">
<head>
 <meta charset="UTF-8">
 <title>Title</title>
</head>
<body>
  <form action = "http://localhost:5000/login" method = "POST">
   <p>Enter Name:</p>
   <p><input type = "text" name = "username" /></p>
   <p><input type = "submit" value = "submit" /></p>
  </form>
</body>
</html>

Flask類具有帶有錯誤代碼的abort()函數(shù)。

Flask.abort(code)

Code參數(shù)采用以下值之一：

400 - 用于錯誤請求
401 - 用于未身份驗證的
403 - Forbidden
404 - 未找到
406 - 表示不接受
415 - 用于不支持的媒體類型
429 - 請求過多

讓我們對上述代碼中的login()函數(shù)稍作更改。如果要顯示'Unauthurized'頁面，請將其替換為調(diào)用abort(401)，而不是重新顯示登錄頁面。

from flask import Flask, redirect, url_for, render_template, request, abort

app = Flask(__name__)

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

@app.route('/login', methods=['POST', 'GET'])
def login():
 if request.method == 'POST':
  if request.form['username'] == 'admin':
   return redirect(url_for('success'))
  else:
   abort(401)
 else:
  return redirect(url_for('index'))

@app.route('/success')
def success():
 return 'logged in successfully'

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

運行，輸入非admin的用戶名，點擊提交

12. Flask 消息閃現(xiàn)

一個好的基于 GUI 的應(yīng)用程序會向用戶提供有關(guān)交互的反饋。例如，桌面應(yīng)用程序使用對話框或消息框，JavaScript 使用警報用于類似目的。

在 Flask Web 應(yīng)用程序中生成這樣的信息性消息很容易。Flask 框架的閃現(xiàn)系統(tǒng)可以在一個視圖中創(chuàng)建消息，并在名為 next 的視圖函數(shù)中呈現(xiàn)它。

Flask 模塊包含 flash() 方法。它將消息傳遞給下一個請求，該請求通常是一個模板。

flash(message, category)

其中，

message 參數(shù)是要閃現(xiàn)的實際消息。
category 參數(shù)是可選的。它可以是“error”，“info”或“warning”。
為了從會話中獲取消息，模板調(diào)用 get_flashed_messages()。

以下是一個完整的示例:

from flask import Flask, flash, redirect, render_template, \
  request, url_for

app = Flask(__name__)
app.secret_key = b'_5#y2L"F4Q8z\n\xec]/'

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

@app.route('/login', methods=['GET', 'POST'])
def login():
 error = None
 if request.method == 'POST':
  if request.form['username'] != 'admin' or \
   request.form['password'] != 'secret':
   error = 'Invalid credentials'
  else:
   flash('You were successfully logged in')
   return redirect(url_for('index'))
 return render_template('login.html', error=error)

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

以下是實現(xiàn)閃現(xiàn)的 layout.html 模板：

<!doctype html>
<title>My Application</title>
{% with messages = get_flashed_messages() %}
 {% if messages %}
 <ul class=flashes>
 {% for message in messages %}
  <li>{{ message }}</li>
 {% endfor %}
 </ul>
 {% endif %}
{% endwith %}
{% block body %}{% endblock %}

以下是繼承自 layout.html 的 index.html 模板：

{% block body %}
 <h1>Overview</h1>
 <p>Do you want to <a href="{{ url_for('login') }}">log in?</a>
{% endblock %}

以下是同樣繼承自 layout.html 的 login.html 模板：

{% extends "layout.html" %}
{% block body %}
 <h1>Login</h1>
 {% if error %}
 <p class=error><strong>Error:</strong> {{ error }}
 {% endif %}
 <form method=post>
 <dl>
  <dt>Username:
  <dd><input type=text name=username value="{{
   request.form.username }}">
  <dt>Password:
  <dd><input type=password name=password>
 </dl>
 <p><input type=submit value=Login>
 </form>
{% endblock %}

運行
首頁

登錄報錯頁

登錄成功頁

13. Flask 文件上傳

在 Flask 中處理文件上傳非常簡單。它需要一個 HTML 表單，其 enctype 屬性設(shè)置為'multipart/form-data'，將文件發(fā)布到 URL。URL 處理程序從 request.files[] 對象中提取文件，并將其保存到所需的位置。

每個上傳的文件首先會保存在服務(wù)器上的臨時位置，然后將其實際保存到它的最終位置。目標文件的名稱可以是硬編碼的，也可以從 request.files[file] 對象的filename屬性中獲取。但是，建議使用 secure_filename() 函數(shù)獲取它的安全版本。
可以在 Flask 對象的配置設(shè)置中定義默認上傳文件夾的路徑和上傳文件的最大大小。

app.config[‘UPLOAD_FOLDER'] 定義上傳文件夾的路徑 app.config[‘MAX_CONTENT_LENGTH'] 指定要上傳的文件的最大大小（以字節(jié)為單位）

以下代碼具有 '/upload' URL 規(guī)則，該規(guī)則在 templates 文件夾中顯示 'upload.html'，以及 '/ upload-file' URL 規(guī)則，用于調(diào)用 uploader() 函數(shù)處理上傳過程。
'upload.html' 有一個文件選擇器按鈕和一個提交按鈕。

<html>
<head>
 <title>File Upload</title>
</head>
<body>
 <form action="http://localhost:5000/uploader" method="POST" enctype="multipart/form-data">
  <input type="file" name="file" accept=".jpg,.png" />
  <input type="submit" />
 </form>
</body>
</html>

以下是 Flask 應(yīng)用程序的 Python 代碼。

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

app = Flask(__name__)
app.config['UPLOAD_FOLDER'] = '/Users/chenshifeng/upload/'

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

@app.route('/uploader', methods = ['GET', 'POST'])
def uploader():
 if request.method == 'POST':
  f = request.files['file']
  f.save(os.path.join(app.config['UPLOAD_FOLDER'],secure_filename(f.filename)))
  return 'file uploaded successfully'

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

您將看到如下所示的界面。

選擇文件后，單擊提交。表單的 post 方法調(diào)用 '/ upload_file' URL。底層函數(shù) uploader() 執(zhí)行保存操作。
上傳成功會顯示以下畫面：

上傳文件被放到/Users/chenshifeng/upload文件夾下：

14. Flask 擴展

Flask通常被稱為微框架，因為核心功能包括基于Werkzeug的WSGI和路由以及基于Jinja2的模板引擎。此外，F(xiàn)lask框架還支持cookie和會話，以及JSON，靜態(tài)文件等Web幫助程序。顯然，這不足以開發(fā)完整的Web應(yīng)用程序。而Flask擴展就具備這樣的功能。Flask擴展為Flask框架提供了可擴展性。

有大量的Flask擴展可用。Flask擴展是一個Python模塊，它向Flask應(yīng)用程序添加了特定類型的支持。Flask Extension Registry（Flask擴展注冊表）是一個可用的擴展目錄。可以通過pip實用程序下載所需的擴展名。

在本教程中，我們將討論以下重要的Flask擴展：

Flask Mail - 為Flask應(yīng)用程序提供SMTP接口
Flask WTF - 添加WTForms的渲染和驗證
Flask SQLAlchemy - 為Flask應(yīng)用程序添加SQLAlchemy支持
Flask Sijax - Sijax的接口 - Python/jQuery庫，使AJAX易于在Web應(yīng)用程序中使用

每種類型的擴展通常提供有關(guān)其用法的大量文檔。由于擴展是一個Python模塊，因此需要導(dǎo)入它才能使用它。Flask擴展名通常命名為flask-foo。導(dǎo)入的操作如下：

from flask_foo import [class, function]

對于0.7以后的Flask版本，您還可以使用語法：

from flask.ext import foo

對于此用法，需要激活兼容性模塊。它可以通過運行flaskext_compat.py來安裝：

import flaskext_compat
flaskext_compat.activate()
from flask.ext import foo

14.1 Flask 郵件

務(wù)器建立簡單的接口變得非常容易。

首先，應(yīng)該在pip實用程序的幫助下安裝Flask-Mail擴展。

pip install Flask-Mail

然后需要通過設(shè)置以下應(yīng)用程序參數(shù)的值來配置Flask-Mail。

參數(shù)	描述
MAIL_SERVER	電子郵件服務(wù)器的名稱/IP地址
MAIL_PORT	使用的服務(wù)器的端口號
MAIL_USE_TLS	啟用/禁用傳輸安全層加密
MAIL_USE_SSL	啟用/禁用安全套接字層加密
MAIL_DEBUG	調(diào)試支持。默認值是Flask應(yīng)用程序的調(diào)試狀態(tài)
MAIL_USERNAME	發(fā)件人的用戶名
MAIL_PASSWORD	發(fā)件人的密碼
MAIL_DEFAULT_SENDER	設(shè)置默認發(fā)件人
MAIL_MAX_EMAILS	設(shè)置要發(fā)送的最大郵件數(shù)
MAIL_SUPPRESS_SEND	如果app.testing設(shè)置為true，則發(fā)送被抑制
MAIL_ASCII_ATTACHMENTS	如果設(shè)置為true，則附加的文件名將轉(zhuǎn)換為ASCII

flask-mail模塊包含以下重要類的定義。

14.1.1 Mail類

它管理電子郵件消息傳遞需求。類構(gòu)造函數(shù)采用以下形式：

flask-mail.Mail(app = None)

構(gòu)造函數(shù)將Flask應(yīng)用程序?qū)ο笞鳛閰?shù)。
Mail類的方法：

方法	描述
send()	發(fā)送Message類對象的內(nèi)容
connect()	打開與郵件主機的連接
send_message()	發(fā)送消息對象

14.1.2 Message類

它封裝了一封電子郵件。Message類構(gòu)造函數(shù)有幾個參數(shù):

flask-mail.Message(subject, recipients, body, html, sender, cc, bcc, reply-to, date, charset, extra_headers, mail_options,rcpt_options)

Message類方法：

attach() - 為郵件添加附件。此方法采用以下參數(shù)：

filename - 要附加的文件的名稱content_type - MIME類型的文件data - 原始文件數(shù)據(jù)處置 - 內(nèi)容處置（如果有的話）。

add_recipient() - 向郵件添加另一個收件人

在下面的示例中，使用QQ郵箱服務(wù)的SMTP服務(wù)器用作Flask-Mail配置的MAIL_SERVER。

from flask import Flask
from flask_mail import Mail, Message

app =Flask(__name__)
mail=Mail(app)

app.config['MAIL_SERVER']='smtp.qq.com'
app.config['MAIL_PORT'] = 465
app.config['MAIL_USERNAME'] = 'xxxxx@qq.com'
app.config['MAIL_PASSWORD'] = 'xxxxxxxx'
app.config['MAIL_USE_TLS'] = False
app.config['MAIL_USE_SSL'] = True
mail = Mail(app)

@app.route("/")
def index():
 msg = Message('Hello', sender = 'xxxxx@qq.com', recipients = ['xxxxx@qq.com'])
 msg.body = "Hello Flask message sent from Flask-Mail"
 mail.send(msg)
 return "Sent"

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

15. Flask SQLAlchemy

步驟1 - 安裝Flask-SQLAlchemy擴展。

pip install flask-sqlalchemy

步驟2 - 您需要從此模塊導(dǎo)入SQLAlchemy類。

from flask_sqlalchemy import SQLAlchemy

步驟3 - 現(xiàn)在創(chuàng)建一個Flask應(yīng)用程序?qū)ο蟛橐褂玫臄?shù)據(jù)庫設(shè)置URI。

app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///students.sqlite3'

步驟4 - 然后使用應(yīng)用程序?qū)ο笞鳛閰?shù)創(chuàng)建SQLAlchemy類的對象。該對象包含用于ORM操作的輔助函數(shù)。它還提供了一個父Model類，使用它來聲明用戶定義的模型。在下面的代碼段中，創(chuàng)建了students模型。

db = SQLAlchemy(app)
class students(db.Model):
 id = db.Column('student_id', db.Integer, primary_key = True)
 name = db.Column(db.String(100))
 city = db.Column(db.String(50)) 
 addr = db.Column(db.String(200))
 pin = db.Column(db.String(10))

def __init__(self, name, city, addr,pin):
 self.name = name
 self.city = city
 self.addr = addr
 self.pin = pin

步驟5 - 要創(chuàng)建/使用URI中提及的數(shù)據(jù)庫，請運行create_all()方法。

db.create_all()

SQLAlchemy的Session對象管理ORM對象的所有持久性操作。
以下session方法執(zhí)行CRUD操作：

db.session.add (模型對象) - 將記錄插入到映射表中
db.session.delete (模型對象) - 從表中刪除記錄
model.query.all() - 從表中檢索所有記錄（對應(yīng)于SELECT查詢）。

您可以通過使用filter屬性將過濾器應(yīng)用于檢索到的記錄集。例如，要在學(xué)生表中檢索city ='Hyderabad'的記錄，請使用以下語句：

Students.query.filter_by(city = 'Hyderabad').all()

有了這么多的背景，現(xiàn)在我們將為我們的應(yīng)用程序提供視圖函數(shù)來添加學(xué)生數(shù)據(jù)。

應(yīng)用程序的入口點是綁定到'/' URL的show_all()函數(shù)。學(xué)生表的記錄集作為參數(shù)發(fā)送到HTML模板。模板中的服務(wù)器端代碼以HTML表格形式呈現(xiàn)記錄。

@app.route('/')
def show_all():
 return render_template('show_all.html', students = students.query.all() )

模板（'show_all.html'）的HTML腳本如下：

<!DOCTYPE html>
<html lang = "en">
 <head></head>
 <body>
  
  <h3>
   <a href = "{{ url_for('show_all') }}">Comments - Flask 
   SQLAlchemy example</a>
  </h3>
  
  <hr/>
  {%- for message in get_flashed_messages() %}
   {{ message }}
  {%- endfor %}
		
  <h3>Students (<a href = "{{ url_for('new') }}">Add Student
   </a>)</h3>
  
  <table>
   <thead>
   <tr>
    <th>Name</th>
    <th>City</th>
    <th>Address</th>
    <th>Pin</th>
   </tr>
   </thead>
   
   <tbody>
   {% for student in students %}
    <tr>
     <td>{{ student.name }}</td>
     <td>{{ student.city }}</td>
     <td>{{ student.addr }}</td>
     <td>{{ student.pin }}</td>
    </tr>
   {% endfor %}
   </tbody>
  </table>
  
 </body>
</html>

上述網(wǎng)頁包含指向'/ new' URL映射new()函數(shù)的超鏈接。單擊時，將打開“學(xué)生信息”表單。數(shù)據(jù)在 POST方法中發(fā)布到相同的URL。
new.html

<!DOCTYPE html>
<html>
 <body>
 
  <h3>Students - Flask SQLAlchemy example</h3>
  <hr/>
  
  {%- for category, message in get_flashed_messages(with_categories = true) %}
   <div class = "alert alert-danger">
   {{ message }}
   </div>
  {%- endfor %}
  
  <form action = "{{ request.path }}" method = "post">
   <label for = "name">Name</label><br>
   <input type = "text" name = "name" placeholder = "Name" /><br>
   <label for = "email">City</label><br>
   <input type = "text" name = "city" placeholder = "city" /><br>
   <label for = "addr">addr</label><br>
   <textarea name = "addr" placeholder = "addr"></textarea><br>
   <label for = "PIN">PINCODE</label><br>
   <input type = "text" name = "pin" placeholder = "pin" /><br>
   <input type = "submit" value = "Submit" />
  </form>
  
 </body>
</html>

當(dāng)http方法被檢測為POST時，表單數(shù)據(jù)被添加到學(xué)生表中，并且應(yīng)用返回到顯示添加數(shù)據(jù)的主頁。

@app.route('/new', methods = ['GET', 'POST'])
def new():
 if request.method == 'POST':
  if not request.form['name'] or not request.form['city'] or not request.form['addr']:
   flash('Please enter all the fields', 'error')
  else:
   student = students(request.form['name'], request.form['city'],
   request.form['addr'], request.form['pin'])
   
   db.session.add(student)
   db.session.commit()
   
   flash('Record was successfully added')
   return redirect(url_for('show_all'))
 return render_template('new.html')

下面給出了應(yīng)用程序（app.py）的完整代碼。

from flask import Flask, request, flash, url_for, redirect, render_template
from flask_sqlalchemy import SQLAlchemy

app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///students.sqlite3'
app.config['SECRET_KEY'] = "random string"

db = SQLAlchemy(app)


class students(db.Model):
 id = db.Column('student_id', db.Integer, primary_key=True)
 name = db.Column(db.String(100))
 city = db.Column(db.String(50))
 addr = db.Column(db.String(200))
 pin = db.Column(db.String(10))


 def __init__(self, name, city, addr, pin):
  self.name = name
  self.city = city
  self.addr = addr
  self.pin = pin


@app.route('/')
def show_all():
 return render_template('show_all.html', students=students.query.all())


@app.route('/new', methods=['GET', 'POST'])
def new():
 if request.method == 'POST':
  if not request.form['name'] or not request.form['city'] or not request.form['addr']:
   flash('Please enter all the fields', 'error')
  else:
   student = students(request.form['name'], request.form['city'],
        request.form['addr'], request.form['pin'])

   db.session.add(student)
   db.session.commit()
   flash('Record was successfully added')
   return redirect(url_for('show_all'))
 return render_template('new.html')


if __name__ == '__main__':
 db.create_all()
 app.run(debug=True)

首頁