imagewebp

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

imagewebp — Affiche une image WebP vers un navigateur ou un fichier

Description

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

Affiche ou sauvegarde une version WebP de l'image fournie.

Liste de paramètres

image: Un objet GdImage, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().
file: Le chemin ou un flux de ressource ouvert (qui sera automatiquement fermé après le retour de cette fonction) vers lequel le fichier sera sauvegardé. Si non-défini ou null, le flux brute de l'image sera affiché directement.
quality: quality plage de 0 (la pire qualité, plus petit fichier) à 100 (meilleure qualité, plus grand fichier). Si la valeur -1 est fournie, la valeur par défaut 80 est utilisée.

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

Attention

Toutefois, si libgd ne parvient pas à produire l'image, cette fonction retourne true.

Erreurs / Exceptions

Lève une ValueError si quality est invalide.

Historique

Version	Description
8.4.0	Lève désormais une ValueError si `quality` est invalide.
8.0.0	`image` attend une instance de GdImage désormais; auparavant, une resource `gd` était attendue.

Exemples

Exemple #1 Sauvegarde d'un fichier WebP

<?php
// Crée une image vide et on y ajoute du texte
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);

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

// Sauvegarde de l'image
imagewebp($im, 'php.webp');

?>