Django en serveur - Sommaire : Site en Python (Django) sous Apache avec mod_python.
(Voici la suite de ma petite série "faire mumuse avec python sur son serveur".)
Lorsque j'ai parlé du framework python Django, beaucoup d'entre vous m'ont fait la réfléxion du :
Ça à l'air cool (ça l'est ! :p), mais la dernière fois que j'ai tenté de faire marcher python avec apache, ça a été l'enfer !
Ce jour est révolu :) Bon, sur le site de Django, ils conseillent d'utiliser mod_wsgi, mais pour ce tutoriel, nous utiliserons mod_python.
Donc tout d'abord, nous allons l'installer (méthode pour Debian) :
apt-get install libapache2-mod-python
Ensuite, il va falloir l'activer :
a2enmod python
ou équivalent :
ln -s /etc/apache2/mods-available/python.load /etc/apache2/mods-enabled/
Ensuite, il va falloir créer un VirtualHost qui indiquera à Apache que pour ce domaine, il faut utiliser python. Voici un exemple de VirtualHost spécifique à Django :
<VirtualHost *:80>
ServerAdmin postmaster@[domain].tld
ServerName www.[domain].tld
ServerAlias [domain].tld
DocumentRoot /var/www/[domain]/www/[domain]
ErrorLog /var/log/apache2/[domain]_error.log
LogLevel warn
CustomLog /var/log/apache2/[domain]_access.log combined
ServerSignature Off
<Location "/">
SetHandler mod_python
PythonHandler django.core.handlers.modpython
SetEnv DJANGO_SETTINGS_MODULE [nom_du_projet_django].settings
PythonPath "['/var/www/[domain]/www/'] + sys.path"
PythonAutoReload Off
PythonDebug Off
</Location>
Alias /media "/var/www/[domain]/www/media"
<Location "/media/">
SetHandler None
</Location>
Alias /static "/var/www/[domain]/www/static"
<Location "/static/">
SetHandler None
</Location>
<LocationMatch "\.(jpg|gif|png)$">
SetHandler None
</LocationMatch>
</VirtualHost>Quelques explications s'imposent. Pour mes projets Django, j'ai choisis de faire un structure simple. Dans le dossier de mon projet (appelons le "domain"), j'ai le nom du sous-domaine (ici, www), et dedans, je crée trois dossiers :
- [domain] (le même nom que son dossier parent aka le nom du projet) : il contiendra le code Django
- static : il contiendra tous les fichiers nécéssaire au site : css, js, images, etc
- template : il contient les templates utilisés par Django
Du coup, le fichier de configuration semble un peu plus clair : on définis un Handler de type python pour le répertoire qui contient le code python (/var/www/[domain]/www/[domain]), puis on définis un Handler null (donc aucune interprétation d'un quelconque code) pour les autres dossiers (media et static).
Maintenant, vous vous demandez à quoi sert "media".
En fait, ce répertoire est un liens symbolique que nous allons créer, et qui pointe sur le module admin de Django. En effet, dans la configuration actuelle, si vous tentez d'accéder à l'admin (en ajoutant un /admin/ sur l'url), vous verrez que les images, le style et le javascript ne sont pas présents.
Logique ! Comment apache peux deviner d'où ils viennent ?
Donc pour que notre admin soit fonctionnel, il faut faire un lien symbolique du module admin à notre projet (en supposant que vous avez installez Django comme indiquez dans notre précédent article) :
ln -s /opt/django/django/contrib/admin/media/ /var/www/[domain]/www/media
Du coup, la configuration dans votre VirtualHost prendra aussi effet pour ce répertoire.
Voilà !
Vous n'avez plus qu'à redémarrer, et si votre fichier settings.py de votre projet est correct (notamment au niveau des répertoires ;)), votre site devrait-être accessible !
