FastCGI, SCGI, AJP で Django を使う

プロトコル

Django は flup のサポートしている全てのプロトコル，すなわち fastcgi, SCGI, AJP1.3 (Apache JServ プロトコルバージョン 1.3) をサポートしていま す．使いたいプロトコルを指定するには， protocol=<protocl_name> を ./manage.py runfcgi のオプションに指定します． <protocol_name> は fcgi (デフォルト)， scgi または ajp のいずれかです．例を以下に 示します:

./manage.py runfcgi protocol=scgi

実行例

TCP ポートを使い，スレッドモードでサーバを起動する場合:

./manage.py runfcgi method=threaded host=127.0.0.1 port=3033

Unix ドメインソケットを使い， prefork モードでサーバを起動する場合:

./manage.py runfcgi method=prefork socket=/home/user/mysite.sock pidfile=django.pid

デーモン化 (バックグラウンド化) させずにプロセスを起動する場合 (デバッグ時 に便利です):

./manage.py runfcgi daemonize=false socket=/tmp/mysite.sock maxrequests=1

FastCGI デーモンを止める

フォアグラウンドでプロセスを走らせているのなら，止めるのは簡単で， Ctrl-C を押して FastCGI サーバを止めるだけですみます．バックグラウンド プロセスを使っているのなら， Unix の kill コマンドを使わねばなりません．

pidfile オプションを指定して manage.py runfcgi を起動しているのなら， 以下のようにして起動中の FastCGI デーモンを殺せます:

kill `cat $PIDFILE`

$PIDFILE は起動時に指定した pidfile の値です．

Unix 上で FastCGI デーモンを簡単に再起動させたいなら，以下のようなシェルス クリプトを試してみましょう:

#!/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

FastCGI サーバの場所を指定する

FastCGIExternalServer ディレクティブは， Apache に FastCGI サーバの探し 方を教えます． FastCGIExternalServer のドキュメント にもある通り， socket または host のいずれかを指定せねばなりません．それぞれの例を 以下に示します:

# 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 は実際に存在し なくてもかまいません．このパスは Web サーバが内部的に使う URL に過ぎず， FastCGI で処理すべきリクエストを URL で区別するための単なるフックです．(次 節で詳しく説明します)

mod_rewrite を使って URL が FastCGI を指すようにする

第二ステップでは，特定のパターンに一致する URL では FastCGI を使うよう Apache に指示します．前節で述べたように， mod_rewrite モジュールを使って， URL を mysite.fcgi (または FastCGIExternalServer ディレクティブに指 定した名前) に書き換えます．

下記の例では，ファイルシステム上に存在せず，かつパスが /media/ で始まら ないファイルに対するリクエストに対して FastCGI を使うよう Apache に指示して います．Django の admin サイトを使っているなら，これはよくある状況でしょう:

<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,PT]
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteRule ^(.*)$ mysite.fcgi/$1 [QSA,L]
</VirtualHost>

lighttpd を使って複数の Django サイトを駆動する

lighttpd には，ホストごとに設定をカスタマイズするための「条件付き設定 (conditional configuration)」があります．複数の FastCGI サイトを指定するに は，各サイトごとに FastCGI 設定を条件分岐のブロックにします:

# If the hostname is 'www.example1.com'...
$HTTP["host"] == "www.example1.com" {
    server.document-root = "/foo/site1"
    fastcgi.server = (
       ...
    )
    ...
}

# If the hostname is 'www.example2.com'...
$HTTP["host"] == "www.example2.com" {
    server.document-root = "/foo/site2"
    fastcgi.server = (
       ...
    )
    ...
}

fastcgi.server ディレクティブに複数のエントリを追加すれば，複数の Django を同じサイトでも駆動できます．各エントリごとに FastCGI ホストを追加 してください．

起動中のサーバを再起動する

サイトを構成する Python コードを変更した場合， FastCGI にコードが変更された ことを教えねばなりません．しかし， FastCGI の場合には Apache を再起動する必 要はありません．その代わり， mysite.fcgi を再度アップロードするか，ファ イルを編集して，タイムスタンプを更新してください． Apache は，ファイルのタ イムスタンプが更新されていることを発見すると，Django アプリケーションを再起 動してくれます．

Unix システムでコマンドラインシェルへのアクセスが許されているなら， touch コマンドを使えば簡単にタイムスタンプを更新できます:

touch mysite.fcgi