exif_thumbnail

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

exif_thumbnail — Récupère la miniature embarquée d'une image

Description

function exif_thumbnail(
    resource|string $file,
    int &$width = null,
    int &$height = null,
    int &$image_type = null
): string|false

exif_thumbnail() lit la miniature de l'image.

Pour afficher des miniatures avec cette fonction, il est recommandé d'envoyer le bon type MIME avec la fonction header().

Il est possible que la fonction exif_thumbnail() n'arrive pas à créer l'image mais peut déterminer sa taille. Dans ce cas, la fonction retourne false mais les paramètres width et height sont définis.

Liste de paramètres

file
Localisation du fichier image. Il peut s'agir soit d'un chemin d'accès au fichier, soit d'un flux resource.
width
La largeur de la miniature retournée.
height
La hauteur de la miniature retournée.
image_type
Le type de l'image de la miniature retournée. Peut être soit TIFF, soit JPEG.

Valeurs de retour

Retourne la miniature embarquée ou false si l'image ne contient pas de miniature.

Historique

Version Description
7.2.0 Le paramètre file supporte les fichiers locaux ou les ressources de flux.

Exemples

Exemple #1 Exemple avec exif_thumbnail()

<?php
if (array_key_exists('file', $_REQUEST)) {
$image = exif_thumbnail($_REQUEST['file'], $width, $height, $type);
} else {
$image = false;
}
if ($image!==false) {
header('Content-type: ' .image_type_to_mime_type($type));
echo $image;
exit;
} else {
// aucune miniature de disponible, traitement de l'erreur ici
echo 'No thumbnail available';
}
?>

Notes

Note: Si le paramètre file est utilisé pour passer un flux à la fonction, alors le flux doit être repositionnable. Il est à noter que la position du pointeur d'un fichier n'est pas modifiée après le retour de cette fonction.

Voir aussi