Django : installation et configuration de l'environnement de développement

Django est un framework de haut niveau qui encourage un développement rapide et un design pragmatique.

Son approche “batteries incluses” signifie qu’il est livré avec une multitude de fonctionnalités prêtes à l’emploi, vous permettant de vous concentrer sur la logique de votre application plutôt que de réinventer la roue.

L’objectif de cet article est simple : vous guider pas à pas pour installer Django et mettre en place un environnement de développement propre et robuste. C’est la première étape cruciale pour construire des applications web solides et évolutives.

Prérequis

Avant de nous lancer, assurons-nous que vous avez tout ce qu’il faut. Pas d’inquiétude, la liste est courte :

• Des connaissances de base en Python : Vous n’avez pas besoin d’être un expert, mais une compréhension des concepts de base comme les variables, les fonctions et les structures de données vous sera très utile.
• Un terminal ou une ligne de commande : C’est ici que nous allons taper nos commandes. Que vous soyez sur Windows (PowerShell, CMD), macOS (Terminal) ou Linux, l’important est d’être à l’aise avec son utilisation.
• Python et pip installés : Django est un framework Python, donc Python est indispensable. pip est le gestionnaire de paquets de Python, et il est généralement installé par défaut avec les versions récentes de Python.

Pour vérifier si Python et pip sont installés, ouvrez votre terminal et tapez les commandes suivantes :

python --version
pip --version

Si vous obtenez des numéros de version, vous êtes prêt ! Sinon, rendez-vous sur le site officiel de Python pour l’installer.

Installation de Django

L’environnement virtuel : une pratique essentielle

En développement Python, il est fondamental de travailler dans un environnement virtuel. C’est un espace isolé qui contient une installation de Python et toutes les dépendances spécifiques à votre projet.

Pourquoi est-ce si important ?

• Isolation : Vous évitez les conflits de versions de paquets entre vos différents projets.
• Reproductibilité : Vous pouvez facilement recréer l’environnement de votre projet sur une autre machine.
• Propreté : Votre installation globale de Python reste propre.

Créons notre environnement virtuel. Choisissez un dossier pour votre projet, ouvrez votre terminal à cet endroit et tapez la commande suivante :

# Crée un environnement virtuel nommé "env"
python -m venv env

Maintenant, activez-le :

# Sur Windows
env\Scripts\activate

# Sur macOS/Linux
source env/bin/activate

Une fois activé, le nom de l’environnement ((env)) apparaîtra dans votre terminal.

Installation de Django avec pip

Maintenant que nous sommes dans notre environnement virtuel, l’installation de Django est un jeu d’enfant. Utilisez pip :

pip install django

Pour vérifier que l’installation s’est bien déroulée, vous pouvez afficher la version de Django :

django-admin --version

Création de votre premier projet Django

Avec Django installé, il est temps de créer la structure de notre projet. Django fournit un utilitaire en ligne de commande, django-admin, pour automatiser cette tâche.

django-admin startproject monprojet .

Analysons cette commande :

• startproject est la commande pour créer un projet.
• monprojet est le nom que nous donnons à notre projet.
• Le . à la fin est très important : il indique à Django de créer le projet dans le répertoire actuel, ce qui évite une imbrication de dossiers inutile.

Cette commande génère l’arborescence suivante :

monprojet/
    __init__.py
    asgi.py
    settings.py
    urls.py
    wsgi.py
manage.py

• manage.py : Votre meilleur ami pour interagir avec votre projet (lancer le serveur, gérer la base de données, etc.).
• monprojet/ : Le package Python de votre projet.
  • settings.py : Le fichier de configuration central de votre projet.
  • urls.py : Le fichier qui définit les routes (URL) de votre site.
  • asgi.py et wsgi.py : Points d’entrée pour les serveurs web.

Configuration de la base de données

Par défaut, Django est configuré pour utiliser SQLite, une base de données légère qui est stockée dans un simple fichier. C’est le choix parfait pour le développement et pour de nombreuses applications de petite et moyenne taille.

Ouvrez le fichier monprojet/settings.py et cherchez la section DATABASES :

# monprojet/settings.py

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    }
}

Pour l’instant, nous n’avons rien besoin de changer. Django créera automatiquement le fichier db.sqlite3 lorsque nous lancerons la première migration.

Si votre projet nécessite une base de données plus robuste comme PostgreSQL, c’est également dans cette section que vous la configurerez. Nous aborderons ce sujet dans un futur article.

Lancement du serveur de développement

Tout est en place ! Il est temps de voir notre projet en action. Pour cela, nous allons utiliser le serveur de développement intégré de Django.

Avant de lancer le serveur, il est recommandé d’appliquer les migrations initiales. Ce sont des scripts qui préparent la base de données pour les applications de base de Django (comme l’authentification).

python manage.py migrate

Maintenant, lancez le serveur :

python manage.py runserver

Ouvrez votre navigateur et rendez-vous à l’adresse http://127.0.0.1:8000/.

Vous devriez voir la page de bienvenue de Django, avec une fusée prête à décoller. Félicitations, votre projet Django est fonctionnel !

Conclusion

Vous avez maintenant toutes les cartes en main pour bien démarrer avec Django.

Vous avez configuré un environnement de développement propre et fonctionnel, installé le framework, et lancé votre tout premier projet.

La prochaine étape consistera à donner vie à votre projet en créant votre première application et en explorant les concepts de modèles et de vues.