Ce document a pour but de vous préparer à faire fonctionner Django.
\nDjango est un cadriciel Web Python. Voir Quelle version de Python puis-je utiliser avec Django ? pour plus de détails.
\nObtenez la dernière version de Python à l’adresse https://www.python.org/downloads/ ou par l’intermédiaire du gestionnaire des paquets de votre système.
\n\n\nmod_wsgiLien vers cette rubrique#Si vous voulez juste faire quelques expériences avec Django, passez directement à la section suivante ; Django inclut un serveur Web léger utilisable pour les tests, il n’est donc pas utile de configurer Apache tant que vous ne souhaitez pas déployer Django en production.
\nSi vous souhaitez utiliser Django sur un site en production, utilisez Apache avec mod_wsgi. mod_wsgi fonctionne dans deux modes : un mode intégré et un mode démon. Dans le mode intégré, mod_wsgi est comparable à mod_perl, il intègre Python dans Apache et charge le code Python en mémoire au démarrage du serveur. Le code reste en mémoire tout au long du cycle de vie du processus Apache, ce qui apporte des améliorations de performance significatives en comparaison d’autres configurations. En mode démon, mod_wsgi délègue la gestion des requêtes à un processus démon indépendant. Ce processus peut fonctionner sous un nom d’utilisateur différent de celui du serveur Web, ce qui peut améliorer la sécurité. D’autre part, le processus peut être redémarré sans devoir redémarrer tout le serveur Web Apache, ce qui peut simplifier la mise à jour de code. Consultez la documentation de mod_wsgi pour déterminer le mode qui vous conviendra le mieux. Assurez-vous que Apache est installé et que son module mod_wsgi est activé. Django fonctionne avec toute version d’Apache qui prend en charge mod_wsgi.
\nConsultez Comment utiliser Django avec mod_wsgi pour plus d’informations sur la façon de configurer mod_wsgi après l’avoir installé.
\nSi vous n’avez pas la possibilité d’utiliser mod_wsgi, ne désespérez pas : Django prend en charge beaucoup d’autres scénarios de déploiement. L’un d’entre eux est uWSGI ; il fonctionne très bien avec nginx. De plus, Django respecte la spécification WSGI (PEP 3333) ce qui permet de le faire fonctionner sur diverses plates-formes serveurs.
\nSi vous prévoyez d’utiliser la fonctionnalité base de données de Django, vous devez faire le nécessaire pour qu’une base de données soit fonctionnelle. Django sait gérer plusieurs serveurs de bases de données différents ; officiellement, il prend en charge PostgreSQL, MySQL, Oracle et SQLite.
\nSi vous développez un projet simple ou quelque chose que vous ne prévoyez pas de déployer dans un environnement de production, SQLite est généralement l’option la plus simple car elle n’exige pas de serveur séparé. Cependant, SQLite comporte beaucoup de différences en comparaison d’autres bases de données et si vous travaillez sur un projet un peu conséquent, il est recommandé de développer avec la même base de données qui sera utilisée en production.
\nEn plus des bases de données prises en charge officiellement, il existe des moteurs externes à Django qui permettent d’utiliser d’autres bases de données avec Django.
\nEn plus du moteur de base de données, il est aussi nécessaire de vérifier que les liaisons Python pour la base de données sont installées.
\nSi vous utilisez PostgreSQL, vous avez besoin du paquet psycopg2. Vous pouvez consultez les notes sur PostgreSQL pour plus de détails.
Si vous utilisez MySQL, vous aurez besoin d’une API de driver de BDD comme mysqlclient. Voir notes pour le backend MySQL pour plus de détails.
Si vous utilisez SQLite, il est recommandé de lire les notes du moteur SQLite.
Si vous utilisez Oracle, vous aurez besoin d’une copie de cx_Oracle, mais veuillez lire les notes spécifiques pour le moteur de base de données Oracle pour les détails concernant les versions prises en charge d’Oracle et de cx_Oracle.
Si vous utilisez un moteur externe non officiel, consultez la documentation qui l’accompagne pour d’éventuels contraintes supplémentaires.
Si vous pensez utiliser la commande de Django manage.py migrate pour créer automatiquement les tables de base de données pour vos modèles (après la fin de l’installation de Django et la création d’un projet), vous devez vous assurer que Django possède les permissions de créer et modifier les tables dans la base de données que vous utilisez ; si vous pensez créer manuellement les tables, il suffit alors d’attribuer à Django les permissions SELECT, INSERT, UPDATE et DELETE. Après avoir créé un utilisateur de base de données possédant ces permissions, il s’agira d’indiquer les détails de connexion dans le fichier de réglages de votre projet, voir DATABASES pour les détails.
Si vous utilisez l”infrastructure de test de Django pour tester les requêtes de bases de données, Django aura besoin des permissions nécessaires pour créer une base de données de test.
\nLes instructions d’installation divergent légèrement selon que vous installez un paquet de votre distribution, que vous téléchargez la dernière version officielle ou que vous récupériez la dernière version en développement.
\nC’est facile, quelle que soit la méthode choisie.
\nC’est la façon recommandée d’installer Django.
\nInstallez pip. La manière la plus simple est d’utiliser l”installeur pip autonome. Si votre distribution contient déjà une version installée de pip, il pourrait être nécessaire de la mettre à jour si elle est trop ancienne. Dans ce cas, vous le verrez bien car l’installation ne fonctionnera pas.
Jetez un œil à virtualenv et virtualenvwrapper. Ces outils fournissent des environnements Python isolés qui sont bien plus pratiques que d’installer des paquets au niveau de tout le système. Ils permettent aussi d’installer des paquets sans avoir besoin de privilèges administrateurs. Le tutoriel de contribution vous guide pour la création d’un environnement virtualenv.
Après avoir créé et activé un environnement virtuel, entrez la commande :
\nLinux / macOS
$ pip install Django\nWindows
...\\> pip install Django\nParcourez les notes spécifiques aux distributions pour vérifier que votre plate-forme/distribution propose des paquets ou installeurs officiels de Django. Les paquets fournis par les distributions permettent généralement de profiter de l’installation automatique des dépendances et de mises à niveau plus faciles ; toutefois, ces paquets correspondent rarement aux dernières versions de Django.
\nSi vous aimeriez pouvoir mettre à jour occasionnellement votre version de Django avec les dernières corrections et améliorations, suivez ces instructions :
\nVérifiez que Git est installé et que vous pouvez lancer ses commandes depuis un terminal (saisissez git help à l’invite de commande pour le tester).
Créez une copie de travail de la branche principale de développement de Django comme ceci :
\nLinux / macOS
$ git clone https://github.com/django/django.git\nWindows
...\\> git clone https://github.com/django/django.git\nUn répertoire django sera créé dans le répertoire actuel.
Vérifiez que l’interpréteur Python peut charger le code de Django. La façon la plus pratique de faire cela est d’utiliser virtualenv, virtualenvwrapper, et pip. Le tutoriel de contribution vous guide pour la création d’un environnement virtualenv.
Après avoir configuré et activé l’environnement virtuel, exécutez la commande suivante :
\nLinux / macOS
$ pip install -e django/\nWindows
...\\> pip install -e django\\\nCeci rendra le code Django importable et mettra aussi à disposition la commande utilitaire django-admin. En d’autres mots, vous serez fin prêt !
Lorsque vous souhaitez mettre à jour votre copie du code source de Django, lancez simplement la commande git pull à partir du répertoire django. Quand vous faites cela, Git télécharge automatiquement toutes les modifications.