Contao installieren

Nachdem du alle Voraussetzungen geprüft und deinen Webserver eingerichtet hast, kannst du nun mit der Installation beginnen.

Es gibt zwei Wege um Contao auf deinem Server zu installieren, zum einen über die grafische Oberfläche des Contao Managers und zum anderen über die Kommandozeile.

Installation mit dem Contao Manager

Contao Manager installieren

Bevor du Contao auf deinem Server installieren kannst, musst du den Contao Manager installieren und konfigurieren.

Contao mit dem Contao Manager installieren

Nach der erfolgreichen Grundkonfiguration kann nun Contao installiert werden. Dazu wählst du die gewünschte Version sowie die initiale Konfiguration aus und klickst auf die Schaltfläche »Installieren«.

Contao per Contao Manager installieren Contao per Contao Manager installieren

Die Installation kann nun mehrere Minuten in Anspruch nehmen. Details zum Installationsprozess können durch Klick auf folgendes Symbol Konsolenausgabe anzeigen/verstecken Konsolenausgabe anzeigen/verstecken angezeigt werden.

Contao wird installiert Contao wird installiert

Datenbanktabellen aktualisieren

Sobald der Contao Manager alle Pakete installiert hat, muss die Datenbank aktualisiert werden. Dazu kannst du das Contao Install Tool (Contao 4.13 LTS) verwenden. Ab Contao 5 ist dies nicht mehr notwendig, da die Datenbank direkt über den Contao Manager aktualisiert werden kann.

Installation über die Kommandozeile

Bei der Installation über die Kommandozeile wird während dem create-project ein composer update ausgeführt. Das wird bei einigen Hostern dazu führen, dass der Prozess wegen der zu hohen Systemanforderung nicht beendet werden kann und die Installation dadurch fehlschlägt. In diesem Fall solltest du den Contao Manager nutzen.

Du hast dich mit deinem Benutzernamen und deiner Domain auf deinem Server angemeldet.

ssh benutzername@example.com

Wechsle in das öffentliche Verzeichnis deines Webhosting.

cd www

Composer installieren

Composer ist ein anwendungsorientierter Paketmanager für die Programmiersprache PHP und installiert Abhängigkeiten.

Info

Du kannst Composer entweder lokal oder global installieren.
Wenn du Composer lokal installierst, befindet sich die Datei composer.phar in deinem Arbeitsverzeichnis (d. h. dort, wo auch die Dateien composer.json und composer.lock deines Projekts gespeichert sind). In diesem Fall rufst du Composer über php composer.phar auf.
Wenn du Composer global installierst, kannst du den Befehl composer in jedem Verzeichnis verwenden.

Contao über die Kommandozeile installieren

Im zweiten Schritt installierst du Contao über den Composer. Dabei steht »example« für das gewünschte Installations-Verzeichnis und die 5.5 für die zu installierende Contao-Version.

php composer.phar create-project contao/managed-edition example 5.5

Hosting-Konfiguration

In Contao befinden sich alle öffentlich erreichbaren Dateien im Unterordner /web der Installation. Erstelle diesen Ordner und setze das Wurzelverzeichnis (Document Root) der Installation über das Admin-Panel des Hosting-Providers auf diesen Unterordner und richte bei dieser Gelegenheit noch eine Datenbank ein.

Beispiel: example.com zeigt auf das Verzeichnis /www/example/web

(ab 4.12 Dem Standard von Symfony folgend, wurde der öffentlich erreichbare Unterordner von /web in /public umbenannt. Falls in deiner Installation ein Verzeichnis /web existiert, wird dieses von Contao automatisch anstelle von /public verwendet.)

Info

Pro Contao-Installation wird deshalb eine eigene (Sub)Domain benötigt.

Datenbanktabellen aktualisieren

Sobald der Contao Manager alle Pakete installiert hat, muss die Datenbank aktualisiert werden. Dazu kannst du das Contao Install Tool (Contao 4.13 LTS) verwenden. Ab Contao 5 ist dies nicht mehr notwendig, da die Datenbank direkt über den Contao Manager aktualisiert werden kann.

Ab Contao 4.9 steht dir hierzu der folgende Befehl auf der Kommandozeile zur Verfügung:

php vendor/bin/contao-console contao:migrate
Tipp

Du kannst dir auf der Kommandozeile auch zuvor eine Datenbank erstellen:
php vendor/bin/contao-console doctrine:database:create

Anmerkung

Contao muss hierzu die entsprechenden Verbindungsdaten deiner Datenbank kennen. Diese Information kann entweder über eine vorhandene »config/parameters.yaml« (wird zur Zeit über das Contao-Installtool erstellt) oder über eine ».env« Datei im Hauptverzeichnis deiner Installation bereit gestellt werden.

Weitere Details für die notwendigen Umgebungsvariablen (DATABASE_URL und APP_SECRET) in einer ».env« Datei findest du hier.

Contao Backend-Benutzer erstellen

Über den Contao Manager kannst du dir deinen Backend Benutzer anlegen.

Ab Contao 4.10 kannst du hierzu den folgenden Befehl auf der Kommandozeile benutzen. Die notwendigen Angaben werden dann auf der Kommandozeile abgefragt:

php vendor/bin/contao-console contao:user:create