Sur cette page
14 janvier 2026
Cecil 8.77.0 est sorti
Cette version refactorise et simplifie la logique de redimensionnement et de recadrage d'images, consolidant la fonctionnalité dans une seule méthode resize plus flexible. Elle met également à jour les filtres Twig et templates associés pour utiliser la nouvelle approche et améliore la gestion d'erreurs et la documentation dans tout le traitement d'images.
Refactorisation et simplification de l'API de traitement d'images
- La méthode
coverpour recadrer les images à des dimensions spécifiques a été supprimée à la fois de la classeAssetet des filtres Twig. Toutes les opérations de redimensionnement et recadrage sont maintenant gérées via une méthoderesizeaméliorée qui accepte à la fois largeur et hauteur, et recadre l'image si les deux sont fournis. - La méthode
resizedansAssetet le filtre Twig correspondant acceptent maintenant largeur et hauteur comme paramètres optionnels, offrant une plus grande flexibilité et réduisant la duplication de code. - La méthode
Image::resizeest mise à jour pour gérer à la fois le redimensionnement et le recadrage, remplaçant les précédentes méthodesresizeetcover. Elle inclut maintenant aussi une option pour supprimer l'animation des images.
Mises à jour de l'utilisation des templates et filtres
- Le filtre Twig
coverest supprimé, et toutes les utilisations dans les templates sont mises à jour pour utiliser la nouvelle signatureresize(width, height). - Le template metatags utilise maintenant le nouveau filtre
resizepour les images OpenGraph, passant largeur et hauteur quand approprié.
Gestion d'erreurs et clarté du code
- Les messages d'exception dans tout le code de traitement d'images ont été standardisés pour inclure des points à la fin et clarifier le contexte d'erreur.
- Nettoyages mineurs du code et amélioration de la documentation pour les méthodes de traitement d'images.
Améliorations du rendu HTML d'images
- L'attribut
sizespour les éléments<source>n'est maintenant inclus que quand il n'est pas vide, empêchant un HTML invalide. - L'attribut
srcsetn'est ajouté aux images que quand il n'est pas vide, améliorant la correction de la sortie.
Dans l'ensemble, ces changements modernisent et rationalisent la gestion des images, rendant l'API plus facile à utiliser et maintenir.
Notes de version sur GitHub