Jak przestać cierpieć przy pracy z grafiką w PHP
Każdy, kto kiedykolwiek pisał generowanie miniaturek w czystym PHP przy użyciu rozszerzenia GD, pamięta ten ból. Tuzin niskopoziomowych funkcji z tajemniczymi sygnaturami, ręczne obliczenia współrzędnych i ciągłe wycieki pamięci. W Imagick składnia jest nieco lepsza, ale ma własny zbiór metod, których trzeba się nauczyć.
Biblioteka Intervention Image rozwiązuje dokładnie ten problem od ponad dziesięciu lat. Ukrywa rozszerzenia systemowe za ujednoliconą i czytelną warstwą abstrakcji. Projekt niedawno osiągnął wersję v3/v4, w której architekturę całkowicie przepisano pod kątem nowoczesnych wersji PHP.
Co kryje się w środku biblioteki
Projekt oferuje wygodną nakładkę na silniki graficzne. Piszesz czytelny, łańcuchowy kod, a pod maską biblioteka wykonuje niezbędne wywołania systemowe.
Główną zaletą jest możliwość podmiany sterowników. Obecnie projekt obsługuje:
- GD (standardowa biblioteka dostępna na praktycznie każdym hostingu)
- Imagick (rozszerzenie oparte na ImageMagick)
- libvips (szybki silnik o niskim zużyciu pamięci poprzez osobny sterownik)
Jeśli serwer nie ma ImageMagick, po prostu przełączasz sterownik na GD bez przepisywania logiki biznesowej aplikacji. Dla usług o wysokim obciążeniu możesz podłączyć libvips, który działa wielokrotnie szybciej i bardziej oszczędnie zarządza pamięcią RAM podczas przetwarzania ciężkich obrazów.
Kolejnym miłym szczegółem jest pełna obsługa animowanych obrazów (GIF, WebP) na wszystkich dostępnych sterownikach. Wcześniej praca z animacjami wymagała ścisłego powiązania z Imagick.
Jak wygląda kod
Aby rozpocząć, zainstaluj bibliotekę przez Composera:
composer require intervention/image
Będziesz potrzebować PHP 8.3 lub nowszego, rozszerzenia mbstring oraz jednego z modułów graficznych do wyboru.
Oto podstawowy przykład skalujący obraz, nakładający znak wodny i zapisujący wynik jako WebP lub JPEG:
use Intervention\Image\ImageManager;
use Intervention\Image\Drivers\Gd\Driver as GdDriver;
use Intervention\Image\Alignment;
use Intervention\Image\Format;
// Инициализируем менеджер с нужным драйвером
$manager = ImageManager::usingDriver(GdDriver::class);
// Читаем исходный файл
$image = $manager->decodePath('images/example.webp');
// Пропорционально меняем размер по высоте
$image->scale(height: 300);
// Накладываем водяной знак в правый нижний угол
$image->insert('images/watermark.png', alignment: Alignment::BOTTOM_RIGHT);
// Кодируем результат с заданным качеством
$encoded = $image->encodeUsingFormat(Format::JPEG, quality: 65);
// Сохраняем готовый файл
$encoded->save('images/example.jpg');
Składnia wykorzystuje nazwane argumenty PHP 8 i ścisłe typowanie z enumami takimi jak Alignment::BOTTOM_RIGHT i Format::JPEG. Popełnianie błędów w parametrach jest teraz znacznie trudniejsze, a autouzupełnianie w IDE działa od razu.
Typowe przypadki użycia
Pakiet nie jest powiązany z konkretnym frameworkiem, więc równie łatwo zintegrować go z Laravel, Symfony lub mikrousługą RoadRunner.
- Generowanie avatara i miniaturek. Przycinanie, dopasowywanie do kwadratu (
crop,cover,scale), usuwanie metadanych przed publikacją. - Optymalizacja treści w locie. Konwersja ciężkich PNG i JPEG do nowoczesnych WebP lub AVIF z kompresją.
- Ochrona praw autorskich. Wsadowe nakładanie znaków wodnych i logo przed udostępnianiem plików do CDN.
- Praca z animacjami. Przycinanie lub zmiana rozmiaru GIF-ów bez utraty klatek.
Czy warto dodać do projektu
Jeśli piszesz w PHP 8.3+ i musisz przetwarzać pliki od użytkowników, Intervention Image zaoszczędzi mnóstwo czasu. W zasadzie jest to de facto standard w ekosystemie PHP jeśli chodzi o grafikę.
Jeden niuans: jeśli projekt utknął na starych wersjach PHP jak 7.4 lub 8.1, będziesz musiał pozostać na branchu v2, który ma całkowicie inne API. Ale dla świeżego stacka biblioteka pasuje idealnie.
Powiązane projekty