WSGI的理解

Python web開發中，服務端程式可分為2個部分：

伺服器程式（用來接收、整理用戶端發送的請求）

應用程式（處理伺服器程式傳遞過來的請求）
在開發應用程式的時候，我們會把常用的功能封裝起來，成為各種架構，比如Flask，Django，Tornado（使用某架構進行web開發，相當於開發服務端的應用程式，處理後台邏輯）
但是，伺服器程式和應用程式互相配合才能給使用者提供服務，而不同應用程式（不同架構）會有不同的函數、功能。 此時，我們就需要一個標準，讓伺服器程式和應用程式都支援這個標準，那麼，二者就能很好的配合了

WSGI：wsgi是python web開發的標準，類似於協議。它是伺服器程式和應用程式的一個約定，規定了各自使用的介面和功能，以便二和互相配合

WSGI應用程式的部分規定

應用程式是一個可調用的對象
可調用的對象有三種：

一個函數

一個類，必須實現__call__()方法

一個類的執行個體

這個對象接收兩個參數
從源碼中，我們可以看到，這兩個參數是environ, start_response. 以可調用對象為一個類為例：

class application:
def __call__(self, environ, start_response):
pass

可調用對象需要返回一個可迭代的值。以可調用對象為一個類為例：

class application:
def __call__(self, environ, start_response):
return [xxx]

WSGI伺服器程式的部分規定

伺服器程式需要調用應用程式

def run(application): #伺服器程式調用應用程式
environ = {} #設定參數

def start_response(xxx): #設定參數
pass
result = application(environ, start_response) #調用應用程式的__call__函數（這裡應用程式是一個類）
def write(data):
pass
def data in result: #迭代訪問
write(data)
伺服器程式主要做了以下的事：
1. 設定應用程式所需要的參數
2. 調用應用程式
3. 迭代訪問應用程式的返回結果，並傳給用戶端

Middleware

middleware是介於伺服器程式和應用程式中間的部分，middleware對伺服器程式和應用程式是透明的。

對於伺服器程式來說，middleware就是應用程式，middleware需要偽裝成應用程式，傳遞給伺服器程式
對於應用程式來說，middleware就是伺服器程式，middleware需要偽裝成伺服器程式，接受並調用應用程式

伺服器程式擷取到了用戶端請求的URL，需要把URL交給不同的函數處理，這個功能可以使用middleware實現：

# URL Routing middleware
def urlrouting(url_app_mapping):
def midware_app(environ, start_response): #函數可調用，包含2個參數，返回可迭代的值
url = environ['PATH_INFO']
app = url_app_mapping[url] #獲得對應url的應用程式
result = app(environ, start_response) #調用應用程式
return result
return midware_app

函數midware_app就是middleware：
一方面，midware_app函數設定了應用程式所需要的變數，並調用了應用程式。所以對於應用程式來說，它是一個伺服器程式
另一方面，midware_app函數是一個可調用的對象，接收兩個參數，同時可調用對象返回了一個可迭代的值。所以對於伺服器程式來說，它是一個應用程式

寫中介軟體（middleware）的邏輯：
1. middleware需要偽裝成應用程式—> WSGI應用程式的要求 —> 1. 可調用 2. 兩個參數 3. 返回可迭代的值
2. middleware需要偽裝成伺服器程式 —> WSGI伺服器程式的要求 —> 調用應用程式

我們需要瞭解一下environ這個變數。在WSGI中, 應用程式需要兩個參數:environ和start_response, 在伺服器程式調用應用程式之前, 需要先設定這兩個參數。 其中start_response通常是個可調用的方法, 而environ則是一個字典, 它是在CGI中定義的, 查看CGI文檔The Common Gateway Interface Specification, 可以找到關於environ的定義。
以下是environ中的參數：

AUTH_TYPE
CONTENT_LENGTH#HTTP請求中Content-Length的部分
CONTENT_TYPE#HTTP請求中Content-Tpye的部分
GATEWAY_INTERFACE
HTTP_*#包含一系列變數, 如HTTP_HOST,HTTP_ACCEPT等
PATH_INFO#URL路徑除了起始部分後的剩餘部分,用於找到相應的應用程式物件,如果請求的路徑就是根路徑,這個值為空白字串
PATH_TRANSLATED
QUERY_STRING#URL路徑中？後面的部分
REMOTE_ADDR
REMOTE_HOST
REMOTE_IDENT
REMOTE_USER
REQUEST_METHOD#HTTP 要求方法，例如 "GET", "POST"
SCRipT_NAME#URL路徑的起始部分對應的應用程式物件,如果應用程式物件對應伺服器的根,那麼這個值可以為空白字串
SERVER_NAME
SERVER_PORT
SERVER_PROTOCOL#用戶端請求的協議(HTTP/1.1 HTTP/1.0)
SERVER_SOFTWARE

舉例：http://localhost:5000/aaa?666, 變數值為：

REQUEST_METHOD=‘GET’
SCRIPT_NAME=''
SERVER_NAME='localhost'
SERVER_PORT=‘5000’
PATH_INFO='/aaa'
QUERY_STRING='666'
SERVER_PROTOCOL='HTTP/1.1'
CONTENT_TYPE='text/plain'
CONTEN_LENGTH=''

HTTP_HOST = 'localhost:8000'
HTTP_ACCEPT = 'text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8'
HTTP_ACCEPT_ENCODING = 'gzip,deflate,sdch'
HTTP_ACCEPT_LANGUAGE = 'en-US,en;q=0.8,zh;q=0.6,zh-CN;q=0.4,zh-TW;q=0.2'
HTTP_CONNECTION = 'keep-alive'
HTTP_USER_AGENT = 'Mozilla/5.0 (X11; linux i686) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/32.0.1700.77 Safari/537.36'

對於start_response()函數：
start_response是HTTP響應的開始, 它的形式為:start_response(status, response_headers, exc_info=None)
status表示HTTP狀態代碼, 比如200 OK
response_headers是一個列表，列表元素是個tuple:(header_name, header_value)
exc_info是個選擇性參數, 當處理請求的過程中發生錯誤時, 會設定該參數, 同時會調用start_response
舉一個werkzeug官方文檔上的例子，我稍作改進，以進行分析(這段建議看完wsgi.py第二部分的SharedDataMiddleware類再看)：

class Shortly(object):

def __init__(self, config):
self.redis = redis.Redis(config['redis_host'], config['redis_port'])

def dispatch_request(self, request):
return Response('Hello World!') #初始化Response類

def wsgi_app(self, environ, start_response):
request = Request(environ)
response = self.dispatch_request(request) #response的類型為Response類
print('%%%%%%%%%%%%%%%%%%%%%%%%%%%')
return response(environ, start_response) #Response的__call__函數就是應用程式，返回迭代對象

def __call__(self, environ, start_response):
print(self.wsgi_app)
print('erghrgheoghegoierge')
return self. wsgi_app(environ, start_response)


def create_app(redis_host='localhost', redis_port=6379, with_static=True):
app = Shortly({
'redis_host': redis_host,
'redis_port': redis_port
})
if with_static:
print('yes')
app.wsgi_app = SharedDataMiddleware(app.wsgi_app, {
'/static': os.path.join(os.path.dirname(__file__), 'static')
})
print('33333333333333333')
return app
#開啟本機伺服器
if __name__ == '__main__':
from werkzeug.serving import run_simple
app = create_app() #建立應用程式的執行個體
run_simple('127.0.0.1', 5000, app, use_debugger=True, use_reloader=True)

我們查看Response的源碼(Response繼承了BaseResponse，查看BaseResponse的源碼即可)可以知道：函數dispatch_request()返回的值是Request的建構函式，即返回了一個Response類, 在函數wsgi_app()中，request的值的類型就是Response, 所以wsgi_app()的傳回值response(environ, start_response)實際上是調用了Response類的__call__()函數。
看了源碼我們可以發現，__call__()是一個WSGI的應用程式！

當運行這個程式的時候：

22222222222222222
yes
33333333333333333
* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
* Restarting with stat
22222222222222222
yes
33333333333333333

我們先不糾結為什麼讀取了2次。
當我們開啟這個網頁，控制台的輸出為：

<werkzeug.wsgi.SharedDataMiddleware object at 0x1007be7b8> #說明wsgi_app是SharedDataMiddleware的執行個體！
erghrgheoghegoierge
%%%%%%%%%%%%%%%%%%%%%%%%%%%#說明執行了原wsgi_app函數中的內容！
127.0.0.1 - - [22/May/2015 21:01:25] "GET / HTTP/1.1" 200 -

可以注意到，在本例中，app.wsgi_app這個方法已經變成了一個SharedDataMiddleware類的執行個體，我很好奇當伺服器把environ和start_response傳遞給app後，為什麼wsgi_pp還會執行原wsgi_app中的內容呢？
當我們訪問主機地址的時候，伺服器程式接受使用者請求，然後會把environ和start_response傳遞給應用程式app,app會執行__call__函數，在該函數中，會執行app.wsgi_app這個函數。 然後wsgi_app會執行ShareDataMiddleware的__call__()函數
這地方需要我們看SharedDataMiddleware類的__call__()的源碼。看了源碼我們可以發現，由於使用者沒有請求靜態檔案，所以會執行return self.app(environ, start_response)，在本例中，我們可以看到在create_app()中，我們定義的ShareDataMiddleware的應用程式是app.wsgi_app，所以這裡返回的是原wsgi_app函數！所以當然會執行原函數了~
同時，我們也可以在static檔案夾中放一個檔案，然後訪問試一下：127.0.0.1/static/檔案名稱，此時就能看到那個檔案了！
通過本例，我們可以更深刻的瞭解Middleware的作用：

Middleware介於伺服器程式和應用程式之間，它會接收伺服器發來的訊息(environ和
start_response)，並做一定的處理，然後把需要應用程式處理的部分傳遞給應用程式處理

另外, 伺服器程式還需要定義WSGI的相關變數：

wsgi.version
值的形式為 (1, 0) 表示 WSGI 版本 1.0
wsgi.url_scheme
表示 url 的模式，例如 "https" 還是 "http"
wsgi.input
輸入資料流，HTTP請求的 body 部分可以從這裡讀取
wsgi.erros
輸出資料流，如果出現錯誤，可以寫往這裡
wsgi.multithread
如果應用程式物件可以被同一進程中的另一線程同時調用，這個值為True
wsgi.multiprocess
如果應用程式物件可以同時被另一個進程調用，這個值為True
wsgi.run_once
如果伺服器希望應用程式物件在包含它的進程中只被調用一次，那麼這個值為True

以上就是WSGI的理解的內容，更多相關文章請關注topic.alibabacloud.com（www.php.cn）！

