Django 'Hello World'

Bevor wir Django zum Laufen bringen können, benötigen Sie Python 3.8+ und pip (Pythons Standard-Paketinstallateur) auf Ihrem System. Die meisten modernen Betriebssysteme werden mit vorinstalliertem Python geliefert, aber es ist immer gut, dies noch einmal zu überprüfen.

Öffnen Sie Ihr Terminal und sehen Sie nach, welche Python-Version dort vorhanden ist:

python3 --version

Wenn Sie nicht etwas wie Python 3.8.x oder neuer sehen oder wenn Python nicht gefunden wird, dann hilft Ihnen ein kurzer Besuch auf python.org weiter. Stellen Sie sicher, dass Sie die neueste stabile 3.x-Version herunterladen – Django liebt sie.

Sehen Sie, mit globalen Python-Paketen herumzuspielen ist wie ein Kleinkind in einer makellosen Bibliothek loszulassen – die Dinge werden schnell unordentlich. Deshalb verwenden wir virtuelle Umgebungen. Sie sind ordentliche, in sich geschlossene Blasen für die Abhängigkeiten Ihres Projekts, die alles ordentlich halten und Konflikte vermeiden.

Entscheiden Sie sich zuerst, wo Ihr Django-Projekt leben soll. Navigieren Sie dort in Ihrem Terminal hin und dann erstellen Sie eine neue virtuelle Umgebung:

python3 -m venv .venv

Nun, lassen Sie uns sie aktivieren. Der Befehl unterscheidet sich je nach Betriebssystem leicht:

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

# Auf Windows (verwenden Sie die Eingabeaufforderung)
.venv\Scripts\activate

Sie wissen, dass es funktioniert, wenn Ihre Terminal-Eingabeaufforderung ein kleines (.venv)-Präfix erhält. Es ist wie ein kleines Ehrenzeichen, das Ihr isoliertes Entwicklungsreich kennzeichnet.

Mit unserer virtuellen Umgebung im Gange ist es Zeit für das Hauptereignis: Django in den Mix zu bringen. Das ist überraschend einfach – nur ein einziger Befehl.

Führen Sie in Ihrer aktiven virtuellen Umgebung Folgendes aus:

pip install django

Pip holt sich Django und alle notwendigen Begleiter. Sobald es fertig ist, sind Sie offiziell ein Django-fähiger Entwickler. Das Framework ist installiert und bereit, eingesetzt zu werden.

Jetzt kommt etwas Django-Magie! Wir verwenden das django-admin-Kommando, das mit Django gebündelt ist, um ein brandneues Projekt zu erstellen. Stellen Sie es sich so vor, als würde Django die grundlegenden Blaupausen für Ihre Webanwendung erstellen.

Führen Sie diesen Befehl von Ihrem Projektstammverzeichnis (wo sich Ihr .venv befindet) aus:

django-admin startproject mysite .

Der Punkt am Ende ist wichtig; er weist Django an, die Projektdateien in Ihrem aktuellen Verzeichnis zu erstellen, anstatt sie in einem weiteren mysite-Ordner zu verschachteln. Sie haben jetzt eine grundlegende Django-Projektstruktur, eine Art Skelett für Ihre Webträume.

Nachdem Sie den Befehl startproject ausgeführt haben, hat sich Ihr Verzeichnis mit einigen neuen Dateien und einem Unterverzeichnis gefüllt. Es lohnt sich, einen kurzen Blick darauf zu werfen, um zu verstehen, was was ist:

.
├── .venv/                  # Ihre virtuelle Umgebung
├── manage.py               # Ein Kommandozeilen-Dienstprogramm für Django
└── mysite/                 # Das eigentliche Python-Paket für Ihr Projekt
    ├── __init__.py         # Macht mysite zu einem Python-Paket
    ├── asgi.py             # ASGI-Einstiegspunkt für asynchrone Server
    ├── settings.py         # Projekteinstellungen und Konfigurationen
    ├── urls.py             # Ihre Projekteinrichtung für URLs
    └── wsgi.py             # WSGI-Einstiegspunkt für synchrone Server
                                

manage.py ist Ihr treuer Begleiter für alles, was mit der Django-Kommandozeile zu tun hat. In mysite/ ist settings.py der Ort, an dem Sie Konfigurationen anpassen, und urls.py ist die Hauptverkehrsregelung Ihres Projekts.

Bevor wir überhaupt daran denken, eine Webseite zu sehen, muss Django seine Standarddatenbanktabellen einrichten. Es verfügt über einige integrierte Funktionen wie Benutzerauthentifizierung und eine Admin-Oberfläche, und diese benötigen einen Ort, um ihre Daten zu speichern.

Hier kommen Migrationen ins Spiel. Sie sind im Wesentlichen Anweisungen für Ihre Datenbank. Führen Sie dies von Ihrem Projektstammverzeichnis (wo sich manage.py befindet) aus:

python manage.py migrate

Sie werden eine Flut von Aktivitäten sehen, während Django Tabellen für die Authentifizierung, Sitzungen und sein Admin-Panel in der Standard-SQLite-Datenbank erstellt. Es ist, als würde man das Fundament vorbereiten, bevor man Wände baut.

In Django ist ein "Projekt" eine Sammlung von Konfigurationen und "Apps". Eine "App" ist eine Webanwendung, die eine bestimmte Aufgabe erledigt – ein Blog, eine Umfrage, ein einfaches "Hello World". Diese Modularität ist eine der Stärken von Django und ermöglicht es Ihnen, Apps in verschiedenen Projekten wiederzuverwenden.

Lassen Sie uns unsere allererste App erstellen. Wir nennen sie hello_world_app. Führen Sie diesen Befehl aus:

python manage.py startapp hello_world_app

Sie sehen nun ein neues Verzeichnis, hello_world_app/, das in Ihrem Projekt verschachtelt ist. Hier wird die Magie unseres "Hello World" tatsächlich stattfinden.

Django weiß nicht automatisch von neuen Apps, die Sie erstellen. Sie müssen Ihrem Projekt explizit mitteilen, dass diese neue App existiert und einbezogen werden soll. Es ist, als würde man ein neues Mitglied zu einem Club hinzufügen – Sie müssen die Mitgliederliste aktualisieren.

Öffnen Sie mysite/settings.py und finden Sie die Liste INSTALLED_APPS. Fügen Sie Ihre neue hello_world_app hinzu:

# 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',  # <-- Fügen Sie diese Zeile hinzu
]
                                

Ohne dies würde Django nicht in Ihrer neuen App nach Views, Models oder irgendetwas anderem suchen. Es ist ein entscheidender Handschlag zwischen Ihrem Projekt und seiner glänzenden neuen Komponente.

Eine "View" in Django ist eine Python-Funktion oder -Klasse, die eine Webanfrage entgegennimmt und eine Webantwort zurückgibt. Im Wesentlichen ist es die Kernlogik, die entscheidet, welche Inhalte angezeigt werden, wenn jemand eine bestimmte URL besucht.

Öffnen Sie hello_world_app/views.py und ersetzen Sie seinen Inhalt durch diese einfache Funktion:

# hello_world_app/views.py

from django.http import HttpResponse

def index(request):
    return HttpResponse("Hallo, Django Welt!")
                                

Diese Funktion, index, ist bemerkenswert einfach: sie gibt einfach den Text "Hallo, Django Welt!" aus, wenn sie aufgerufen wird. Ziemlich nett für den ersten Schritt, oder?

Damit Ihre neue View über eine Webadresse erreichbar ist, benötigt sie ein URL-Muster. Wir erstellen eine dedizierte urls.py-Datei *innerhalb* unserer hello_world_app, um ihre spezifischen Routen zu verwalten. Das hält die Dinge modular, so wie Django es mag.

Erstellen Sie eine neue Datei: hello_world_app/urls.py, und geben Sie ihr diesen Inhalt:

# hello_world_app/urls.py

from django.urls import path
from . import views

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

Hier bedeutet path("", views.index, name="index"), dass ein leerer Pfad (d. h. die Wurzel des URL-Raums unserer App) unsere index-View auslöst. Einfach, oder?

Wir haben unserer App ihre eigenen URLs mitgeteilt, aber der Haupt-URL-Dispatcher des Projekts (mysite/urls.py) muss immer noch darüber informiert werden, dass unsere hello_world_app Pfade hat, die sie interessieren. Es ist, als hätte man eine Zweigstelle, aber die Hauptzentrale muss wissen, dass sie existiert, um Post weiterzuleiten.

Öffnen Sie mysite/urls.py und fügen Sie ein include hinzu, um Ihre App-URLs zu verlinken:

# mysite/urls.py

from django.contrib import admin
from django.urls import path, include # <-- 'include' hinzufügen

urlpatterns = [
    path("admin/", admin.site.urls),
    path("", include("hello_world_app.urls")), # <-- Diese Zeile hinzufügen
]
                                

Jetzt, wenn jemand die Stamm-URL Ihres Projekts (/) besucht, wird Django die URL-Muster aus hello_world_app/urls.py "einbinden" und Ihre "Hello World"-View finden. Die Teile fügen sich zusammen!

Wir haben die gesamte Grundlage geschaffen, den Code zusammengenäht und die Routen definiert. Jetzt kommt der Moment der Wahrheit! Django wird mit einem leichten Entwicklungsserver geliefert, der sich perfekt zum lokalen Testen eignet.

Führen Sie von Ihrem Projektstammverzeichnis (wo sich manage.py befindet) Folgendes aus:

python manage.py runserver

Sie sehen eine Menge Terminalausgabe, die mit etwas wie Starting development server at http://127.0.0.1:8000/ endet. Das bedeutet, dass Ihr Django-Server läuft und geduldig auf Anfragen wartet.

Der Moment ist gekommen! Öffnen Sie Ihren Webbrowser und navigieren Sie zu der Adresse, die Django angegeben hat, normalerweise http://127.0.0.1:8000/.

Wenn alle Verbindungen korrekt sind, sollten Sie von einer einfachen Webseite begrüßt werden, die stolz anzeigt:

Und da haben Sie es – Ihre allererste Django "Hello World"-Anwendung, live und mit Inhalten! Es ist ein kleiner Schritt, aber er bestätigt, dass alles korrekt konfiguriert ist, von Python bis zum URL-Routing von Django. Sie haben offiziell Ihre Reise in die Django-Entwicklung gestartet.