# imagecreatefromgif

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

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

### Description

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 frame est retournée par l'objet de l'image. La taille de l'image n'est pas forcément ce qui est rapporté 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 ; auparavant, 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, 'Error loading ' . $imgname, $tc);
}
return $im;
}
header('Content-Type: image/gif');
$img = LoadGif('bogus.image');
imagegif($img);
?>`

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