tempest/responsive-image

Server-side responsive images with PHP

0.0.1 2026-05-29 08:41 UTC

Requires

• php: ^8.5
• intervention/image: ^4.1

Requires (Dev)

• carthage-software/mago: 1.16.0
• phpbench/phpbench: ^1.4
• phpunit/phpunit: ^12.0
• tempest/command-bus: ^3.11
• tempest/debug: ^3.11

MIT

• Brent Roose

README

Generate responsive images with PHP and render the correct HTML.

Important

This package is still a work in progress! Feel free to open issues.

Quickstart

composer require tempest/responsive-image

use Tempest\ResponsiveImage\ResponsiveImageFactory;
use Tempest\ResponsiveImage\ResponsiveImageConfig;

$config = new ResponsiveImageConfig(
    srcPath: __DIR__ . '/path/to/image/sources',
    publicPath: __DIR__ . '/../public',
);

$imageFactory = new ResponsiveImageFactory($config);

$image = $imageFactory->create('/parrot.jpg');

echo $image->html;

// <img src="/parrot.jpg" srcset="/parrot-1920-1280.jpg 1920w, /parrot-1606-1070.jpg 1606w, /parrot-1214-809.jpg 1214w, /parrot-607-404.jpg 607w">

In depth

Read the full docs here: https://tempestphp.com/docs/packages/responsive-image