在生产环境上,一般会使用比较健壮的Web服务器,如Apache来运行我们的应用。如果我们的Web应用是采用Python开发,而且符合WSGI规范,比如基于Django,Flask等框架,那如何将其部署在Apache中呢?本文中,我们就会介绍如何使用Apache模块mod_wsgi来运行Python WSGI应用。
安装mod_wsgi
我们假设你已经有了Apache和Python环境,在Linux或者Mac上,那第一步自然是安装。在Ubuntu或Debian环境中,你可以使用apt-get命令来安装:
1
2
|
$ sudo apt-get install libapache2-mod-wsgi $ sudo apt-get install libapache2-mod-wsgi-py3 # For Python 3 |
不过我们建议采用编译安装,这样在任何系统中都可以安装成功,具体步骤如下:
1、下载源码包
mod_wsgi的源码托管在Github上,你可以从https://github.com/GrahamDumpleton/mod_wsgi/releases下载它各个版本的源码包。
2、解压后,配置编译选项
一般采用默认配置即可,即执行:
1
|
$ . / configure |
如果要指定Apache和Python环境,那你需要加上”–with-apxs”和”–with-python”选项:
1
|
$ . / configure - - with - apxs = / usr / local / apache / bin / apxs - - with - python = / usr / local / bin / python |
3、编译并安装
1
|
$ sudo make && make install |
4、在Apache配置文件中载入mod_wsgi
让我们打开Apache的配置文件httpd.conf,默认是在:
1
2
|
$ sudo vi /etc/httpd/conf/httpd .conf # For Linux $ sudo vi /etc/apache2/httpd .conf # For Mac |
在所有”Load Module”配置项的最后,加上载入mod_wsgi的配置,注意Linux和Mac的模块加载路径不同:
1
2
|
LoadModule wsgi_module modules /mod_wsgi .so # For Linux # LoadModule wsgi_module libexec/apache2/mod_wsgi.so # For Mac |
5、重启Apache来启用配置
1
2
|
$ sudo service httpd restart # For Linux $ sudo service apachectl restart # For Mac |
测试mod_wsgi
最简单的测试方法自然是Hello World,让我们在Apache的DocumentRoot根目录下创建一个文件”test.wsgi”。在文件中,我们写入这样的内容:
1
2
3
4
5
6
7
8
9
|
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路径映射:
1
|
WSGIScriptAlias / test / var / www / test.wsgi |
这里我们假设Apache的文档根目录是”/var/www”。
现在你可以打开浏览器,访问一下”http://localhost/test”,如果看到”Hello World!”了,就说明mod_wsgi已经安装成功。
我们可以试试运行Flask应用,当然首先是你本地Python环境已经安装了Flask,我们将”test.wsgi”改为:
1
2
3
4
5
6
|
from flask import Flask application = Flask(__name__) @application .route( '/' ) def index(): return '<h1>Hello World!</h1>' |
注意,这里必须要将Flask应用对象命名为”application”,这样才能被mod_wsgi识别。再用浏览器访问下,是不是能看到大标题”Hello World!”?
使用Python虚拟环境
一般我们会将应用安装在虚拟环境中,这样应用的更新只需改变虚拟环境即可,不会影响到其他应用环境。要使用虚拟环境来运行当前WSGI应用的话,你必须在”.wsgi”文件中先执行虚拟环境的启用脚本,基于上面的代码,我们来做如下改动:
1
2
3
4
5
6
7
8
9
|
activate_this = '/home/bjhee/virtualenv/bin/activate_this.py' execfile (activate_this, dict (__file__ = activate_this)) from flask import Flask application = Flask(__name__) @application .route( '/' ) def index(): return '<h1>Hello World!</h1>' |
上例中,我们的虚拟环境在目录”/home/bjhee/virtualenv”下,你可以在其”/bin”子目录中找到启用脚本”activate_this.py”。在WSGI应用的一开始执行它即可。
补充内容
当我们的Python环境中有模块是以.egg压缩包安装的话,WSGI应用运行时需要将.egg压缩包解开。默认的解压路径很有可能没有访问权限,比如Mac下是”/Library/WebServer/.python-eggs”,因此你需要指定临时解压目录。方法有两种,一是在Apache的httpd.conf文件中,使用”WSGIPythonEggs”配置项,配置参数就是我们的临时目录路径;二是设置系统环境变量”PYTHON_EGG_CACHE”。我们建议采用第二种,并将其写在”.wsgi”文件中,这样就不会影响其他的应用:
1
2
3
4
5
6
7
8
9
10
11
12
|
activate_this = '/home/bjhee/virtualenv/bin/activate_this.py' execfile (activate_this, dict (__file__ = activate_this)) import os os.environ[ 'PYTHON_EGG_CACHE' ] = '/home/bjhee/.python-eggs' from flask import Flask application = Flask(__name__) @application .route( '/' ) def index(): return '<h1>Hello World!</h1>' |
运行前,请确保临时目录(上例中的”/home/bjhee/.python-eggs”)有访问及写权限。
更多内容请参阅mod_wsgi的官方文档。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持服务器之家。
原文链接:http://www.bjhee.com/apache-wsgi.html