array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.imagejpeg.php', 1 => 'imagejpeg', 2 => 'Envia a imagem para o navegador ou para um arquivo', ), 'up' => array ( 0 => 'ref.image.php', 1 => 'Funções de GD e Image', ), 'prev' => array ( 0 => 'function.imageistruecolor.php', 1 => 'imageistruecolor', ), 'next' => array ( 0 => 'function.imagelayereffect.php', 1 => 'imagelayereffect', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', '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 — Envia a imagem para o navegador ou para um arquivo

Descrição

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

imagejpeg() cria um arquivo JPEG a partir da imagem informada em image.

Parâmetros

image

Um objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().

file

O caminho ou um recurso de fluxo aberto (que será fechado automaticamente após o retorno desta função) para salvar o arquivo. Se não for definido ou for null, o fluxo da imagem bruta será enviado diretamente.

quality

quality é opcional e varia de 0 (pior qualidade, arquivo menor) a 100 (melhor qualidade, arquivo maior). O padrão (-1) usa o valor de qualidade IJG padrão (por volta de 75).

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Cuidado

Entretanto, se a biblioteca libgd falhar ao gerar a imagem, esta função retornará true.

Erros/Exceções

Lança um ValueError se quality for inválido.

Registro de Alterações

Versão Descrição
8.4.0 Agora lança um ValueError se quality for inválido.
8.0.0 O parâmetro image agora espera uma instância de GdImage; anteriormente, um resource gd válido era esperado.

Exemplos

Exemplo #1 Mostrando uma imagem JPEG no navegador

<?php
// Cria uma imagem vazia e adiciona um texto
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'A Simple Text String', $text_color);

// Define o cabeçalho de tipo de conteúdo - neste caso image/jpeg
header('Content-Type: image/jpeg');

// Mostra a imagem
imagejpeg($im);
?>

O exemplo acima produzirá algo semelhante a:

Saída do exemplo: Mostrando uma imagem JPEG

Exemplo #2 Gravando uma imagem JPEG em um arquivo

<?php
// Cria uma imagem vazia e adiciona um texto
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'A Simple Text String', $text_color);

// Grava a imagem como 'simpletext.jpg'
imagejpeg($im, 'simpletext.jpg');
?>

Exemplo #3 Mostrando a imagem com 75% de qualidade no navegador

<?php
// Cria uma imagem vazia e adiciona um texto
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'A Simple Text String', $text_color);

// Define o cabeçalho de tipo de conteúdo - neste caso image/jpeg
header('Content-Type: image/jpeg');

// Ignora o parâmetro arquivo usando NULL, e então define a qualidade para 75%
imagejpeg($im, NULL, 75);
?>

Notas

Nota:

Se for desejado mostrar JPEGs progressivos, deve-se habilitar entrelace com a função imageinterlace().

Veja Também