from flask import Flask
app = Flask(__name__)

傳入構(gòu)造方法的第一個參數(shù)是模塊或包的名稱，我們應(yīng)該使用特殊變量 __name__ 。Python 會根據(jù)所處的模塊來賦予 name 變量相應(yīng)的值，對于我們的程序來說（app.py），這個值為 app 。除此之外，這也會幫助 Flask 在相應(yīng)的文件夾里找到需要的資源，比如模板和靜態(tài)文件。

@app.route("/")
def hello():
    return "
hello flask
"

在一個 Web 應(yīng)用里，客戶端和服務(wù)器上的 Flask 程序的交互可以簡單概括為以下幾步：

用戶在瀏覽器輸入 URL 訪問某個資源。

Flask 接收用戶請求并分析請求的 URL。

為這個 URL 找到對應(yīng)的處理函數(shù)。

執(zhí)行函數(shù)并生成響應(yīng)，返回給瀏覽器。

瀏覽器接收并解析響應(yīng)，將信息顯示在頁面中。

在上面這些步驟中，大部分都由 Flask 完成，我們要做的只是建立處理請求的函數(shù)，并為其定義對應(yīng)的 URL 規(guī)則。只需為函數(shù)附加 app.route() 裝飾器，并傳入 URL 規(guī)則作為參數(shù)，我們就可以讓 URL 與函數(shù)建立關(guān)聯(lián)。這個過程我們稱為注冊路由 (route)，路由負責管理 URL 和函數(shù)之間的映射，而這個函數(shù)則被稱為視圖函數(shù) (view function)。route() 裝飾器的第一個參數(shù)是 URL 規(guī)則，用字符串表示，必須以斜杠（/）開始。這里的 URL 是相對 URL（又稱為內(nèi)部 URL ），即不包含域名的 URL。

一個視圖函數(shù)可以綁定多個 URL，比如下面的代碼把 /hi 和 /hello 都綁定到 say_hello() 函數(shù)上，這就會為 say_hello 視圖注冊兩個路由，用戶訪問這兩個 URL 均會觸發(fā) say_hello() 函數(shù)，獲得相同的響應(yīng)。

@app.route("/")
@app.route("/hello")
def index():
    return "hello world"

在 URL 規(guī)則中添加變量部分，使用“<變量名>”的形式表示。Flask 處理請求時會把變量傳入視圖函數(shù)，所以我們可以添加參數(shù)獲取這個變量值。

@app.route("/greet/")
def index(name)：
    return "hello,{}".format(name)

因為 URL 中可以包含變量，所以我們將傳入 app.route() 的字符串稱為 URL 規(guī)則，而不是 URL。Flask 會解析請求并把請求的URL與視圖函數(shù)的URL規(guī)則進行匹配。比如，這個 index 視圖的 URL 規(guī)則為 "/greet/"，那么類似 /greet/foo、/greet/bar 的請求都會觸發(fā)這個視圖函數(shù)。還可以設(shè)置默認值，這樣即使不輸入 name 的值訪問也不會 404

Flask 內(nèi)置了一個簡單的開發(fā)服務(wù)器（由依賴包 Werkzeug 提供）， 足夠在開發(fā)和測試階段使用。Flask 通過依賴包 Click 內(nèi)置了一個 CLI（Command Line Interface，命令行交互界面）系統(tǒng)。當我們安裝 Flask 后，會自動添加一個 flask 命令腳本，我們可以通過 flask 命令執(zhí)行內(nèi)置命令、擴展提供的命令或是我們自己定義的命令。其中，flask run 命令用來啟動內(nèi)置的開發(fā)服務(wù)器。

pipenv run flask run

一般來說，在執(zhí)行 flask run 命令運行程序前，我們需要提供程序?qū)嵗谀K的位置。我們在上面可以直接運行程序，是因為 Flask 會自動探測程序?qū)嵗詣犹綔y存在下面這些規(guī)則：

從當前目錄尋找 app.py 和 wsgi.py 模塊，并從中尋找名為 app 或 application 的程序?qū)嵗?/p>

從環(huán)境變量 FLASK_APP 對應(yīng)的值尋找名為 app 或 application 的程序?qū)嵗?/p>

因為我們的程序主模塊命名為 app.py，所以 flask run 命令會自動在其中尋找程序?qū)嵗Ｈ绻愕某绦蛑髂K是其他名稱，比如 hello.py，那么需要設(shè)置環(huán)境變量 FLASK_APP，將包含程序?qū)嵗哪K名賦值給這個變量。Linux 或 macOS 系統(tǒng)使用 export 命令：

export FLASK_APP=hello

Flask的自動發(fā)現(xiàn)程序?qū)嵗龣C制還有第三條規(guī)則：如果安裝了 python-dotenv，那么在使用 flask run 或其他命令時會使用它自動從 .flaskenv 文件和 .env 文件中加載環(huán)境變量。當安裝了 python-dotenv 時，F(xiàn)lask 在加載環(huán)境變量的優(yōu)先級是：
手動設(shè)置的環(huán)境變量>.env 中設(shè)置的環(huán)境變量>.flaskenv 設(shè)置的環(huán)境變量。
除了 FLASK_APP，在后面我們還會用到其他環(huán)境變量。環(huán)境變量在新創(chuàng)建命令行窗口或重啟電腦后就清除了，每次都要重設(shè)變量有些麻煩。而且如果你同時開發(fā)多個 Flask 程序，這個 FLASK_APP 就需要在不同的值之間切換。為了避免頻繁設(shè)置環(huán)境變量，我們可以使用 python-dotenv 管理項目的環(huán)境變量，首先使用 Pipenv 將它安裝到虛擬環(huán)境：

pipenv install python-dotenv

我們在項目根目錄下分別創(chuàng)建兩個文件：.env 和 .flaskenv。.flaskenv 用來存儲和 Flask 相關(guān)的公開環(huán)境變量，比如 FLASK_APP；而 .env 用來存儲包含敏感信息的環(huán)境變量，比如后面我們會用來配置 Email 服務(wù)器的賬戶名與密碼。在 .flaskenv 或 .env 文件中，環(huán)境變量使用鍵值對的形式定義，每行一個，以#開頭的為注釋。.env 包含敏感信息，除非是私有項目，否則絕對不能提交到 Git 倉庫中。當你開發(fā)一個新項目時，記得把它的名稱添加到 .gitignore 文件中， 這會告訴 Git 忽略這個文件。gitignore 文件是一個名為 .gitignore 的文本文件，它存儲了項目中 Git 提交時的忽略文件規(guī)則清單。Python項目的.gitignore模板

在上面啟動的 Web 服務(wù)器默認是對外不可見的，可以在 run 命令后添加 --host 選項將主機地址設(shè)為 0.0.0.0 使其對外可見

flask run --host=0.0.0.0

ngrok

Localtunnel

Flask 提供的 Web 服務(wù)器默認監(jiān)聽 5000 端口，你可以在啟動時傳入?yún)?shù)來改變它

flask run --port=8000

執(zhí)行 flask run 命令時的 host 和 port 選項也可以通過環(huán)境變量 FLASK_RUN_HOST 和 FLASK_RUN_PORT 設(shè)置。事實上，F(xiàn)lask 內(nèi)置的命令都可以使用這種模式定義默認選項值，即 “FLASK__”，你可以使用 flask--help 命令查看所有可用的命令。

開發(fā)環(huán)境（development enviroment）和生產(chǎn)環(huán)境（production enviroment）是我們會頻繁接觸到的概念。
開發(fā)環(huán)境是指我們在本地編寫和測試程序時的計算機環(huán)境，
而生產(chǎn)環(huán)境與開發(fā)環(huán)境相對，它指的是網(wǎng)站部署上線供用戶訪問時的服務(wù)器環(huán)境。
根據(jù)運行環(huán)境的不同，F(xiàn)lask 程序、擴展以及其他程序會改變相應(yīng)的行為和設(shè)置。為了區(qū)分程序運行環(huán)境，F(xiàn)lask 提供了一個 FLASK_ENV 環(huán)境變量用來設(shè)置環(huán)境，默認為 production 。在開發(fā)時，我們可以將其設(shè)為 development ，這會開啟所有支持開發(fā)的特性。為了方便管理，我們將把環(huán)境變量 FLASK_ENV 的值寫入 .flaskenv 文件中:

FLASK_ENV=development

在開發(fā)環(huán)境下，調(diào)試模式（Debug Mode）將被開啟，這時執(zhí)行 flask run 啟動程序會自動激活 Werkzeug 內(nèi)置的調(diào)試器（debugger）和重載器（reloader），它們會為開發(fā)帶來很大的幫助。如果你想多帶帶控制調(diào)試模式的開關(guān)，可以通過 FLASK_DEBUG 環(huán)境變量設(shè)置，設(shè)為 1 則開啟，設(shè)為 0 則關(guān)閉，不過通常不推薦手動設(shè)置這個值。
在生產(chǎn)環(huán)境中部署程序時，絕不能開啟調(diào)試模式。盡管 PIN 碼可以避免用戶任意執(zhí)行代碼，提高攻擊者利用調(diào)試器的難度，但并不能確保調(diào)試器完全安全，會帶來巨大的安全隱患。而且攻擊者可能會通過調(diào)試信息獲取你的數(shù)據(jù)庫結(jié)構(gòu)等容易帶來安全問題的信息。另一方面，調(diào)試界面顯示的錯誤信息也會讓普通用戶感到困惑。
當在一個新電腦創(chuàng)建運行環(huán)境時，使用 pipenv install 命令時需要添加額外的 --dev 選項才會安裝 dev-packages 部分定義的開發(fā)依賴包。

在Flask中，配置變量就是一些大寫形式的 Python 變量，你也可以稱之為配置參數(shù)或配置鍵。使用統(tǒng)一的配置變量可以避免在程序中以硬編碼（hard coded）的形式設(shè)置程序。在一個項目中，你會用到許多配置：Flask 提供的配置，擴展提供的配置，還有程序特定的配置。和平時使用變量不同，這些配置變量都通過 Flask 對象的 app.config 屬性作為統(tǒng)一的接口來設(shè)置和獲取，它指向的 Config 類實際上是字典的子類，所以你可以像操作其他字典一樣操作它。

app.config["ADMIN_NAME"]="Eric"

配置的名稱必須是全大寫形式，小寫的變量將不會被讀取。使用 update() 方法則可以一次加載多個值：

app.config.update(
    TESTING1=True
    TESTING2=flase
)

和操作字典一樣，讀取一個配置就是從config字典里通過將配置變量的名稱作為鍵讀取對應(yīng)的值：

value = app.config["ADMIN_NAME"]

在 Web 程序中，URL 無處不在。如果程序中的 URL 都是以硬編碼的方式寫出，那么將會大大降低代碼的易用性。比如，當你修改了某個路由的URL 規(guī)則，那么程序里對應(yīng)的 URL 都要一個一個進行修改。更好的解決辦法是使用 Flask 提供的 url_for() 函數(shù)獲取 URL，當路由中定義的 URL 規(guī)則被修改時，這個函數(shù)總會返回正確的 URL。調(diào)用 url_for() 函數(shù)時，第一個參數(shù)為端點（endpoint）值。在 Flask 中，端點用來標記一個視圖函數(shù)以及對應(yīng)的 URL 規(guī)則。

@app.route("/")
def index():
    return "hello flask"

這個路由的端點即視圖函數(shù)的名稱 index，調(diào)用 url_for（"index"）即可獲取對應(yīng)的 URL，即“/”。
如果 URL 含有動態(tài)部分，那么我們需要在 url_for() 函數(shù)里傳入相應(yīng)的參數(shù)，以下面的視圖函數(shù)為例：

@app.route("/hello/")
def index(name)：
    return "hello {}".format(name)

這時使用 url_for（"say_hello"，name="Jack"）得到的 URL 為“/hello/Jack”。
我們使用 url_for（）函數(shù)生成的 URL 是相對 URL（即內(nèi)部URL）， 即URL中的path部分，比如“/hello”，不包含根URL。相對URL只能在程序內(nèi)部使用。如果你想要生成供外部使用的絕對 URL，可以在使用 url_for（）函數(shù)時，將 _external 參數(shù)設(shè)為 True，這會生成完整的 URL， 比如 http://helloflask.com/hello，在本地運行程序時則會獲得 http://localhost:5000/hello。

除了 Flask 內(nèi)置的 flask run 等命令，我們也可以自定義命令。在虛擬環(huán)境安裝 Flask 后，包含許多內(nèi)置命令的 flask 腳本就可以使用了。在前面我們已經(jīng)接觸了很多 flask 命令，比如運行服務(wù)器的 flask run，啟動 shell 的 flask shell。通過創(chuàng)建任意一個函數(shù)，并為其添加 app.cli.command() 裝飾器， 我們就可以注冊一個 flask 命令。hello() 命令函數(shù)，在函數(shù)中我們?nèi)匀恢皇谴蛴∫恍袉柡颉?/p>

@app.cli.command() 
def hello():
    click.echo("hello,flask")

函數(shù)的名稱即為命令名稱，這里注冊的命令即 hello，你可以使用 flask hello 命令來觸發(fā)函數(shù)。作為替代，你也可以在 app.cli.command() 裝飾器中傳入?yún)?shù)來設(shè)置命令名稱，比如 app.cli.command（"hello"）, 會把命令名稱設(shè)置為hello，完整的命令即flask hello。