本帖来自廖雪峰官网Python教程
Web开发
WSGI接口
一个web应用的本质:
1. 浏览器发送 HTTP Request
2. 服务器收到请求,生成HTML文档
3. 服务器返回HTTP Response(HTML文档作为HTTP Response的Body部分 )
4. 浏览器收到HTTP Response,从HTTP Body取出HTML文档并显示
所以,最简单的web应用就是先把HTML用文件保存好,用一个现成的HTTP服务软件,接受用户请求,从文件中读取HTML,返回。
底层代码(接受HTTP请求、解析HTTP请求、发送HTTP响应)由专门的服务器软件实现,我们用Python专注于生成HTML文档,这时就需要一个统一的接口,供我们用Python编写Web业务。
这个接口就是WSGI:Web Sever Gateway Interface。 它只需要实现一个函数,就能够相应HTTP请求:
def application(environ,start_response):
start_response('200 OK', [('Content-Type', 'text/html')])
return [b'<h1>Hello, web!</h1>']
上面的application()
函数就是符合WSGI标准的一个HTTP处理函数,它接受两个参数:
environ: 包含所有HTTP request的
dict
对象start_response: 一个发送HTTP Response的函数
在application()函数中,调用:
start_response('200 OK', [('Content-Type', 'text/html')])
发送一个HTTP相应的Header,但是只能发送一次,就是只能调用一次start_response()
函数。start_response()
函数接受两个参数:
200 OK
: HTTP响应码。[('Content-Type', 'text/html')]
: 一组list表示的HTTP Header,每个Header是一个tuple
,包含两个str
。
通过WSGI,省掉了底层的繁杂步骤,我们只需关心如何从environ
拿到HTTP请求信息,然后构造HTML,通过start_response()
发送Header,最后返回Body。
要调用application()
必须由WSGI服务器调用,Python内置了wsgiref.py
作为WSGI服务器。
为了方便理解,将上面的文字整理成了一张图:
有了上面的介绍过后,就可以运行WSGI服务了,用来实现web应用。
运行WSGI服务
首先编写hello.py
,实现Web应用程序的WSGI处理函数:
# hello.py
def application(environ, start_response):
start_response('200 OK', [('Content-Type', 'text/html')])
return [b'<h1>Hello, web!</h1>']
然后,编写一个sever.py,负责启动WSGI服务器,加载application()
函数:
# server.py
# 从wsgiref模块导入:
from wsgiref.simple_server import make_server
# 导入我们自己编写的application函数:
from hello import application
# 创建一个服务器,IP地址为空,端口是8000,处理函数是application:
httpd = make_server('', 8000, application)
print('Serving HTTP on port 8000...')
# 开始监听HTTP请求:
httpd.serve_forever()
确保以上两个文件在同一目录下,先在命令行运行sever.py
,再在浏览器输入localhost:8000
,运行结果如下:
成功启动服务器:
浏览器显示:
服务器端显示:
总结
无论什么Web应用程序,入口都是一个WSGI处理函数。HTTP请求的所有输入信息都可以通过environ
获得,HTTP响应的输出都可以通过start_response()
加上函数返回值作为Body。
对于复杂的Web应用程序,光靠WSGI函数来处理太底层了,需要在WSGI之上再抽象出Web框架,进一步简化Web开发。