WSGI協議

首先弄清下面幾個概念：
WSGI：全稱是Web Server Gateway Interface，WSGI不是伺服器，python模組，框架，API或者任何軟體，只是一種規範，描述web server如何與web application通訊的規範。server和application的規範在PEP 3333中有具體描述。要實現WSGI協議，必須同時實現web server和web application，當前執行在WSGI協議之上的web框架有Bottle, Flask, Django。
uwsgi：與WSGI一樣是一種通訊協議，是uWSGI伺服器的獨佔協議，用於定義傳輸資訊的型別(type of information

WSGI協議主要包括server和application兩部分：

• WSGI server負責從客戶端接收請求，將request轉發給application，將application返回的response返回給客戶端；
• WSGI application接收由server轉發的request，處理請求，並將處理結果返回給server。application中可以包括多個棧式的中介軟體(middlewares
  )，這些中介軟體需要同時實現server與application，因此可以在WSGI伺服器與WSGI應用之間起調節作用：對伺服器來說，中介軟體扮演應用程式，對應用程式來說，中介軟體扮演伺服器。

WSGI協議其實是定義了一種server與application解耦的規範，即可以有多個實現WSGI server的伺服器，也可以有多個實現WSGI application的框架，那麼就可以選擇任意的server和application組合實現自己的web應用。例如uWSGI和Gunicorn都是實現了WSGI server協議的伺服器，Django，Flask是實現了WSGI application協議的web

wsgi.png-22.9kB

像Django，Flask框架都有自己實現的簡單的WSGI server，一般用於伺服器除錯，生產環境下建議用其他WSGI server。

WSGI協議的實現

以Django為例，分析一下WSGI協議的具體實現過程。

django WSGI application

WSGI application應該實現為一個可呼叫物件，例如函式、方法、類(包含`call`方法)。需要接收兩個引數：

• 一個字典，該字典可以包含了客戶端請求的資訊以及其他資訊，可以認為是請求上下文，一般叫做environment（編碼中多簡寫為environ、env）
• 一個用於傳送HTTP響應狀態（HTTP status ）、響應頭（HTTP headers）的回撥函式

通過回撥函式將響應狀態和響應頭返回給server，同時返回響應正文(response body)，響應正文是可迭代的、幷包含了多個字串。下面是Django中application的具體實現部分：

class WSGIHandler(base.BaseHandler):
    initLock = Lock()
    request_class = WSGIRequest

    def __call__(self, environ, start_response):
        # 載入中介軟體
        if self._request_middleware is None:
            with self.initLock:
                try:
                    # Check that middleware is still uninitialized.
                    if self._request_middleware is None:
                        self.load_middleware()
                except:
                    # Unload whatever middleware we got
                    self._request_middleware = None
                    raise

        set_script_prefix(get_script_name(environ))
        # 請求處理之前傳送訊號
        signals.request_started.send(sender=self.__class__, environ=environ)
        try:
            request = self.request_class(environ)
        except UnicodeDecodeError:
            logger.warning('Bad Request (UnicodeDecodeError)',
                exc_info=sys.exc_info(),
                extra={'status_code': 400,})
            response = http.HttpResponseBadRequest()
        else:
            response = self.get_response(request)

        response._handler_class = self.__class__

        status = '%s %s' % (response.status_code, response.reason_phrase)
        response_headers = [(str(k), str(v)) for k, v in response.items()]
        for c in response.cookies.values():
            response_headers.append((str('Set-Cookie'), str(c.output(header=''))))
        # server提供的回撥方法，將響應的header和status返回給server
        start_response(force_str(status), response_headers)
        if getattr(response, 'file_to_stream', None) is not None and environ.get('wsgi.file_wrapper'):
            response = environ['wsgi.file_wrapper'](response.file_to_stream)
        return response

可以看出application的流程包括:

• 載入所有中介軟體，以及執行框架相關的操作，設定當前執行緒指令碼字首，傳送請求開始訊號；
• 處理請求，呼叫get_response()方法處理當前請求，該方法的的主要邏輯是通過urlconf找到對應的view和callback，按順序執行各種middleware和callback。
• 呼叫由server傳入的start_response()方法將響應header與status返回給server。
• 返回響應正文

django WSGI Server

負責獲取http請求，將請求傳遞給WSGI application，由application處理請求後返回response。以Django內建server為例看一下具體實現。
通過runserver執行django專案，在啟動時都會呼叫下面的run方法，建立一個WSGIServer的例項，之後再呼叫其serve_forever()方法啟動服務。

def run(addr, port, wsgi_handler, ipv6=False, threading=False):
    server_address = (addr, port)
    if threading:
        httpd_cls = type(str('WSGIServer'), (socketserver.ThreadingMixIn, WSGIServer), {})
    else:
        httpd_cls = WSGIServer
    # 這裡的wsgi_handler就是WSGIApplication
    httpd = httpd_cls(server_address, WSGIRequestHandler, ipv6=ipv6)
    if threading:
        httpd.daemon_threads = True
    httpd.set_app(wsgi_handler)
    httpd.serve_forever()

下面表示WSGI server伺服器處理流程中關鍵的類和方法。

• WSGIServer
  run()方法會建立WSGIServer例項，主要作用是接收客戶端請求，將請求傳遞給application，然後將application返回的response返回給客戶端。
  • 建立例項時會指定HTTP請求的handler：WSGIRequestHandler類
  • 通過set_app和get_app方法設定和獲取WSGIApplication例項wsgi_handler
  • 處理http請求時，呼叫handler_request方法，會建立WSGIRequestHandler例項處理http請求。
  • WSGIServer中get_request方法通過socket接受請求資料
• WSGIRequestHandler
  • 由WSGIServer在呼叫handle_request時建立例項，傳入request、cient_address、WSGIServer三個引數，__init__方法在例項化同時還會呼叫自身的handle方法
  • handle方法會建立ServerHandler例項，然後呼叫其run方法處理請求
• ServerHandler
  • WSGIRequestHandler在其handle方法中呼叫run方法，傳入self.server.get_app()引數，獲取WSGIApplication，然後呼叫例項(__call__)，獲取response，其中會傳入start_response回撥，用來處理返回的header和status。
  • 通過application獲取response以後，通過finish_response返回response
• WSGIHandler
  • WSGI協議中的application，接收兩個引數，environ字典包含了客戶端請求的資訊以及其他資訊，可以認為是請求上下文，start_response用於傳送返回status和header的回撥函式

雖然上面一個WSGI server涉及到多個類實現以及相互引用，但其實原理還是呼叫WSGIHandler，傳入請求引數以及回撥方法start_response()，並將響應返回給客戶端。

django simple_server

django的simple_server.py模組實現了一個簡單的HTTP伺服器，並給出了一個簡單的demo，可以直接執行，執行結果會將請求中涉及到的環境變數在瀏覽器中展示出來。
其中包括上述描述的整個http請求的所有元件:
ServerHandler, WSGIServer, WSGIRequestHandler，以及demo_app表示的簡易版的WSGIApplication。
可以看一下整個流程：

if __name__ == '__main__':
    # 通過make_server方法建立WSGIServer例項
    # 傳入建議application，demo_app
    httpd = make_server('', 8000, demo_app)
    sa = httpd.socket.getsockname()
    print("Serving HTTP on", sa[0], "port", sa[1], "...")
    import webbrowser
    webbrowser.open('http://localhost:8000/xyz?abc')
    # 呼叫WSGIServer的handle_request方法處理http請求
    httpd.handle_request()  # serve one request, then exit
    httpd.server_close()
    
def make_server(
    host, port, app, server_class=WSGIServer, handler_class=WSGIRequestHandler
):
    """Create a new WSGI server listening on `host` and `port` for `app`"""
    server = server_class((host, port), handler_class)
    server.set_app(app)
    return server

# demo_app可呼叫物件，接受請求輸出結果
def demo_app(environ,start_response):
    from io import StringIO
    stdout = StringIO()
    print("Hello world!", file=stdout)
    print(file=stdout)
    h = sorted(environ.items())
    for k,v in h:
        print(k,'=',repr(v), file=stdout)
    start_response("200 OK", [('Content-Type','text/plain; charset=utf-8')])
    return [stdout.getvalue().encode("utf-8")]

demo_app()表示一個簡單的WSGI application實現，通過make_server()方法建立一個WSGIServer例項，呼叫其handle_request()方法，該方法會呼叫demo_app()處理請求，並最終返回響應。

uWSGI

uWSGI旨在為部署分散式叢集的網路應用開發一套完整的解決方案。主要面向web及其標準服務。由於其可擴充套件性，能夠被無限制的擴充套件用來支援更多平臺和語言。uWSGI是一個web伺服器，實現了WSGI協議，uwsgi協議，http協議等。
uWSGI的主要特點是：

• 超快的效能
• 低記憶體佔用
• 多app管理
• 詳盡的日誌功能（可以用來分析app的效能和瓶頸）
• 高度可定製（記憶體大小限制，服務一定次數後重啟等）

uWSGI伺服器自己實現了基於uwsgi協議的server部分，我們只需要在uwsgi的配置檔案中指定application的地址，uWSGI就能直接和應用框架中的WSGI application通訊。

作者：rainybowe
連結：https://www.jianshu.com/p/679dee0a4193
來源：簡書
簡書著作權歸作者所有，任何形式的轉載都請聯絡作者獲得授權並註明出處。