Cómo escalar imágenes y añadir marcas de agua con PHP Imagick
Para redimensionar una foto y añadirle una marca de agua con PHP Imagick, aplica primero su orientación, redimensiona los píxeles y luego dibuja el texto al tamaño final. El siguiente script recibe un JPEG o PNG local, reduce los anchos superiores a 800 píxeles sin recortar y guarda un PNG independiente con «© Your Company» en la esquina inferior derecha. El original permanece intacto y nunca se sobrescribe un archivo de salida existente.
Imagick es la interfaz de PHP para ImageMagick. Permite realizar estas operaciones sobre una imagen en memoria. Este ejemplo está pensado para imágenes estáticas que tú controlas: usa una foto sRGB o un PNG, que puede tener transparencia. Se rechazan las entradas GIF, WebP, PDF y CMYK. Los PNG animados y los JPEG con múltiples imágenes (MPO) quedan fuera del alcance de este tutorial; el decodificador puede exponer solo el primer fotograma, por lo que comprobar el número de fotogramas decodificados no demuestra que un archivo contenga solo una imagen.
Configura PHP e Imagick
La siguiente configuración usa Docker y una terminal compatible con Bash en Linux. Se probó en Linux
x86_64 con PHP 8.4.27, Imagick 3.8.1, ImageMagick 7.1.2-35 y DejaVu Sans 2.37. El Dockerfile fija las
versiones de PHP e Imagick, pero instala los paquetes actuales de los repositorios de Alpine 3.23;
las compilaciones posteriores pueden usar revisiones más recientes de los paquetes de Alpine.
Crea un directorio de trabajo vacío y abre tu terminal allí. Guarda lo siguiente 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
Compila la imagen local; este paso requiere acceso a internet. La instalación de la extensión sigue las instrucciones de PECL de la imagen oficial de PHP.
docker build -t imagick-demo:local .
Espera a que la compilación termine correctamente antes de continuar. Alpine distribuye el
codificador JPEG en un paquete separado,
por lo que esta configuración lo instala explícitamente. La imagen contiene la fuente en
/usr/share/fonts/dejavu/DejaVuSans.ttf, genera su caché de fuentes y mantiene las cachés de ejecución en el
directorio /tmp del contenedor, que permite escritura. Si ya tienes este
conjunto de PHP e Imagick instalado localmente, puedes ejecutar el script PHP directamente con tu
propio archivo de fuente; el contenedor que se usa a continuación proporciona las tres dependencias
sin modificar la instalación de PHP de tu equipo.
Guarda el script para redimensionar y añadir marcas de agua
Guarda el código completo que aparece a continuación como resize-watermark.php junto al
Dockerfile. Los tres argumentos son la imagen de entrada, una nueva ruta de salida
.png y un archivo de fuente TrueType que se pueda leer. El directorio padre
del archivo de salida ya debe 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);
El script pasa un descriptor de archivo abierto a
readImageFile(), de modo que ImageMagick no interpreta
el nombre del archivo de entrada como un prefijo de formato o un selector de fotogramas. También
escribe mediante un descriptor de archivo: el
modo xb de PHP rechaza cualquier archivo
de salida existente, incluido el propio archivo de entrada. Úsalo como un comando local secuencial;
el archivo de salida se hace visible mientras se escribe. Si se detecta un fallo de escritura, se
elimina el nuevo archivo parcial, pero un proceso terminado puede dejarlo en el disco.
Ejecútalo con una imagen local
Copia una imagen estática en este directorio con el nombre input.jpg, o cambia
el argumento de entrada que aparece a continuación por el nombre de tu archivo PNG. Luego ejecuta:
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
El directorio montado permite acceder a output.png desde tu equipo. Para una
entrada de 1.600 × 1.000 sin rotación, el comando muestra Wrote output.png (800 × 500). Abre ese
archivo: debería contener la imagen completa, con el texto separado del borde inferior derecho por
un margen. Si ejecutas el mismo comando de nuevo, falla con un estado distinto de cero y deja
intacto el PNG existente. Elige un nombre de archivo de salida nuevo para la próxima versión.
Ajusta el tamaño y la marca de agua
autoOrient() aplica la orientación almacenada antes
de medir el ancho. Esto es importante para las fotos de teléfonos: una foto vertical almacenada de
lado debe rotarse antes de elegir sus dimensiones de salida. En
resizeImage(), una altura de cero permite calcular
la altura proporcional. La comprobación del ancho evita ampliar las imágenes más pequeñas; no hay
un límite de altura.
Cambia $text por tu marca de agua breve de una sola línea. El script
establece el tamaño de la fuente después de redimensionar, por lo que el texto no se escala con las
dimensiones en píxeles de la imagen de origen. El relleno blanco con contorno negro ayuda a que el
texto siga siendo visible tanto sobre zonas claras como oscuras. La comprobación de las métricas
de la fuente rechaza las imágenes demasiado pequeñas para contener el texto con sus márgenes.
Esta es una marca de atribución visible, no una protección contra quienes recorten o editen la
imagen.
Elige el comportamiento de la salida y los metadatos
PNG conserva las áreas transparentes en lugar de aplanarlas sobre un fondo. También puede ocupar
más que el JPEG original, incluso después de redimensionar; este script no promete reducir el
tamaño del archivo. Cambiar el nombre de la salida a .jpg no cambia el
codificador, por lo que el script requiere la extensión .png.
stripImage() elimina perfiles y comentarios.
Aquí se ejecuta después de aplicar la orientación. El script restaura el perfil de color ICC y
ajusta la configuración de los bloques PNG para conservarlo.
También borra las propiedades de la imagen para que los campos EXIF decodificados no se copien en
los bloques de texto del PNG. El codificador aún puede añadir metadatos de formato y color; esto no
garantiza un archivo sin metadatos. Usa imágenes de origen sRGB para este flujo de trabajo y una
conversión independiente con gestión del color para los activos destinados a impresión o con una
gama de colores amplia.
Gestiona los fallos y los archivos no confiables
Si falta la entrada o la fuente, la imagen no se puede decodificar, el formato no es compatible o
la salida ya existe, el proceso termina con un código distinto de cero y un mensaje en la salida
de error estándar. El archivo de salida no se abre hasta que la decodificación, el cambio de tamaño
y el dibujo se completan correctamente. Si la ruta de la fuente existe pero no corresponde a una
fuente válida, Imagick informa del fallo al medir o dibujar el texto. Para una miniatura muy
pequeña, acorta el texto o reduce setFontSize(24) en el script.
Este es un ejemplo de edición local de imágenes, no un endpoint de subida. ImageMagick debe decodificar la entrada antes de que el script pueda comprobar su formato y el número de fotogramas, y un decodificador puede tolerar algunos archivos dañados. Un procesamiento correcto no certifica que una entrada esté completa o sea segura. Para las subidas no confiables, configura una política de seguridad de ImageMagick que restrinja los codificadores, los delegados, las dimensiones, los fotogramas, la memoria, el disco y el tiempo de procesamiento, junto con límites de tamaño de las solicitudes y aislamiento de los ejecutores. Los límites de memoria por sí solos pueden hacer que la caché de píxeles se traslade al disco; no limitan la tarea completa.
¿Prefieres no ejecutarlo por tu cuenta?
Transloadit redimensiona, recorta y optimiza imágenes mediante una sola API.
