TYPO3 nie wyświetla obrazów – przyczyny od ImageMagick po _processed_
Po przeniesieniu strony albo aktualizacji TYPO3 pokazuje puste miejsca zamiast zdjęć? Najczęstsze przyczyny i jak krok po kroku usunąć je w Admin Tools.
W skrócie: jeśli TYPO3 przestał wyświetlać obrazy, zwykle zawodzi przetwarzanie obrazów. TYPO3 tworzy z każdego oryginału pomniejszone wersje w folderze fileadmin/_processed_/ i potrzebuje do tego programu ImageMagick albo GraphicsMagick na serwerze. Jeśli po przeniesieniu brakuje programu, ścieżka jest błędna albo uprawnienia folderów są złe, obrazy zostają puste. Trzeba sprawdzić przetwarzanie obrazów w Admin Tools, usunąć przetworzone pliki i pozwolić TYPO3 wygenerować je ponownie.
Typowe przyczyny to zmiana hostingu, nowa wersja PHP, aktualizacja TYPO3 albo zmiana struktury folderów. Na stronie widać puste miejsca, ikonki zepsutych obrazów albo zdjęcia w oryginalnym rozmiarze zamiast dopasowanych kadrów. W panelu czasem brakuje miniatur.
Nazwy menu dotyczą TYPO3 do wersji 13. W TYPO3 14 część modułów panelu ma nowe nazwy, np. „Admin Tools” to teraz „Administration” albo „System”.
Krok 1: ustalić, czego dokładnie brakuje
Proszę otworzyć stronę, kliknąć prawym przyciskiem na brakujący obraz i wyświetlić adres obrazu.
- Jeśli adres prowadzi do
fileadmin/_processed_/…i zwraca 404: brakuje przetworzonej wersji. Dalej krok 2. - Jeśli prowadzi do oryginału w
fileadmin/…i zwraca 404: brakuje oryginału albo leży gdzie indziej. Dalej krok 4. - Jeśli w HTML w ogóle nie ma obrazu: problem w szablonie albo w zarządzaniu plikami (FAL). Patrz krok 4.
Krok 2: sprawdzić przetwarzanie obrazów
W Admin Tools w „Environment” jest „Image Processing”. TYPO3 testuje tam, czy potrafi czytać, zmniejszać i zapisywać obrazy. Jeśli test się nie udaje, winne jest przetwarzanie obrazów.
- Brak programu: na nowym serwerze nie ma ani ImageMagick, ani GraphicsMagick. Trzeba zapytać hostingodawcę. Na hostingu współdzielonym jeden z nich zwykle jest, często pod inną ścieżką.
- Zła ścieżka: w „Settings → Configure Installation-Wide Options” w sekcji GFX są procesor (
processor) i ścieżka (processor_path). Trzeba wpisać ścieżkę podaną przez hostingodawcę, często/usr/bin/. - Zablokowane wywołania programów: jeśli hosting wyłączył funkcję PHP
exec(), TYPO3 nie może uruchomić ImageMagick. Musi ją odblokować hostingodawca.
Krok 3: wygenerować przetworzone pliki ponownie
Gdy przetwarzanie obrazów znów działa, stare wpisy przetworzonych obrazów często są nadal błędne. W „Admin Tools → Maintenance” jest „Remove Temporary Assets”. Można tam usunąć przetworzone pliki, a TYPO3 utworzy je przy następnym wejściu. Potem trzeba wyczyścić cały cache przyciskiem „Flush TYPO3 and PHP Cache”. Przy wielu obrazach pierwsze wejście na każdą podstronę potrwa nieco dłużej.
Krok 4: sprawdzić magazyn plików i uprawnienia
- Magazyn plików: w panelu w module „Lista” na najwyższym poziomie (strona 0) jest magazyn plików (File Storage), zwykle „fileadmin”. Jeśli po przeniesieniu ścieżka bazowa się nie zgadza, TYPO3 nie znajdzie oryginałów.
- Uprawnienia: serwer WWW musi mieć prawo zapisu w
fileadmin/_processed_/. Po wgraniu plików przez FTP innym użytkownikiem czasem brakuje praw zapisu. - Brakujące oryginały: jeśli przy przenosinach nie przeniesiono wszystkich plików, TYPO3 oznacza je jako brakujące. Trzeba dograć pliki i zaktualizować indeks zadaniem Schedulera do indeksowania magazynu plików.
Limity pamięci
Bardzo dużych oryginałów, np. prosto z aparatu o szerokości 6000 pikseli, przetwarzanie obrazów przy małej ilości pamięci nie przetworzy. Wtedy brakuje tylko pojedynczych zdjęć. Pomaga zmniejszanie zdjęć przed wgraniem albo zapytanie hostingodawcy o wyższe limity pamięci i procesów.
Profesjonalna pomoc
Po przeniesieniu albo aktualizacji często brakuje nie tylko obrazów. Sprawdzam całą instalację TYPO3 i porządkuję przetwarzanie obrazów, magazyn plików i cache. Więcej w usłudze pomoc TYPO3, analiza 150 € netto, naprawa od 290 € netto.
