Resizer

# Introduction

October CMS ships with an image resizer that lets you change the shape and size of supported images.

# Resize a File on Disk

To resize an image, use the open method on the Resizer facade to target a file path.

$image = Resizer::open('path/to/image.jpg');

You may also pass an uploaded file from the page request input.

$image = Resizer::open(Input::file('field_name'));

To resize the image, call the resize method on the object to perform the resize. The first argument is the image width, the second argument is the image height and the third argument is an array of resize parameters.

$image->resize(800, 600, ['mode' => 'crop']);

The width and height arguments are also optional, for example, to use the existing width and only adjust the height, pass the second argument as null. This value is then calculated using original image ratio (automatic proportional scaling) based on the mode option.

$image->resize(800, null, [...]);

Finally, use the save method to save the resized image to a new location.

$image->save('path/to/new/file.jpg');

# Resize Parameters

The following elements are supported in the options array are supported:

# Available Modes

The mode option allows you to specify how the image should be resized. The available modes are as follows:

# Resize a File to Browser

The System\Classes\ResizeImages class can be used to resize an image and serve it via a URL:

$url = \System\Classes\ResizeImages::resize($image, $width, $height, $options);

If you are resizing a media library item, you should resolve the media path using the Media\Classes\MediaLibrary class and url method.

$image = \Media\Classes\MediaLibrary::url('relative/path/to/asset.jpg');

$url = \System\Classes\ResizeImages::resize($image, $width, $height, $options);

# See Also