(PHP 5 >= 5.4.0, PHP 7, PHP 8)
imagewebp — Вывод WebP-изображение в браузер или файл
Функция выводит или сохраняет изображение image в формате WebP.
imageОбъект GdImage, который возвращает одна из функций, создающих изображения, например, imagecreatetruecolor().
fileПуть или ресурс открытого потока, который функция автоматически закрывает
после возврата значения, для сохранения файла. Функция выведет поток необработанного изображения напрямую,
если параметр не установили или передали в аргументе значение null.
quality
Параметр quality определяет качество изображения и принимает значения в диапазоне
от 0 для худшего качества, но меньшего размера файла, до 100 для наилучшего качества, но с наибольшим размером файла.
При передаче значения -1 для качества изображения устанавливается значение по умолчанию — 80.
Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.
Однако,
если libgd не может вывести изображения, эта функция вернёт true.
Функция выбрасывает ошибку ValueError,
если значение параметра quality недопустимо.
| Версия | Описание |
|---|---|
| 8.4.0 |
Функция теперь выбрасывает ошибку ValueError,
если значение параметра quality недопустимо.
|
| 8.0.0 |
Параметр image теперь ожидает экземпляр класса GdImage;
раньше параметр ждал корректный gd-ресурс (resource).
|
Пример #1 Пример сохранения WebP-файла
<?php
// Создать пустое изображение и добавить текст
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'WebP with PHP', $text_color);
// Сохранить изображение
imagewebp($im, 'php.webp');
?>