array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'en', ), 'this' => array ( 0 => 'function.imagecreatefromstring.php', 1 => 'imagecreatefromstring', ), 'up' => array ( 0 => 'ref.image.php', 1 => 'GD and Image Functions', ), 'prev' => array ( 0 => 'function.imagecreatefrompng.php', 1 => 'imagecreatefrompng', ), 'next' => array ( 0 => 'function.imagecreatefromtga.php', 1 => 'imagecreatefromtga', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/image/functions/imagecreatefromstring.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)
imagecreatefromstring — Create a new image from the image stream in the string
imagecreatefromstring() returns an image identifier
representing the image obtained from the given data
.
These types will be automatically detected if your build of PHP supports
them: JPEG, PNG, GIF, BMP, WBMP, GD2, and WEBP.
data
A string containing the image data.
An image object will be returned on success. false
is returned if
the image type is unsupported, the data is not in a recognised format,
or the image is corrupt and cannot be loaded.
imagecreatefromstring() raises an E_WARNING level error, if the data is not in a recognized format.
Version | Description |
---|---|
8.0.0 | On success, this function returns a GDImage instance now; previously, a resource was returned. |
7.3.0 | WEBP is supported now (if supported by the libgd in use). |
Example #1 imagecreatefromstring() example
<?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);
imagedestroy($im);
}
else {
echo 'An error occurred.';
}
?>
The above example will output something similar to: