快捷導航

Python WSGI 規(guī)范簡介

更新時間：2021年04月09日 14:49:09 作者：江湖十年

這篇文章主要介紹了Python WSGI 規(guī)范的相關(guān)資料，幫助大家更好的理解和學習使用python，感興趣的朋友可以了解下

WSGI 全拼 Web Server Gateway Interface，是為 Python 語言定義的 Web 服務(wù)器和 Web 應用程序（或框架）之間的一種通用編程接口。翻譯成白話就是說 WSGI 是一個協(xié)議，就像 HTTP 協(xié)議定義了客戶端和服務(wù)端數(shù)據(jù)傳輸?shù)囊?guī)范，WSGI 協(xié)議定義了 Web 服務(wù)器和 Web 應用程序之間協(xié)同工作的規(guī)范。

Python Web 應用部署方案

Flask 或 Django 等 Web 框架都提供了內(nèi)置的 Web Server，本地開發(fā)階段可以使用 flask run 或 python manage.py runserver 來分別啟動 Flask 或 Django 內(nèi)置的 Server。

在生產(chǎn)環(huán)境部署應用時，通常不會使用框架內(nèi)置的 Server，而是使用 Gunicorn 或 uWSGI 來部署，以獲得更好的性能。部署過 Python Web 應用的同學應該對如下部署架構(gòu)有所了解，左側(cè)是瀏覽器，右側(cè)是服務(wù)器。在服務(wù)器內(nèi)部，首先通過 Nginx 來監(jiān)聽 80/443 端口，當接收到來自客戶端的請求時，Nginx 會將請求轉(zhuǎn)發(fā)到監(jiān)聽 5000 端口的 Gunicorn/uWSGI Server，接著請求會通過 WSGI 協(xié)議被傳遞到 Flask/Django 框架，在框架內(nèi)部處理請求邏輯后，會將響應信息按照原路返回。

你可能會問，Nginx 性能很高，為什么不將應用直接部署到 Nginx 上，而是中間通過 Gunicorn/uWSGI 做一層轉(zhuǎn)發(fā)呢？因為 Nginx 沒有遵循 WSGI 規(guī)范，并不能像 Gunicorn/uWSGI 這樣很容易的與 Flask/Django 框架結(jié)合起來。

WSGI 規(guī)范

根據(jù) Python Web 應用部署架構(gòu)，我們知道了 WSGI 所處的位置，接下來看下 WSGI 規(guī)范具體定義了哪些內(nèi)容。

如同 HTTP 協(xié)議有一個客戶端和一個服務(wù)端，WSGI 協(xié)議有一個 Application 端和一個 Server 端，其中 Application 就是指 Flask、Django 這些 Web 框架，而 Server 就是指 Gunicorn、uWSGI 等 Web 服務(wù)器。

WSGI 協(xié)議規(guī)定 Application 端需要實現(xiàn)成一個可調(diào)用對象（函數(shù)、類等），其接口如下：

def simple_app(environ, start_response):
    status = '200 OK'
    response_headers = [('Content-type', 'text/plain')]
    start_response(status, response_headers)
    return ['Hello world!\n']

simple_app 就是一個最簡單的 Application，它需要接收兩個參數(shù)，environ 是一個 dict，其中保存了所有 HTTP 請求相關(guān)的信息，由 Server 端提供，start_response 是一個可調(diào)用對象，同樣由 Server 端提供，simple_app內(nèi)部需要調(diào)用一次 start_response，并將狀態(tài)碼和響應頭當作參數(shù)傳遞給它，simple_app 最終會返回一個可迭代對象作為 HTTP Body 內(nèi)容返回給客戶端。

我們已經(jīng)知道了 Application 端接口，接下來看下一個符合 WSGI 協(xié)議的 Server 端實現(xiàn)：

import os


def wsgi_server(application):
    environ = dict(os.environ.items())

    def start_response(status, response_headers):
        print(f'status: {status}')
        print(f'response_headers: {response_headers}')

    result = application(environ, start_response)
    for data in result:
        print(f'response_body: {data}')

示例中 Server 端同樣使用函數(shù)來實現(xiàn)，wsgi_server 接收一個 application 作為參數(shù)，在其內(nèi)部構(gòu)造了 environ 和 start_response 兩個對象，這里使用環(huán)境變量信息來模擬 HTTP 請求信息構(gòu)造 environ 字典，start_response 同樣被定義為一個函數(shù)，供 application 在內(nèi)部對其進行調(diào)用，wsgi_server 函數(shù)最后會調(diào)用 application 并對其進行打印。

現(xiàn)在有了 Application 端和 Server 端，我們可以來測試一下這個簡單的 WSGI 程序示例。只需要將 simple_app 作為參數(shù)傳遞給 wsgi_server 并調(diào)用 wsgi_server 即可：

wsgi_server(simple_app)

執(zhí)行以上代碼，將得到如下打?。?/p>

status: 200 OK
response_headers: [('Content-type', 'text/plain')]
response_body: Hello world!

以上，我們分別實現(xiàn)了符合 WSGI 規(guī)范的 Application 端和 Server 端，雖然程序看起來比較簡陋，但不論多么復雜的 Python Web 框架和 Server 都同樣遵循此規(guī)范。

WSGI 實際應用

學習了 WSGI 規(guī)范，我們可以來驗證下平時使用的 Python Web 框架是否真的遵循此規(guī)范，這里以 Flask 框架源碼為例，可以在 https://github.com/pallets/flask/blob/master/src/flask/app.py 查看 Flask 的定義：

class Flask(Scaffold):
    ...

    def __call__(self, environ, start_response):
        """The WSGI server calls the Flask application object as the
        WSGI application. This calls :meth:`wsgi_app`, which can be
        wrapped to apply middleware.
        """
        return self.wsgi_app(environ, start_response)

Flask 類內(nèi)部通過實現(xiàn) __call__ 方法，使得 Flask 實例對象成為一個可調(diào)用對象，其接口實現(xiàn)同樣符合 WSGI Application 規(guī)范。

以上就是Python WSGI 規(guī)范簡介的詳細內(nèi)容，更多關(guān)于Python WSGI 規(guī)范的資料請關(guān)注腳本之家其它相關(guān)文章！

您可能感興趣的文章: