40.3    Erstellen eines neuen Django-Projekts 

Bevor wir mit Django arbeiten können, müssen wir einen Projektordner erstellen, der die Konfiguration unseres Projekts enthält. Django stellt dazu das Tool django-admin.py bereit. Mit dem folgenden Befehl in der Kommandozeile wird die Projektstruktur angelegt.

$ django-admin.py startproject news_seite

Die Zeichenfolge news_seite ist dabei der gewünschte Name des neuen Projekts. Nach der erfolgreichen Ausführung von django-admin.py existiert eine neue Ordnerstruktur mit den Projektdateien auf der Festplatte (siehe Abbildung 40.1).

Abbildung 40.1    Ordnerstruktur eines frischen Django-Projekts

Wie Sie sehen, wurden zwei verschachtelte Verzeichnisse mit dem Namen des Projekts news_seite angelegt. Dabei enthält das innere Verzeichnis das eigentliche Projekt, während das äußere Verzeichnis zur Verwaltung dient.

In Tabelle 40.1 sind die Bedeutungen der einzelnen Dateien erklärt.

Tabelle 40.1    Bedeutung der Dateien in einem Django-Projekt

Nun können wir mit der Arbeit an dem Projekt beginnen.

 

40.3.1    Der Entwicklungswebserver 

Das frische Projektskelett kann in diesem Zustand schon getestet werden. Um die Entwicklung von Django-Anwendungen zu erleichtern, bietet das Framework einen einfachen Webserver an. Dieser Server überwacht ständig die Änderungen, die Sie am Code Ihrer Anwendung vornehmen, und lädt automatisch die veränderten Programmteile nach, ohne dass er dazu neu gestartet werden muss.

Den Entwicklungswebserver können Sie über das Verwaltungsprogramm manage.py starten, indem Sie den Parameter runserver übergeben. Bevor Sie den Befehl ausführen, müssen Sie in das Projektverzeichnis news_seite wechseln. Unter Windows entfällt das Kommando python zu Beginn des folgenden Beispiels, falls Sie .py-Dateien mit Python verknüpft haben.

$ cd news_seite
$ python manage.py runserver
python manage.py runserver
Performing system checks...

System check identified no issues (0 silenced).

You have 13 unapplied migration(s). Your project may not work properly until 
you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them.

February 12, 2017 - 16:28:08
Django version 1.10.5, using settings 'news_seite.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

Wie Sie der Ausgabe entnehmen können, ist der Entwicklungsserver unter der Adresse http://127.0.0.1:8000/ erreichbar. Die Seite sieht im Browser folgendermaßen aus:

Abbildung 40.2    Ausgabe des noch leeren Projekts im Browser

 

40.3.2    Konfiguration des Projekts 

Bevor wir sinnvoll mit unserem Projekt arbeiten können, muss es konfiguriert werden. Dazu öffnen wir die Datei settings.py in einem Texteditor. Es handelt sich bei der Datei um ein einfaches Python-Modul, das Django über globale Variablen konfiguriert. Allerdings beinhaltet es auch sehr spezielle Einstellungen, die uns an dieser Stelle nicht interessieren.

Wir beschränken uns im ersten Schritt auf die Einstellungen, die die Datenbank von Django betreffen. In der Datei finden Sie einen Block der folgenden Gestalt:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
}

Das Dictionary DATABASES definiert die Datenbanken, die mit dem Django-Projekt verwendet werden sollen. Dabei wird dem Namen jeder Datenbank ein weiteres Dictionary mit der Datenbankkonfiguration zugeordnet. In einem Projekt, das nur eine Datenbank verwendet, gibt es nur den obligatorischen Eintrag 'default'.

Der Wert zum Schlüssel ENGINE legt den verwendeten Datenbanktreiber fest. Django liefert die folgenden Treiber mit:[ 209 ](Neben diesen mitgelieferten Treibern gibt es weitere Treiber, die von anderen Anbietern zur Verfügung gestellt werden. Informationen dazu finden Sie unter https://docs.djangoproject.com/en/1.10/ref/databases/#third-party-notes. )

Tabelle 40.2    Von Django mitgelieferte Datenbanktreiber. Gegebenenfalls werden Drittanbietermodule benötigt.

Die weiteren Angaben legen die Parameter der Datenbank fest. Für SQLite3 im Beispiel gibt der Parameter NAME den Pfad zu der Datenbankdatei an. Weitere Parameter sind HOST, PORT, USER und PASSWORD, mit denen der Zugang zu einem Datenbankserver zum Beispiel bei MySQL oder PostgreSQL festgelegt werden kann.

Da SQLite standardmäßig mit Python ausgeliefert wird und daher bei der Verwendung von SQLite keine zusätzlichen Module installiert werden müssen, wird unser Beispielprojekt eine SQLite-Datenbank nutzen. Dazu belassen wir die beiden für SQLite relevanten Einstellungen ENGINE und NAME wie in der Standardkonfiguration, wodurch die Datenbankdatei im selben Verzeichnis wie manage.py angelegt wird.

Außerdem sollten Sie die Sprache von Django auf die Gegebenheiten von Deutschland umstellen. Dies geschieht mit der Anpassung der Variablen LANGUAGE_CODE.

LANGUAGE_CODE = 'de-DE'

Der Einfachheit halber deaktivieren wir außerdem Djangos Unterstützung für Zeitzonen, indem wir die Variable USE_TZ anpassen.

USE_TZ = False

Wenn Sie nun in Ihrem Webbrowser die Adresse http://127.0.0.1:8000/ neu laden, erscheint die Standardausgabe des neuen Projekts aus Abbildung 40.2 in deutscher Sprache.

Damit sind die grundlegenden Einstellungen vorgenommen, und wir können uns an unsere erste Django-Applikation wagen.