imagecreatefromstring

(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)

imagecreatefromstring — Создаёт новое изображение из представленного строкой потока

Описание

imagecreatefromstring(string $data): GdImage|false

Функция imagecreatefromstring() возвращает идентификатор изображения, которое функция получила из параметра data. PHP-сборка, если поддерживает, будет автоматически определять типы изображений: JPEG, PNG, GIF, BMP, WBMP, GD2, WEBP и AVIF.

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

data: Строка, которая содержит данные изображения.

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

Функция вернёт объект изображения, если выполнилась успешно. Функция вернёт false, если модуль не поддерживает тип изображения, не распознаёт формат данных или изображение повреждено и загружается.

Ошибки

Функция imagecreatefromstring() выдаёт ошибку уровня E_WARNING, если не распознала формат данных.

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

Версия	Описание
8.0.0	Функция теперь возвращает экземпляр класса GDImage, если выполнилась успешно; раньше функция возвращала ресурс (resource).
7.3.0	Добавили поддержку формата WEBP, если модуль libgd поддерживает такой формат.

Примеры

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

<?php

$data = 'iVBORw0KGgoAAAANSUhEUgAAABwAAAASCAMAAAB/2U7WAAAABl'
       . 'BMVEUAAAD///+l2Z/dAAAASUlEQVR4XqWQUQoAIAxC2/0vXZDr'
       . 'EX4IJTRkb7lobNUStXsB0jIXIAMSsQnWlsV+wULF4Avk9fLq2r'
       . '8a5HSE35Q3eO2XP1A1wQkZSgETvDtKdQAAAABJRU5ErkJggg=='
;

$data = base64_decode($data);

$im = imagecreatefromstring($data);

if ($im !== false) {
    header('Content-Type: image/png');
    imagepng($im);
} else {
    echo 'Возникла ошибка.';
}

?>

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

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

imagecreatefromjpeg() - Создаёт новое изображение из файла или URL-адреса
imagecreatefrompng() - Создаёт новое изображение из файла или URL-адреса
imagecreatefromgif() - Создаёт новое изображение из файла или URL-адреса
imagecreatetruecolor() - Создаёт новое truecolor-изображение