Skip to content

Gappa/Resizer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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|Gd
    	wwwDir: %wwwDir%
    	tempDir: %tempDir%

    Other options with their defaults:

    resizer:
    	interlace: true # for progressive JPEGs
    	strip: true # removes image metadata, color profiles etc.
    	cache: '/resizer/'
    	qualityAvif: 70 # 0 - 100
    	qualityWebp: 70 # 0 - 100
    	qualityJpeg: 70 # 0 - 100
    	compressionPng: 9 # 0 - 9
    	upgradeJpg2Webp: true # automatically convert JPEGs to WEBP when the format is supported by the browser & server
    	upgradeJpg2Avif: true # automatically convert JPEGs to AVIF when the format is supported by the browser & server
    	upgradePng2Webp: true # automatically convert PNGs to WEBP when the format is supported by the browser & server
    	upgradePng2Avif: 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>