Última actualización: 11 de septiembre

Redimensionar imágenes y añadir marcas de agua en PHP con Imagick

Kevin van Zonneveld

Cofundador · Ámsterdam, Países Bajos ·

Imagick es una extensión robusta de PHP que envuelve la biblioteca ImageMagick y permite a los desarrolladores crear, modificar y convertir imágenes de forma eficiente. Este tutorial muestra cómo redimensionar imágenes y aplicar marcas de agua con Imagick, para que puedas mejorar las capacidades de procesamiento de imágenes de tu aplicación web.

Introducción a Imagick y sus beneficios

Imagick es una extensión de PHP de código abierto que ofrece una API orientada a objetos para el procesamiento de imágenes. Al aprovechar la potente biblioteca ImageMagick, admite una amplia variedad de formatos de imagen y funciones avanzadas de procesamiento de imágenes.

Compatibilidad de versiones de PHP

Usa una versión de PHP 8 con soporte y una compilación compatible de la extensión Imagick.

Ventajas de usar Imagick

Amplio soporte de formatos: admite más de 200 formatos de imagen, incluidos JPEG, PNG, GIF y más.
Procesamiento avanzado: ofrece funciones robustas para redimensionar, recortar, rotar y añadir efectos.
Rendimiento: maneja imágenes grandes de forma eficiente y ejecuta operaciones complejas con rapidez.
Desarrollo activo: se actualiza continuamente gracias a una gran comunidad.
Código abierto: disponible libremente y con contribuciones de la comunidad.

Instalación y configuración de Imagick

Antes de usar Imagick, instala tanto el software ImageMagick como la extensión Imagick de PHP.

Instalación en Ubuntu/Debian (PHP 8.x)

# Ubuntu/Debian (PHP 8.x)
sudo apt-get update
sudo apt-get install php-imagick imagemagick fonts-dejavu-core

Instalación en macOS

brew install imagemagick
brew install php
pecl install imagick

Tras la instalación, asegúrate de que la extensión esté habilitada añadiendo la siguiente línea a tu php.ini:

extension=imagick.so

Reinicia tu servidor web para aplicar los cambios.

Consideraciones de seguridad

Establece límites de recursos antes de leer una imagen y valida después su tipo decodificado. Restringe también los tamaños de subida y los codificadores de imagen permitidos en la política de seguridad de ImageMagick; los límites de memoria por sí solos no son una defensa completa frente a archivos maliciosos.

<?php
// Limits are bytes. Configure them before decoding untrusted image data.
Imagick::setResourceLimit(Imagick::RESOURCETYPE_MEMORY, 256 * 1024 * 1024);
Imagick::setResourceLimit(Imagick::RESOURCETYPE_DISK, 1024 * 1024 * 1024);
$image = new Imagick($imagePath);

// Validate image MIME types
$allowedMimeTypes = ['image/jpeg', 'image/png', 'image/gif'];
if (!in_array($image->getImageMimeType(), $allowedMimeTypes)) {
    throw new Exception('Invalid image type');
}

Redimensionar imágenes con Imagick: tutorial paso a paso

El siguiente ejemplo muestra cómo redimensionar imágenes de forma segura con Imagick:

<?php
try {
    $image = new Imagick($imagePath);

    // Ensure the file is a valid image
    if (!$image->valid()) {
        throw new Exception('Invalid image');
    }

    // Validate MIME type
    $allowedMimeTypes = ['image/jpeg', 'image/png', 'image/gif'];
    if (!in_array($image->getImageMimeType(), $allowedMimeTypes)) {
        throw new Exception('Invalid image type');
    }

    // Resize the image to a width of 800px while maintaining the aspect ratio
    $image->resizeImage(800, 0, Imagick::FILTER_LANCZOS, 1);

    // Strip metadata for enhanced security and performance
    $image->stripImage();

    $image->writeImage($outputPath);
} catch (ImagickException $e) {
    error_log('Imagick error: ' . $e->getMessage());
    throw new Exception('Image processing failed');
} finally {
    if (isset($image)) {
        $image->clear();
    }
}

Añadir marcas de agua a las imágenes con Imagick

Los ejemplos de marca de agua usan la fuente DejaVu instalada más arriba. Configura $fontPath con un archivo de fuente instalado en tu sistema; en Debian/Ubuntu, usa /usr/share/fonts/truetype/dejavu/DejaVuSans.ttf.

<?php
try {
    $image = new Imagick($imagePath);

    // Ensure the file is a valid image
    if (!$image->valid()) {
        throw new Exception('Invalid image');
    }

    // Create watermark text
    $draw = new ImagickDraw();
    $draw->setFillColor('gray');
    $draw->setFont($fontPath);
    $draw->setFontSize(30);
    $draw->setGravity(Imagick::GRAVITY_SOUTHEAST);
    $draw->setFillOpacity(0.5);

    // Add watermark text with a slight opacity effect
    $image->annotateImage($draw, 10, 12, 0, '© Your Company');

    $image->writeImage($outputPath);
} catch (ImagickException $e) {
    error_log('Imagick error: ' . $e->getMessage());
    throw new Exception('Watermark application failed');
} finally {
    if (isset($image)) {
        $image->clear();
    }
}

Optimización del rendimiento

Optimiza tus imágenes procesadas para el rendimiento web con estos ajustes:

<?php
try {
    $image = new Imagick($imagePath);

    // Set compression quality for larger images
    if ($image->getImageLength() > 1024 * 1024) {
        $image->setImageCompressionQuality(85);
    }

    // Convert image format to WebP for improved compression
    $image->setImageFormat('webp');

    // Remove metadata to reduce file size
    $image->stripImage();

    $image->writeImage($outputPath);
} catch (ImagickException $e) {
    error_log('Imagick error: ' . $e->getMessage());
    throw new Exception('Image optimization failed');
} finally {
    if (isset($image)) {
        $image->clear();
    }
}

Combinar operaciones para flujos de trabajo eficientes

Combina el redimensionado, la marca de agua y la optimización en un único proceso eficiente:

<?php
try {
    $image = new Imagick($imagePath);

    // Validate the image
    if (!$image->valid()) {
        throw new Exception('Invalid image');
    }

    // Resize the image
    $image->resizeImage(800, 0, Imagick::FILTER_LANCZOS, 1);

    // Apply watermark text
    $draw = new ImagickDraw();
    $draw->setFillColor('gray');
    $draw->setFont($fontPath);
    $draw->setFontSize(20);
    $draw->setGravity(Imagick::GRAVITY_SOUTHEAST);
    $image->annotateImage($draw, 10, 12, 0, '© Your Company');

    // Optimize the image for the web
    $image->stripImage();
    $image->setImageCompressionQuality(85);
    $image->setInterlaceScheme(Imagick::INTERLACE_PLANE);

    $image->writeImage($outputPath);
} catch (ImagickException $e) {
    error_log('Imagick error: ' . $e->getMessage());
    throw new Exception('Image processing failed');
} finally {
    if (isset($image)) {
        $image->clear();
    }
}

Buenas prácticas

Cuando trabajes con Imagick, sigue estas buenas prácticas:

Usa un manejo de errores completo con bloques try-catch.
Valida rigurosamente las imágenes de entrada y sus tipos MIME.
Establece límites de recursos para prevenir ataques de denegación de servicio.
Prefiere la carga progresiva de imágenes para el rendimiento web.
Elimina los metadatos para reducir el tamaño de los archivos y mejorar la seguridad.
Libera recursos llamando a clear() en los objetos Imagick.
Considera convertir las imágenes al formato WebP para mejorar la compresión.
Configura permisos de archivo y controles de acceso adecuados.
Registra los errores de forma efectiva para facilitar la resolución de problemas.

Si sigues estas estrategias y aprovechas las funciones robustas de Imagick, podrás crear flujos de trabajo de procesamiento de imágenes eficientes en tus aplicaciones PHP.

En Transloadit, usamos herramientas robustas de procesamiento de imágenes para gestionar de forma eficiente procesamientos de imagen complejos. Si buscas soluciones escalables para manejar imágenes y archivos multimedia, explora nuestra API de procesamiento de imágenes.