
Imagick es la extensión de PHP que permite a una aplicación utilizar ImageMagick para leer, transformar y generar imágenes. En WordPress puede mejorar el tratamiento de imágenes, PDF y otros formatos, pero no es un requisito obligatorio: si no está disponible, el CMS suele recurrir a GD Library.
Esta guía sustituye los comandos antiguos de RunCloud por un procedimiento más general para servidores Ubuntu y Debian. Los nombres de los paquetes y del servicio PHP-FPM pueden cambiar según la distribución y la versión de PHP instalada, así que conviene comprobar esos datos antes de copiar cualquier orden.
php-imagick desde los repositorios.ImageMagick es una suite capaz de leer, convertir y escribir numerosos formatos, entre ellos JPEG, PNG, GIF, WebP, TIFF, SVG y PDF. Permite redimensionar, recortar, rotar, componer, convertir y aplicar ajustes a imágenes. La documentación de PHP describe Imagick como una extensión nativa que expone la API de ImageMagick a las aplicaciones PHP.
La alternativa más habitual en WordPress es GD. Para las operaciones comunes de la biblioteca multimedia suele ser suficiente y está disponible en muchos alojamientos. Imagick resulta interesante cuando necesitas trabajar con más formatos, imágenes de varias páginas, perfiles de color o transformaciones más complejas. No significa que todas las imágenes vayan a verse automáticamente mejor: el resultado depende también del formato, la compresión y la configuración del servidor.
Antes de cambiar nada, revisa los requisitos actuales de PHP para WordPress. WordPress.org recomienda PHP 8.3 o superior, aunque las versiones mínimas y la disponibilidad de cada extensión dependen de tu instalación y de tu proveedor.
Empieza identificando la versión de PHP que utiliza la consola:
php -v
cat /etc/os-release
En un servidor con varias versiones instaladas, la salida de php -v puede no coincidir con el PHP que atiende las peticiones web. Más adelante veremos cómo comprobar la extensión en PHP-FPM.
En una instalación estándar de Ubuntu o Debian, actualiza el índice de paquetes e instala el programa y la extensión:
sudo apt update
sudo apt install imagemagick php-imagick
Si mantienes varias versiones de PHP y necesitas activar Imagick solo en una de ellas, algunos repositorios ofrecen un paquete específico, por ejemplo:
sudo apt install php8.3-imagickLenguaje del código: CSS (css)
Sustituye 8.3 por la versión disponible en tu servidor. No mezcles paquetes de una distribución o repositorio distinto sin comprobar antes sus dependencias. En Debian, por ejemplo, la disponibilidad de paquetes específicos cambia entre versiones del sistema.
Después de instalar la extensión, recarga el servicio que procesa PHP. En un servidor con PHP-FPM, el nombre suele incluir la versión:
sudo systemctl reload php8.3-fpmLenguaje del código: CSS (css)
Si usas Apache con el módulo de PHP, el servicio puede ser apache2. Comprueba el nombre real con systemctl list-units --type=service | grep -E 'php|apache|nginx' y recarga únicamente el servicio que corresponda. En alojamientos administrados, esta operación puede tener que hacerla el proveedor.
Primero verifica la extensión desde la línea de comandos:
php --ri imagick
php -m | grep -i imagick
Si aparece la información de Imagick, está activa para ese PHP de consola. Para confirmar el PHP que utiliza la web, revisa la información del servidor en Herramientas > Salud del sitio > Información y comprueba también la biblioteca multimedia. Si la consola muestra Imagick pero la web no, probablemente estás usando distintas versiones, distintos archivos php.ini o PHP-FPM no se ha recargado.
No dejes un archivo público de phpinfo() en producción. Si lo necesitas para diagnosticar el servidor, úsalo de forma temporal, protégelo y elimínalo en cuanto termines.
El soporte para PDF no depende únicamente de instalar Imagick. ImageMagick necesita un delegado como Ghostscript para algunas operaciones y, además, muchas distribuciones bloquean determinados formatos mediante policy.xml. Es una medida de seguridad: procesar archivos PDF, PostScript o EPS no confiables puede ampliar la superficie de ataque.
Antes de tocar la política, revisa qué está permitido:
magick -list policyLenguaje del código: PHP (php)
La ruta y el comando pueden variar entre ImageMagick 6 y 7. Si necesitas convertir PDF, limita la función a archivos controlados, mantén ImageMagick y Ghostscript actualizados y aplica una política específica para el caso de uso. No recomendamos comentar sin más la regla que bloquea PDF para aceptar cualquier archivo subido por usuarios.
Para una web normal, la decisión no debe tomarse solo por el número de formatos compatibles. Si el servidor genera miniaturas correctamente con GD, instalar otra biblioteca añade una pieza más que mantener. Imagick tiene sentido cuando un plugin lo necesita, cuando trabajas con formatos concretos o cuando el servidor debe realizar transformaciones que GD no resuelve bien.
Después de activarlo, prueba cargas grandes, imágenes transparentes, WebP y cualquier flujo de PDF que utilice tu web. Comprueba también el consumo de memoria y el tiempo de respuesta: una conversión más completa puede exigir más recursos. Para mejorar el resultado final, combina la configuración del servidor con una buena estrategia de optimización de imágenes para SEO en WordPress y revisa el rendimiento general de la instalación.
No. ImageMagick es el software de procesamiento de imágenes. Imagick es la extensión de PHP que permite a una aplicación utilizar su API.
No. WordPress puede trabajar con GD Library. Imagick es útil cuando necesitas funciones, formatos o transformaciones que encajan mejor con ImageMagick.
Normalmente significa que Imagick no está instalado, no está habilitado para el PHP que usa la web o el servicio PHP-FPM necesita recargarse. Comprueba la extensión en consola y en el entorno web antes de cambiar la configuración.
Solo si necesitas procesar PDF y entiendes el riesgo. Mantén bloqueados los formatos que no uses y acepta únicamente archivos de confianza o procésalos en un entorno aislado.
Empieza por los requisitos del plugin o aplicación. Si GD cubre tus necesidades, no tienes que añadir Imagick. Si necesitas PDF, formatos concretos o transformaciones avanzadas, comprueba la compatibilidad de Imagick con tu versión de PHP y con el alojamiento.
Fuentes oficiales: manual de Imagick en PHP; requisitos de Imagick; requisitos actuales de WordPress; política de seguridad de ImageMagick.
