wsgi

1、廖雪峰的网站

https://www.liaoxuefeng.com/wiki/001374738125095c955c1e6d8bb493182103fac9270762a000/001386832689740b04430a98f614b6da89da2157ea3efe2000

了解了HTTP协议和HTML文档，我们其实就明白了一个Web应用的本质就是：

1. 浏览器发送一个HTTP请求；

2. 服务器收到请求，生成一个HTML文档；

3. 服务器把HTML文档作为HTTP响应的Body发送给浏览器；

4. 浏览器收到HTTP响应，从HTTP Body取出HTML文档并显示。

所以，最简单的Web应用就是先把HTML用文件保存好，用一个现成的HTTP服务器软件，接收用户请求，从文件中读取HTML，返回。Apache、Nginx、Lighttpd等这些常见的静态服务器就是干这件事情的。

如果要动态生成HTML，就需要把上述步骤自己来实现。不过，接受HTTP请求、解析HTTP请求、发送HTTP响应都是苦力活，如果我们自己来写这些底层代码，还没开始写动态HTML呢，就得花个把月去读HTTP规范。

正确的做法是底层代码由专门的服务器软件实现，我们用Python专注于生成HTML文档。因为我们不希望接触到TCP连接、HTTP原始请求和响应格式，所以，需要一个统一的接口，让我们专心用Python编写Web业务。

这个接口就是WSGI：Web Server Gateway Interface。

WSGI接口定义非常简单，它只要求Web开发者实现一个函数，就可以响应HTTP请求。我们来看一个最简单的Web版本的“Hello, web!”：

def application(environ, start_response):
    start_response('200 OK', [('Content-Type', 'text/html')])
    return '<h1>Hello, web!</h1>'

上面的application()函数就是符合WSGI标准的一个HTTP处理函数，它接收两个参数：

• environ：一个包含所有HTTP请求信息的dict对象；

• start_response：一个发送HTTP响应的函数。

在application()函数中，调用：

start_response('200 OK', [('Content-Type', 'text/html')])

就发送了HTTP响应的Header，注意Header只能发送一次，也就是只能调用一次start_response()函数。start_response()函数接收两个参数，一个是HTTP响应码，一个是一组list表示的HTTP Header，每个Header用一个包含两个str的tuple表示。

通常情况下，都应该把Content-Type头发送给浏览器。其他很多常用的HTTP Header也应该发送。

然后，函数的返回值'<h1>Hello, web!</h1>'将作为HTTP响应的Body发送给浏览器。

有了WSGI，我们关心的就是如何从environ这个dict对象拿到HTTP请求信息，然后构造HTML，通过start_response()发送Header，最后返回Body。

整个application()函数本身没有涉及到任何解析HTTP的部分，也就是说，底层代码不需要我们自己编写，我们只负责在更高层次上考虑如何响应请求就可以了。

不过，等等，这个application()函数怎么调用？如果我们自己调用，两个参数environ和start_response我们没法提供，返回的str也没法发给浏览器。

所以application()函数必须由WSGI服务器来调用。有很多符合WSGI规范的服务器，我们可以挑选一个来用。但是现在，我们只想尽快测试一下我们编写的application()函数真的可以把HTML输出到浏览器，所以，要赶紧找一个最简单的WSGI服务器，把我们的Web应用程序跑起来。

好消息是Python内置了一个WSGI服务器，这个模块叫wsgiref，它是用纯Python编写的WSGI服务器的参考实现。所谓“参考实现”是指该实现完全符合WSGI标准，但是不考虑任何运行效率，仅供开发和测试使用。

运行WSGI服务

我们先编写hello.py，实现Web应用程序的WSGI处理函数：

# hello.py
​
def application(environ, start_response):
    start_response('200 OK', [('Content-Type', 'text/html')])
    return '<h1>Hello, web!</h1>'

然后，再编写一个server.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()

确保以上两个文件在同一个目录下，然后在命令行输入python server.py来启动WSGI服务器：

---

在Apache中运行Python WSGI应用

https://www.cnblogs.com/Erick-L/p/7063173.html

我们介绍如何使用Apache模块mod_wsgi来运行Python WSGI应用。

安装mod_wsgi

我们假设你已经有了Apache和Python环境，在Linux或者Mac上，那第一步自然是安装。在Ubuntu或Debian环境中，你可以使用apt-get命令来安装：

sudo apt-get install libapache2-mod-wsgi
sudo apt-get install libapache2-mod-wsgi-py3 

不过我们建议采用编译安装，这样在任何系统中都可以安装成功，具体步骤如下：

• 下载源码包

mod_wsgi的源码托管在Github上，你可以从https://github.com/GrahamDumpleton/mod_wsgi/releases下载它各个版本的源码包。

• 解压后，配置编译选项

一般采用默认配置即可，即执行:

./configure

如果要指定Apache和Python环境，那你需要加上”–with-apxs”和”–with-python”选项：

./configure --with-apxs=/usr/local/apache/bin/apxs --with-python=/usr/local/bin/python

• 编译并安装

sudo make && make install 

• 在Apache配置文件中载入mod_wsgi

让我们打开Apache的配置文件httpd.conf，默认是在：

$ sudo vi /etc/httpd/conf/httpd.conf   # For Linux
$ sudo vi /etc/apache2/httpd.conf      # For Mac

在所有”Load Module”配置项的最后，加上载入mod_wsgi的配置，注意Linux和Mac的模块加载路径不同：

LoadModule wsgi_module modules/mod_wsgi.so   # For Linux
# LoadModule wsgi_module libexec/apache2/mod_wsgi.so   # For Mac 

• 重启Apache来启用配置

$ sudo service httpd restart       # For Linux
$ sudo service apachectl restart   # For Mac

测试mod_wsgi

最简单的测试方法自然是Hello World，让我们在Apache的DocumentRoot根目录下创建一个文件”test.wsgi”。在文件中，我们写入这样的内容：

def application(environ, start_response):
    status = '200 OK'
    output = 'Hello World!'
 
    response_headers = [('Content-type', 'text/plain'),
                        ('Content-Length', str(len(output)))]
    start_response(status, response_headers)
 
    return [output]

这里的函数application即为WSGI应用对象，它返回的值就是该应用收到请求后的响应。然后，再打开Apache的配置文件httpd.conf，在其最后加上URL路径映射：

WSGIScriptAlias /test /var/www/test.wsgi

这里我们假设Apache的文档根目录是”/var/www”。

现在你可以打开浏览器，访问一下”http://localhost/test”，如果看到”Hello World!”了，就说明mod_wsgi已经安装成功。

我们可以试试运行Flask应用，当然首先是你本地Python环境已经安装了Flask，我们将”test.wsgi”改为：

from flask import Flask
application = Flask(__name__)
 
@application.route('/')
def index():
    return '<h1>Hello World!</h1>' 

注意，这里必须要将Flask应用对象命名为”application”，这样才能被mod_wsgi识别。再用浏览器访问下，是不是能看到大标题”Hello World!”?