Änderungen erscheinen nicht — meistens der Cache.

Die Ebenen.

Die Unterscheidung zwischen den ersten beiden Zeilen ist die wichtigste: Der Anwendungscache betrifft Technik, der Seitencache betrifft Inhalte. Wer nach einer Textänderung den Anwendungscache leert, hat die falsche Ebene erwischt.

Anwendungscache.

Hier liegen aufbereitete Konfiguration und übersetzte Templates. Dieser Zwischenspeicher ist der Grund, warum Contao im Betrieb schnell ist — und die Quelle vieler Probleme nach Änderungen an Code oder Konfiguration.

Zu leeren nach: einem Update, dem Hinzufügen oder Entfernen einer Erweiterung, Änderungen an Konfigurationsdateien, Änderungen an Templates und nach dem Einspielen aus einer anderen Umgebung.

Typisches Fehlerbild bei einem widersprüchlichen Zustand: eine weiße Seite oder Meldungen über nicht gefundene Klassen. Das wirkt dramatisch und ist meist in einer Minute behoben (Weiße Seite).

Seitencache.

Fertig zusammengebaute Seiten, die ohne erneute Verarbeitung ausgeliefert werden. Das ist der wirksamste Tempofaktor und zugleich der häufigste Grund für „meine Änderung ist nicht da“.

Contao leert betroffene Einträge in der Regel beim Speichern automatisch. Nicht automatisch passiert es bei Änderungen, die über die Oberfläche hinausgehen — etwa bei einem Import, bei Änderungen über eine Schnittstelle oder bei Anpassungen am Template.

Wichtig für den Betrieb: Seiten mit personalisierten Inhalten dürfen nicht zwischengespeichert werden. Geschützte Bereiche, Formulare mit Prüfmerkmal und alles für angemeldete Besucher gehören ausgenommen — sonst sieht jemand Inhalte, die für einen anderen bestimmt waren.

Bildcache.

Contao erzeugt aus hochgeladenen Bildern zugeschnittene Fassungen in den definierten Größen und legt sie ab. Wird eine Bildgröße geändert, bleiben die alten Dateien bestehen — die Seite zeigt weiterhin den alten Zuschnitt.

Das Leeren erzwingt die Neuberechnung. Bei vielen Bildern dauert das: Die Dateien werden beim nächsten Aufruf einzeln neu erzeugt, und die ersten Besucher danach warten entsprechend. Bei großen Installationen lohnt es, das außerhalb der Hauptzeit zu machen (Bilder optimieren).

Suchindex.

Die interne Suche arbeitet über einen Index. Wird er nicht aktualisiert, findet die Suche alte oder gelöschte Inhalte — oder neue gar nicht.

Ein Neuaufbau geht über das Backend oder die Kommandozeile und dauert je nach Umfang. Sinnvoll ist er nach größeren Inhaltsänderungen, nach einem Umzug und nach einem Versionssprung.

Wenn die Suche dauerhaft nichts findet, ist meist der Index leer — und das hat oft denselben Grund wie an anderer Stelle: Eine zeitgesteuerte Aufgabe, die ihn füllen soll, läuft nicht (Wartungsaufgaben).

Wege zum Leeren.

1. Backend: Im Systemwartungsbereich lassen sich die Zwischenspeicher einzeln leeren. Der normale Weg.
2. Kommandozeile: Zuverlässiger und für Automatisierung geeignet — und der einzige Weg, wenn das Backend nicht erreichbar ist.
3. Dateisystem: Das Zwischenspeicherverzeichnis entfernen. Der Notweg, wenn sonst nichts geht.

Zum dritten Weg zwei Hinweise. Erstens: Contao legt das Verzeichnis beim nächsten Aufruf neu an — dieser erste Aufruf dauert dann länger. Zweitens: Achte auf die Dateirechte. Wird das Verzeichnis unter einem anderen Systembenutzer erzeugt als dem des Webservers, entsteht das nächste Problem.

Ohne Backend.

Wenn das Backend selbst nicht mehr lädt, ist der Weg über das Dateisystem der richtige. Per Dateizugriff oder Kommandozeile ins Projektverzeichnis, das Zwischenspeicherverzeichnis leeren, Seite neu aufrufen.

In vielen Fällen ist das bereits die Lösung — besonders nach einem Update oder einem abgebrochenen Vorgang. Wenn danach immer noch nichts geht, liegt es woanders, und der Weg führt über das Protokoll (Kein Zugang zum Backend).

Vorgeschaltete Dienste.

Zwischen Besucher und Server sitzt oft noch etwas: ein Zwischenspeicher des Hosters, ein vorgeschalteter Dienst, ein Auslieferungsnetz. Diese Ebenen kennen Contao nicht und bekommen vom Leeren nichts mit.

Typisches Bild: Im Backend ist alles richtig, lokal auch, aber Besucher sehen den alten Stand. Dann muss dort separat geleert werden — über das jeweilige Kundenmenü.

Besonders wichtig bei geschützten Bereichen: Ein vorgeschalteter Dienst, der Seiten für angemeldete Nutzer zwischenspeichert, zeigt diese Inhalte unter Umständen auch anderen. Das ist nicht nur ein Fehler, sondern ein Datenschutzvorfall (Caching richtig einrichten).

Wenn es trotzdem nicht erscheint.

1. Privates Fenster — schließt den Browser als Ursache aus.
2. Anderes Gerät oder Mobilfunk — schließt lokale Zwischenspeicher aus.
3. Parameter an die Adresse hängen — umgeht viele Caches.
4. Alle Contao-Ebenen leeren.
5. Vorgeschaltete Dienste leeren.
6. Ist der Inhalt veröffentlicht? Nicht jede ausbleibende Änderung ist Caching.
7. Zeitsteuerung prüfen — Start- und Enddatum am Element.
8. Richtige Umgebung? Manchmal wurde in der Testkopie gearbeitet.

Punkt sechs bis acht sind kein Scherz: Ein erheblicher Teil der gemeldeten Cache-Probleme sind unveröffentlichte Elemente, abgelaufene Zeitsteuerungen oder Änderungen in der falschen Umgebung.

Was automatisch passiert.

Contao leert beim Speichern eines Datensatzes die betroffenen Einträge selbst. Das deckt den redaktionellen Alltag ab — wer einen Text ändert, muss nichts weiter tun.

Nicht erfasst werden: Änderungen an Dateien im Dateisystem, Importe über die Kommandozeile, Änderungen über Schnittstellen, Anpassungen an Templates und an der Konfiguration. In diesen Fällen gehört das Leeren zum Vorgang dazu.

Wer automatisierte Abläufe baut — etwa einen nächtlichen Import — sollte das Leeren mit einplanen. Sonst sind die Daten da und die Seiten zeigen sie nicht.

Typische Fehler.

• Falsche Ebene geleert — Anwendungscache statt Seitencache.
• Vorgeschalteten Dienst vergessen.
• Im eigenen Browser geprüft statt im privaten Fenster.
• Zwischenspeicherverzeichnis mit falschen Rechten neu erzeugt.
• Geschützte Bereiche nicht ausgenommen.
• Bildcache nach Größenänderung nicht geleert.
• Suchindex nie neu aufgebaut.

Wenn du nicht weiterkommst.

Wenn Änderungen nicht erscheinen und du schon dreimal geleert hast. Ich finde die Ursache, behebe sie und erkläre dir, was passiert ist. Bei einem laufenden Ausfall hilft der Notfall-Support, dauerhaft begleitet die Contao-Wartung.

Orientierungswerte, keine Fixpreise — nach einem kurzen Gespräch bekommst du ein Festpreisangebot.

Wer hilft.

Ich bin Manuel Killert, Webentwickler aus Quakenbrück. Content-Management-Systeme sind mein Fachgebiet — ich arbeite seit Jahren damit, unterrichte das Thema als Dozent und kenne die Systeme nicht nur aus der Anwendung, sondern von innen: Datenmodell, Rechtekonzept, Templating, Erweiterungsarchitektur, Betrieb.

Das ist bei Contao besonders nützlich, weil es auf demselben Unterbau aufsetzt wie andere professionelle Systeme. Wer versteht, wie Abhängigkeitsverwaltung, Zwischenspeicherung und Konfigurationsebenen zusammenspielen, findet Fehler schneller — unabhängig davon, welcher Name über dem Backend steht.

Was du von mir bekommst: eine Diagnose in verständlicher Sprache, eine Behebung, die nicht nur das Symptom wegräumt, und eine ehrliche Einschätzung dazu, ob dein System weiterbetrieben, aktualisiert oder abgelöst gehört. Auch wenn die Antwort lautet, dass alles so bleiben kann.