Django est le framework Web Python le plus populaire conçu pour aider les développeurs à créer des applications Web sécurisées, évolutives et maintenables.
Django peut être installé à l'échelle du système ou dans un environnement virtuel Python à l'aide de pip. Les packages Django sont inclus dans les dépôts officiels Debian et peuvent être installés à l'aide de apt
directeur chargé d'emballage. C'est la méthode la plus simple pour installer Django sur Debian 9, mais pas aussi flexible que l'installation dans un environnement virtuel. De plus, la version incluse dans les référentiels a toujours plusieurs versions de retard sur la dernière version de Django.
L'objectif principal des environnements virtuels Python est de créer un environnement isolé pour différents projets Python. De cette façon, vous pouvez avoir plusieurs environnements Django différents sur un seul ordinateur et installer une version spécifique d'un module par projet sans craindre que cela n'affecte vos autres installations Django. Si vous installez Django dans l'environnement global, vous ne pouvez installer qu'une seule version de Django sur votre ordinateur.
Installer Django sur Debian 9 #
Effectuez les étapes suivantes pour installer Django dans un environnement virtuel Python sur Debian 9.
1. Installer Python 3 et venv #
Debian 9 est livré avec Python 3.5 par défaut. Vous pouvez vérifier que Python 3 est installé sur votre système en tapant :
python3 -V
Le résultat devrait ressembler à ceci :
Python 3.5.3
La méthode recommandée pour créer un environnement virtuel consiste à utiliser le venv
module.
Le venv
le module est inclus dans le python3-venv
emballer. Installez-le en tapant la commande suivante :
sudo apt install python3-venv
Une fois le module installé, nous sommes prêts à créer un environnement virtuel pour notre application Django.
2. Création d'un environnement virtuel #
Commencez par naviguer vers le répertoire où vous souhaitez stocker vos environnements virtuels Python 3. Il peut s'agir de votre répertoire personnel ou de tout autre répertoire dans lequel votre utilisateur dispose d'autorisations de lecture et d'écriture.
Créez un nouveau répertoire pour votre application Django et naviguez-y :
mkdir my_django_app
cd my_django_app
Depuis le répertoire, exécutez la commande suivante pour créer un nouvel environnement virtuel :
python3 -m venv venv
La commande ci-dessus crée un répertoire appelé venv
, qui contient une copie du binaire Python, du gestionnaire de packages Pip, de la bibliothèque Python standard et d'autres fichiers de support. Vous pouvez utiliser le nom de votre choix pour l'environnement virtuel.
Pour commencer à utiliser l'environnement virtuel, activez-le en exécutant le activate
script :
source venv/bin/activate
Une fois activé, le répertoire bin de l'environnement virtuel sera ajouté au début du $PATH
variable. L'invite de votre shell changera également et affichera le nom de l'environnement virtuel que vous utilisez actuellement. Dans notre cas, c'est venv
.
3. Installer Django #
Maintenant que l'environnement virtuel est actif, installez Django en utilisant le gestionnaire de packages Python pip
:
pip install django
Dans l'environnement virtuel, vous pouvez utiliser la commande pip
au lieu de pip3
et python
au lieu de python3
. Vérifiez l'installation à l'aide de la commande suivante qui imprimera la version de Django :
python -m django --version
Au moment de la rédaction de cet article, la dernière version de Django est 2.1.2
.
2.1.3
Votre version de Django peut être différente de la version présentée ici.
4. Création d'un projet Django #
Utilisez le django-admin
utilitaire de ligne de commande pour créer un nouveau projet Django nommé mydjangoapp
:
django-admin startproject mydjangoapp
La commande ci-dessus va créer un mydjangoapp
répertoire dans votre répertoire courant.
tree mydjangoapp/
mydjangoapp/
|-- manage.py
`-- mydjangoapp
|-- __init__.py
|-- settings.py
|-- urls.py
`-- wsgi.py
Dans ce répertoire, vous trouverez le script principal de gestion des projets nommé manage.py
et un autre répertoire comprenant la configuration de la base de données, Django et les paramètres spécifiques à l'application.
Migrons la base de données et créons un utilisateur administratif.
Tout d'abord, accédez à mydjangoapp
répertoire :
cd mydjangoapp
SQLite est la base de données par défaut pour Django. Pour les applications de production, vous pouvez utiliser PostgreSQL, MariaDB, Oracle ou MySQLDatabase.
Migrez la base de données en saisissant :
python manage.py migrate
Le résultat ressemblera à ceci :
Operations to perform:
Apply all migrations: admin, auth, contenttypes, sessions
Running migrations:
Applying contenttypes.0001_initial... OK
Applying auth.0001_initial... OK
Applying admin.0001_initial... OK
Applying admin.0002_logentry_remove_auto_add... OK
Applying admin.0003_logentry_add_action_flag_choices... OK
Applying contenttypes.0002_remove_content_type_name... OK
Applying auth.0002_alter_permission_name_max_length... OK
Applying auth.0003_alter_user_email_max_length... OK
Applying auth.0004_alter_user_username_opts... OK
Applying auth.0005_alter_user_last_login_null... OK
Applying auth.0006_require_contenttypes_0002... OK
Applying auth.0007_alter_validators_add_error_messages... OK
Applying auth.0008_alter_user_username_max_length... OK
Applying auth.0009_alter_user_last_name_max_length... OK
Applying sessions.0001_initial... OK
Une fois la base de données migrée, créer un utilisateur administratif sera utilisé pour accéder à l'interface d'administration de Django :
python manage.py createsuperuser
La commande vous demandera un nom d'utilisateur, une adresse e-mail et un mot de passe.
Username (leave blank to use 'linuxize'): admin
Email address: [email protected]
Password:
Password (again):
Superuser created successfully.
5. Test du serveur de développement #
Démarrez le serveur Web de développement à l'aide de manage.py
script suivi du runserver
choix :
python manage.py runserver
Vous verrez le résultat suivant :
Performing system checks...
System check identified no issues (0 silenced).
October 20, 2018 - 11:16:28
Django version 2.1.2, using settings 'mydjangoapp.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.
Si vous avez installé Django sur une machine virtuelle et que vous souhaitez accéder au serveur de développement Django, vous devrez modifier le settings.py
fichier et ajoutez l'adresse IP du serveur dans le ALLOWED_HOSTS
liste.
Ouvrez http://127.0.0.1:8000
dans votre navigateur Web et la page d'accueil par défaut de Django vous sera présentée :
Pour accéder à l'interface d'administration de Django, ajoutez /admin
à la fin de l'URL (http://127.0.0.1:8000/admin/
). Cela vous amènera à l'écran de connexion de l'administrateur :
Entrez votre nom d'utilisateur et votre mot de passe et vous serez redirigé vers la page d'administration de Django :
Pour arrêter le serveur de développement tapez CTRL-C
dans votre terminal.
6. Désactivation de l'environnement virtuel #
Une fois votre travail terminé, désactivez l'environnement en tapant deactivate
et vous reviendrez à votre shell normal.
deactivate