{"title":"Comment installer Django avec Windows","version":"3.1","locale":"fr","docname":"howto/windows","url":"/fr/3.1/howto/windows/","canonical":"https://djangodocs.dev/fr/3.1/howto/windows/","summary":"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…","html":"<h1>Comment installer Django avec Windows<a class=\"heading-anchor\" href=\"#how-to-install-django-on-windows\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>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.</p>\n<p>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.</p>\n<section id=\"install-python\">\n<span id=\"install-python-windows\"></span><h2>Installation de Python<a class=\"heading-anchor\" href=\"#install-python\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>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.</p>\n<p>Pour installer Python sur votre machine, visitez <a class=\"reference external\" href=\"https://python.org/downloads/\">https://python.org/downloads/</a>. 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 ».</p>\n<p>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 :</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> py --version\n</code></pre></div>\n<aside class=\"admonition admonition-seealso\">\n<p class=\"admonition-title\">Voir aussi</p>\n<p>Pour plus de détails, lisez la documentation <a class=\"reference external\" href=\"https://docs.python.org/3/using/windows.html\" title=\"(disponible dans Python v3.14)\"><span>Using Python on Windows</span></a>.</p>\n</aside>\n</section>\n<section id=\"about-pip\">\n<h2>À propos de <code class=\"docutils literal notranslate\"><span class=\"pre\">pip</span></code><a class=\"heading-anchor\" href=\"#about-pip\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<p><a class=\"reference external\" href=\"https://pypi.org/project/pip/\">pip</a> 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 <code class=\"docutils literal notranslate\"><span class=\"pre\">pip</span></code> pour installer des paquets Python à partir de la ligne de commande.</p>\n</section>\n<section id=\"setting-up-a-virtual-environment\">\n<span id=\"virtualenvironment\"></span><h2>Configuration d’un environnement virtuel<a class=\"heading-anchor\" href=\"#setting-up-a-virtual-environment\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>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 <a class=\"reference external\" href=\"https://packaging.python.org/guides/tool-recommendations/\">documentation de Python</a>. Python lui-même contient <a class=\"reference external\" href=\"https://docs.python.org/3/tutorial/venv.html\" title=\"(disponible dans Python v3.14)\"><span class=\"xref std std-doc\">venv</span></a> pour la gestion des environnements et c’est celui que nous allons utiliser dans ce guide.</p>\n<p>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</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> py -m venv project-name\n</code></pre></div>\n<p>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</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> project-name\\Scripts\\activate.bat\n</code></pre></div>\n<p>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.</p>\n</section>\n<section id=\"install-django\">\n<h2>Installation de Django<a class=\"heading-anchor\" href=\"#install-django\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Django peut être installé facilement en utilisant <code class=\"docutils literal notranslate\"><span class=\"pre\">pip</span></code> dans votre environnement virtuel.</p>\n<p>Dans l’invite de commande, vérifiez que l’environnement virtuel est actif et exécutez la commande suivante :</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> py -m pip install Django\n</code></pre></div>\n<p>Ceci va télécharger et installer la dernière version de Django.</p>\n<p>À la fin de l’installation, vous pouvez contrôler que tout s’est bien déroulé en exécutant <code class=\"docutils literal notranslate\"><span class=\"pre\">django-admin</span> <span class=\"pre\">--version</span></code> dans l’invite de commande.</p>\n<p>Consultez <a class=\"reference internal\" href=\"/fr/3.1/topics/install/#database-installation\"><span class=\"std std-ref\">Mise en route de la base de données</span></a> pour plus d’informations sur l’installation de bases de données avec Django.</p>\n</section>\n<section id=\"common-pitfalls\">\n<h2>Problèmes fréquents<a class=\"heading-anchor\" href=\"#common-pitfalls\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<ul>\n<li><p>Si <code class=\"docutils literal notranslate\"><span class=\"pre\">django-admin</span></code> 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 dans <code class=\"docutils literal notranslate\"><span class=\"pre\">PATH</span></code>. Cela se produit généralement lorsqu’il y a plusieurs versions de Python installées.</p></li>\n<li><p>Si vous passez par un serveur mandataire (proxy) pour vous connecter à Internet, il peut y avoir des problèmes lorsque vous lancez la commande <code class=\"docutils literal notranslate\"><span class=\"pre\">py</span> <span class=\"pre\">-m</span> <span class=\"pre\">pip</span> <span class=\"pre\">install</span> <span class=\"pre\">Django</span></code>. Définissez les variables d’environnement de configuration du serveur mandataire dans l’invite de commande, comme ceci :</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> <span class=\"k\">set</span> <span class=\"nv\">http_proxy</span><span class=\"p\">=</span>http://username:password@proxyserver:proxyport\n<span class=\"gp\">...\\&gt;</span> <span class=\"k\">set</span> <span class=\"nv\">https_proxy</span><span class=\"p\">=</span>https://username:password@proxyserver:proxyport\n</code></pre></div>\n</li>\n</ul>\n</section>","rootId":"how-to-install-django-on-windows","toc":[{"title":"Installation de Python","anchor":"install-python","children":[]},{"title":"À propos de pip","anchor":"about-pip","children":[]},{"title":"Configuration d’un environnement virtuel","anchor":"setting-up-a-virtual-environment","children":[]},{"title":"Installation de Django","anchor":"install-django","children":[]},{"title":"Problèmes fréquents","anchor":"common-pitfalls","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"Guides pratiques","url":"/fr/3.1/howto/"}],"prev":{"docname":"howto/static-files/deployment","title":"Déploiement des fichiers statiques","url":"/fr/3.1/howto/static-files/deployment/"},"next":{"docname":"howto/writing-migrations","title":"Écriture de migrations de base de données","url":"/fr/3.1/howto/writing-migrations/"},"formats":{"html":"/fr/3.1/howto/windows/","markdown":"/fr/3.1/howto/windows.md","json":"/fr/3.1/howto/windows.json"},"source":"https://github.com/django/django/blob/stable/3.1.x/docs/howto/windows.txt","official":"https://docs.djangoproject.com/fr/3.1/howto/windows/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","pt-br","ko","es","el","pl"]}