Installation

1. Composer: composer require nelson/resizer

2. Register:

   extensions:resizer:Nelson\Resizer\DI\ResizerExtension

3. Config:

   This is the bare minimum required:

   resizer:library:'Imagick'# Imagick|Gmagick|GdwwwDir:%wwwDir%tempDir:%tempDir%

   Other options with their defaults:

   resizer:interlace:true# for progressive JPEGsstrip:true# removes image metadata, color profiles etc.cache:'/resizer/'qualityAvif:70# 0 - 100qualityWebp:70# 0 - 100qualityJpeg:70# 0 - 100compressionPng:9# 0 - 9upgradeJpg2Webp:true# automatically convert JPEGs to WEBP when the format is supported by the browser & serverupgradeJpg2Avif:true# automatically convert JPEGs to AVIF when the format is supported by the browser & serverupgradePng2Webp:true# automatically convert PNGs to WEBP when the format is supported by the browser & serverupgradePng2Avif:true# automatically convert PNGs to AVIF when the format is supported by the browser & server

There is also an upgrade/downgrade logic for AVIF & WEBP. Most preferred is the original AVIF/WEBP, then each other, finally JPEG.

AVIF is preferred over WEBP in case both upgrades are enabled.

Usage

Order of parameters is dependant on the router, the default is:

1. Dimensions & modifiers. string
2. Image file. string
3. Format. string

Dimensions & modifiers

Syntax: - [ifresize-][[cropX]width]x[[cropY]height][forceDimensions][-quality]

Dimensions:

• 100x100 - width and height must be equal or less, resized according to AR.
• x100 - height must be equal or less.
• 100x - width must be equal or less.
• 100x50! - dimensions are forced without respecting ifresize and AR.
• Cropping:
  • width: l - left, c - center, r - right.
  • height: t - top, c - center, b - bottom.
  • Example: c100xc100

Modifiers:

• ifresize
  • Example: ifresize-100x200
  • If the image is smaller than the desired width and/or height, image will not be enlarged.
• Quality
  • Example: x-q50 - sets just the quality without any resize.
  • For WEBP/AVIF quality set to 100 means lossless compression.

Format:

• The format parameter can be used to switch between image file formats, e.g. <source srcset=""> in <picture> tag for converting jpegs to WEBP/AVIF.

Relative and absolute URLs

Relative:

• <img src="{rlink 'test.jpg', '200x100'}">

Absolute, uses diffent tag:

• <img src="{rlinkabs 'test.jpg', 'l400xc200'}">
• <a href="{rlinkabs 'test.jpg', 'l400xc200'}" target="_blank">Link to image</a>