Über den Contao Manager

Die Entwicklung des Contao Managers wird durch die Contao Association unterstützt.

Aufgabe des Managers

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:

  • Contao installieren
  • Contao aktualisieren
  • Erweiterungen suchen
  • Erweiterungen installieren
  • Erweiterungen deinstallieren
  • Contao Cache leeren (Systemwartung)

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.

Contao Manager installieren

Systemvoraussetzungen

Die Systemvoraussetzungen entsprechen grundsätzlich denen von Contao. Der Contao Manager prüft automatisch, ob die Anforderungen erfüllt sind.

Für die neuste Version benötigst du:

  • PHP Version 8.1 oder neuer
  • PHP Erweiterung Intl und OpenSSL
  • PHP Funktionen proc_open und proc_close
  • PHP Einstellung allow_url_fopen muss aktiv sein
Anmerkung

Der Contao Manager kann auch bei PHP 5 oder PHP 7 installiert werden. Beim ersten Aufruf wird automatisch die PHP-Version erkannt und eine entsprechend kompatible Version heruntergeladen. Funktionen der neueren Version sind dann natürlich nicht verfügbar, aber Contao und Erweiterungen können weiterhin installiert bzw. aktualisiert werden.

Hosting-Konfiguration

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.)

Info

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

Download und Installation

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.

Anmerkung

.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).

Warnung

.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.

Contao Manager aufrufen

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.

Willkommensseite des Contao Managers Willkommensseite des Contao Managers

Grundkonfiguration

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.

Serverkonfiguration

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.

Serverkonfiguration Serverkonfiguration

Composer Resolver Cloud

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.

Häufige Fragen zum Contao Manager

Wie kann man den Contao Manager aktualisieren?

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.

Hast du die Zugangsdaten vom Contao Manager vergessen?

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.

Der Contao Manager hat sich »aufgehangen«

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.

Kann ich dem Contao Manager ein weiteres Benutzerkonto hinzufügen?

Info

Diese Funktion ist ab Contao Manager 1.9 verfügbar.

Ja, mit ADMIN-Rechten kannst du weitere Benutzer:innen zum Contao Manager einladen. Klicke dazu im Menü auf das Zahnrad und dann auf Konten. Hier kannst du einen Einladungs-Link erstellen, und dem neuen Konto eine der folgenden Berechtigungen vergeben:

  • READ – kann die installierten Pakete sehen und Log-Dateien lesen, aber das System nicht verändern.
  • UPDATE – darf bestehende Pakete aktualisieren und Wartungsaufgaben vornehmen (z. B. Cache leeren).
  • INSTALL – darf Pakete aktualisieren und installieren und Systemeinstellungen ändern.
  • ADMIN – kann alle Funktionen des Contao Managers nutzen.

Kann der Contao Manager zu einer bestehenden Installation hinzugefügt werden?

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.

Kann ich die ».phar« Datei umbenennen?

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