[摘要] 如何用 FastCGI 运行 Django
摘要自 Django 文档：http://www.djangoproject.com/documentation/fastcgi/
------------------------------------------------------------------------------------
首先要安装 flup (http://www.saddi.com/software/flup/)，
这是 Python 处理 FastCGI 的库。
FactCGI 采用 c/s 模型，独立的运行一个进程。在需要处理请求时，web 服务器(apache, httpd,..)直接和 FactCGI 进程进行通信即可。
web 服务器可通过两种办法和 FastCGI server 连接：
1. Unix domain socket(或 win32 的“命名管道")
2. TCP socket
通常 TCP socket 更简单，因为权限问题比较好配置。
如何启动 FactCGI 服务器：
到项目目录中，执行：
./manage.py runfcgi [options]
如果要看帮助：
./manage.py runfcgi help
在选项中，需要指定一个 socket 或 host 和 port 的组合，这样的话，当你启动 web server 时，就可以通过这些信息来连接到 FactCGI 服务器。
例子
在 TCP 端口中运行一个线程内服务器：
./manage.py runfcgi method=threaded host=127.0.0.1 port=3033
在 Unix domain socket 上运行一个 preforked 服务器:
./manage.py runfcgi method=prefork socket=/home/user/mysite.sock pidfile=django.pid
不作为后台进程执行（便于调试）：
./manage.py runfcgi daemonize=false socket=/tmp/mysite.sock
如何停止后台的 FastCGI 进程：
1. 如果指定了 pidfile 属性，则可以这样：
kill `cat $PIDFILE`
其中 $PIDFILE 是你指定的 pidfile 选项。
要重启 Unix 上的后台 FactCGI 进程，可执行下列 shell 脚本：
#!/bin/bash
# Replace these three settings.
PROJDIR="/home/user/myproject"
PIDFILE="$PROJDIR/mysite.pid"
SOCKET="$PROJDIR/mysite.sock"
cd $PROJDIR
if [ -f $PIDFILE ]; then
kill `cat -- $PIDFILE`
rm -f -- $PIDFILE
fi
exec /usr/bin/env - \
PYTHONPATH="../python:.." \
./manage.py runfcgi socket=$SOCKET pidfile=$PIDFILE
Apache 的设定：
1. 需要安装了 mod_fastcgi
2. 编辑 httpd.conf:
(1) 用 FastCGIExternalServer 指向 FastCGI 服务器的位置
可以用 socket 也可以用主机+端口的方式指定。例子：
# Connect to FastCGI via a socket / named pipe.
FastCGIExternalServer /home/user/public_html/mysite.fcgi -socket /home/user/mysite.sock
# Connect to FastCGI via a TCP host/port.
FastCGIExternalServer /home/user/public_html/mysite.fcgi -host 127.0.0.1:3033
不管上述那种情况，/home/user/public_html/mysite.fcgi 这个文件是不需要存在的。其作用指示作为一个 URL 指示 Web 服务器哪些请求需要被 FastCGI 来处理。
(2) 用 mod_rewrite 来分派需要处理的 URL 到 FastCGI.
例子：
<VirtualHost 12.34.56.78>
ServerName example.com
DocumentRoot /home/user/public_html
Alias /media /home/user/python/django/contrib/admin/media
RewriteEngine On
RewriteRule ^/(media.*)$ /$1 [QSA,L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^/(.*)$ /mysite.fcgi/$1 [QSA,L]
</VirtualHost>
这里指示的重写后的 url 就是上面 FastCGIExternalServer 中那个。
上述配置将不是 /media/ 开头的，或者指向不存在的文件的请求，转给了 FastCGI.
lighttpd 配置
lighttpd 天然的支持 FastCGI.
首先要确认你的 mod_fastcgi 在模块列表中，并且在 mod_rewrite 和 mod_access 后，在 mod_accesslog 前。
为了服务 admin media, 也许你还需要 mod_alias.
在 lighttpd 的配置文件中加如下一段：
server.document-root = "/home/user/public_html"
fastcgi.server = (
"/mysite.fcgi" => (
"main" => (
# Use host / port instead of socket for TCP fastcgi
# "host" => "127.0.0.1",
# "port" => 3033,
"socket" => "/home/user/mysite.sock",
"check-local" => "disable",
)
),
)
alias.url = (
"/media/" => "/home/user/django/contrib/admin/media/",
)
url.rewrite-once = (
"^(/media.*)$" => "$1",
"^/favicon\.ico$" => "/media/favicon.ico",
"^(/.*)$" => "/mysite.fcgi$1",
)
还可以在一个 lighttp 服务器上跑多个 Django. 只要为每一个应用指定一个独立的 FastCGI host.
如何在共享的 web hosting 上运行 Django / Apache:
编辑 .htaccess:
AddHandler fastcgi-script .fcgi
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ mysite.fcgi/$1 [QSA,L]
再写一个 mysite.fcgi 的可执行的脚本：
#!/usr/bin/python
import sys, os
# Add a custom Python path.
sys.path.insert(0, "/home/user/python")
# Switch to the directory of your project. (Optional.)
# os.chdir("/home/user/myproject")
# Set the DJANGO_SETTINGS_MODULE environment variable.
os.environ['DJANGO_SETTINGS_MODULE'] = "myproject.settings"
from django.core.servers.fastcgi import runfastcgi
runfastcgi(method="threaded", daemonize="false")
在更新代码后，可以通过重新上传 mysite.fcgi 文件来指示 Apache 重启 Django 程序。
如果有 shell 权限，可以直接用 touch 命令改变时间戳：
touch mysite.fcgi
