Resizing

Basic Resize

Set the width and height for your image:

$url = imgproxy('https://example.com/image.jpg')
    ->width(300)
    ->height(200)
    ->build();

Preserve Aspect Ratio

Use only width or height to maintain the original aspect ratio:

// Width only - height auto-calculated
$url = imgproxy($url)->width(300)->build();

// Height only - width auto-calculated
$url = imgproxy($url)->height(300)->build();

Resize Types

Choose how the image is resized using the fluent fit methods or ResizeType enum:

use Imsus\ImgProxy\Enums\ResizeType;

// Using fluent shortcut
$url = imgproxy($url)
    ->width(300)
    ->height(200)
    ->cover()
    ->build();

// Using enum directly
$url = imgproxy($url)
    ->width(300)
    ->height(200)
    ->setResizeType(ResizeType::FILL)
    ->build();

Available Resize Types

Type	Description
FIT	Resize keeping aspect ratio to fit dimensions (default)
FILL	Resize keeping aspect ratio to fill dimensions (crops overflow)
FILL_DOWN	Same as fill, but maintains requested aspect ratio for smaller images
FORCE	Resize without keeping aspect ratio (stretches/distorts)
AUTO	Automatically choose between fit/fill based on orientation

Resize Type Examples

// Fit - image fits within bounds, no cropping
imgproxy($url)
    ->width(300)
    ->height(200)
    ->contain()
    ->build();

// Fill - image fills bounds, excess is cropped
imgproxy($url)
    ->width(300)
    ->height(200)
    ->cover()
    ->build();

// Fill-down - force dimensions, smaller images preserved
imgproxy($url)
    ->width(300)
    ->height(200)
    ->fill()
    ->build();

Gravity

When using FILL resize type, you can specify the gravity position to control which part of the image is kept:

use Imsus\ImgProxy\Enums\Gravity;

$url = imgproxy($url)
    ->width(300)
    ->height(200)
    ->cover()
    ->gravity(Gravity::CENTER)
    ->build();

Available Gravity Options

Gravity	Description
CE	Center (default)
NO	North (top)
SO	South (bottom)
EA	East (right)
WE	West (left)
NOEA	North-East (top-right)
NOWE	North-West (top-left)
SOEA	South-East (bottom-right)
SOWE	South-West (bottom-left)

Smart Gravity

Use auto gravity for smart cropping based on image content:

$url = imgproxy($url)
    ->width(300)
    ->height(200)
    ->cover()
    ->gravity(Gravity::AUTO)
    ->build();

Device Pixel Ratio (DPR)

For high DPI displays (Retina, etc.), set the DPR to generate higher resolution images:

// Standard display (1x)
$url = imgproxy($url)->width(300)->dpr(1)->build();

// Retina display (2x)
$url = imgproxy($url)->width(300)->dpr(2)->build();

// High DPI displays (3x)
$url = imgproxy($url)->width(300)->dpr(3)->build();

The actual image size will be width * dpr pixels, providing crisp images on high-resolution screens.

Complete Resize Example

use Imsus\ImgProxy\Enums\Gravity;

$url = imgproxy('https://example.com/image.jpg')
    ->width(800)
    ->height(600)
    ->cover()
    ->gravity(Gravity::CENTER)
    ->dpr(2)
    ->build();