Django 'Hello World'

Avant de pouvoir faire fonctionner Django, vous aurez besoin de Python 3.8+ et de pip (le gestionnaire de paquets Python par excellence) installés sur votre système. La plupart des systèmes d'exploitation modernes sont livrés avec Python préinstallé, mais il est toujours bon de vérifier.

Ouvrez votre terminal et vérifiez quelle version de Python s'y trouve :

python3 --version

Si vous ne voyez pas quelque chose comme Python 3.8.x ou une version plus récente, ou si Python n'est pas trouvé, alors un passage rapide sur python.org vous permettra de régler le problème. Assurez-vous de télécharger la dernière version stable de la branche 3.x, Django l'adore.

Écoutez, tripoter les paquets Python globaux, c'est comme laisser un enfant en bas âge se déchaîner dans une bibliothèque immaculée : ça devient vite le chaos. C'est pourquoi nous utilisons des environnements virtuels. Ce sont des bulles propres et autonomes pour les dépendances de votre projet, gardant tout rangé et évitant les conflits.

D'abord, décidez où votre projet Django va vivre. Naviguez-y dans votre terminal, puis créez un nouvel environnement virtuel :

python3 -m venv .venv

Maintenant, activons-le. La commande diffère légèrement selon votre système d'exploitation :

# Sur macOS/Linux
source .venv/bin/activate

# Sur Windows (utilisez l'invite de commande)
.venv\Scripts\activate

Vous saurez que cela fonctionne lorsque votre invite de terminal sera précédée de (.venv). C'est comme un petit badge d'honneur, signifiant votre royaume de développement isolé.

Avec notre environnement virtuel en marche, il est temps de passer à l'événement principal : intégrer Django. C'est étonnamment facile, une seule commande suffit.

Dans votre environnement virtuel actif, exécutez :

pip install django

Pip téléchargera Django et tous ses compagnons nécessaires. Une fois terminé, vous êtes officiellement un développeur équipé de Django. Le framework est installé et prêt à être utilisé.

Maintenant, place à la magie de Django ! Nous utiliserons la commande django-admin, fournie avec Django, pour créer un tout nouveau projet. Pensez-y comme si Django posait les plans fondamentaux de votre application web.

Depuis le répertoire racine de votre projet (où se trouve votre .venv), exécutez cette commande :

django-admin startproject mysite .

Le . à la fin est important ; il indique à Django de créer les fichiers du projet dans votre répertoire actuel, plutôt que de les imbriquer dans un autre dossier mysite. Vous aurez maintenant une structure de projet Django de base, une sorte de squelette pour vos rêves web.

Une fois que vous avez exécuté la commande startproject, votre répertoire aura fleuri avec quelques nouveaux fichiers et un sous-répertoire. Il vaut la peine d'y jeter un œil rapide pour comprendre ce qui est quoi :

.
├── .venv/                  # Votre environnement virtuel
├── manage.py               # Un utilitaire en ligne de commande pour Django
└── mysite/                 # Le package Python réel de votre projet
    ├── __init__.py         # Fait de mysite un package Python
    ├── asgi.py             # Point d'entrée ASGI pour les serveurs asynchrones
    ├── settings.py         # Paramètres et configurations du projet
    ├── urls.py             # Vos déclarations d'URL du projet
    └── wsgi.py             # Point d'entrée WSGI pour les serveurs synchrones
                                

manage.py est votre fidèle compagnon pour tout ce qui concerne les commandes Django. Dans mysite/, settings.py est l'endroit où vous modifierez les configurations, et urls.py est le contrôleur de trafic principal de votre projet.

Avant même de penser à voir une page web, Django doit configurer ses tables de base de données par défaut. Il est livré avec des fonctionnalités intégrées, telles que l'authentification des utilisateurs et une interface d'administration, et celles-ci ont besoin d'un endroit pour stocker leurs données.

C'est là qu'interviennent les migrations. Ce sont essentiellement des instructions pour votre base de données. Exécutez ceci depuis la racine de votre projet (où se trouve manage.py) :

python manage.py migrate

Vous verrez une activité intense pendant que Django crée des tables pour l'authentification, les sessions et son panneau d'administration dans la base de données SQLite par défaut. C'est comme préparer les fondations avant de construire des murs.

Dans Django, un "projet" est une collection de configurations et d'"applications". Une "application" est une application web qui fait une chose spécifique : un blog, un sondage, un simple "Hello World". Cette modularité est l'une des superpuissances de Django, vous permettant de réutiliser des applications dans différents projets.

Créons notre toute première application. Nous l'appellerons hello_world_app. Exécutez cette commande :

python manage.py startapp hello_world_app

Vous verrez maintenant un nouveau répertoire, hello_world_app/, imbriqué dans votre projet. C'est là que la magie de notre "Hello World" va réellement se produire.

Django ne connaît pas magiquement les nouvelles applications que vous créez. Vous devez indiquer explicitement dans les paramètres de votre projet que cette nouvelle application existe et qu'elle doit être incluse. C'est comme ajouter un nouveau membre à un club : vous devez mettre à jour la liste des membres.

Ouvrez mysite/settings.py et trouvez la liste INSTALLED_APPS. Ajoutez-y votre nouvelle hello_world_app :

# mysite/settings.py

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'hello_world_app',  # <-- Ajoutez cette ligne
]
                                

Sans cela, Django ne prendrait pas la peine de chercher dans votre nouvelle application les vues, modèles ou quoi que ce soit d'autre. C'est une poignée de main cruciale entre votre projet et son nouveau composant brillant.

Une "vue" dans Django est une fonction ou une classe Python qui prend une requête web et renvoie une réponse web. Essentiellement, c'est la logique centrale qui décide quel contenu afficher lorsque quelqu'un visite une URL particulière.

Ouvrez hello_world_app/views.py et remplacez son contenu par cette fonction simple :

# hello_world_app/views.py

from django.http import HttpResponse

def index(request):
    return HttpResponse("Hello, Django World!")
                                

Cette fonction, index, est remarquablement simple : elle affiche simplement le texte "Hello, Django World!" lorsqu'elle est appelée. Plutôt sympa pour une première étape, non ?

Pour que votre nouvelle vue soit accessible via une adresse web, elle a besoin d'un schéma d'URL. Nous allons créer un fichier dédié urls.py *à l'intérieur* de notre hello_world_app pour gérer ses routes spécifiques. Cela maintient les choses modulaires, comme Django l'aime.

Créez un nouveau fichier : hello_world_app/urls.py, et donnez-lui ce contenu :

# hello_world_app/urls.py

from django.urls import path
from . import views

urlpatterns = [
    path("", views.index, name="index"),
]
                                

Ici, path("", views.index, name="index") signifie qu'un chemin vide (c'est-à-dire la racine de l'espace d'URL de notre application) déclenchera notre vue index. Simple, non ?

Nous avons informé notre application de ses propres URLs, mais le répartiteur d'URL principal du projet (mysite/urls.py) doit toujours être informé que notre hello_world_app a des chemins qui l'intéressent. C'est comme avoir une succursale, mais le siège social doit savoir qu'elle existe pour réacheminer le courrier.

Ouvrez mysite/urls.py et ajoutez un include pour relier les URLs de votre application :

# mysite/urls.py

from django.contrib import admin
from django.urls import path, include # <-- Ajoutez 'include'

urlpatterns = [
    path("admin/", admin.site.urls),
    path("", include("hello_world_app.urls")), # <-- Ajoutez cette ligne
]
                                

Maintenant, lorsque quelqu'un visite l'URL racine de votre projet (/), Django "inclura" les schémas d'URL de hello_world_app/urls.py et trouvera votre vue "Hello World". Les pièces s'assemblent !

Nous avons posé toutes les bases, assemblé le code et défini les routes. Maintenant, le moment de vérité ! Django est livré avec un serveur de développement léger, idéal pour tester les choses localement.

Depuis le répertoire racine de votre projet (où se trouve manage.py), exécutez :

python manage.py runserver

Vous verrez un flot de sortie dans le terminal, se terminant par quelque chose comme Starting development server at http://127.0.0.1:8000/. Cela signifie que votre serveur Django est en marche et attend patiemment les requêtes.

Le moment est venu ! Ouvrez votre navigateur web et naviguez vers l'adresse fournie par Django, généralement http://127.0.0.1:8000/.

Si tous les fils sont connectés correctement, vous devriez être accueilli par une page web simple affichant fièrement :

Et voilà, votre toute première application "Hello World" Django, en direct et diffusant du contenu ! C'est un petit pas, mais il confirme que tout est correctement configuré, de Python au routage des URL de Django. Vous avez officiellement lancé votre voyage dans le développement Django.