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

# imagecreatefromgif

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

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

### Описание

function 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);

    ?>

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

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