Systemvoraussetzungen

Um Contao erfolgreich auszuführen, muss der Webserver diese Systemvoraussetzungen erfüllen. Contao wurde ursprünglich für den vertrauten LAMP-Stack entwickelt, läuft jedoch auf jedem Webserver, der eine aktuelle Version von PHP und MySQL bereitstellt.

Software-Empfehlungen

Die Mindestanforderungen hängen davon ab, ob du die neueste oder die Long Term Support-Version installierst. Alle gepflegten Versionen von Contao sind mit den neuesten PHP- und MySQL-Versionen kompatibel. Daher wird grundsätzlich empfohlen, diese immer zu verwenden.

• PHP: Version 7.4+ (neueste Patch-Version)
• MySQL: Version 8.0+ oder gleichwertiger MariaDB Server

PHP-Erweiterungen

$ vendor/bin/contao-console debug:container contao.image.imagine

Alle erforderlichen Erweiterungen sind in aktuellen PHP-Versionen standardmäßig aktiviert. Einige Hosting-Anbieter deaktivieren sie jedoch explizit. Die Anforderungen werden bei der Installation durch Contao Manager oder Composer automatisch überprüft.

PHP-Konfiguration (php.ini)

Diese Einstellungen sind die Empfehlungen für den idealen Betrieb von Contao. Eine andere Konfiguration bedeutet nicht, dass Contao nicht funktioniert, kann jedoch zu unerwartetem Verhalten oder Leistungseinbußen/langsamen Reaktionen führen.

MySQL-Konfiguration

• MySQL Tabellenformat InnoDB (Standard seit MySQL 5.7)
• MySQL Option innodb_large_prefix = 1 (standardmäßig aktiviert seit MySQL 5.7.7)
• MySQL Option innodb_file_format = Barracuda (nicht mehr notwendig seit MySQL 8.0)
• MySQL Option innodb_file_per_table = 1 (standardmäßig aktiviert seit MySQL 5.6.7)
• MySQL Zeichensatz utf8mb4

Mindestanforderungen an PHP

Contao 5.0 and später

• PHP Version 8.1.0 oder höher ist erforderlich.

Contao 4.13 (LTS)

• PHP Version 7.4.0 oder höher ist erforderlich.

Contao 4.9 (LTS)

• PHP Version 7.2.0 oder höher ist erforderlich.
• Bilder können mit den PHP-Erweiterungen GD (ext-gd), Imagick (ext-imagick) oder Gmagick (ext-gmagick) verarbeitet werden.
  Contao erkennt und verwendet automatisch die beste verfügbare Erweiterung.

Contao 4.4 (LTS)

• PHP Version 5.6.0 oder höher ist erforderlich.
• Die GD-Erweiterung (ext-gd) wird für die Bildverarbeitung benötigt.

Wechsel der PHP-Version

Falls die PHP-Version einer laufenden Contao-Instanz geändert werden soll, sollte immer ein volles composer update nach dem Wechsel durchgeführt werden. Dies ist besonders dann wichtig, wenn zwischen Haupt-Versionen gewechselt wird, z. B. von PHP 7.x zu PHP 8.x - oder umgekehrt. Dadurch wird für die installierten Pakete die Kompatibilität zu der jeweiligen PHP-Version sichergestellt, da jedes Paket (inklusive Contao selbst, installierte Contao-Extensions oder Dritt-Pakete) nach spezifischen PHP-Versionen und PHP-Extensions verlangen kann.

Unter Verwendung des Contao Managers kann das composer update in der Systemwartung unter Composer-Abhängigkeiten ausgeführt werden:

MySQL-Mindestanforderungen

Obwohl Contao die Doctrine DBAL Datenbank-Abstraktionsschicht verwendet, werden derzeit keine anderen Datenbankserver als MySQL (oder ein kompatibler Fork wie MariaDB) unterstützt.

Contao wurde erfolgreich auf MySQL-Servern der Version 5.7 / 8.0 (und gleichwertigen MariaDB Versionen) mit InnoDB-Tabellenformat getestet. Die Verwendung von utf8 anstelle des utf8mb4-Zeichensatzes führt zu einer verschlechterten UTF8-Unterstützung (z. B. keine Emojis).

Wenn die oben empfohlenen Optionen auf deinem Server nicht aktiviert werden können, konfiguriere bitte einen anderen Zeichensatz in deiner config/config.yaml-Datei:

doctrine:
    dbal:
        connections:
            default:
                default_table_options:
                    charset: utf8
                    collate: utf8_unicode_ci
                    collation: utf8_unicode_ci

Es wird außerdem empfohlen, MySQL im “Strict Mode” zu betreiben, um korrupte oder abgeschnittene Daten zu verhindern und die Datenintegrität zu gewährleisten.

Um den “Strict Mode” zu aktivieren, ergänze folgendes in deiner my.cnf oder my.ini Datei bzw. stelle sicher, dass die Einstellung entsprechend angepasst oder erweitert wird:

[mysqld]
…
sql_mode="TRADITIONAL"
…

Wenn die oben empfohlene Einstellung auf deinem Server nicht aktiviert werden kann, konfiguriere die Verbindungsoptionen bitte in deiner config/config.yaml-Datei:

doctrine:
    dbal:
        connections:
            default:
                options:
                    # Depending on the DB driver, the option key is either 1002 (pdo_mysql) or 3 (mysqli)
                    1002: "SET SESSION sql_mode=(SELECT CONCAT(@@sql_mode, ',TRADITIONAL'))"

Webserver

• Ein modernes Hosting ermöglicht es Kunden heute, über ein SSH-Terminal auf ihr Konto zuzugreifen. Dies ist nicht nur eine sicherere Verbindung als herkömmliches unverschlüsseltes FTP, sondern ermöglicht auch ein effizientes Debugging oder die Entwicklung der Anwendung.

• Es wird empfohlen, den PHP-Stack für die Verwendung von PHP-FPM oder einem ähnlichen FastCGI-Setup zu konfigurieren. Durch die Verwendung von fastcgi_finish_request() kann Contao Hintergrundaufgaben (wie die Indizierung des Seiteninhalts) ausführen, ohne dass der Browser auf die Antwort wartet.

Hosting-Konfiguration

In Contao befinden sich alle öffentlich erreichbaren Dateien im Unterordner web/ der Installation. 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.)

ab 4.13 Wenn du noch den /web-Ordner verwendest, dann definiere diesen entsprechend, um für zukünftige Contao Versionen gerüstet zu sein:

{
  "extra": {
    "public-dir": "web"
  }
}

siehe auch: https://symfony.com/doc/current/configuration/override_dir_structure.html#override-the-public-directory

Webserver-Konfiguration

In der Konfiguration des Webservers muss sichergestellt sein, dass alle Anfragen von der Applikation über die index.php im öffentlichen Verzeichnis verarbeitet werden (via »URL-Rewriting«). Wie diese Konfiguration aussehen muss hängt von der eingesetzten Webserver-Software ab. Weit verbreitete Beispiele sind Apache und NGINX:

<VirtualHost *:80>
    ServerName domain.tld
    ServerAlias www.domain.tld
    DocumentRoot /var/www/project/public

    <Directory /var/www/project/public>
        AllowOverride All
        Require all granted
        Options SymLinksIfOwnerMatch
    </Directory>
</VirtualHost>

server {
    server_name domain.tld www.domain.tld;
    root /var/www/project/public;

    location / {
        try_files $uri /index.php$is_args$args;
    }

    # Haupt Einstiegspunkt
    location ~ ^/index\.php(/|$) {
        # the exact FastCGI configuration depends on your environment
        fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
        fastcgi_split_path_info ^(.+\.php)(/.*)$;
        include fastcgi.conf;
        internal;
    }

    # preview.php und contao-manager.phar.php auch zur Verarbeitung erlauben
    location ~ ^/(preview|contao-manager\.phar)\.php(/|$) {
        # the exact FastCGI configuration depends on your environment
        fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
        fastcgi_split_path_info ^(.+\.php)(/.*)$;
        include fastcgi.conf;
    }
}

Mehr Informationen über die Konfiguration des Webservers können auch aus der Symfony Dokumentation entnommen werden.

Providerspezifische Einstellungen

Es gibt ein paar wenige große Internet Service Provider, die spezielle Einstellungen für den Betrieb von Contao erfordern. Zum Glück sind sie nur die Ausnahme von der Regel. Die Provider-spezifische Einstellungen findest du im Contao-Forum. Sorgenfreies Contao-Hosting erhältst du bei den Contao-Partnern in der Leistungskategorie »Webhosting«.