Aller au contenu principal

Réglez désormais vos services avec Revolut Pay

Gaprod

Nextcloud et Imagick : activer les aperçus d'images

Billy Rousseau— Fondateur de Gaprod11 min read

Une alerte demande d'installer PHP Imagick dans Nextcloud, mais les miniatures restent absentes après l'ajout du paquet ? Imagick n'est qu'un maillon. Le serveur web doit charger l'extension dans la bonne version de PHP, ImageMagick doit savoir décoder le format et la politique de sécurité doit autoriser l'opération.

Ce guide suit cette chaîne dans l'ordre. Il permet de corriger un module manquant sans activer tous les fournisseurs d'aperçus ni affaiblir la sécurité pour faire fonctionner un seul fichier.

À quoi servent Imagick et ImageMagick dans Nextcloud ?

Les noms sont proches, mais ils ne désignent pas la même couche :

  • ImageMagick est la bibliothèque et l'ensemble d'outils qui lisent, transforment et écrivent des images.
  • Imagick est l'extension PHP qui donne accès à ImageMagick depuis une application PHP.
  • Le fournisseur d'aperçu Nextcloud décide si un type de fichier peut produire une miniature.
  • Un délégué est une bibliothèque ou un programme externe utilisé par ImageMagick pour certains formats.

Nextcloud classe imagick parmi les modules PHP optionnels destinés aux aperçus d'images. Son système de miniatures possède déjà des réglages par défaut adaptés aux formats courants. Les aperçus PDF, SVG, bureautiques et vidéo sont désactivés par défaut en raison de leurs coûts et de leurs risques. Installer Imagick ne les active donc pas automatiquement.

La conséquence pratique est importante : extension_loaded('imagick') peut renvoyer vrai alors qu'un HEIC, un SVG ou un PDF reste illisible. L'extension PHP fonctionne, mais la bibliothèque liée peut manquer du format nécessaire, son délégué peut être absent ou une règle de sécurité peut bloquer le décodage.

Pour replacer ce composant dans l'ensemble du serveur, consultez le guide général de Nextcloud. La configuration de la mémoire PHP et d'OPcache aide ensuite à identifier la version et le SAPI réellement utilisés.

Chaîne de génération des aperçus Nextcloud entre PHP Imagick, ImageMagick, formats et politique de sécurité
Un aperçu dépend de quatre contrôles successifs. La présence du module PHP ne suffit pas à valider le format final.

Comment installer PHP Imagick pour Nextcloud ?

Avant toute installation, relevez le mode de déploiement. Une archive sur Ubuntu, une image Docker, Nextcloud AIO, Snap et un hébergement administré n'exposent pas les mêmes paquets ni les mêmes services. Ne modifiez pas le système hôte si PHP s'exécute dans un conteneur.

Sur l'installation Ubuntu 24.04 documentée par Nextcloud, le paquet est inclus dans la liste des modules proposés :

sudo apt update
sudo apt install php-imagick

Le paquet non versionné suit normalement la version PHP fournie par la distribution. Si plusieurs versions coexistent, affichez d'abord le binaire du terminal et les paquets installés :

php -v
dpkg -l 'php*-imagick'

Rechargez ensuite le processus qui exécute Nextcloud. Avec PHP-FPM, adaptez le nom du service à la version active. Avec le module Apache, rechargez Apache.

# Exemple pour PHP-FPM 8.3
sudo systemctl reload php8.3-fpm

# Exemple pour Apache avec mod_php
sudo systemctl reload apache2

Un nom de service copié au hasard peut recharger un PHP qui ne sert pas le site. Vérifiez la configuration du virtual host, du proxy FastCGI ou du panneau avant cette étape. Sur Docker, reconstruisez ou redémarrez le service prévu par l'image au lieu d'installer le paquet dans un conteneur éphémère.

Le manuel PHP précise que l'extension officielle s'appelle imagick et qu'elle n'est pas intégrée au cœur de PHP. Une compilation PECL reste possible, mais le paquet de la distribution est préférable lorsqu'il existe, car il garde les dépendances ImageMagick cohérentes avec le système. Sur une offre gérée, demandez au fournisseur d'activer le module dans la version PHP du domaine.

Ne confondez pas PHP CLI et PHP du site

php -m contrôle le terminal. Nextcloud peut utiliser une autre version, un autre fichier php.ini ou un autre pool PHP-FPM. Il faut valider les deux environnements avant de conclure que l'installation est terminée.

Comment vérifier qu'Imagick est chargé par le bon PHP ?

Commencez par le terminal utilisé pour les commandes occ et les tâches Cron :

php -m | grep -i '^imagick$'
php --ri imagick
php -r 'var_dump(extension_loaded("imagick"));'

La première commande doit afficher imagick. La deuxième fournit notamment la version de l'extension et la version d'ImageMagick liée. La troisième doit renvoyer bool(true).

Ce contrôle ne représente le service web que si occ, Cron et PHP-FPM utilisent le même binaire et les mêmes fichiers de configuration. La documentation Nextcloud recommande de vérifier l'environnement web depuis Paramètres d'administration > Système. L'affichage PHP peut être activé temporairement avec :

sudo -u www-data php /var/www/nextcloud/occ \
  config:app:set --value=yes serverinfo phpinfo

Ouvrez ensuite les informations système, recherchez la section imagick, puis désactivez cet affichage après le contrôle. Ces informations révèlent des chemins et des réglages sensibles. Ne publiez pas leur copie dans un ticket ouvert.

Comparez au minimum ces éléments :

ContrôleTerminalServeur web
Version de PHPphp -vEn-tête de la page PHP
Fichier chargéphp --iniLoaded Configuration File
Module Imagickphp --ri imagickSection imagick
Version ImageMagickSortie ImagickSection imagick

Si le module apparaît en CLI mais pas dans Nextcloud, cherchez une version PHP différente, un fichier php.ini propre à FPM, une directive extension absente ou un service non rechargé. Si l'erreur concerne seulement Cron, faites l'analyse inverse : le site peut charger Imagick alors que le binaire exécuté par la crontab ne le charge pas.

Comment vérifier les formats réellement pris en charge ?

Une extension active ne prouve pas que chaque format est décodable. Interrogez directement ImageMagick :

Les exemples ci-dessous utilisent l'interface ImageMagick 7. Si votre distribution fournit ImageMagick 6, remplacez magick identify par la commande directe identify.

magick identify -list format | grep -E 'HEIC|HEIF|JPEG|PDF|PNG|SVG|TIFF|WEBP'
magick identify -list delegate

La liste des formats indique les capacités de lecture et d'écriture compilées. ImageMagick précise par exemple que WebP demande sa bibliothèque déléguée et que le rendu SVG peut passer par Inkscape, RSVG ou son moteur interne. Le résultat dépend donc du paquet installé, pas seulement du nom ImageMagick.

Testez ensuite un fichier représentatif, avec une copie sans donnée sensible :

magick identify -verbose /chemin/vers/test.webp
magick identify -verbose /chemin/vers/test.heic

Un JPEG réussi ne valide pas HEIC. Un HEIC listé mais impossible à lire peut révéler un délégué absent, une version incompatible ou une politique restrictive. Sur Debian 13 et Ubuntu 24.04, la documentation Nextcloud cite aussi un paquet ImageMagick complémentaire pour fournir le support SVG utilisé par la génération d'icônes de Theming. Le nom diffère selon la distribution, il faut donc suivre le paquet correspondant à votre système.

Pour une photothèque, testez au moins un exemplaire de chaque famille réellement présente : JPEG, PNG, WebP, HEIC ou HEIF et TIFF. Le guide Nextcloud Memories couvre séparément l'indexation des métadonnées, la chronologie et les dépendances vidéo. Imagick ne remplace ni ffmpeg ni ffprobe.

Validez un nouveau fichier, pas seulement une ancienne miniature

Importez une copie renommée du média de test, ouvrez son dossier dans Files ou Photos et observez les journaux au même instant. Une miniature déjà stockée peut masquer une régression, tandis qu'un ancien échec peut rester visible après la correction.

Pourquoi PDF ou SVG restent-ils bloqués ?

ImageMagick applique des politiques de sécurité qui peuvent limiter un codeur, un chemin, une ressource ou un délégué. Affichez les règles actives avec :

magick identify -list policy

Une erreur comme not authorized ne signifie pas qu'il faut autoriser globalement PDF, PostScript ou SVG. Identifiez d'abord le format demandé, le fournisseur Nextcloud concerné et la règle exacte. La documentation Nextcloud rappelle que plusieurs fournisseurs, dont PDF et SVG, sont désactivés par défaut pour des raisons de sécurité et de performance, et déconseille leur activation générale.

La politique ImageMagick peut aussi limiter la mémoire, la taille des images, le nombre de fichiers ou l'accès indirect. Ces restrictions protègent un service exposé à des fichiers envoyés par les utilisateurs. Modifiez seulement la règle nécessaire, conservez une copie du fichier de politique, puis testez un fichier valide et un fichier volontairement refusé.

Si votre besoin porte uniquement sur JPEG, PNG et WebP, ne modifiez pas les règles PDF ou SVG. Si un métier exige les miniatures PDF, documentez la source des fichiers, leur taille maximale, les processus externes impliqués et le retour arrière avant de changer la politique.

Comment tester la correction dans Nextcloud ?

Procédez du composant le plus bas vers l'application :

  1. php --ri imagick confirme l'extension dans le PHP de occ.
  2. La page Système confirme l'extension dans le PHP du serveur web.
  3. magick identify lit le format du fichier test.
  4. magick identify -list policy ne montre pas de règle contradictoire.
  5. Un nouveau fichier produit un aperçu dans Files ou Photos.
  6. Les journaux Nextcloud et PHP ne contiennent plus l'erreur reproduite.

Ne lancez pas immédiatement une régénération de toute la photothèque. Commencez avec un dossier pilote qui contient plusieurs formats et quelques images de grande taille. Mesurez le temps, la mémoire et la charge CPU. La génération d'aperçus décompresse les images en mémoire, parfois bien au-delà de leur poids sur disque.

Si vous utilisez l'application Preview Generator, corrigez Imagick avant de remplir sa file. Le guide Nextcloud Preview Generator explique comment cibler un utilisateur ou un dossier, limiter les tailles et surveiller la file. La pré-génération ne répare pas un décodeur absent, elle répète simplement l'échec à plus grande échelle.

Après un changement de dimensions ou de fournisseurs, Nextcloud fournit occ preview:cleanup pour retirer les aperçus devenus obsolètes. Cette opération prépare une régénération potentiellement coûteuse. Elle ne doit pas être utilisée comme premier test d'une extension nouvellement installée, ni remplacée par une suppression manuelle du dossier appdata_*/preview.

Diagnostic rapide des erreurs Imagick

SymptômeCause probableVérification utile
Imagick absent en CLI et dans le webPaquet non installé ou extension désactivéeInstaller le paquet adapté, puis contrôler les fichiers php.ini
Imagick présent en CLI, absent dans NextcloudVersion ou SAPI différentComparer php --ini avec la page Système
JPEG fonctionne, HEIC échoueFormat ou délégué HEIC absentLire la sortie de identify -list format et tester un HEIC
PDF renvoie not authorizedPolitique ImageMagick ou fournisseur désactivéLire les politiques et la configuration des aperçus
Toutes les images montrent une icôneAperçus désactivés, module absent ou limite de ressourcesVérifier enable_previews, les journaux et la mémoire
Cron échoue alors que le site fonctionnePHP CLI différent de PHP-FPMExécuter Cron avec le même binaire et contrôler Imagick
Ancienne miniature inchangéeAperçu déjà stockéTester une copie renommée avant toute purge globale

Conclusion

Pour activer Imagick dans Nextcloud, installez l'extension dans la version PHP réellement utilisée, rechargez le bon service et vérifiez séparément CLI et serveur web. Contrôlez ensuite les formats et les politiques ImageMagick avec un fichier représentatif. Cette séquence distingue un module absent, un délégué manquant, une règle de sécurité et un fournisseur Nextcloud désactivé.

Sur une instance administrée, l'installation des modules, le redémarrage de PHP et les politiques ImageMagick relèvent généralement de l'exploitant. Transmettez le format qui échoue, l'heure du test et le message exact plutôt que de demander une ouverture générale des aperçus.

Découvrir l'hébergement Nextcloud GaprodModules PHP et génération d'aperçus administrés selon le périmètre de l'offre

Sources officielles

Articles similaires

Prêt à démarrer avec Gaprod ?

Hébergement web, VPS et solutions cloud 100% français, avec support expert inclus.

30j rembourséMigration gratuiteSupport 7j/7