agilepixel/imagesrespond

On-the-fly responsive images

v0.2.1 2019-05-16 09:11 UTC

This package is auto-updated.

Last update: 2024-11-16 21:16:57 UTC


README

Build Status Coverage Status

A quick drop-in PHP library to output scaled images for responsive purposes

Usage

You have a large image with the following url

http://my.site/img/my_large_image.png

Once installed and configured, you can return a scaled version of this image with a width of 200px by amending the requested url:

http://my.site/img/respond-200-my_large_image.png

If you need the scaling to be based on height instead of witdh use the following:

http://my.site/img/respond-200h-my_large_image.png

Installation via Composer

composer require agilepixel/imagesrespond

Configure for Apache

Enter into your server configuration or .htaccess, customise based on your desired configuration

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} respond-[0-9]+h?-.*\.(jpg|gif|png|webp|jpeg)$
RewriteRule ^(.*)$ vendor/agilepixel/imagesrespond/src/rewrite.php [L]

Configure for Nginx

Enter the following into your Nginx server configuration, customise based on your desired configuration

rewrite respond-([0-9]+)h?-.*\.(jpg|gif|png|webp|jpeg)$ /vendor/agilepixel/imagesrespond/src/rewrite.php last;