FAQ - Contao Setup

Seit dem 06.06.2025 ist diese Contao-Website online.

Inzwischen ist der Speicherplatzbedarf der Website und die Anzahl der daraus resultierenden Dateien erheblich angewachsen.

Aktuell ergeben sich folgende Werte:

• Messmethode, Software: TreeSize Personal Version 9.6
• Stand: 02.12.2025
• belegter Speicherplatz: 3,79 GB
• Anzahl der Dateien: 65.570

Beschreibung Text...

Bevor du mit dem Installieren von Contao z.Bsp. Version 5 loslegst, solltest du einige Vorbereitungen treffen.

• Contao-Projektordner (Unterordner) in deinem doc-root anlegen
• z.Bsp. contao5_projektname2025-test
• so hast du schon mal die richtigen Arbeits-Infos  wie:
• Contao Version - Projekt - Jahr und sufix test für Testversion
• falls du bereits mehrere Projekte angelegt hast, ist das sofort eine gute Orientierung für dich.
• Genauso benennst du die zugehörige SQL-Datenbank bei deinem Webhoster z.Bsp. db_contao5_projektname2025-test
• Lege eine neue Datenbank bei deinem Webhoster an, MySQL oder MariaDB (Open Source) - passt beides für Contao

Contao 5 erwartet beim NeuSetup ein Subdirectory für den Inhalt der Website

Der Ordner public muss vor dem Contao Setup wie folgt angelegt werden:

• Contao 5: root/dein-projektordner/public/
• Contao 4: root/dein-projektordner/web/
• dem ordner puplic bzw. web muss dann bei deinem Hoster die gewünschte Domain zugewiesen werden
• nur der ordner public bzw. web sind öffentlich erreichbar!

die .env.local wird bei Neusetup von Contao 5 automatisch angelegt. Sie enthält wichtige Parameter:

SECRET_KEY

• Schlüssel für die Verschlüsselung von sensiblen Daten in der Datenbank.
• Beispiel: APP_SECRET=dbazeichenkette-schlüssel
• geht er verloren, ist kein Zugriff auf die verschlüsselten Daten in der Datenbank mehr möglich.
• am besten die .env.local nach Contao-Neusetup per FTP downloaden und als Backup lokal auf dem PC ablegen.

URL der SQL-Datenbank

• Beispiel: DATABASE_URL=mysql://dbusername:passwort@db12345657.hosting-data.io:3306/dbs12345678

Einträge optional ergänzen

• zusätzlich kann hier ein eigener Mailer zum E-Mail-Transport für Contao 5 angelegt werden.
• Beispiel für IONOS: MAILER_DSN=smtp://smtp%40domain-name:passwort@smtp.ionos.de:587?encryption=tls
• zur besseren Performance beim Laden der Website können folgende Anweisungen nachgetragen werden:
• APP_ENV=prod
• APP_DEBUG=0

Im Contao Projektordner befinden sich die Dateien composer.json und composer.lock

diese beiden Dateien sind zentral für das Contao 5 Projekt (und jedes andere Composer-basierte PHP-Projekt). Hier eine einfache und klare Erklärung:

• composer.json – die Wunschliste

Diese Datei enthält:

• Welche Pakete (z. B. Erweiterungen, Bundles) dein Projekt benötigt
• Versionseinschränkungen (z. B. ^5.1 oder >=4.13)
• Metadaten, wie Name des Projekts, PHP-Version, usw.

Du kannst dir die Datei also wie eine Einkaufsliste vorstellen: "Ich möchte diese Erweiterungen in bestimmten Versionen."

• composer.lock - die Einkaufsliste

Diese Datei speichert die exakt installierten Versionen aller Abhängigkeiten, einschließlich aller verschachtelten Abhängigkeiten (Dependencies von Dependencies).

Das heißt:

• Wenn du composer install auf einem Server oder bei einem Teamkollegen ausführst, werden genau dieselben Versionen installiert wie bei dir lokal
• Das sorgt für Stabilität, Reproduzierbarkeit und verhindert Versionskonflikte.

Typischer Ablauf:

1. Du fügst etwas zur composer.json hinzu (z. B. über den Contao Manager oder manuell).
2. Du führst composer update aus:

• Composer lädt die neuesten kompatiblen Versionen.
• composer.lock wird aktualisiert.

1. Du checkst beide Dateien ins Git-Repository ein.
2. Auf anderen Umgebungen wird mit composer install genau das installiert, was im composer.lock steht – egal, was sich inzwischen bei den Paket-Anbietern geändert hat.

Wichtiger Hinweis

• In Contao 5, wird die composer.json primär vom Contao Manager gepflegt. Manuelles Bearbeiten ist möglich, aber mit Vorsicht.
• Änderungen in vendor/ passieren auf Basis dieser beiden Dateien.

Kurz gesagt:

• composer.json - Welche Pakete möchtest du installieren?
• composer.lock - Welche Pakete wurden tatsächlich installiert?

Contao-Datenbankimport z.Bsp. IONOS phpMyAdmin - Schritt für Schritt:

Datenbank auswählen:

• Klicke in phpMyAdmin links in der Sidebar auf den Namen deiner leeren Datenbank, z. B. dbs14304332.
• Wichtig: Es muss eine Datenbank ausgewählt sein, sonst kommt der Fehler #1046 – Keine Datenbank ausgewählt.

Zum Import wechseln:

• Im oberen Menü: Reiter „Importieren“ auswählen.

Datei auswählen:

• Klicke auf „Datei auswählen“ und lade deine .sql-Datei hoch (Backup-Datei deiner Contao-Datenbank).

Importoptionen:

• Format: SQL (Standard, nicht ändern)
• Zeichencodierung der Datei: UTF-8 (Standard, prüfen)
• Alle anderen Optionen kannst du in der Regel so lassen, wie sie sind.

Import starten:

• Klicke auf „OK“ oder „Importieren“ (unten).

Falls du beim Export ein komplettes Datenbank-Backup mit DROP TABLE IF EXISTS etc. erstellt hast, kannst du es direkt so wieder importieren. Achte aber darauf:

• Die Datenbank selbst (z. B. dbs14304332) muss vorher existieren.
• Der Import ersetzt dann alle Tabellen in dieser Datenbank.

Nach dem Import:

Wenn der Import erfolgreich durchläuft, kannst du anschließend:

• In Contao den Contao-Manager öffnen.
• „Datenbank prüfen“ im Installtool durchführen.
• Caches leeren.
• Dann wie gewohnt dein Backend öffnen.

Wenn du möchtest, kannst du vor dem eigentlichen Import noch einen Dry-Run-Test machen:

• Lege eine leere Test-Datenbank an.
• Importiere dort die Datei.
• So erkennst du vorab, ob im Dump selbst Fehler stecken.

Zusammenfassung Import-Optionen:

Einstellung:    Wert:    Anmerkung:
Format: SQL  Standard bleibt so
Zeichencodierung:  UTF-8  Wichtig für Umlaute, Sonderzeichen
Kompatibilitätsmodus: Kein Unverändert lassen
Import unterbrechen: Aktiviert (empfohlen) Stoppt bei schwerwiegenden Fehlern
Maximale Dateigröße: abhängig vom IONOS-Server ggf. aufteilen, falls zu groß