imagewebp

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

imagewebpMuestra una imagen WebP hacia un navegador o un fichero

Descripción

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

Muestra o guarda una versión WebP de la image proporcionada.

Parámetros

image

Un recurso image, es devuelto por una de las funciones de creación de imágenes, como imagecreatetruecolor().

file

La ruta o un recurso de flujo de apertura (el cual se cierra automáticamente después de que devuelva esta función) donde guardar el fichero. Si no se establece, o su valor es null, se mostrará directamente en la salida el flujo de imagen sin tratar.

quality

quality rango de 0 (la peor calidad, fichero más pequeño) a 100 (mejor calidad, fichero más grande). Si se proporciona el valor -1, se utiliza el valor por omisión 80.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Precaución

Sin embargo, si libgd falla al producir la imagen, esta función devuelve true.

Errores/Excepciones

Genera una ValueError si quality es inválido.

Historial de cambios

Versión Descripción
8.4.0 Genera ahora una ValueError si quality es inválido.
8.0.0 image expects a GdImage instance now; previously, a valid gd resource was expected.

Ejemplos

Ejemplo #1 Guardado de un fichero WebP

<?php
// Crea una imagen vacía y se añade texto
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);

imagestring($im, 1, 5, 5, 'WebP con PHP', $text_color);

// Guardado de la imagen
imagewebp($im, 'php.webp');

?>