Bilder fehlen — meist liegt es nicht an den Bildern.

Der schnelle Test.

Rechtsklick auf das fehlende Bild, Grafikadresse kopieren, im neuen Tab öffnen. Drei mögliche Ergebnisse: Das Bild erscheint — dann liegt es an der Einbindung oder am Caching. Es kommt eine Fehlerseite — dann fehlt die verarbeitete Datei. Oder es erscheint gar keine Adresse im Quelltext — dann findet TYPO3 die Datei schon in der Verwaltung nicht.

Prüfe zusätzlich, ob das Original im Dateimodul des Backends sichtbar ist und sich dort als Vorschau anzeigen lässt. Funktioniert die Vorschau im Backend nicht, ist es kein Frontend-Problem, sondern eines der Verarbeitung.

Wie TYPO3 Bilder verarbeitet.

Das Original liegt in der Dateiverwaltung, meist unter fileadmin. Für die Ausgabe erzeugt TYPO3 daraus eine bearbeitete Fassung in der angeforderten Größe und legt sie in einem eigenen Verzeichnis ab — zusammen mit einem Eintrag in der Datenbank, der Original und Ergebnis verknüpft. Beim nächsten Aufruf wird die fertige Datei genutzt.

Diese Kette hat drei Bruchstellen: Das Bearbeitungsprogramm fehlt, das Verzeichnis ist nicht beschreibbar, oder die Datenbankeinträge zeigen auf Dateien, die es nicht mehr gibt. Jede davon führt zum gleichen Symptom.

Bildbearbeitung auf dem Server.

TYPO3 nutzt für die Verarbeitung ein externes Programm — üblicherweise ImageMagick oder GraphicsMagick. Ist es nicht installiert oder stimmt der hinterlegte Pfad nicht, scheitert jede Verarbeitung. Das passiert typischerweise nach einem Serverwechsel oder wenn der Hoster seine Umgebung umstellt.

Prüfen lässt sich das im Install-Tool: Dort gibt es einen Bereich, der die Bildverarbeitung testet und eine Reihe von Beispielbildern erzeugt. Erscheinen diese Testbilder nicht oder fehlerhaft, hast du die Ursache gefunden — und zwar belegbar, was für das Gespräch mit dem Hoster hilfreich ist. In der Konfiguration lässt sich anschließend der korrekte Pfad eintragen.

Das Verzeichnis für verarbeitete Dateien.

Die erzeugten Fassungen liegen in einem eigenen Ordner innerhalb der Dateiverwaltung. Ist er nicht vorhanden oder nicht beschreibbar, kann TYPO3 nichts ablegen — und liefert leere Bilder aus. Das ist nach einem Umzug ein häufiger Fall, weil der Ordner beim Übertragen leer war und deshalb teils gar nicht mitkam.

Wenn Bilder flächendeckend fehlen, ist es oft der schnellste Weg, die verarbeiteten Dateien komplett entfernen zu lassen und neu erzeugen zu lassen. Dafür gibt es im Wartungsbereich eine entsprechende Funktion. Danach dauert der erste Aufruf jeder Seite länger, weil alles neu berechnet wird — das ist normal, bei großen Installationen aber spürbar. Mach das deshalb nicht zur Hauptbesuchszeit.

Dateiindex und fileadmin.

TYPO3 führt einen Index über alle Dateien in der Verwaltung. Wird eine Datei per FTP hochgeladen, gelöscht oder verschoben, weiß TYPO3 davon zunächst nichts — der Index zeigt dann auf etwas, das es nicht gibt, oder kennt neue Dateien nicht. Symptome: Bilder im Backend mit Platzhalter, Meldungen über fehlende Dateien, Inhalte ohne Bild obwohl eines zugewiesen ist.

Abhilfe schafft eine erneute Indexierung der Dateiverwaltung, die sich über die Kommandozeile oder einen geplanten Vorgang anstoßen lässt. Daraus folgt eine Regel für den Alltag: Dateien gehören über das Backend verwaltet, nicht per FTP. Wo das nicht geht — etwa bei großen Mengen —, gehört die Indexierung danach ausgeführt.

Rechte und Besitzverhältnisse.

Der Webserver muss in die Verzeichnisse für Dateien und verarbeitete Fassungen schreiben dürfen. Stimmen Besitzer oder Rechte nicht, scheitert jede Verarbeitung — typischerweise nach einem Umzug, wenn Dateien per FTP hochgeladen wurden und damit dem FTP-Benutzer gehören, während der Webserver unter einem anderen Konto läuft.

Übliche Werte sind 755 für Verzeichnisse und 644 für Dateien, entscheidend sind aber die Besitzverhältnisse. Bei klassischem Webhosting stellt das der Hoster auf Anfrage zurecht. Und auch hier gilt: 777 ist keine Lösung, sondern ein Sicherheitsrisiko (Dateirechte erklärt).

Nach einem Umzug.

1. Dateiverwaltung prüfen: Sind die Originale vorhanden?
2. Bildverarbeitung testen im Install-Tool.
3. Verzeichnis für verarbeitete Dateien leeren und neu erzeugen lassen.
4. Dateiindex neu aufbauen.
5. Rechte prüfen lassen.
6. Caches leeren (Cache leeren).

Diese sechs Schritte decken fast alle Bildprobleme nach einem Serverwechsel ab, und zwar in dieser Reihenfolge.

Große Bilder und Grenzen.

Die Verarbeitung sehr großer Bilder braucht Arbeitsspeicher und Zeit. Reicht eines von beiden nicht, bricht der Vorgang ab — und das Ergebnis ist ein fehlendes oder halb erzeugtes Bild, oft ohne Fehlermeldung im Frontend. Erkennbar daran, dass kleine Bilder funktionieren und große nicht.

Zwei Hebel: die Grenzen auf dem Server anheben, soweit möglich, und Redakteuren beibringen, Bilder nicht direkt aus der Kamera hochzuladen. Ein Foto mit mehreren tausend Pixeln Kantenlänge und einigen Megabyte braucht niemand im Web. Eine Obergrenze für den Upload und eine kurze Einweisung lösen das dauerhaft (Speichergrenzen allgemein).

Bilder fehlen nur im Backend.

Erscheinen Bilder im Frontend, aber nicht in der Dateiliste oder im Inhaltselement, deutet das auf den Dateiindex oder auf die Vorschauerzeugung hin — Letztere nutzt denselben Verarbeitungsweg wie das Frontend, nur mit kleineren Größen. Prüfe also auch hier die Bildverarbeitung im Install-Tool. Ein weiterer Fall: Die Dateiablage selbst ist nicht erreichbar, etwa wenn sie auf einen externen Speicher zeigt, der nicht antwortet. Dann melden Dateiliste und Inhaltselemente gleichzeitig Probleme.

Aufräumen.

Das Verzeichnis mit verarbeiteten Dateien wächst stetig — jede Größe jedes Bildes liegt dort als eigene Datei. Bei langlebigen Installationen sammeln sich dabei Gigabyte an, darunter viele Fassungen, die seit einem Theme-Wechsel niemand mehr abruft. Ein gelegentliches Leeren mit anschließender Neuerzeugung hält das in Grenzen und löst nebenbei viele Darstellungsprobleme.

Prüfe bei der Gelegenheit den freien Speicherplatz: Ist er erschöpft, kann TYPO3 keine neuen Dateien ablegen — und genau das sieht dann aus wie ein Bildproblem, ist aber ein Speicherproblem (Webspace voll).

Wenn du nicht weiterkommst.

Wenn Bilder flächendeckend fehlen, prüfe ich Bildverarbeitung, Dateiindex und Rechte und bringe die Kette wieder zum Laufen. Schreib mir mit Domain, TYPO3-Version und einer kurzen Beschreibung — du bekommst eine ehrliche Einschätzung, ob ich der Richtige bin. Den Überblick über alle Themen gibt TYPO3-Fehler beheben. Wenn sich am Ende herausstellt, dass ein Wechsel die bessere Lösung ist: TYPO3 zu WordPress.

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

Wer hilft.

Ich bin Manuel Killert, Web-Entwickler aus Quakenbrück. Mein Schwerpunkt liegt auf WordPress — an TYPO3-Installationen arbeite ich dort, wo es um Betrieb und Fehlersuche geht: Ausfälle, Serverthemen, Datenbank, Mailversand, Updates und die Frage, wie es mit einer alten Installation weitergehen soll. Das sind die Probleme, bei denen die Ursache meist nicht im System selbst liegt, sondern darunter. Geht es um tiefe Entwicklung in TYPO3 — eigene Extensions, komplexe Mehrsprachigkeit, große Redaktionssysteme —, sage ich dir das offen und empfehle jemanden, der genau das macht. Ehrlich beraten heißt für mich auch, eine Anfrage abzugeben.