array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.imagejpeg.php', 1 => 'imagejpeg', 2 => 'Выводит изображение в браузер или записывает в файл', ), 'up' => array ( 0 => 'ref.image.php', 1 => 'Функции GD и функции для работы с изображениями', ), 'prev' => array ( 0 => 'function.imageistruecolor.php', 1 => 'imageistruecolor', ), 'next' => array ( 0 => 'function.imagelayereffect.php', 1 => 'imagelayereffect', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/image/functions/imagejpeg.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

imagejpeg

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

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

Описание

imagejpeg(GdImage $image, resource|string|null $file = null, int $quality = -1): bool

Функция imagejpeg() создаёт файл в формате JPEG из изображения image.

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

image

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

file

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

quality

Необязательный параметр, который принимает значения в диапазоне от 0 — низкое качество, файл меньшего размера, — до 100 для высокого качества при наибольшем размере файла. Значение по умолчанию равняется -1 и устанавливает качество IJG по умолчанию — около 75.

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

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

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

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

Ошибки

Функция выбрасывает ошибку ValueError, если значение параметра quality недопустимо.

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

Версия Описание
8.4.0 Функция теперь выбрасывает ошибку ValueError, если значение параметра quality недопустимо.
8.0.0 Параметр image теперь принимает объект GdImage; раньше параметр принимал корректный gd-ресурс (resource).

Примеры

Пример #1 Пример вывода JPEG-изображения в браузер

<?php

// Создаём пустое изображение и добавляем текст
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'A Simple Text String', $text_color);

// Устанавливаем заголовок для типа содержимого image/jpeg
header('Content-Type: image/jpeg');

// Выводим изображение
imagejpeg($im);

?>

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

Пример выведет изображение в формате JPEG

Пример #2 Пример сохранения JPEG-изображения в файл

<?php

// Создаём пустое изображение и добавляем текст
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'A Simple Text String', $text_color);

// Сохраняем изображение в файл 'simpletext.jpg'
imagejpeg($im, 'simpletext.jpg');

?>

Пример #3 Пример вывода JPEG-изображения в браузер с качеством 75 %

<?php

// Создаём пустое изображение и добавляем текст
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'A Simple Text String', $text_color);

// Устанавливаем заголовок для типа содержимого image/jpeg
header('Content-Type: image/jpeg');

// Передаём в параметр file значение NULL, чтобы пропустить его, и устанавливаем качество 75 %
imagejpeg($im, NULL, 75);

?>

Примечания

Замечание:

Для вывода данных в формате Progressive JPEG потребуется путём вызова функции imageinterlace() включить для изображения интерлейсинг.

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