Installer et configurer un Environnement de développement Django

Objectifs

Ce tutoriel a pour but de vous guider dans l’installation et la configuration d’un environnement de développement Django sur votre machine. À la fin de ce guide, vous serez en mesure de :

Installer Python et pip.
Créer et activer un environnement virtuel Python.
Installer Django dans cet environnement.
Créer un nouveau projet Django.
Lancer le serveur de développement Django.

Prérequis

Avant de commencer, assurez-vous d’avoir des connaissances de base en ligne de commande et en Python. Aucune expérience préalable avec Django n’est requise.

Étape 1 : Installer Python et pip

Django est un framework web écrit en Python, il est donc essentiel d’avoir Python installé sur votre système.

Windows :
- Téléchargez l’installateur depuis le site officiel de Python : python.org/downloads.
- Lors de l’installation, cochez l’option “Add Python to PATH” pour faciliter l’utilisation en ligne de commande.
macOS et Linux :
- Python est généralement préinstallé.
- Pour vérifier, ouvrez un terminal et exécutez

python --version

Si Python n’est pas installé ou si vous souhaitez une version plus récente, téléchargez-la depuis python.org.

pip est le gestionnaire de paquets de Python, généralement inclus avec Python. Pour vérifier son installation, exécutez :

pip --version

Si pip n’est pas installé, vous pouvez l’installer en suivant les instructions officielles : Installation de pip.

Étape 2 : Créer un Environnement Virtuel

Il est recommandé d’utiliser un environnement virtuel pour isoler les dépendances de votre projet.

Ouvrez un terminal ou l’invite de commandes.
Naviguez vers le répertoire où vous souhaitez créer votre projet.
Exécutez les commandes suivantes :

Windows

python -m venv env
env\Scripts\activate

macOS et Linux :

python3 -m venv env
source env/bin/activate

L’invite de commande devrait maintenant afficher le nom de votre environnement virtuel entre parenthèses, indiquant qu’il est activé.

Étape 3 : Installer Django

Avec l’environnement virtuel activé, installez la dernière version de Django en utilisant pip.

pip install django

Pour vérifier que l’installation a réussi, exécutez :

python -m django --version

Cela devrait afficher le numéro de version de Django installé.

Étape 4 : Créer un Nouveau Projet Django

Utilisez l’outil django-admin pour créer un nouveau projet.

django-admin startproject nom_du_projet

Remplacez nom_du_projet par le nom souhaité pour votre projet.

Étape 5 : Démarrer le Serveur de Développement

Naviguez dans le répertoire de votre projet et lancez le serveur de développement pour vérifier que tout fonctionne correctement.

cd nom_du_projet
python manage.py runserver

Accédez à http://127.0.0.1:8000/ dans votre navigateur pour voir la page d’accueil par défaut de Django.

Étape 6 : Créer une Application au Sein du Projet

Pour ajouter une nouvelle application à votre projet, exécutez :

python manage.py startapp nom_de_l_application

Remplacez nom_de_l_application par le nom souhaité pour votre application.

Après l’installation rendez-vous dans le fichier setting.py à la racine du projet et rajouter votre application dans INSTALLED_APPS

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'nom_de_l_application' # rajouter le nom de votre application
]

Étape 7 : Configurer la Base de Données

Par défaut, Django utilise SQLite comme base de données. Si vous souhaitez utiliser une autre base de données (comme PostgreSQL, MySQL, etc.), vous devrez installer le pilote approprié et modifier les paramètres de la base de données dans le fichier settings.py de votre projet.

Étape 8 : Appliquer les Migrations Initiales

Django utilise un système de migration pour gérer les modifications de la base de données. Appliquez les migrations initiales en exécutant :

python manage.py migrate

Étape 9 : Créer un Superutilisateur

Pour accéder à l’interface d’administration de Django, créez un superutilisateur :

python manage.py createsuperuser

Suivez les invites pour définir un nom d’utilisateur, une adresse e-mail et un mot de passe.

Étape 10 : Accéder à l’Interface d’Administration

Avec le serveur de développement en cours d’exécution, accédez à http://127.0.0.1:8000/admin/ dans votre navigateur et connectez-vous avec les identifiants du superutilisateur que vous venez de créer.

En suivant ces étapes, vous aurez configuré un environnement de développement Django fonctionnel avec la dernière version du framework. Pour plus de détails et des instructions spécifiques, consultez la documentation officielle de Django.