Crée une nouvelle image depuis un fichier ou une URL

# imagecreatefromgif

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

imagecreatefromgif — Crée une nouvelle image depuis un fichier ou une URL

### Description

function imagecreatefromgif(string `$filename`): GdImage|false

imagecreatefromgif() retourne un identifiant d'image qui représente l'image obtenue à partir du fichier dont le nom est donné par `filename`.

Attention

Lors de la lecture en mémoire de fichiers GIF animés, seule la première image est retournée dans l'objet image. La taille de l'image n'est pas forcément celle rapportée par getimagesize().

Astuce

Vous pouvez utiliser une URL comme nom de fichier avec cette fonction, si le gestionnaire fopen a été activé. Voyez fopen() pour plus de détails sur la façon de spécifier le nom du fichier. Reportez-vous aux Liste des protocoles et des gestionnaires supportés pour plus d'informations sur les capacités des différents gestionnaires, les notes sur leur utilisation, ainsi que les informations sur les variables prédéfinies qu'elles fournissent.

### Liste de paramètres

`filename`

  Chemin vers l'image GIF.

### Valeurs de retour

Retourne un objet d'image en cas de succès, ou `false` si une erreur survient.

### Historique

Version | Description
--- | ---
8.0.0 | En cas de succès, cette fonction retourne désormais une instance de GDImage ; antérieur à PHP 8.0.0, une resource était retournée.

### Exemples

Exemple #1 Exemple de prise en charge d'une erreur lors du chargement d'une image GIF

    <?php
    function LoadGif($imgname)
    {
        /* Tente d'ouvrir l'image */
        $im = @imagecreatefromgif($imgname);

        /* Traitement si l'ouverture a échoué */
        if(!$im)
        {
            /* Création d'une image vide */
            $im = imagecreatetruecolor (150, 30);
            $bgc = imagecolorallocate ($im, 255, 255, 255);
            $tc = imagecolorallocate ($im, 0, 0, 0);

            imagefilledrectangle ($im, 0, 0, 150, 30, $bgc);

            /* Affiche un message d'erreur dans l'image */
            imagestring ($im, 1, 5, 5, 'Erreur de chargement ' . $imgname, $tc);
        }

        return $im;
    }

    header('Content-Type: image/gif');

    $img = LoadGif('bogus.image');

    imagegif($img);
    ?>

Résultat de l'exemple ci-dessus est similaire à :

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