Como redimensionar imagens e inserir marca-d’água com PHP Imagick
Para redimensionar uma foto e inserir uma marca-d’água com PHP Imagick, aplique primeiro a orientação, redimensione os pixels e depois desenhe o texto no tamanho final. O script abaixo recebe um JPEG ou PNG local, reduz larguras acima de 800 pixels sem recortar e salva um PNG separado com “© Your Company” no canto inferior direito. O original permanece inalterado, e um arquivo de saída existente nunca é sobrescrito.
Imagick é a interface do PHP para o ImageMagick. Ela permite realizar essas operações em uma imagem na memória. Este exemplo se destina a imagens estáticas sob seu controle: use uma foto ou um PNG em sRGB, inclusive com transparência. Entradas GIF, WebP, PDF e CMYK são rejeitadas. PNG animado e JPEG com múltiplas imagens (MPO) estão fora do escopo deste tutorial; o decodificador pode expor apenas o primeiro quadro, portanto verificar a contagem de quadros decodificados não comprova que um arquivo contém apenas uma imagem.
Configure o PHP e o Imagick
A configuração a seguir usa Docker e um terminal compatível com Bash no Linux. Ela foi testada
no Linux x86_64 com PHP 8.4.27, Imagick 3.8.1, ImageMagick 7.1.2-35 e DejaVu Sans 2.37.
O Dockerfile fixa as versões do PHP e do Imagick, mas instala os pacotes atuais dos repositórios
3.23 do Alpine; compilações posteriores podem usar revisões mais recentes dos pacotes do Alpine.
Crie um diretório de trabalho vazio e abra seu terminal nele. Salve este conteúdo como
Dockerfile:
FROM php:8.4.27-cli-alpine3.23
RUN apk add --no-cache imagemagick imagemagick-jpeg font-dejavu \
&& apk add --no-cache --virtual .build-deps $PHPIZE_DEPS imagemagick-dev \
&& pecl install imagick-3.8.1 \
&& docker-php-ext-enable imagick \
&& apk del .build-deps \
&& fc-cache -f
ENV XDG_CACHE_HOME=/tmp
WORKDIR /work
Compile a imagem local; esta etapa precisa de acesso à internet. A instalação da extensão segue as instruções de PECL da imagem oficial do PHP.
docker build -t imagick-demo:local .
Aguarde a conclusão bem-sucedida da compilação antes de continuar. O Alpine distribui o
codificador JPEG separadamente,
por isso a configuração o instala explicitamente. A imagem contém a fonte em
/usr/share/fonts/dejavu/DejaVuSans.ttf, gera o cache de fontes e mantém os caches de execução no
diretório /tmp do contêiner, que permite gravação. Se você já tem esse
stack de PHP/Imagick instalado localmente, pode executar o script PHP diretamente com seu próprio
arquivo de fonte; o contêiner abaixo fornece as três dependências sem alterar a instalação do
PHP na sua máquina.
Salve o script de redimensionamento e marca-d’água
Salve o código completo abaixo como resize-watermark.php ao lado do Dockerfile.
Os três argumentos são a imagem de entrada, um novo caminho de saída
.png e um arquivo de fonte TrueType com permissão de leitura.
O diretório pai da saída já deve existir.
<?php
declare(strict_types=1);
$image = null;
$input = null;
$output = null;
$created = false;
$status = 0;
try {
if ($argc !== 4) {
throw new RuntimeException('Usage: php resize-watermark.php INPUT OUTPUT.png FONT.ttf');
}
if (!extension_loaded('imagick')) {
throw new RuntimeException('Enable the Imagick extension in your CLI PHP.');
}
$inputPath = realpath($argv[1]);
$outputDirectory = realpath(dirname($argv[2]));
$fontPath = realpath($argv[3]);
if ($inputPath === false || !is_file($inputPath) || !is_readable($inputPath)) {
throw new RuntimeException('Input must be a readable local image file.');
}
if ($fontPath === false || !is_file($fontPath) || !is_readable($fontPath)) {
throw new RuntimeException('Font must be a readable local TrueType file.');
}
if ($outputDirectory === false || strtolower(pathinfo($argv[2], PATHINFO_EXTENSION)) !== 'png') {
throw new RuntimeException('Use a .png output in an existing directory.');
}
$outputPath = $outputDirectory . DIRECTORY_SEPARATOR . basename($argv[2]);
$input = fopen($inputPath, 'rb');
if ($input === false) {
throw new RuntimeException('Could not open the input.');
}
$image = new Imagick();
$image->setOption('png:preserve-iCCP', 'true');
$image->readImageFile($input);
if ($image->getNumberImages() !== 1 || !in_array($image->getImageFormat(), ['JPEG', 'PNG'], true)) {
throw new RuntimeException('Use a still JPEG or PNG image.');
}
if ($image->getImageColorspace() === Imagick::COLORSPACE_CMYK) {
throw new RuntimeException('Convert CMYK images to sRGB before using this example.');
}
$image->autoOrient();
if ($image->getImageWidth() > 800) {
$image->resizeImage(800, 0, Imagick::FILTER_LANCZOS, 1);
}
$image->setImagePage(0, 0, 0, 0);
$text = '© Your Company';
$draw = new ImagickDraw();
$draw->setFont($fontPath);
$draw->setFontSize(24);
$draw->setFillColor('white');
$draw->setFillOpacity(0.8);
$draw->setStrokeColor('black');
$draw->setStrokeWidth(1);
$draw->setGravity(Imagick::GRAVITY_SOUTHEAST);
$metrics = $image->queryFontMetrics($draw, $text);
if ($metrics['textWidth'] + 32 > $image->getImageWidth()
|| $metrics['textHeight'] + 32 > $image->getImageHeight()) {
throw new RuntimeException('Image is too small for this watermark. Shorten the text or reduce its font size.');
}
$image->annotateImage($draw, 16, 16, 0, $text);
$profiles = $image->getImageProfiles('icc', true);
$image->stripImage();
// stripImage also tells the PNG encoder to omit ICC, even if we restore the profile.
$image->setImageArtifact('png:exclude-chunk', 'eXIf,date');
if (isset($profiles['icc'])) {
$image->profileImage('icc', $profiles['icc']);
}
// Decoded EXIF properties can otherwise be copied into PNG text chunks.
foreach ($image->getImageProperties('*', false) as $property) {
$image->deleteImageProperty($property);
}
$image->setImageFormat('png');
$output = @fopen($outputPath, 'xb');
if ($output === false) {
throw new RuntimeException('Cannot create output: it already exists or the directory is not writable.');
}
$created = true;
if (!$image->writeImageFile($output, 'png') || !fflush($output)) {
throw new RuntimeException('Could not finish writing the PNG.');
}
printf("Wrote %s (%d × %d)\n", $argv[2], $image->getImageWidth(), $image->getImageHeight());
} catch (Throwable $error) {
fwrite(STDERR, 'Resize failed: ' . $error->getMessage() . PHP_EOL);
$status = 1;
} finally {
if (is_resource($input)) {
fclose($input);
}
if (is_resource($output)) {
fclose($output);
}
if ($status !== 0 && $created) {
unlink($outputPath);
}
$image?->clear();
}
exit($status);
O script passa um identificador de arquivo aberto para
readImageFile(), para que o ImageMagick não
interprete o nome do arquivo de entrada como um prefixo de formato ou seletor de quadro. Ele
também grava por meio de um identificador de arquivo: o
modo xb do PHP recusa uma saída
existente, inclusive o próprio arquivo de entrada. Use este script como um comando local
sequencial; a saída fica visível enquanto está sendo gravada. Uma falha de gravação capturada
remove o novo arquivo parcial, mas um processo encerrado pode deixá-lo para trás.
Execute em uma imagem local
Copie uma imagem estática para este diretório como input.jpg ou altere o
argumento de entrada abaixo para o nome do seu arquivo PNG. Em seguida, execute:
docker run --rm --network none --user "$(id -u):$(id -g)" \
--mount "type=bind,source=$PWD,target=/work" --workdir /work \
imagick-demo:local php resize-watermark.php input.jpg output.png \
/usr/share/fonts/dejavu/DejaVuSans.ttf
O diretório montado disponibiliza output.png na sua máquina. Para uma entrada
de 1.600 × 1.000 sem rotação, o comando informa Wrote output.png (800 × 500). Abra esse arquivo:
a imagem inteira deve estar presente, com o texto afastado da borda inferior direita. Executar
o mesmo comando novamente causa uma falha com status diferente de zero e deixa o PNG existente
inalterado. Escolha um novo nome de arquivo de saída para a próxima versão.
Ajuste o tamanho e a marca-d’água
autoOrient() aplica a orientação armazenada
antes de medir a largura. Isso é importante para fotos de celular: uma foto em modo retrato
armazenada de lado precisa ser girada antes de você escolher as dimensões de saída. Em
resizeImage(), uma altura de zero calcula
a altura proporcional. A verificação de largura evita ampliar imagens menores; não há limite
de altura.
Altere $text para sua marca-d’água curta, de uma única linha. O script
define o tamanho da fonte após o redimensionamento, para que o texto não seja escalado conforme
as dimensões em pixels da imagem de origem. O preenchimento branco com contorno preto ajuda o
texto a permanecer visível tanto em áreas claras quanto escuras. A verificação das métricas da
fonte rejeita imagens pequenas demais para acomodar o texto com suas margens. Essa é uma marca
visível de atribuição, não uma proteção contra alguém recortar ou editar a imagem.
Escolha o comportamento da saída e dos metadados
O PNG mantém as áreas transparentes em vez de mesclá-las a um fundo. Ele também pode ser maior
que o JPEG original, mesmo após o redimensionamento; este script não promete reduzir o tamanho
do arquivo. Renomear a saída para .jpg não altera o codificador, por
isso o script exige a extensão .png.
stripImage() remove perfis e comentários.
Aqui, ele é executado após a aplicação da orientação. O script restaura o perfil de cores ICC e
ajusta as configurações de chunks do PNG para preservá-lo.
Ele também limpa as propriedades da imagem para que os campos EXIF decodificados não sejam
copiados para chunks de texto do PNG. O codificador ainda pode adicionar metadados de formato
e cor; isso não garante um arquivo sem metadados. Use imagens de origem em sRGB neste fluxo de
trabalho e uma conversão separada com gerenciamento de cores para recursos destinados à
impressão ou com ampla gama de cores.
Trate falhas e arquivos não confiáveis
Uma entrada ausente, uma fonte ausente, uma imagem que não pode ser decodificada, um formato não
compatível ou uma saída existente causa o encerramento com status diferente de zero e uma
mensagem na saída de erro padrão. A saída só é aberta depois que a decodificação, o
redimensionamento e o desenho são concluídos com sucesso. Se o caminho da fonte existir, mas
não for uma fonte válida, o Imagick informa a falha ao medir ou desenhar o texto. Para uma
miniatura muito pequena, encurte o texto ou reduza setFontSize(24) no script.
Este é um exemplo local de edição de imagens, não um endpoint de upload. O ImageMagick precisa decodificar a entrada antes que o script possa verificar seu formato e sua contagem de quadros, e um decodificador pode tolerar alguns arquivos danificados. O processamento bem-sucedido não certifica que uma entrada está completa ou é segura. Para uploads não confiáveis, configure uma política de segurança do ImageMagick que restrinja codificadores, delegados, dimensões, quadros, memória, disco e tempo de processamento, em conjunto com limites de tamanho das requisições e isolamento das unidades de processamento. Limites de memória, por si só, podem fazer o cache de pixels ser gravado em disco; eles não limitam o processamento como um todo.
Prefere não executar isso por conta própria?
A Transloadit redimensiona, recorta e otimiza imagens por meio de uma única API.
