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 On success, this function returns a GDImage instance now; previously, a resource was returned.
7.3.0 WEBP agora é suportado (caso seja suportado pela libgd em uso).

Exemplos

Example #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);
    imagedestroy($im);
}
else {
    echo 'Ocorreu um erro.';
}
?>

O exemplo acima produzirá algo semelhante a:

Saída do exemplo: imagecreatefromstring()

Veja Também