hermajan / imagony

dev-master 2026-10-09 14:36 UTC

Requires

• php: >=8.2
• imagine/imagine: ^1.5
• psr/log: ^1.0|^2.0|^3.0
• symfony/config: ^8.0
• symfony/dependency-injection: ^8.0
• symfony/finder: ^7.4|^8.0
• symfony/http-kernel: ^8.0
• symfony/yaml: ^7.4|^8.0
• twig/twig: ^3.0

Requires (Dev)

• phpunit/phpunit: ^13.3

Suggests

• ext-gd: GD driver. Needs WebP/AVIF support compiled in for those formats (docker-php-ext-configure gd --with-webp --with-avif)
• ext-imagick: Imagick driver, preferred when present. Needs an ImageMagick with WebP/AVIF delegates for those formats
• symfony/console: Provides `bin/console imagony:check` which diagnoses missing PHP image extensions and configuration problems

MIT

Published on Packagist.org on 2026-10-09 14:38 UTC

README

Symfony bundle and Twig extension for creating thumbnails of images using Imagine.

✨ Features

• Thumbnails: the Twig function thumbnail() creates cached thumbnails of a given size or of a named template.
• Resize modes: fit, shrink only, stretch, fill and exact (crop).
• WebP and AVIF: thumbnails are also converted to modern formats.
• Built-in placeholder: a missing or broken image is replaced by a fallback served by the bundle, no assets to install.
• Zero configuration: works without a config file, GD or Imagick is used automatically.
• Diagnostics: imagony:check explains missing PHP extensions and wrong configuration, imagony:clean removes generated thumbnails.
• Open Graph images: converts images to the 1.91:1 ratio.

📥 Installation

Install this via Composer:

composer require hermajan/imagony

PHP 8.2+ with the GD or Imagick extension is required.

📚 Documentation

Usage and documentation for this project is in wiki.