array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.imagecreatefromstring.php', 1 => 'imagecreatefromstring', 2 => 'Cria uma nova imagem a partir de um fluxo de imagem na string', ), 'up' => array ( 0 => 'ref.image.php', 1 => 'Funções de GD e Image', ), 'prev' => array ( 0 => 'function.imagecreatefrompng.php', 1 => 'imagecreatefrompng', ), 'next' => array ( 0 => 'function.imagecreatefromtga.php', 1 => 'imagecreatefromtga', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/image/functions/imagecreatefromstring.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

imagecreatefromstring

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

imagecreatefromstring — Cria uma nova imagem a partir de um fluxo de imagem na string

Descrição

imagecreatefromstring(string $data): GdImage|false

imagecreatefromstring() retorna um identificador de imagem representando a imagem obtida pelos dados informados no parâmetro data. Estes tipos serão automaticamente detectados se a compilação do PHP suportá-los: JPEG, PNG, GIF, BMP, WBMP, GD2, WEBP e AVIF.

Parâmetros

data

Uma string contendo os dados da imagem.

Valor Retornado

Um objeto de imagem será retornado em caso de sucesso. false é retornado se o tipo da imagem não for suportado, se os dados não estiverem em formato reconhecido, ou se a imagem estiver corrompida e não puder ser carregada.

Erros/Exceções

imagecreatefromstring() emite um erro de nível E_WARNING, se os dados não estiverem em um formato reconhecido.

Registro de Alterações

Versão Descrição
8.0.0 Em caso de sucesso, esta função retorna agora uma instância de GDImage; anteriormente, retornava um resource.
7.3.0 WEBP agora é suportado (caso seja suportado pela libgd em uso).

Exemplos

Exemplo #1 Exemplo de 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 'Ocorreu um erro.';
}
?>

O exemplo acima produzirá algo semelhante a:

Saída do exemplo: imagecreatefromstring()

Veja Também