Выводит изображение в браузер или записывает в файл

# imagegif

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

imagegif — Выводит изображение в браузер или записывает в файл

### Описание

function imagegif(GdImage `$image`, resource|string|null `$file` = `null`): bool

Функция imagegif() создаёт изображение в формате GIF в файле или ресурсе потока, который указали в аргументе `file`. Функция берёт за основу изображение `image`. Аргумент `image` — изображение, которое возвращает функция imagecreate() или функции семейства `imagecreatefrom*`.

Функция создаст файл в формате GIF87a, если только изображение не сделали прозрачным функцией imagecolortransparent(), тогда функция создаст изображение в формате GIF89a.

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

`image`
  Объект GdImage, который вернула функция imagecreatetruecolor() или другая функция генерации изображений.
`file`

  Путь или ресурс открытого потока, который функция автоматически закрывает после возврата значения, для сохранения файла. Функция выведет поток необработанного изображения напрямую, если параметр не установили или передали в аргументе значение `null`.

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

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

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

Функция вернёт значение `true`, если вывести изображение средствами библиотеки libgd невозможно.

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

Версия | Описание
--- | ---
8.0.0 | Параметр `image` теперь принимает объект GdImage; раньше параметр принимал корректный `gd`-ресурс (resource).

### Примеры

Пример #1 Пример вывода изображения функцией imagegif()

    <?php

    // Создание изображения
    $im = imagecreatetruecolor(100, 100);

    // Создание белого фона
    imagefilledrectangle($im, 0, 0, 99, 99, 0xFFFFFF);

    // Отрисовка текста на изображении
    imagestring($im, 3, 40, 20, 'GD библиотека', 0xFFBA00);

    // Вывод изображения в браузер
    header('Content-Type: image/gif');

    imagegif($im);

    ?>

Пример #2 Пример преобразования PNG-изображения в формат GIF функцией imagegif()

    <?php

    // Загрузка PNG-файла
    $png = imagecreatefrompng('./php.png');

    // Сохранение файла в формате GIF
    imagegif($png, './php.gif');

    // Готово
    echo 'Преобразование PNG-файла в GIF-файл завершилось успешно!';

    ?>

### Примечания

> Замечание:

> Следующий фрагмент кода помогает писать переносимые PHP-приложения и автоматически определяет доступный тип GD-изображения. Замените строки `header ("Content-Type: image/gif"); imagegif ($im);` на более гибкую последовательность:

>     <?php

>     // Создание нового изображения
>     $im = imagecreatetruecolor(100, 100);

>     // Какие-либо операции с изображением

>     // Обработка вывода
>     if (function_exists('imagegif')) {
>         // Для GIF-файлов
>         header('Content-Type: image/gif');

>         imagegif($im);
>     } elseif (function_exists('imagejpeg')) {
>         // Для JPEG-файлов
>         header('Content-Type: image/jpeg');

>         imagejpeg($im, NULL, 100);
>     } elseif (function_exists('imagepng')) {
>         // Для PNG-файлов
>         header('Content-Type: image/png');

>         imagepng($im);
>     } elseif (function_exists('imagewbmp')) {
>         // Для WBMP-файлов
>         header('Content-Type: image/vnd.wap.wbmp');

>         imagewbmp($im);
>     } else {
>         die('На этом PHP-сервере нет поддержки изображений');
>     }

>     ?>

> Замечание:

> Проверить поддержку формата помогает функция imagetypes():

>     <?php

>     if (imagetypes() & IMG_GIF) {
>         header('Content-Type: image/gif');
>         imagegif($im);
>     } elseif (imagetypes() & IMG_JPG) {
>         /* ... и т. д. */
>     }

>     ?>

### Смотрите также

- imagepng() - Выводит PNG-изображение в браузер или файл
- imagewbmp() - Выводит изображение в браузер или записывает в файл
- imagejpeg() - Выводит изображение в браузер или записывает в файл
- imagetypes() - Возвращает список типов изображений, поддерживаемых PHP сборкой

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