Home/ Manual/ image / functions/ imagecreatefromgif

imagecreatefromgif

PHP function Edit on GitHub ✎

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

New

Description

imagecreatefromgif(string $filename): GdImage|false

imagecreatefromgif() returns an image identifier representing the image obtained from the given filename.

Caution

When reading GIF files into memory, only the first frame is returned in the image object. The size of the image is not necessarily what is reported by getimagesize().

Fopen-wrapper

Parameters

filename: Path to the GIF image.

Return Values

Identifier

Changelog

Version	Description
8.0.0	On success, this function returns a `GDImage` instance now; previously, a `resource` was returned.

Examples

Example to handle an error during loading of a GIF

php

<?php
function LoadGif($imgname)
{
    /* Attempt to open */
    $im = @imagecreatefromgif($imgname);

    /* See if it failed */
    if(!$im)
    {
        /* Create a blank image */
        $im = imagecreatetruecolor (150, 30);
        $bgc = imagecolorallocate ($im, 255, 255, 255);
        $tc = imagecolorallocate ($im, 0, 0, 0);

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

        /* Output an error message */
        imagestring ($im, 1, 5, 5, 'Error loading ' . $imgname, $tc);
    }

    return $im;
}

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

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

imagegif($img);
?>

The above example will output something similar to: Output of example : Example to handle an error during loading of a GIF

Source: reference/image/functions/imagecreatefromgif.xml · from the official PHP manual (php/doc-en)