本文参考了:
- Wikipedia : Web Server Gateway Interface
- WSGI: The Server-Application Interface for Python
- wsgi.tutorial.codepoint.net/intro
- flask 源码解析:应用启动流程
想要理解wsgi,首先得区分一个概念:server 和 app。
此图来源于: www.toptal.com/python/pyth…
uwsgi、gunicorn是 server,我们写的 django、flask、sanic 程序是 app。app 就是一个可被调用的对象(callable object),server 会解析请求数据传给 app,app 运行业务逻辑之后,把结果返回给 server。
现实生活中,我们部署的时候,可能还会在 server 前面加上一个 nginx,所以整个流程简单来说是这样的:
app 可嵌套 -> 中间件
app 是一个可调用对象,这意味着我可以在 app1里面调用 app2,app2里面再调用 app3,这样一层一层嵌套下去。这不就是 middleware 吗?
如果你看过 django middleware 的源码,会看到 MiddlewareMixin
这个类:
class MiddlewareMixin: def __init__(self, get_response=None): self.get_response = get_response super().__init__() def __call__(self, request): response = None if hasattr(self, 'process_request'): response = self.process_request(request) response = response or self.get_response(request) if hasattr(self, 'process_response'): response = self.process_response(request, response) return response 复制代码
定义了一个 __call__
方法,它是一个可调用对象。
你在 django 配置文件中定义的:
MIDDLEWARE = [ 'django.middleware.security.SecurityMiddleware', 'django.contrib.sessions.middleware.SessionMiddleware', 'django.middleware.common.CommonMiddleware', 'django.middleware.csrf.CsrfViewMiddleware', 'django.contrib.auth.middleware.AuthenticationMiddleware', 'django.contrib.messages.middleware.MessageMiddleware', 'django.middleware.clickjacking.XFrameOptionsMiddleware', ] 复制代码
运行的时候,就是这样一个一个地调用 middleware,直到调用到你的业务逻辑代码(最终的 app 部分)。
后面会再详细讲讲中间件开发。
app向server暴露的接口
app 是一个可调用的对象,它需要接收一些参数,具体如下:
def app(environ,start_response): pass 复制代码
具体看一下这两个参数:
- environ,就是一个保护请求信息的字典。
比如 server 收到 GET http://localhost:8000/auth?user=obiwan&token=123
这条请求后,会生成下面这样一个 environ 字典:
这里面包含了此次请求的所有必要信息,通过这个字典,app就能知道这次请求的 path 是 /auth
,于是就知道该调用哪个 handler 函数。还能通过 HTTP_COOKIE知道 cookie 值,然后可以定位到具体的用户。
- start_response(status, headers,errors)
Server 传给 app 的回调函数,返回数据给 server 之前需要先调用这个回调函数,通知 server 你该来获取返回数据了。
听说这个参数实已经快有被废弃了,不需要完全了解。下图来源于: WSGI: The Server-Application Interface for Python 底部评论区。