Django est un framework web populaire en Python qui offre une structure robuste et des outils pour créer des applications web rapidement et facilement. Dans cet article, nous allons voir étape par étape pour créer votre premier projet Django.

  1. Installation et création d’un environnement virtuel

Avant de commencer, vous devez vous assurer que Python est installé sur votre ordinateur. Si ce n’est pas le cas, vous pouvez le télécharger et l’installer à partir du site officiel de Python.

Ensuite, vous devez créer un environnement virtuel pour votre projet Django. Un environnement virtuel vous permet d’installer des packages Python spécifiques pour chaque projet, sans affecter les autres projets. Voici comment créer un environnement virtuel sur Windows et Linux :

Sur Windows :

pip install virtualenv

virtualenv myenv

Sur Linux :

sudo apt-get install python3-pip
sudo pip3 install virtualenv
python3 -m venv myenv
ou
virtualenv myenv

2. Activation de l’environnement virtuel

Maintenant que vous avez créé l’environnement virtuel, vous devez l’activer. Voici comment activer l’environnement virtuel sur Windows et Linux :

Sur Windows :

myenv\Scripts\activate (activation)

Sur Linux :

source myenv/bin/activate (activation)

3. Installation de Django

Maintenant que vous avez activé l’environnement virtuel, vous pouvez installer Django en utilisant pip, le gestionnaire de packages Python. Voici comment installer Django :

pip install django

4. Vérification de la version de Django

Avant de créer votre projet Django, il est important de vérifier la version de Django que vous avez installée. Pour cela, vous pouvez utiliser la commande suivante :

django-admin --version

5. Création d’un projet Django

Une fois que vous avez installé Django, vous pouvez créer votre premier projet Django en utilisant la commande suivante :

django-admin startproject myproject

Cette commande crée un dossier appelé “myproject” qui contient les fichiers nécessaires pour votre projet Django.

6. Explication de la structure du projet

myproject/
  myenv/
  manage.py : le fichier qui est utilisé pour gérer le projet Django
  myproject/
    settings.py : le fichier de configuration principal de votre projet Django
    urls.py : le fichier qui contient les URL de votre projet Django
    asgi.py : le point d'entrée de l'interface asynchrone entre le serveur web et votre application
    wsgi.py : le point d'entrée de l'interface synchrone entre le serveur web et votre application

7. Lancement du serveur

Maintenant que vous avez créé votre projet Django, vous pouvez lancer le serveur web en utilisant la commande suivante :

python manage.py runserver

Cette commande lance le serveur web local à l’adresse http://127.0.0.1:8000/

Press enter or click to view image in full sizerunserver

8. Création d’une application

Maintenant que vous avez créé votre projet Django, vous pouvez créer une application Django en utilisant la commande suivante :

python manage.py startapp myapp

Cette commande crée un dossier appelé “myapp” qui contient les fichiers nécessaires pour votre application Django.

9. Explication de la structure de l’application

Voici une explication de la structure de l’application

myapp/
  init.py : un fichier vide qui indique à Python que ce dossier doit être considéré comme un package Python
  admin.py : le fichier qui contient la configuration de l'interface d'administration de votre application
  apps.py : le fichier de configuration de votre application
  models.py : le fichier qui contient les modèles de données de votre application
  tests.py : le fichier qui contient les tests pour votre application
  views.py : le fichier qui contient les vues de votre application

Ajouter votre application myapp à la liste des applications installées dans le fichier settings.py, vous devez ajouter 'myapp', à la liste INSTALLED_APPS comme suit :

INSTALLED_APPS = [    
    'django.contrib.admin',
    'django.contrib.auth',    
    'django.contrib.contenttypes', 
    'django.contrib.sessions',  
    'django.contrib.messages',    
    'django.contrib.staticfiles',   
    'myapp',#nouveau
]

Cette liste contient les noms des applications que vous avez créées dans votre projet Django, ainsi que les applications intégrées de Django. En ajoutant 'myapp' à la liste, Django saura que votre application doit être installée et utilisée dans le projet

10. Faire les migrations

Maintenant que vous avez créé votre application, vous pouvez créer les tables correspondantes dans la base de données en utilisant la commande suivante :

python manage.py makemigrations
python manage.py migrates

La première commande crée un fichier de migration qui décrit les modifications à apporter à la base de données. La deuxième commande applique ces modifications à la base de données.

11. Configuration du setting pour les templates et static

Pour permettre à Django de trouver les fichiers de templates et les fichiers statiques de votre application, vous devez les ajouter à la variable TEMPLATES et STATICFILES_DIRS dans le fichier settings.py. Voici un exemple de configuration :

TEMPLATES = [    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': ['templates'],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

STATICFILES_DIRS = [    os.path.join(BASE_DIR, 'static'),]

12. Création d’une vue pour afficher un “Hello World”

Maintenant que vous avez configuré votre application, vous pouvez créer une vue qui affiche “Hello World”. Pour cela, vous devez ajouter le code suivant dans le fichier views.py :

from django.shortcuts import render
from django.http import HttpResponse

def hello_world(request):
    return HttpResponse('Hello World')

La vue hello_world renvoie une réponse HTTP avec le contenu "Hello World" en utilisant l'objet HttpResponse fourni par Django. Cette réponse sera ensuite affichée sur la page Web.

13. Création de l’URL de la vue

Enfin, vous devez créer l’URL qui pointe vers votre vue. Pour cela, vous devez ajouter le code suivant dans le fichier urls.py de votre application :

from django.urls import path
from . import views

urlpatterns = [
    path('hello/', views.hello_world, name='hello'),
]

Ensuite, vous devez inclure ces URL dans le fichier urls.py principal de votre projet. Pour cela, vous pouvez utiliser la fonction include() comme suit :

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('myapp/', include('myapp.urls')),
]

Maintenant, si vous accédez à l’URL http://127.0.0.1:8000/myapp/hello/, vous devriez voir le message “Hello World” s’afficher.

Press enter or click to view image in full size

Bravo, vous avez réussi à créer votre premier projet Django ! En suivant ces étapes, vous avez appris à installer Django, à créer un projet et une application Django, à faire les migrations, à configurer les paramètres de votre projet pour les templates et les fichiers statiques, et à créer une vue et une URL pour afficher un simple “Hello World” sur une page web.

Bien entendu, ceci n’est qu’un début et il reste beaucoup à apprendre sur Django. Cependant, ce tutoriel vous donne une base solide pour poursuivre votre apprentissage et explorer les nombreuses fonctionnalités et capacités de ce puissant framework web.

J espère que cet article vous a été utile pour démarrer votre projet Django et je vous souhaite bonne chance pour la suite de votre aventure dans le développement web avec Django !

Voir ma vidéo sur Apprendre les Bases de Django en 2023

Voir sur Youtube