Die Entwicklung des Contao Managers wird durch die Contao Association unterstützt.
Contao wird – wie mittlerweile die meisten PHP-Projekte – mit Composer installiert und aktualisiert. Bei Composer handelt es sich um einen Paketmanager der via Kommandozeile bedient wird und auch sonst kann Contao komplett von der Kommandozeile aus verwaltet werden. Der Contao Manager ist ein Tool, welches eine grafische Oberfläche zur einfacheren Verwaltung einer Contao-Installation bietet. Er nimmt dir also die Hürde der Kommandozeile und erlaubt es dir, die nötigen Befehle auf Klick auszuführen.
Mit dem Manager können unter anderem folgende Aufgaben durchgeführt werden:
Für die Zukunft sind weitere Funktionen geplant, wie z. B. Systemeinstellungen festlegen.
Der Contao Manager ist optional und nicht zwingend für den Betrieb von Contao nötig. Das Tool erleichtert jedoch besonders Einsteigern die Installation und Verwaltung von Erweiterungen, da keine Composer-Kenntnisse nötig sind.
Es ist weiterhin möglich die Installation von Contao 4 und Extensions direkt über die Kommandozeile per Composer zu verwalten.
Die Systemvoraussetzungen entsprechen grundsätzlich denen von Contao. Der Contao Manager prüft automatisch, ob die Anforderungen erfüllt sind.
In Contao befinden sich alle öffentlich erreichbaren Dateien im Unterordner /public
der Installation. Erstelle
dazu den Ordner public
und setze das Wurzelverzeichnis (Document Root) der Installation über das Admin-Panel
des Hosting-Providers auf diesen Unterordner.
Beispiel: example.com
zeigt auf das Verzeichnis /www/example/public
(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. Bei einem Wechsel von /web
auf /public
ist die Änderung auch in der composer.json anzugeben.)
Pro Contao-Installation wird deshalb eine eigene (Sub)Domain benötigt.
Der Contao Manager besteht aus einer einzelnen Datei, welche über contao.org
heruntergeladen werden kann. Nach erfolgreichem Download erhältst du eine Datei contao-manager.phar
.
Übertrage diese Datei in das Verzeichnis public
auf deinem Webserver.
.phar
-Dateien werden nicht von allen Hosting-Anbietern ausgeführt. Für beste Kompatibilität füge die
Dateiendung .php
hinzu (Finaler Dateiname: contao-manager.phar.php
).
.php
-Dateien werden von den meisten FTP-Programmen im Text- statt Binär-Modus übertragen, was die
Manager-Datei zerstört. Füge deshalb die Dateiendung .php
erst nach dem Upload hinzu.
Rufe anschließend mit deinem Browser die URL www.example.com/contao-manager.phar.php
auf. Du solltest nun
die Willkommensseite des Contao Managers sehen.
Bevor du nun Contao installierst, muss der Manager selbst konfiguriert werden. Lege dazu einen neuen Benutzer an, indem du einen Benutzernamen und ein Passwort vergibst. Das Passwort ist unabhängig von der späteren Contao Installation.
Der Contao Manager benötigt keine eigene Datenbank. Die Konfiguration des Contao Managers wird in der
manager.json
und die Benutzerdaten in der users.json
im Verzeichnis
/contao-manager
gespeichert.
Der Contao Manager benötigt den Pfad zum PHP-Binary und weitere Server-Informationen, um Hintergrund-Prozesse korrekt auszuführen. In der Regel wird der Pfad automatisch erkannt.
Die Composer Resolver Cloud erlaubt die Installation von Composer-Abhängigkeiten, selbst wenn der Server nicht über genug Arbeitsspeicher verfügt. Bitte beachte, dass deine Paketinformationen für die Auflösung der Abhängigkeiten an einen Cloud-Dienst der Contao Association übermittelt werden.
Nach der erfolgreichen Grundkonfiguration kann nun Contao installiert werden.
Grundsätzlich ist ein manuelles Update nicht nötig. Der Manager führt automatisch im Hintergrund eine Prüfung durch. Sollte eine neue Version verfügbar sein, aktualisiert sich der Manager selbst.
Bei Problemen kannst du jederzeit die aktuellste contao-manager.phar
herunterladen und diese manuell
per FTP hochladen und ersetzen.
Um dein Passwort zurückzusetzen, musst du dich per FTP mit deinem Server verbinden.
Lösche im Verzeichnis contao-manager
die Datei users.json
.
Rufe nun den Contao Manager über deine Domain mit dem Zusatz contao-manager.phar.php
auf und lege einen
neuen Admin-User an.
Siehst du trotz des Löschens der Datei users.json
die Loginmaske für einen vorhandenen User, dann lösche die
Cookies der Domain oder öffne die Seite zum Contao Manager im »Inkognito-Modus« deines Browsers.
Sollte es vorkommen, dass der Contao Manager nicht mehr reagiert, das Fenster der Konsolenausgabe sich nicht schließen lässt
oder nach einem Reload der Manager-Seite man immer wieder zur selben Ausgabe kommt, lösche im Verzeichnis contao-manager
die Datei task.json
.
Anschließend sollte der Contao Manager wieder laufen.
Ja, dazu musst du im Verzeichnis contao-manager
die Datei users.json
bearbeiten und ein
weiteres Benutzerkonto hinzufügen. In unserem Fall ist das h.lewis
.
{
"users": {
"k.jones": {
"username": "k.jones",
"password": "…"
},
"h.lewis": {
"username": "h.lewis",
"password": "…"
}
},
"version": 2,
"secret": "…"
}
Der Wert für »password« muss hierbei verschlüsselt eingetragen werden. Über bcrypt-generator.com könntest du z. B. den notwendigen Hash-Wert generieren. Alternativ dazu kann man den Hash-Wert auch mit dem folgenden Konsolenaufruf in seiner eigenen Contao-Installation erstellen:
php vendor/bin/contao-console security:encode-password 'my_1._pA~~w0rd'
Ja, wenn du eine Contao Installation in der Managed Edition verwendest, dann kann der Contao Manager nachinstalliert
werden. Dazu einfach die contao-manager.phar
in das Verzeichnis public
laden und mit der
Dateiendung .php
versehen.
Der Manager erkennt bei der Grundinstallation, dass bereits Contao installiert ist.
Ja. Du kannst einen beliebigen Dateinamen verwenden. Allerdings ist der Contao Manager dann nicht mehr über das Backend erreichbar. In diesem Fall kannst du die config.yaml entsprechend anpassen. Anschließend musst du über den Contao Manager (»Systemwartung« > »Prod.-Cache erneuern«) oder über die Konsole einmalig den Anwendungs-Cache leeren.
# config/config.yaml
contao_manager:
manager_path: dein-name.phar.php