必要なもの: flup¶

Django で FastCGI を使うには、まず flup をインストールせねばなりません。 flup は FastCGI を使えるようにするための Python ライブラリです。 Django は バージョン0.5 以降の flup で動作します。

FastCGI サーバを起動する¶

FastCGI はクライアントサーバモデルで動作します。ほとんどの場合、 FastCGI プ ロセスを自分で起動することになるでしょう。 Web サーバ (Apache、 lighttpd な ど) が Djagno の FastCGI プロセスにアクセスするのは、サーバが動的ページをロー ドするときだけです。デーモンは常にコードをメモリ上にロードしたまま動作して いるので、非常に高速に応答を返せるのです。

Web サーバが FastCGI サーバにアクセスするには二つの方法があります。一つは Unix ドメインソケット (Win32 システムにおける「名前付きパイプ」) で、もう一 つは TCP ソケットです。どちらを選ぶかは好みの問題です。パーミッションの問題 から、通常は TCP ソケットの方が簡単です。

サーバを起動するには、プロジェクトのあるディレクトリ (manage.py のある 場所) に移動して、 manage.py の runfcgi コマンドを実行します:

./manage.py runfcgi [options]

runfcgi に help オプションだけを指定すると、利用可能な全ての オプションを表示します。

引数として、 socket, protocol, または、 host および port を 指定せねばなりません。さらに、 Web サーバをセットアップする際に、FastCGI サー バを起動するときに使ったソケット名か、ホスト/ポート番号の組合せを指定せねば なりません。後述の 実行例 を参照してください。

./manage.py runfcgi protocol=scgi

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

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

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

kill `cat $PIDFILE`

#!/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 での FastCGI 構成¶

Django を Apache と FastCGI の構成で使うには、 Apache をインストールして、 mod_fastcgi がインストールされ、有効になっているようにせねばなりません。 詳しい手順は Apache のドキュメントを参照してください。

mod_fastcgi の構成が終ったら、 httpd.conf ファイルを編集して、 Apache に Django の FastCGI インスタンスを教えます。以下の二つの設定を行わねばなり ません:

• FastCGIExternalServer ディレクティブを使って、 FastCGI サーバの場 所を指定します。
• mod_rewrite を使って、リクエストが適切な FastCGI に向くようにしま す。

# 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

<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 での FastCGI 構成¶

lighttpd は静的ファイルのサービスによく使われている軽量な Web サーバです。 lighttpd はネイティブの FastCGI サポートを持っているので、 Apache の縛りが ない場合、動的ページと静的ページの両方をサービスするには良い選択肢といえま す。

mod_fastcgi がモジュールリストに入っているようにしてください。このとき、 mod_rewrite や mod_access よりも後ろにして、 mod_accesslog より も前にします。 admin メディアファイルを提供するなら、 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",
)

# 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 = (
       ...
    )
    ...
}

Apache を使っている共有ホスティングプロバイダ上で Django を使う¶

共有ホスティングプロバイダの多くでは、独自のサーバデーモンを起動できなかっ たり、 httpd.conf ファイルを編集できなかったりします。このような場合で も、サーバ起動プロセスを使えば Django を駆動できます。

Web コンテンツのルートディレクトリ下に、以下のような内容のファイルを .htaccess という名前で保存します:

AddHandler fastcgi-script .fcgi
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^/(.*)$ /mysite.fcgi/$1 [QSA,L]

次に、 Apache に FastCGI プログラムの起動方法を教える小さなスクリプトを作成 します。 mysite.fcgi というファイルを作成して Web コンテンツディレクト リに置き、実行可能にします:

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

touch mysite.fcgi

Admin メディアファイルの提供¶

サーバやその設定がどうあれ、何らかの形で admin メディアファイルを提供する方 法を考えておかねばなりません。 modpython での運用に関するドキュメントには、上記の構成でも使えるアドバイスがあります。

URL のプレフィクス部分を特定の値にする¶

FastCGI を使った設置方法は、ほとんどが URL をリライトしてウェブサーバ内部の 別の場所を指すようにしています。このとき、 Django から見えるパス情報には、 もともとの URL が反映されません。そのため、 Django アプリケーションを特定の プレフィクスの下で動かしていて、 {% url %} タグで表示される URL を、 mysite.fcgi のようなリライト後のものでなく、プレフィクスのついた URL に したいときに問題が生じます。

Django は実際のスクリプト名プレフィクスが何だったかをそれなりにうまく調べよ うとします。特に、ウェブサーバが SCRIPT_URL を設定する場合(Apache の modo_rewrite 特有の機能です) や、 REDIRECT_URL を設定する場合 (Apache と mod_rewrite をある構成で使ったとき) には、もとのプレフィクスを自動的に 見つけ出します。

Django がプレフィクスを正しく見付けられない場合や、リライト前の値を URL に 使いたい場合には、設定ファイル中で FORCE_SCRIPT_NAME を設定して ください。この変数には、全ての URL に共通なスクリプト名を指定します。したがっ て、別々のスクリプト名を持った URL に対応するには個別に設定ファイルを用意せ ねばなりませんが、そのようなケースは稀でしょう。

例えば、全てのコンテンツを '/' 以下の URL で提供するように Django を構 成しているなら、設定ファイルには FORCE_SCRIPT_NAME = '' と指定してくだ さい。