Download the PHP package mistralys/application-utils-image without Composer

AppUtils - Image Helper

PHP image helper library for basic image editing and color management.

Features

• Dedicated image file classes, e.g. JPGFile, SVGFile.
• Resample images by width, height, or both.
• Get image dimensions, SVG files included.
• Crop images.
• Sharpen images.
• Trim images.
• Work with alpha transparency.
• Add text to images.
• Calculate the average color of an image.
• Calculate the brightness or luma value of an image.
• Work with a mix of HEX, 8Bit, 7Bit and percentage-based color values.

Requirements

• PHP 7.4 or higher
• Composer
• GD extension

Usage

Image file classes

The library provides classes for handling different image formats:

• GIFFile
• JPGFile and JPEGFile
• PNGFile
• SVGFile

These classes work like the FileInfo class provided by the File Helper, so they provide all typical file operation methods as well as specialized image-related methods.

Simple image operations

The image file class methods will immediately save the modifications to the file system. If you want to perform multiple operations before saving, you will have to use an ImageHelper instance instead.

Resampling by width

This resamples the image to a new width, adjusting the height to keep the original image aspect ratio.

Resampling by height

This resamples the image to a new height, adjusting the width to keep the original image aspect ratio.

Resampling without the aspect ratio

This resamples the image to a new width and height, ignoring the original image aspect ratio.

Displaying an image in the browser

Send an image file to the browser for display. This automatically sets the correct headers for the image format.

Trigger the download of an image

This will send the image to the browser, and force it to treat it as a download and show the download dialog.

Advanced editing

The ImageHelper class

While the image file classes are practical for simple operations, the ImageHelper class provides more advanced editing capabilities, as well as combining multiple operations in a single chain.

Creating an instance

Examples

Resampling an image

Sharpening an image

This will sharpen the image by the given percentage.

NOTE: For best results, do some testing to find the optimal sharpening percentage for your target image size.

Get image dimensions (including SVG)

Freeing resources

When you're done editing, call the dispose() method to release file handles and memory resources. By default, the save() method will automatically do this for you. In case you're not saving the image, you should call dispose() manually.