Affichage de l'image vers le navigateur ou dans un fichier

# imagegif

(PHP 4, PHP 5, PHP 7, PHP 8)

imagegif — Affichage de l'image vers le navigateur ou dans un fichier

### Description

function imagegif(GdImage `$image`, resource|string|null `$file` = `null`): bool

imagegif() crée un fichier image GIF dans `file` d'après l'image `image`. L'argument `image` est un identifiant valide retourné par la fonction imagecreate() ou les fonctions `imagecreatefrom*`.

Le format de l'image sera GIF87a, à moins que l'image n'ait une couleur transparente (mise en place grâce à la fonction imagecolortransparent()), ce qui fera qu'elle sera au format GIF89a.

### 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.

### 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`.

### Historique

Version | Description
--- | ---
8.0.0 | `image` attend une instance de GdImage désormais; auparavant, une resource `gd` était attendue.

### Exemples

Exemple #1 Affichage d'une image en utilisant imagegif()

    <?php
    // Création d'une image
    $im = imagecreatetruecolor(100, 100);

    // Définit l'arrière-plan en blanc
    imagefilledrectangle($im, 0, 0, 99, 99, 0xFFFFFF);

    // Dessine un texte dans l'image
    imagestring($im, 3, 40, 20, 'GD Library', 0xFFBA00);

    // Affiche l'image sur le navigateur
    header('Content-Type: image/gif');

    imagegif($im);
    ?>

Exemple #2 Conversion d'une image PNG en GIF, en utilisant imagegif()

    <?php
    // Chargement de l'image PNG
    $png = imagecreatefrompng('./php.png');

    // Sauvegarde de l'image en GIF
    imagegif($png, './php.gif');

    // C'est fait !
    echo 'Conversion avec succès de l\'image PNG en GIF !';
    ?>

### Notes

> Note:

> Le code suivant permet d'écrire des scripts PHP plus portables : le type de GD est automatiquement détecté. Il remplace la séquence `header ("Content-Type: image/gif"); imagegif ($im);` par un code plus souple :

>     <?php
>     // Création d'une image
>     $im = imagecreatetruecolor(100, 100);

>     // On fait quelques opérations sur l'image ici...

>     // Gestion de l'affichage
>     if(function_exists('imagegif'))
>     {
>         // Pour GIF
>         header('Content-Type: image/gif');

>         imagegif($im);
>     }
>     elseif(function_exists('imagejpeg'))
>     {
>         // Pour JPEG
>         header('Content-Type: image/jpeg');

>         imagejpeg($im, NULL, 100);
>     }
>     elseif(function_exists('imagepng'))
>     {
>         // Pour PNG
>         header('Content-Type: image/png');

>         imagepng($im);
>     }
>     elseif(function_exists('imagewbmp'))
>     {
>         // Pour WBMP
>         header('Content-Type: image/vnd.wap.wbmp');

>         imagewbmp($im);
>     }
>     else
>     {
>         die('Aucun support sur ce serveur PHP n\'a été trouvé');
>     }

>     ?>

> Note:

> Il est possible d'utiliser la fonction imagetypes() au lieu de function_exists() pour vérifier la présence des différents formats d'images supportés :

>     <?php
>     if(imagetypes() & IMG_GIF)
>     {
>         header('Content-Type: image/gif');
>         imagegif($im);
>     }
>     elseif(imagetypes() & IMG_JPG)
>     {
>         /* ... etc. */
>     }
>     ?>

### Voir aussi

- imagepng() - Envoie une image PNG vers un navigateur ou un fichier
- imagewbmp() - Affichage de l'image vers le navigateur ou dans un fichier
- imagejpeg() - Affichage de l'image vers le navigateur ou dans un fichier
- imagetypes() - Retourne les types d'images supportés par la version courante de PHP

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