【Python Web开发】05-WSGI概述
文章目录
- 1. 定义
- 1.1 什么是WSGI
- 2. 工作原理
- 3. WSGI使用
- 4. WSGI的优势
- 4.1 中间件
1. 定义
1.1 什么是WSGI
WSGI全称是Web Server Gateway Interface，即Web服务器网关接口。它是Python中定义的一种标准接口，主要用于解决Web服务器和Web应用程序之间的通信问题。
在Python的Web开发里，又各种各样的Web服务器（像Apache、Nginx、Gunicorn等）和Web应用框架（例如Flask、Django等）。不同服务器和框架可能采用不用的通信方式，这就使得他们之间的协作变得困难。WSGI就像一个“翻译官”，定义了一套统一的规则，让Web服务器和Web应用程序能够顺畅地“交流”。
2. 工作原理
WSGI定义了两个角色：服务器端和应用程序端
-
服务器端
Web服务器负责接收客户端（如浏览器）的请求，然后根据WSGI协议将请求信息传递给Web应用程序。服务器需要实现一个WSGI服务器接口，这个接口会调用Web应用程序提供的可调用对象（通常是一个函数或类） -
WSGI服务器作用
- 监听HTTP服务端口（TCPServer，默认端口80）
- 接收浏览器端的HTTP请求并解析封装成environ环境数据
- 负责调用应用程序，将environ和start_response 方法传入
- 将应用程序响应的正文封装成HTTP响应报文返回浏览器端
-
应用程序端
Web应用程序要实现一个符合WSGI规范的可调用对象。这个可调用对象接收两个参数：- environ：这是一个包含了所有请求信息的字典，比如请求的方法（Get、Post等），请求的URL、客户端的IP地址等。
- start_response：这是一个由服务器提供的函数，用于发送响应头信息。应用程序需要调用这个函数来设置响应的状态码、响应头，然后返回响应体。
下面是一个简单的 WSGI 应用程序示例：
def simple_app(environ, start_response):# 设置响应状态码status = '200 OK'# 设置响应头headers = [('Content-type', 'text/plain; charset=utf-8')]# 调用 start_response 函数发送响应头start_response(status, headers)# 响应体内容response_body = 'Hello, World!'# 返回响应体，注意要以字节形式返回return [response_body.encode('utf-8')]
3. WSGI使用
- 与服务器结合使用
在实际开发中，你可以将上述的 WSGI 应用程序和一个支持 WSGI 的服务器结合使用。例如，使用 wsgiref 这个 Python 标准库中的简单 WSGI 服务器：
from wsgiref.simple_server import make_server# 定义 WSGI 应用程序
def simple_app(environ, start_response):status = '200 OK'headers = [('Content-type', 'text/plain; charset=utf-8')]start_response(status, headers)response_body = 'Hello, World!'return [response_body.encode('utf-8')]# 创建服务器实例
httpd = make_server('', 8000, simple_app)
print("Serving on port 8000...")
# 启动服务器，开始监听请求
httpd.serve_forever()
在这个示例中，make_server 函数创建了一个 wsgiref 服务器实例，它接收三个参数：服务器的地址（这里为空表示监听所有地址）、端口号（8000）和 WSGI 应用程序（simple_app）。
然后调用 serve_forever 方法启动服务器，开始监听客户端的请求。
- 在Web框架中的应用
大多数 Python 的 Web 框架都遵循 WSGI 规范。例如 Flask 框架，它本质上就是一个 WSGI 应用程序：
from flask import Flaskapp = Flask(__name__)@app.route('/')
def hello_world():return 'Hello, World!'if __name__ == '__main__':app.run()
Flask 应用程序的 app 对象实际上就是一个符合 WSGI 规范的可调用对象。当你使用 app.run() 启动 Flask 应用时，它内部会使用一个简单的 WSGI 服务器来运行这个应用。
4. WSGI的优势
- 兼容性：WSGI 提供了一种统一的标准，使得不同的 Web 服务器和 Web 应用程序能够相互兼容，方便开发者选择适合自己需求的服务器和框架进行组合。
- 灵活性：开发者可以根据需要选择不同的服务器和应用程序，并且可以在不改变应用程序代码的情况下更换服务器，或者在不改变服务器配置的情况下更换应用程序。
- 可扩展性：由于 WSGI 是一个简单而灵活的接口，开发者可以基于它开发出各种中间件，用于处理请求和响应，增加应用程序的功能。
4.1 中间件
WSGI中间件是一种特殊的组件，它位于Web服务器和Web应用程序之间，可以对请求和响应进行拦截和处理。中间件本身也是一种符合WSGI规范的可调用对象，它可以修改请求信息、添加额外的响应头、进行日志记录等操作。
下面是一个简单的日志中间件示例：
def log_middleware(app):def wrapper(environ, start_response):# 记录请求信息print(f"Request received: {environ['REQUEST_METHOD']} {environ['PATH_INFO']}")# 调用原始的 WSGI 应用程序result = app(environ, start_response)# 记录响应信息print("Response sent")return resultreturn wrapper# 定义原始的 WSGI 应用程序
def simple_app(environ, start_response):status = '200 OK'headers = [('Content-type', 'text/plain; charset=utf-8')]start_response(status, headers)response_body = 'Hello, World!'return [response_body.encode('utf-8')]# 使用中间件包装原始应用程序
app_with_middleware = log_middleware(simple_app)
log_middleware 是一个中间件函数，它接收一个 WSGI 应用程序作为参数，返回一个新的可调用对象 wrapper。wrapper 函数会在调用原始应用程序前后记录请求和响应信息。