啟動開發伺服器
Flask內建了一個簡單的開發伺服器(由依賴包Werkzeug提供),足夠 在開發和測試階段使用。
執行flaskFlask 透過依賴包 Click內建了一個CLI(Command Line Interface,命令列互動介面)系統。當我們安裝Flask後,會自動新增一個flask命令指令碼, 我們可以透過flask命令執行內建命令、擴充套件提供的命令或是我們自己定義 的命令。其中,flask run命令用來啟動內建的開發伺服器:
(helloflask) $ flask run * 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)
確保執行命令前激活了虛擬環境(pipenv shell),否則需要使用 pipenv run flask run命令啟動開發伺服器。後面將不再提示。
flask run命令執行的開發伺服器預設會監聽 http://127.0.0.1:5000/ 地址 (按Crtl+C退出),並開啟多執行緒⽀持。當我們開啟瀏覽器訪問這個地址時,會看到⽹頁上顯示“Hello,flask!”
localhost與127.0.0.1
http://127.0.0.1 即 localhost ,是指向本地機的IP地址,一般用來測試。Flask預設使用5000埠,上面的地址可以使 用http://localhost:5000/ 。除了地址不同外, 兩者沒有實際區別,即域名和IP地址的對映關係。最⼩的Flask程式from flask import Flask # ⑴app = Flask(__name__) # ⑵@app.route('/') # ⑶def index(): # ⑷ return 'Hello flask !' # ⑸if __name__ == '__main__': app.run() # ⑹
啟動服務之後,就可以在瀏覽器中訪問了。整個請求的處理過程如下所示:
當用戶在瀏覽器位址列訪問這個地址,在這裡即 http://127.0.0.1:5000/伺服器解析請求,發現請求 URL 匹配的 URL 規則是 /,因此呼叫對應的處理函式 hello()獲取 hello() 函式的返回值,處理後返回給客戶端(瀏覽器)瀏覽器接受響應,將其顯示在視窗上程式碼邏輯⑴ 首先我們從 flask 包匯入 Flask 類
from flask import Flask # ⑴
⑵ 透過例項化這個類,建立一個程式物件 app:
app = Flask(__name__) # ⑵
⑶ 使用 app.route() 裝飾器將函式繫結對應的 URL,當用戶在瀏覽器訪問這個 URL 的時候,就會觸發這個函式,獲取返回值,並把返回值顯示到瀏覽器視窗。
⑷ 裝飾器註冊的處理函式,這個函式是處理某個請求的處理函式,Flask 官方把它叫做檢視函式(view funciton)!你可以理解為 請求處理函式。
⑸ 返回響應內容
# 填入 app.route() 裝飾器的第一個引數是 URL 規則字串,這裡的 / 指的是根地址。@app.route('/') # ⑶def index(): # ⑷ return 'Hello flask !' # ⑸
⑹ Flask應用程式例項的 run 方法啟動 WEB 伺服器
if __name__ == '__main__': app.run() # ⑹
更多的啟動選項
使伺服器外部可見
我們在上面啟動的Web伺服器預設是對外不可見的,可以在run命令後 新增--host選項將主機地址設為0.0.0.0使其對外可見:
$ flask run --host=0.0.0.0
這會讓伺服器監聽所有外部請求。個人計算機(主機)一般沒有公⽹ IP(公有地址),所以你的程式只能被局域⽹內的其他使用者透過你的個人 計算機的內⽹IP(私有地址)訪問,比如你的內⽹IP為192.168.191.1。當局域⽹內的其他使用者訪問http://192.168.191.1:5000 時,也會看到瀏覽器裡 顯示一行“Hello,Flask!”。
改變預設埠
Flask提供的Web伺服器預設監聽5000埠,你可以在啟動時傳入引數來改變它:
$ flask run --port=8000
這時伺服器會監聽來自8000埠的請求,程式的主頁地址也相應變成 了http://localhost:8000/ 。
將引數儲存到檔案執行 flask run 命令時的 host 和 port 選項也可以透過環境變數 FLASK_RUN_HOST 和 FLASK_RUN_PORT 設定。事實上,Flask內建的命令都可以使用這種模式定義預設選項值, 即“FLASK_<COMMAND>_<OPTION>”
如果想不需要每次都指定,可以內容儲存到當前目錄下的 .flaskenv 或者是 .env 檔案中(需要安裝 python-dotenv )。
# 一些 flask 內建命令# 需要提前安裝 python-dotenv FLASK_ENV=development # 設定當前開發模式FLASK_RUN_PORT = 5050 # 設定執行的埠FLASK_RUN_HOST = 0.0.0.0 # 設定監聽的 ip
也可以使用 flask --help 命令檢視所有可用的命令。
設定執行環境開發環境(development enviroment)和生產環境(production enviroment)是我們後面會頻繁接觸到的概念。開發環境是指我們在本地 編寫和測試程式時的計算機環境,而生產環境與開發環境相對,它指的是 ⽹站部署上線供使用者訪問時的伺服器環境
根據執行環境的不同,Flask程式、擴充套件以及其他程式會改變相應的行 為和設定。為了區分程式執行環境,Flask提供了一個FLASK_ENV環境變 量用來設定環境,預設為 production(生產)。在開發時,我們可以將其設 為development(開發),這會開啟所有⽀持開發的特性。為了方便管理, 我們將把環境變數 FLASK_ENV 的值寫入 .flaskenv 檔案中:
FLASK_ENV=development
現在啟動程式,你會看到下面的輸出提示:
(helloflask) $ flask run * Environment: development * Debug mode: on * Restarting with stat * Debugger is active! * Debugger PIN: 161-372-375 * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
Python Shell本書有許多操作需要在Python Shell(即Python互動式直譯器)裡執 行。在開發Flask程式時,我們並不會直接使用python命令啟動Python Shell,而是使用flask shell命令:
(helloflask) $ flask shellPython 3.6.5 |Anaconda, Inc.| (default, Mar 29 2018, 13:32:41) [MSC v.1900 64 bit (AMD64)] on win32App: app [development]Instance: C:\Users\Administrator\Desktop\helloflask\instance>>>
和其他 flask 命令相同,執行這個命令前我們要確保程式例項可以被正常找到。
在本書中,如果程式碼⽚段前的提示符為三個大於號,即“>>>”,那麼就表示這些程式碼需要在使用flask shell命令開啟的Python Shell中執行。
使用flask shell命令開啟的Python Shell自動包含程式上下文,並且已經匯入了app例項:
>>> app<Flask 'app'>>>> app.name'app'>>>
上下文(context)可以理解為環境。為了正常執行程式,一些操作相關的狀態和資料需要被臨時儲存下來,這些狀態和資料被統稱為上下文。在Flask中,上下文有兩種,分別為程式上下文和請求上下文,後面我們會詳細瞭解。