symfony/ux-lazy-image

Lazy image loader and utilities for Symfony

v2.27.0 2025-06-08 13:02 UTC

Requires

• php: >=8.1
• symfony/config: ^5.4|^6.0|^7.0
• symfony/dependency-injection: ^5.4|^6.0|^7.0
• symfony/deprecation-contracts: ^2.5|^3
• symfony/http-kernel: ^5.4|^6.0|^7.0

Requires (Dev)

• intervention/image: ^2.5|^3.0
• kornrunner/blurhash: ^1.1
• symfony/cache-contracts: ^2.2
• symfony/framework-bundle: ^5.4|^6.0|^7.0
• symfony/phpunit-bridge: ^5.2|^6.0|^7.0
• symfony/twig-bundle: ^5.4|^6.0|^7.0
• symfony/var-dumper: ^5.4|^6.0|^7.0

MIT

• Titouan Galopin
• Symfony Community

• symfony-ux

README

Warning

Deprecated: This package has been deprecated in 2.x and will be removed in the next major version.

The package has been deprecated in favor of modern techniques to improve image loading performance natively supported by all major browsers (<img loading="lazy">).

To keep using BlurHash functionality, you can use the package kornrunner/php-blurhash.

Symfony UX LazyImage is a Symfony bundle providing utilities to improve image loading performance. It is part of the Symfony UX initiative.

It provides two key features:

• a Stimulus controller to load lazily heavy images, with a placeholder
• a BlurHash implementation to create data-uri thumbnails for images

This repository is a READ-ONLY sub-tree split. See https://github.com/symfony/ux to create issues or submit pull requests.

Sponsor

The Symfony UX packages are backed by Mercure.rocks.

Create real-time experiences in minutes! Mercure.rocks provides a realtime API service that is tightly integrated with Symfony: create UIs that update in live with UX Turbo, send notifications with the Notifier component, expose async APIs with API Platform and create low level stuffs with the Mercure component. We maintain and scale the complex infrastructure for you!

Help Symfony by sponsoring its development!

Resources

• Documentation
• Report issues and send Pull Requests in the main Symfony UX repository