Les informations de ce cours proviennent en partie de la documentation de Django

https://docs.djangoproject.com/fr/4.1/

python3
pip

venv

  $ python -m pip install Django

  $ python -m django --version

Si Django est installé, vous devriez voir apparaître la version de l’installation. Dans le cas contraire, vous obtiendrez une erreur disant « No module named django » (aucun module nommé django).

Depuis un terminal en ligne de commande, ce placer dans le dossier dans lequel vous souhaitez conserver votre code, puis lancez la commande suivante :

$ django-admin startproject monsupersite

$ python -m django startproject monsupersite

Cela va créer un répertoire monsupersite dans le répertoire courant.

Note:Vous devez éviter de nommer vos projets en utilisant des noms réservés de Python ou des noms de composants de Django. Cela signifie en particulier que vous devez éviter d’utiliser des noms comme `django` (qui entrerait en conflit avec Django lui-même) ou `test` (qui entrerait en conflit avec un composant intégré de Python).

Voyons ce que `startproject` a créé :

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

Ces fichiers sont :

• Le premier répertoire racine monsupersite/ est un contenant pour votre projet. Son nom n’a pas d’importance pour Django ; vous pouvez le renommer comme vous voulez.
• manage.py : un utilitaire en ligne de commande qui vous permet d’interagir avec ce projet Django de différentes façons. Vous trouverez toutes les informations nécessaires sur manage.py dans django-admin et manage.py.
• Le sous-répertoire monsupersite/ correspond au paquet Python effectif de votre projet. C’est le nom du paquet Python que vous devrez utiliser pour importer ce qu’il contient (par ex. monsupersite.urls).
• monsupersite/__init__.py : un fichier vide qui indique à Python que ce répertoire doit être considéré comme un paquet. Si vous êtes débutant en Python, lisez les informations sur les paquets (en) dans la documentation officielle de Python.
• monsupersite/settings.py : réglages et configuration de ce projet Django. Les réglages de Django vous apprendra tout sur le fonctionnement des réglages.
• monsupersite/urls.py : les déclarations des URL de ce projet Django, une sorte de « table des matières » de votre site Django. Vous pouvez en lire plus sur les URL dans Distribution des URL.
• monsupersite/asgi.py : un point d’entrée pour les serveurs Web compatibles aSGI pour déployer votre projet. Voir Comment déployer avec ASGI pour plus de détails.
• monsupersite/wsgi.py : un point d’entrée pour les serveurs Web compatibles WSGI pour déployer votre projet. Voir Comment déployer avec WSGI pour plus de détails.

Vérifions que votre projet Django fonctionne. Déplacez-vous dans le répertoire monsupersite si ce n’est pas déjà fait, et lancez la commande suivante :

$ python manage.py runserver

Vous verrez les messages suivants défiler en ligne de commande :

Performing system checks...

System check identified no issues (0 silenced).

You have unapplied migrations; your app may not work properly until they are applied.
Run 'python manage.py migrate' to apply them.

août 02, 2021 - 15:50:53
Django version 3.2, using settings 'monsupersite.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

Ignorez pour l’instant l’avertissement au sujet des migrations de base de données non appliquées ; nous nous occuperons de la base de données plus tard.

Vous avez démarré le serveur de développement de Django, un serveur Web léger entièrement écrit en Python.

Ne jamais utiliser ce serveur pour l'environnement de production. Il est fait seulement pour tester le travail pendant le développement.

Allez à l’adresse http://127.0.0.1:8000 et vérifiez que la page avec le message « Félicitations ! » ainsi qu’une fusée qui décolle s'affiche

Pour stopper le serveur, faire ctrl + c

Par défaut, la commande `runserver` démarre le serveur de développement sur l’IP interne sur le port 8000.

Si vous voulez changer cette valeur, passez-la comme paramètre sur la ligne de commande. Par exemple, cette commande démarre le serveur sur le port 8080 :

$ python manage.py runserver 8080

Si vous voulez changer l’IP du serveur, passez-la comme paramètre avec le port. Par exemple, pour écouter toutes les IP publiques disponibles (ce qui est utile si vous exécutez Vagrant ou que souhaitez montrer votre travail à des personnes sur d’autres ordinateurs de votre réseau), faites :

La documentation complète du serveur de développement se trouve dans la référence de `runserver`.

Le serveur de développement recharge automatiquement le code Python lors de chaque requête si nécessaire. Vous ne devez pas redémarrer le serveur pour que les changements de code soient pris en compte. Cependant, certaines actions comme l’ajout de fichiers ne provoquent pas de redémarrage, il est donc nécessaire de redémarrer manuellement le serveur dans ces cas.

• https://docs.djangoproject.com/fr/4.1/intro/install/
• https://docs.djangoproject.com/fr/4.1/intro/tutorial01/