Protocoles

Django supporte les mêmes protocoles que ceux supportés par flup, c'est à dire fastcgi, SCGI et AJP1.3 (le protocole Apache JServ, en version 1.3). Choissisez le protocole de votre choix en utilisant le paramètre protocol=<protocol_name> avec ./manage.py runfcgi, où <protocole_name> est une valeur parmi : fcgi (par défaut), scgi ou ajp. Par exemple:

./manage.py runfcgi protocol=scgi

Exemples

Lancer un serveur en mode "thread" sur un port TCP:

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

Lancer un serveur en mode "prefork" sur une "domain socket" Unix:

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

Lancer sans le service en tache de fond (utile pour débugguer):

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

Arrêter le service (démon) FastCGI

Si votre process n'est pas en tache de fond, il est aisé de l'arrêter : pressez les touches Ctrl-C pour arrêter et éteindre votre serveur FastCGI. Par contre, en utilisant les process en tâche de fond, vous devez utiliser la commande Unix kill.

Si vous spécifiez le paramètre pidfile à manage.py runfcgi, vous pouvez tuer votre service FastCGI de la façon suivante:

kill `cat $PIDFILE`

...où $PIDFILE est le pidfile que vous avez spécifié.

Pour redémarrer aisément votre service FastCGI sur Unix, essayez ce petit script:

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

Indiquer la location de votre serveur FastCGI

La directive FastCGIExternalServer indique à Apache comment trouver votre serveur FastCGI. Comme l'explique la documentation de FastCGIExternalServer, vous devez indiquer une socket ou un hôte. Ci-après des exemples:

# 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

Dans les deux cas, le fichier /home/user/public_html/mysite.fcgi n'a pas à exister. C'est juste une URL interne utilisée par le serveur web -- un "hook" pour indiquer quelles requêtes à une URL donnée doivent être traitées par FastCGI (Plus de détails à ce sujet dans la section suivante).

Utilisation de mod_rewrite pour pointer vos URLs vers votre serveur FastCGI

La seconde étape est d'indiquer à Apache d'utiliser FastCGI pour les urls correspondant à un certain motif. Pour faire ceci, utilisez le module mod_rewrite et réécrivez vos URLs vers mysite.fcgi (ie, ce que vous avez défini pour la directive FastCGIExternalServer, comme expliqué précédemment).

Dans cet exemple, nous indiquons à Apache d'utiliser FastCGI pour toutes les requêtes ne correspondant pas à un fichier sur le système de fichiers et qui ne commencent pas pas /media/. Il s'agit probablement du cas le plus courant, si vous utilisez l'interface d'administration de Django:

<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>

Héberber plusieurs sites Django sur une instance de lighttpd

lighttpd vous permet d'utiliser une "configuration conditionnelle" pour personnaliser votre configuration par hôte. Pour utiliser plusieurs sites avec FastCGI, ajoutez le block conditionnel suivant autour de la configuration FastCGI de chaque site:

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

Vous pouvez également exécuter plusieurs instances Django sur le même site en spécifiant simplement plusieurs entrées dans la directive fastcgi.server. Ajouter une hôte FastCGI pour chacune d'entre-elles.

Relancer le process fastcgi

Si vous changez le moindre bout de code python sur votre site, vous devez indiquer à FastCGI que votre code a changé. Pour autant, il n'y a pas besoin de redémarrer Apache dans ce cas. Préférez plutôt de retransférer votre fichier mysite.fcgi ou d'éditer ce fichier. Ceci afin que la date du fichier change. Quand Apache voit que le fichier a été mis à jour, il rechargera votre application Django.

Si vous avez accès à une console sur un système Unix, vous pouvez le faire simplement en utilisant la commande touch

touch mysite.fcgi