// Shopware-Hilfe
Nach einem Shopware-Update oder einem Serverumzug zeigt der Shop leere Bildrahmen, Vorschaubilder fehlen oder Bilder laden in voller Größe und bremsen den Shop aus? Die Dateien sind meist noch da. Es fehlen Pfade, Vorschaubilder oder die richtige Domain, und das lässt sich reparieren.
Shopware speichert zu jedem Bild, wo die Datei liegt, und erzeugt daraus kleinere Vorschaubilder, die Thumbnails, in den Größen, die in den Medienordnern eingestellt sind. Nach Updates oder Umzügen passen diese Informationen oft nicht mehr zusammen: Der gespeicherte Pfad zeigt ins Leere, Thumbnails wurden nicht mitkopiert oder nie erzeugt, oder die Bildadressen enthalten noch die alte Domain. Mit den richtigen Befehlen werden Pfade und Thumbnails neu geschrieben, ohne dass Bilder neu hochgeladen werden müssen.
// Ursachen
Neuere Shopware-Versionen speichern den Pfad jeder Datei in der Datenbank. Nach einem Update oder einer geänderten Pfad-Strategie zeigt dieser Pfad nicht mehr dorthin, wo die Datei tatsächlich liegt.
Beim Umzug wurde nur der Ordner public/media kopiert, nicht public/thumbnails, oder Thumbnails wurden nach geänderten Größen nie neu erzeugt.
Thumbnails entstehen über die Warteschlange. Läuft sie nicht, bleiben sie bei „werden generiert“ stehen, und der Shop zeigt Originalbilder oder gar nichts.
Nach einem Umzug oder dem Kopieren vom Testsystem stehen in der .env oder in den Domains des Verkaufskanals noch alte Adressen. Die Bilder werden dann von einem Server geladen, den es nicht mehr gibt.
Das Erzeugen bricht mit einem Speicherfehler ab, oder eine einzelne Datei in einem nicht unterstützten Format, etwa TIFF, stoppt den ganzen Lauf mit „not supported for creating thumbnails“.
Die Dateien liegen da, aber der Webserver darf sie nicht lesen, oder der Shop ist auf einen externen Speicher wie S3 umgestellt, dessen Zugangsdaten nicht mehr stimmen.
/media/, Vorschaubilder unter /thumbnails/.Vorher Datenbank sowie die Ordner public/media und public/thumbnails sichern. Dann in dieser Reihenfolge:
1. Medienpfade neu schreiben. Passt der gespeicherte Pfad nicht zum tatsächlichen Speicherort:
php bin/console media:update-path --force2. Vorschaubilder erzeugen. Bei vielen Bildern in kleinen Stapeln und mit genug Speicher:
php -d memory_limit=1G bin/console media:generate-thumbnails --batch-size=20 -vMit -v sehen Sie, welche Datei einen Fehler auslöst. Dateien in Formaten wie TIFF in JPG, PNG oder WebP umwandeln und neu hochladen.
3. Cache leeren. php bin/console cache:clear
Bleiben Vorschaubilder danach bei „werden generiert“ hängen, prüfen Sie, ob die Message Queue abgearbeitet wird. Nach einem Umzug zusätzlich APP_URL in der .env und die Domains der Verkaufskanäle auf die neue Adresse setzen.
public/thumbnails löschen, bevor neue Vorschaubilder erzeugt sind. Dann zeigt der Shop bis zum Ende des Laufs gar keine Bilder mehr.Wenn nach den Befehlen weiterhin Bilder fehlen, wenn der Lauf auf einem großen Shop Stunden dauert und den Server belastet oder wenn es um einen Umzug mit externem Speicher geht. Wir reparieren Pfade und Vorschaubilder, stellen Größen und Formate so ein, dass der Shop schneller lädt, und begleiten Updates und Umzüge so, dass Bilder gar nicht erst verschwinden.
// Soforthilfe
Schicken Sie uns kurz die Adresse einer Seite mit fehlendem Bild und was zuletzt geändert wurde, etwa ein Update oder ein Umzug.
// Häufige Fragen
Nein. Es reicht, die Ordner public/media und public/thumbnails mitzukopieren, die neuen Domains einzutragen und bei Bedarf Pfade und Vorschaubilder neu zu schreiben. Neu hochgeladene Bilder würden die Verknüpfungen in Produkten und Erlebniswelten zerstören.
Der Admin zeigt oft das Original, der Shop dagegen Vorschaubilder. Fehlen diese oder zeigt ihr Pfad ins Leere, bleiben die Bildrahmen im Shop leer.
Eine Datei hat ein Format, aus dem Shopware keine Vorschaubilder erzeugen kann, etwa TIFF, oder sie ist beschädigt. Diese Datei umwandeln oder ersetzen, dann läuft die Erzeugung für alle anderen durch.
Der Befehl prüft alle Bilder aller Ordner. Bei großen Shops sind das Zehntausende Dateien. Kleine Stapel, ausreichend Speicher und ein Lauf in der Nacht verhindern, dass der Shop währenddessen langsam wird.
Shopware erzeugt sie über die Warteschlange. Wird diese nicht abgearbeitet, etwa weil nur der Admin-Worker läuft, bleibt der Status stehen.
In den Medienordnern passende Thumbnail-Größen und die Qualität einstellen und die Vorschaubilder neu erzeugen. Das Theme muss diese Größen dann auch verwenden, sonst lädt der Shop weiter die großen Originale.