Czego szukasz?

Wpisz temat, narzędzie lub problem do rozwiązania.

← Wszystkie artykuły

Jak automatycznie konwertować obrazy do WebP przed publikacją

Dwie mozaiki w kolorze turkusowym i oliwkowym połączone strzałką

Konwersja do WebP jest użyteczna wtedy, gdy zmniejsza koszt obrazu bez pogorszenia jego funkcji. Nie wystarczy zmienić rozszerzenia. Trzeba poprawnie odczytać plik, uwzględnić orientację, rozmiar i przezroczystość, a potem obejrzeć wynik.

Poniżej przygotujemy prostą funkcję w Pythonie, która zachowuje oryginał i zapisuje osobny WebP. Ma celowo wąski zakres: pojedyncze obrazy bez osadzonego profilu ICC. Pliki wymagające zarządzania kolorem oraz animacje odrzuca, zamiast przetwarzać je po cichu w nieodpowiedni sposób.

Najpierw ustal docelowe zastosowanie

Obraz wyróżniający, diagram i zrzut terminala mają inne potrzeby. Zdjęcie zwykle toleruje kompresję stratną lepiej niż drobny tekst. Przy diagramie możesz potrzebować trybu bezstratnego albo zachowania wektora.

Rozmiar dobieraj do miejsca wyświetlania. Jeśli grafika nigdy nie jest oglądana w dużym powiększeniu, wysyłanie wielokrotnie większego pliku nie daje czytelnikowi proporcjonalnej korzyści. Z drugiej strony zbyt mały obraz na ekranie o wysokiej gęstości będzie miękki.

W przykładzie dłuższy bok jest ograniczony do 1600 pikseli. To ustawienie demonstracyjne, a nie uniwersalny wymóg WordPressa. Dostosuj je do szablonu i potrzeb materiału.

Środowisko i zachowanie oryginałów

Utwórz osobne środowisko oraz zainstaluj Pillow:

python -m venv .venv

Aktywacja w PowerShell:

.\.venv\Scripts\Activate.ps1
python -m pip install Pillow

Na Linuxie lub macOS:

. .venv/bin/activate
python -m pip install Pillow

W projekcie automatycznym zapisz używaną wersję zależności po sprawdzeniu działania. Nie aktualizuj jej bez żadnej próby na reprezentatywnych plikach.

Trzymaj wejście i wynik w oddzielnych katalogach. Ponowne przetwarzanie już stratnie skompresowanego WebP może pogarszać jakość. Najlepiej generować warianty z zachowanego źródła.

Funkcja konwersji

Zapisz jako convert.py:

from pathlib import Path
from PIL import Image, ImageOps

def convert(source, destination):
    source, destination = Path(source), Path(destination)
    if destination.exists() or source.resolve() == destination.resolve():
        raise FileExistsError('Keep originals and existing results')
    with Image.open(source) as original:
        if getattr(original, 'n_frames', 1) != 1:
            raise ValueError('Animated input needs a separate workflow')
        if original.info.get('icc_profile') or original.mode == 'CMYK':
            raise ValueError('Convert color profile to sRGB first')
        im = ImageOps.exif_transpose(original)
        alpha = 'A' in im.getbands() or 'transparency' in im.info
        im = im.convert('RGBA' if alpha else 'RGB')
        im.thumbnail((1600, 1600), Image.Resampling.LANCZOS)
        destination.parent.mkdir(parents=True, exist_ok=True)
        with destination.open('xb') as target:
            im.save(target, format='WEBP', quality=85, method=6)
    with Image.open(destination) as result:
        result.load()
        return {'size': result.size, 'bytes': destination.stat().st_size,
                'alpha': 'A' in result.getbands()}

Przykładowe wywołanie z drugiego pliku Python:

from convert import convert

print(convert('images/source/przyklad.png', 'images/web/przyklad.webp'))

Funkcja odmawia nadpisania istniejącego celu. Katalog wynikowy tworzy automatycznie, a po zapisie ponownie otwiera plik i wymusza jego odczyt. Zwraca wymiary, liczbę bajtów i informację o kanale alfa.

Jeśli zapis zakończy się awarią, może pozostać niepełny plik docelowy. Trzeba go sprawdzić i świadomie usunąć przed ponowieniem. W większej kolejce warto rozbudować zapis o plik tymczasowy i atomowe przeniesienie dopiero po pełnej walidacji.

Orientacja, proporcje i przezroczystość

ImageOps.exif_transpose uwzględnia informację o orientacji. Dzięki temu zdjęcie nie powinno obrócić się po usunięciu zależności od metadanych orientacji.

thumbnail mieści obraz w zadanym prostokącie, zachowując proporcje. Nie kadruje do kwadratu i nie powiększa małego wejścia. Dla obrazu 2000 × 1000 ograniczenie do 1600 × 1600 daje 1600 × 800.

Jeżeli wejście ma przezroczystość, konwersja korzysta z RGBA. W przeciwnym razie wystarcza RGB. Nie podstawiamy automatycznie białego tła pod transparentne logo, ponieważ mogłoby to zmienić jego wygląd na ciemnej stronie.

Animację funkcja odrzuca. Zapisanie wyłącznie pierwszej klatki bez informacji dla użytkownika byłoby zmianą treści, nie tylko optymalizacją.

Dlaczego profil koloru jest osobnym przypadkiem

Plik CMYK lub obraz z profilem ICC wymaga świadomego przeliczenia kolorów do przestrzeni docelowej. Samo przełączenie trybu na RGB nie zastępuje pełnego zarządzania kolorem.

Dlatego przykład zgłasza błąd dla takich wejść. Przygotuj je wcześniej w narzędziu obsługującym profile albo dodaj jawny etap przez ImageCms z poprawnym profilem źródłowym i docelowym sRGB.

Nie usuwaj profilu tylko po to, żeby przejść walidację. Najpierw wykonaj konwersję kolorów, potem zdecyduj o metadanych. Szczególnie sprawdź barwy marki, gradienty i zdjęcia z szeroką gamą.

Co zostało sprawdzone w teście

Na potrzeby artykułu utworzono syntetyczny obraz RGBA o rozmiarze 2000 × 1000. Funkcja zapisała WebP 1600 × 800 z kanałem alfa. Ponowna próba użycia tej samej ścieżki została odrzucona.

To test wymiarów, odczytu i ochrony istniejącego wyniku. Nie jest pomiarem oszczędności dla fotografii ani dowodem zachowania jakości każdego obrazu. Nie podaję procentowej redukcji, ponieważ zależy ona od konkretnego wejścia.

Właściwa kontrola obejmuje porównanie źródła i wyniku w docelowym rozmiarze oraz przy powiększeniu. Zwróć uwagę na cienkie linie, litery, ostre krawędzie i przezroczyste brzegi.

Jakość 85 nie oznacza zachowania 85 procent obrazu

Parametr quality steruje pracą kodera. Nie jest bezpośrednią miarą podobieństwa ani gwarantowanej oszczędności. Wyższy poziom zazwyczaj zmienia kompromis rozmiaru i jakości, ale efekt należy sprawdzić na konkretnym materiale.

Dla zrzutów z drobnym tekstem porównaj także zapis bezstratny. Dla źródłowego SVG zachowaj wektor, jeśli jest właściwy dla zastosowania i bezpiecznie obsługiwany w projekcie. Nie rasteryzuj go wyłącznie po to, żeby wszystkie pliki miały to samo rozszerzenie.

Jak włączyć konwersję do publikacji

Najpierw przeprowadź walidację wejścia, potem konwersję i kontrolę wyniku. Dopiero zaakceptowany plik przesyłaj do CMS. Zapisz powiązanie oryginału z wynikiem, parametry i ewentualny błąd.

Nazwy plików powinny być stabilne i związane z materiałem. Nie opieraj całej identyfikacji na numerze kolejności w folderze. Przy większej liczbie obrazów przydaje się manifest z rozmiarem źródła, ścieżką celu i stanem przetwarzania.

Format rekordu i jego walidację możesz uporządkować podobnie jak w automatyzacji danych CSV. Przebiegi oraz błędy zapisuj według zasad monitorowania automatyzacji.

Przy integracji z WordPressem pamiętaj o metadanych obrazu: alt, tytule, podpisie i opisie. Proces zapisu szkiców i mediów omawia poradnik AI i WordPress REST API.

Harmonogram może uruchamiać cron, a jednorazowy import przez SSH ułatwia WP-CLI. Konwersja nie zastępuje jednak poprawnych wymiarów w HTML, responsywnych wariantów i rozsądnego ładowania obrazów w szablonie.

Najczęstsze pytania

Czy zmiana rozszerzenia PNG na WebP wystarczy?

Nie. Trzeba ponownie zakodować zawartość za pomocą odpowiedniego narzędzia.

Czy WebP zawsze będzie mniejszy?

Nie. Zależy to od obrazu, parametrów i trybu kodowania. Porównaj rzeczywiste pliki.

Czy funkcja obsługuje animacje i profile ICC?

Nie. Odrzuca je jawnie, żeby wymagały osobnego, świadomego procesu.

Czy można usunąć oryginały po konwersji?

Lepiej je zachować. Umożliwiają przygotowanie nowych rozmiarów i parametrów bez wielokrotnej kompresji stratnej.

Źródła

Data publikacji: 17.11.2026.

KP
O AUTORZE

Krystian Proć

Tworzę narzędzia do pracy z danymi, systemy backendowe i automatyzacje. Pracuję z SQL, PHP, TypeScriptem i Dockerem; rozwijam m.in. dragon-island.com. AI pomaga mi przyspieszać pracę, a architekturę, weryfikację i decyzje techniczne biorę na siebie. Na Trybie Technicznym dzielę się doświadczeniami z budowania i utrzymywania własnych projektów.

Dyskusja

Dodaj komentarz

Twój adres email nie zostanie opublikowany. Wymagane pola są oznaczone *