Voraussetzung: flup¶

Um Django mit FastCGI verwenden zu können, benötigst du flup, eine Python-Bibliothek für den Umgang mit FastCGI. Installiere Version 0.5 oder neuer.

Starte deinen FastCGI-Server¶

FastCGI operiert in einem Client-Server-Modell und in der Regel wirst du deinen FastCGI-Prozess selbst starten. Der Webserver (sei es nun Apache, lighttpd oder ein anderer Webserver) kontaktiert den Django-FastCGI-Prozess nur dann, wenn eine dynamische Seite geladen werden soll. Da der Dienst dann bereits läuft und den Code geladen hat, kann er sehr schnell eine Antwort generieren.

Ein Webserver kann nun auf zwei Arten mit einem FastCGI-Server kommunizieren: Mit einem Unix Domain Socket (unter Win32 “Named Pipes”) oder mit einem TCP-Socket. Welchen Weg du nimmst, ist an sich nur eine Frage des Geschmacks, TCP-Sockets sind jedoch normalerweise einfacher aufgrund von Berechtigungen.

Um deinen Server nun zu starten, wechsle zuerst in dein Projektverzeichnis (dort wo sich deine manage.py befindet) und führe den runfcgi-Befehl aus:

./manage.py runfcgi [options]

Wenn du help als einzige Option nach dem runfcgi-Befehl angibst, bekommst du eine Liste aller verfügbaren Optionen.

Du musst entweder einen socket, ein protocol oder sowohl einen host als auch einen port angeben. Wenn du dann deinen Webserver konfigurierst, musst du dort den Host/Port oder den Socket eintragen, den du für den FastCGI-Server verwendest. Unten findest du dazu ein paar Beispiele.

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

# Korrigiere diese Einstellungen.
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

Konfiguration von Apache¶

Um Django mit Apache und FastCGI verwenden zu können, muss Apache installiert und konfiguriert sein, sowie mod_fastcgi für Apache installiert, konfiguriert und in Apache aktiviert sein. Eine Anleitung hierfür findest du in der Apache-Dokumentation.

Sobald das erledigt ist, musst du Apache nur noch sagen, wo er deine Django-FastCGI-Instanz finden kann. Du musst hierfür zwei Dinge in deiner httpd.conf (Apaches Konfigurationsdatei) angeben:

• Verwende die FastCGIExternalServer-Direktive, um den Ort des FastCGI-Servers zu spezifizieren.
• Verwende mod_rewrite um URLs an den FastCGI-Server zu verweisen.

# Verbinde dich mit dem FastCGI-Server via Socket/Named Pipe.
FastCGIExternalServer /home/user/public_html/mysite.fcgi -socket /home/user/mysite.sock

# Verbinde dich mit dem FastCGI-Server via 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-Konfiguration¶

lighttpd ist ein Leichtgewicht unter den Webservern und wird in der Regel oft für statische Dateien verwendet. Er unterstützt FastCGI nativ und ist somit auch gut für das Ausliefern von dynamischen Seiten geeignet, falls du nicht unbedingt Apache-spezifische Features benötigst.

Stelle sicher, dass mod_fastcgi in deiner Modulliste irgendwo nach mod_rewrite und mod_access aber nicht nach mod_accesslog eingetragen ist. Für die statischen Dateien der Admin-Anwendung ist zusätzlich noch mod_alias nützlich.

Trage Folgendes in deine lighttpd-Konfigurationsdatei ein:

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",
)

# Wenn der Hostname 'www.example1.com' ist ...
$HTTP["host"] == "www.example1.com" {
    server.document-root = "/foo/site1"
    fastcgi.server = (
       ...
    )
    ...
}

# Wenn der Hostname 'www.example2.com' ist ...
$HTTP["host"] == "www.example2.com" {
    server.document-root = "/foo/site2"
    fastcgi.server = (
       ...
    )
    ...
}

Cherokee-Konfiguration¶

Cherokee ist ein sehr schneller, flexibler und einfach zu konfigurierender Webserver. Er unterstützt auch weitverbreitete Technologien wie FastCGI, SCGI, PHP, CGI, SSI, TLS- und SSL-verschlüsselte Verbindungen, Virtual hosts, Authentication, On the fly-Encoding, Load Balancing, Apache-kompatible Log-Dateien, Data Base Balancer, Reverse HTTP Proxy und vieles mehr.

Das Cherokee-Projekt stellt auch eine Anleitung zur Installation von Django mit Cherokee zur Verfügung.

Django auf Shared-Hosting-Providern mit Apache betreiben¶

Viele Shared-Hosting-Provider erlauben dir nicht, eigene Server-Dienste zu betreiben oder die httpd.conf zu editieren. In solchen Fällen ist es trotzdem möglich, Django innerhalb von Webserver-Prozessen zu betreiben.

In deinem Web-Verzeichnis füge Folgendes zu deiner .htaccess-Datei hinzu:

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

Als nächstes erstelle ein kleines Script, das Apache verwendet, um dein FastCGI-Programm zu starten. Lege eine mysite.fcgi an, speichere sie in deinem Web-Verzeichnis und stelle sicher, dass sie ausführbar ist:

#!/usr/bin/python
import sys, os

# Erweitere den Python-Pfad.
sys.path.insert(0, "/home/user/python")

# Wechsle in das Verzeichnis deines Projektes. (Optional.)
# os.chdir("/home/user/myproject")

# Setze die DJANGO_SETTINGS_MODULE-Umgebungsvariable.
os.environ['DJANGO_SETTINGS_MODULE'] = "myproject.settings"

from django.core.servers.fastcgi import runfastcgi
runfastcgi(method="threaded", daemonize="false")

touch mysite.fcgi

Statische Dateien des Admin-Moduls ausliefern¶

Ungeachtet dessen welchen Server du schlussendlich verwenden möchtest, solltest du auch darüber nachdenken, wie die statischen Dateien des Admin-Moduls ausgeliefert werden sollen. Die Empfehlungen in der modpython-Dokumentation sind auch auf die oben beschriebenen Installationen anwendbar.

Einen bestimmten URL-Präfix erzwingen¶

Da viele FastCGI-basierte Lösungen an der einen oder anderen Stelle im Server URLs ändern müssen, sieht Django möglicherweise nicht mehr die ursprüngliche URL. Das ist dann ein Problem, wenn Django innerhalb eines bestimmten URL-Präfixes betrieben wird und du willst, dass URLs von {% url %} auch diesen Präfix enthalten anstelle der geänderten URL, die zum Beispiel mysite.fcgi enthält.

Django versucht hier so gut als möglich, den tatsächlichen Präfix des Script-Namen zu bestimmen. Im Speziellen bestimmt Django den Original-Präfix automatisch, wenn der Server SCRIPT_URL (spezifisch für Apaches mod_rewrite) oder REDIRECT_URL (gesetzt von einer Reihe von Servern inkl. Apache + mod_rewrite in einigen Fällen) setzt.

In Situationen, wo Django nicht in der Lage war, den korrekten Präfix zu bestimmen, kannst du den Wert mit der FORCE_SCRIPT_NAME-Einstellung in deiner settings-Datei korrigieren. Damit setzt du den Script-Namen durchgängig für jede URL, die mit dieser settings-Datei generiert wird. Wenn du folglich unterschiedliche Script-Namen benötigst, brauchst du auch mehrere settings-Dateien.

Wenn deine Django-Konfiguration zum Beispiel alle URLs unterhalb von '/' anbieten soll und du diese Einstellung verwenden möchtest, setze FORCE_SCRIPT_NAME = '' in deiner settings-Datei.