Comment installer Django avec Windows¶
Ce document vous guide dans l’installation de Python 3.8 et de Django pour Windows. Il fournit également des instructions de configuration d’un environnement virtuel qui facilite le travail sur des projets Python. L’objectif est d’en faire une introduction pour les utilisateurs travaillant sur des projets Django, et non pas de décrire la manière d’installer Django pour pouvoir développer des correctifs pour Django lui-même.
Les étapes de ce guide ont été testées avec Windows 10. Avec d’autres versions, les instructions devraient être similaires. Vous devez être à l’aise avec l’utilisation de l’invite de commandes de Windows.
Installation de Python¶
Django est un applicatif Web pour Python, il nécessite donc que Python soit installé sur le système. Au moment de la rédaction de ce guide, Python 3.8 est la version la plus récente.
Pour installer Python sur votre machine, visitez https://www.python.org/downloads/. Ce site devrait vous proposer un bouton de téléchargement pour la dernière version de Python. Téléchargez l’exécutable d’installation et lancez-le. Cochez les cases « Install launcher for all users (recommended) » puis cliquez sur « Installer maintenant ».
Après l’installation, ouvrez l’invite de commande et vérifiez que la version de Python correspond à celle que vous avez installée en exécutant :
...\> py --version
Voir aussi
Pour plus de détails, lisez la documentation Using Python on Windows.
À propos de pip
¶
pip est un gestionnaire de paquet pour Python et il est inclus par défaut dans l’installeur Python. Il aide à installer et désinstaller des paquets Python (tels que Django !). Pour le reste de l’installation, nous utiliserons pip
pour installer des paquets Python à partir de la ligne de commande.
Configuration d’un environnement virtuel¶
Une bonne pratique reconnue est de définir un environnement dédié pour chaque projet Django que vous créez. Il existe de nombreuses options pour gérer les environnements et les paquets dans l’écosystème Python, dont certains sont recommandés dans la documentation de Python. Python lui-même contient venv pour la gestion des environnements et c’est celui que nous allons utiliser dans ce guide.
Pour créer un environnement virtuel pour votre projet, ouvrez une nouvelle invite de commande et placez-vous dans le dossier dans lequel vous souhaitez créer le projet, puis saisissez ce qui suit
...\> py -m venv project-name
Cela va créer un dossier nommé « project-name » s’il n’existe pas déjà et va configurer l’environnement virtuel. Pour activer l’environnement, exécutez
...\> project-name\Scripts\activate.bat
L’environnement virtuel sera activé et vous verrez « (nom-du-projet) » à côté de l’invite de commande pour vous en convaincre. Chaque fois que vous lancez une nouvelle invite de commande, vous devrez activer à nouveau l’environnement.
Installation de Django¶
Django peut être installé facilement en utilisant pip
dans votre environnement virtuel.
Dans l’invite de commande, vérifiez que l’environnement virtuel est actif et exécutez la commande suivante :
...\> py -m pip install Django
Ceci va télécharger et installer la dernière version de Django.
À la fin de l’installation, vous pouvez contrôler que tout s’est bien déroulé en exécutant django-admin --version
dans l’invite de commande.
Consultez Mise en route de la base de données pour plus d’informations sur l’installation de bases de données avec Django.
Sortie de terminal colorée¶
Une fonctionnalité très appréciable affiche du contenu coloré dans le terminal. Avec les terminaux modernes, cela doit fonctionner aussi bien avec CMD que PowerShell. Si pour une raison quelconque ceci doit être désactivé, définissez la variable d’environnement DJANGO_COLORS
à nocolor
.
Sur les anciennes versions de Windows ou d’anciens terminaux, colorama doit être installé pour activer la syntaxe colorée
...\> py -m pip install colorama
Voir Syntaxe colorée pour plus d’informations sur les réglages de couleur.
Problèmes fréquents¶
Si
django-admin
n’affiche que le texte d’aide quels que soient les paramètres indiqués, il y a probablement un problème avec les associations de fichiers dans Windows. Contrôlez s’il y a plus d’une variable d’environnement définie pour l’exécution de scripts Python dansPATH
. Cela se produit généralement lorsqu’il y a plusieurs versions de Python installées.Si vous passez par un serveur mandataire (proxy) pour vous connecter à Internet, il peut y avoir des problèmes lorsque vous lancez la commande
py -m pip install Django
. Définissez les variables d’environnement de configuration du serveur mandataire dans l’invite de commande, comme ceci :...\> set http_proxy=http://username:password@proxyserver:proxyport ...\> set https_proxy=https://username:password@proxyserver:proxyport
En général, Django suppose que les entrées/sorties utilisent le codage
UTF-8
. Cela peut être problématique si votre système est configuré pour utiliser un autre codage. Les versions récentes de Python permettent de définir la variable d’environnementPYTHONUTF8
afin de forcer le codage enUTF-8
. Windows 10 propose aussi un réglage système que l’on peut activer en cochantUtiliser Unicode UTF-8 pour la prise en charge universelle des langues
dans dans les réglages système.