nginx[+spawn-fcgi]+flup+webpy服务搭建

webpy环境搭建

在开始webpy搭建之前,有必要熟悉一下什么是fastcgi,因为搭建环境时都是使用这个模式去运行webpy程序的,具体的fastcgi描述可以参考各种百科;fastcgi协议官网(http://www.fastcgi.com/drupal/)上面描述一些基础信息,fastcgi的api、开发,fastcgi的实现程序,支持fastcgi的web服务器等等。

除了fastcgi之外还有一些其他的相关名词:cgi、fastcgi、wsgi。gi是gateway interface的缩写,所以前面3个都是属于一个大类型、一种规范;至于具体规范的谁、怎么规范的会有各自的不同。

cgi和fastcgi规范的都是http server与对应解释程序的之间的通信;比如apache与python、nginx与python等。只是它们规范的方式不一样;cgi是最原始的公用通信协议,它规定的是每次有请求就会新起一个应用进程来处理,在请求结束后关闭应用进程【导致反复新起进程、关闭进程,消耗系统资源】;fastcgi是cgi的扩展,目的就是解决cgi的这种资源消耗的弊端,它规定http server启动时同时启动了若干个应用进程【应用进程数可配置】,然后常驻内存等待接收请求并处理,处理完请求后继续等待不会退出。

由于cgi是直接对接那些有标准输出的应用即可,sh、tcl等;所以使用cgi协议时可以直接调用应用程序来启动应用进程,在执行结束后获得标准输出作为返回的html内容。而fastcgi则实现了固定的通信机制,它不能通过直接调用应用程序来执行结果,所以就需要一个支持fastcgi协议的web server/gateway来与之通信;这样请求就会通过fastcgi进程传输给特定的web请求处理程序【flup】,这个程序会根据业务逻辑处理请求并返回结果;最终通过fastcgi返回给前端的http server。

然后再看看fastcgi和wagi的关系,其实它们没有关系,虽然都是规范,但它们规范的不是一个地方,所以没有直接可关联的,唯一可关联的就是,有些程序会同时实现了这2种协议,比如:flup

fastcgi是通信规范,规定了通信的方式、协议;而wsgi是接口规范,规定了函数定义、调用。

最后还有一个spawn-fcgi,这是一个fastcgi进程管理器【最初是lighttpd的子模块,lighttpd也是一个与nginx类似的http server】,作用等同于其它http server中的fastcgi模块;只不过它实现的比较好、在某些情况下的效能会比较高,所以被大家分离出来广泛使用,以致独立出来作为一个项目。【所以就有了apache+spawn-fcgi、nginx+spawn-fcgi等】

下面总结了一张图,大概覆盖了上面所说的。

nginx[+spawn-fcgi]+flup+webpy服务搭建_第1张图片


通常搭建webpy都是想使用它的fastcgi模式,因此搭建webpy可以有2套方式运行:一是web服务+flup,二是web服务+spawn-fcgi+flup。又因为spawn-fcgi只有linux版本,所以windows下只能使用第一种方式搭建webpy,而linux下则可以使用第二种方式。下面内容简述了这2种方式的搭建过程,web服务器使用的是nginx,官网更多webpy服务的搭建见http://webpy.org/cookbook/index.zh-cn 部署章节,里面还包括apache、lighttpd等服务器的fastcgi搭建。

1、资源下载
python下载地址:
http://www.python.org/
webpy下载地址:
http://webpy.org/
flup下载地址:
http://trac.saddi.com/flup
nginx下载地址:
http://nginx.org/en/download.html
spawn-fcgi下载地址:
http://redmine.lighttpd.net/projects/spawn-fcgi/news

2、nginx配置熟悉
因为使用nginx服务,所以有必要先熟悉一下nginx服务器的简单配置,否则配置过程中出现问题时就会手忙脚乱了,安装完成nginx后其默认的配置文件里会有几种默认配置和注释说明,不过是英文的,这里有一个比它更详细的中文版:http://my.oschina.net/duxuefeng/blog/34880 
注:修改前先备份一个原始的文件


3、环境部署
webpy官网搭建说明见: http://webpy.org/cookbook/fastcgi-nginx.zh-cn

python、webpy、flup、nginx分别默认安装即可,完成后测试各软件默认安装是否正常,如果正常则开始修改nginx配置,添加配置一个虚拟主机,内容如下:

server{
	listen       80;
	server_name  www.test.com;
	root /path/to/web/root;
	access_log  logs/www.xx.com.access.log  main;

	location / {
		include fastcgi_params;   ##包含默认的fastcgi参数
		fastcgi_param SCRIPT_FILENAME $fastcgi_script_name;  
		fastcgi_param PATH_INFO $fastcgi_script_name;       
		fastcgi_pass 127.0.0.1:9002;                  ##把请求通过fastcgi传送给本机的9002端口
	}

	location /static/ {                    #配置静态文件的访问
		if (-f $request_filename) {        #如果请求文件名是一个文件
		rewrite ^/static/(.*)$  /static/$1 break;   #直接跳转到对应的资源,中断fastcgi的传输
		}
	}
}

完了重载nginx配置,nginx -s reload,为了保险起见,也可以如下操作:

1、先测试一下nginx.conf文件:./nginx -t   
2、没有问题在停止服务 ./nginx -s stop
3、启动服务 ./nginx

此时可以直接访问www.test.com,如果出现如下页面则表示配置nginx的fastcgi格式正确,可以继续后面的配置

nginx[+spawn-fcgi]+flup+webpy服务搭建_第2张图片


新建一个py文件,比如code.py,用来接收web请求并处理之,其内容可以如下:
#!/usr/bin/env python
# -*- coding: utf-8 -*-


import web


urls = ("/.*", "hello")
app = web.application(urls, globals())


class hello:
    def GET(self):
        return 'Hello, world!'


if __name__ == "__main__":
    app.run()
运行python程序,python code.py 9002 fastcgi
注:上面的nginx配置文件里配置的是9002,这里开启的就是9002,要保持一致否则就接不上了。
通过浏览器访问localhost,看看是不是返回了Hello, world!


上面是以方式一搭建的,如果使用方式二搭建,则还需要安装spawn-fcgi,然后修改code.py文件的内容,添加一句代码,全部内容如下:
#!/usr/bin/env python
# -*- coding: utf-8 -*-


import web


urls = ("/.*", "hello")
app = web.application(urls, globals())


class hello:
    def GET(self):
        return 'Hello, world!'


if __name__ == "__main__":
    web.wsgi.runwsgi = lambda func, addr=None: web.wsgi.runfcgi(func, addr)   ##这行是新增的
    app.run()

然后启动spawn-fcgi程序即可,即不需要直接以fastcgi方式运行code.py文件,而是通过运行spawn-fcgi程序来间接启动code.py程序,启动的命令如下:
spawn-fcgi -d /path/to/www -f /path/to/www/code.py -a 127.0.0.1 -p 9002   #端口和nginx配置里要一致
-f 指定调用FastCGI的web文件,web程序的入口文件,即code.py文件
-d 指定web程序的主目录,即code.py所在的目录
-a 绑定到地址 addr
-p 绑定到端口 port
-F 指定产生的 FastCGI 的进程数
-P 指定产生的进程的 PID 文件路径
-u 和 -g FastCGI 使用什么身份运行
可以将进程PID保存下来方便关闭进程:
kill `cat /tmp/zcut.pid`

比如:
spawn-fcgi -u www -g www -p /tmp/spwn.pid -F 10 -d /path/to/www -f /path/to/www/code.py -a 127.0.0.1 -p 9002
在127.0.0.1的9002端口以www身份启动webpy服务,webpy主程序路径为/path/to/www/code.py,webpy的程序主目录为/path/to/www/,总共启动了10个spawn进程,所有的进程id将存放在/tmp/spwn.pid文件里


参考文章:
webpy指南:
http://webpy.org/cookbook/index.zh-cn
CGI,FastCGI,WSGI,flup,spawn-fcgi之间的关系
http://lihuipeng.blog.51cto.com/3064864/890573
Windows下安装nginx+webpy+flup
http://blog.csdn.net/yavobo/article/details/6213063


你可能感兴趣的:(nginx,python,cgi,lighttpd,web服务)