imagecreatefromgif

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

imagecreatefromgif — Создаёт новое изображение из файла или URL-адреса

Описание

imagecreatefromgif(string $filename): GdImage|false

Функция imagecreatefromgif() возвращает объект изображения, которое получили по названию файла.

Предостережение

При чтении анимированных GIF-файлов в память возвращается указатель на ресурс изображения только для первого фрейма. Размер изображения не вегда соответствует тому, что возвращает функция getimagesize().

Подсказка

В эту функцию в качестве имени файла можно передавать URL-адреса, если была включена директива fopen wrappers. Подробнее о том, как указать имя файла, рассказано в описании функции fopen(). В разделе «Протоколы и обёртки» также даны ссылки на информацию о способностях поддерживаемых обёрток, замечания по работе с ними и список предопределённых переменных, которые они дают.

Список параметров

filename: Путь к GIF-картинке.

Возвращаемые значения

Функция возвращает объект изображения, если выполнилась успешно, или false, если возникла ошибка.

Список изменений

Версия	Описание
8.0.0	Функция теперь возвращает экземпляр класса GDImage, если выполнилась успешно; раньше возвращался ресурс (resource).

Примеры

Пример #1 Пример обработки ошибки при загрузке изображения в формате GIF

<?php

function LoadGif($imgname)
{
    /* Пытаемся открыть */
    $im = @imagecreatefromgif($imgname);

    /* При неудаче */
    if (!$im) {
        /* Создаём пустое изображение */
        $im = imagecreatetruecolor (150, 30);
        $bgc = imagecolorallocate ($im, 255, 255, 255);
        $tc = imagecolorallocate ($im, 0, 0, 0);

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

        /* Выводим сообщение об ошибке */
        imagestring ($im, 1, 5, 5, 'Ошибка загрузки ' . $imgname, $tc);
    }

    return $im;
}

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

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

imagegif($img);

?>

Вывод приведённого примера будет похож на: