1. Installation de Django

Prérequis (Python, pip, environnement virtuel)

Avant d’installer Django, il est nécessaire d’avoir Python installé sur votre machine (version 3.8 ou supérieure recommandée). Django s’appuie sur l'utilitaire pip gestionnaire de paquets de Python, pour l’installation et la gestion des dépendances. Il est également conseillé de travailler dans un environnement virtuel (virtual environment) afin d’isoler les dépendances de chaque projet. Cela évite les conflits entre différentes versions de bibliothèques utilisées dans plusieurs projets.

Création d’un environnement virtuel :

Activer l'environnement virtuel

Sous Windows :

Sous Linux/Mac :

Installation de Django avec pip :

Une fois l’environnement virtuel activé, l’installation de Django se fait simplement via pip:

Nous pouvons aussi vérifier la version installée avec:

2. Structure d’un projet Django

Après installation de django, nous pouvons créer notre premier projet Django nommé à titre d'exemple 'my_project' en utilisant la commande suivante:

Ceci génère l'arborescence des fichiers suivante que nous allons détailler:

1. Le répertoire racine my_project/: designe le conteneur de votre projet. Il englobe tout le contenu de votre site.
2. Le fichier "manage.py": est un script qui permet d'effectuer diverses tâches liées à votre projet Django, telles que lancer le serveur de développement, effectuer des migrations de base de données, etc.
3. Le répertoire "mysite": contient les fichiers principaux du projet :
4. Le fichier "init.py": indique que ce répertoire est un package Python.
5. Le fichier "settings.py": contient les paramètres de configuration pour votre projet, tels que la base de données, les applications installées, les clés secrètes, etc.
6. Le fichier "urls.py": définit les URL (chemins d'accès) de votre application, en spécifiant quelles vues doivent être appelées pour chaque URL.
7. Les fichiers "asgi.py" et "wsgi.py" : ont des points d'entrée pour les serveurs ASGI (Asynchronous Server Gateway Interface) et WSGI (Web Server Gateway Interface), respectivement. Ils permettent de déployer votre application Django sur des serveurs compatibles.

3. Demarrage du serveur Django du projet

Afin de s'assurer que notre premier projet Django fonctionne correctement nous devons:

1. Se déplacer via la commande cmd et se diriger vers le répertoire externe my_project de votre application
2. Exécuter ensuite la commande suivante:

Nous verrons alors la sortie suivante sur la ligne de commande:

Qui nous indique que le serveur est démarré à l'adresse http://127.0.0.1:8000

Si on souhaite accéder à la home page de notre serveur, il suffit de tapez l'adresse indiquée ci-dessus sur la barre d'adresse du navigateur pour vour voir finalement la page d'accueil par défaut de django:

4. Changement du port 8000

Le serveur django choisi le port 8000 par défaut! Mais il arrive parfois que ce port soit occupé par d'autres processus, et que vous devriez le changer, il suffit alors pour cela d'ajouter le numéro de port de votre choix juste après la commande runserver:

Exemple: changement du port

Dans ce cas le serveur sera accessible à l'adresse : http://127.0.0.1:5050

Commande d'arrêt du serveur

Pour arrêter le serveur, il suffit de taper la combinaison de touche : Ctrl + C

 

Younes Derfoufi CRMEF OUJDA