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 для наилучшего качества при наибольшем размере файла.

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

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

?>