imagewebp

(PHP 5 >= 5.4.0, PHP 7, PHP 8)

imagewebpВывод WebP-изображение в браузер или файл

Описание

imagewebp(GdImage $image, resource|string|null $file = null, int $quality = -1): bool

Функция выводит или сохраняет изображение image в формате WebP.

Список параметров

image

Объект GdImage, который вернула функция imagecreatetruecolor() или другая функция генерации изображений.

file

Путь или ресурс открытого потока, который функция автоматически закрывает после возврата значения, для сохранения файла. Функция выведет поток необработанного изображения напрямую, если параметр не установили или передали в аргументе значение null.

quality

Параметр quality определяет качество изображения и принимает значения в диапазоне от 0 для худшего качества, но меньшего размера файла, до 100 для наилучшего качества, но с наибольшим размером файла. При передаче значения -1 для качества изображения устанавливается значение по умолчанию — 80.

Возвращаемые значения

Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.

Предостережение

Функция вернёт значение true, если вывести изображение средствами библиотеки libgd невозможно.

Ошибки

Функция выбрасывает ошибку 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');

?>