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

# imagewebp

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

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

### Описание

function 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');

    ?>

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open