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

• 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.

• PHP 7.4 or higher
• Composer
• GD extension

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.

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.

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

use AppUtils\ImageHelper\ImageFiles\FileTypes\JPGFile;

JPGFile::factory('image.jpg')
    ->resampleByWidth('resized.jpg', 200);

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

use AppUtils\ImageHelper\ImageFiles\FileTypes\JPGFile;

JPGFile::factory('image.jpg')
    ->resampleByHeight('resized.jpg', 200);

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

use AppUtils\ImageHelper\ImageFiles\FileTypes\JPGFile;

JPGFile::factory('image.jpg')
    ->resample('resized.jpg', 200, 400);

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

use AppUtils\ImageHelper\ImageFiles\FileTypes\JPGFile;

JPGFile::factory('image.jpg')
    ->send('optional-name.jpg');

// You must manually exit the script after sending the image.
exit;

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

use AppUtils\ImageHelper\ImageFiles\FileTypes\JPGFile;

JPGFile::factory('image.jpg')
    // Set the second parameter to true to force the download.
    ->send('optional-name.jpg', true);

// You must manually exit the script after sending the image.
exit;

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.

use AppUtils\ImageHelper;
use AppUtils\ImageHelper\ImageFiles\FileTypes\JPGFile;

// From a file path
$helper = ImageHelper::createFromFile('image.jpg');

// From an image class
$helper = JPGFile::factory('image.jpg')->createImageHelper();

// From a GD resource    
$resource = imagecreatefromjpeg('image.jpg');
$helper = ImageHelper::createFromResource($resource);

// New blank image
$helper = ImageHelper::createNew(200, 100);

use AppUtils\ImageHelper;

ImageHelper::createFromFile('image.jpg')
    ->resampleByWidth(200)
    ->save('resized.jpg');

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.

use AppUtils\ImageHelper;

ImageHelper::createFromFile('image.jpg')
    ->resampleByWidth(200)
    ->sharpen(50)
    ->setQuality(80)
    ->save('sharpened.jpg');

use AppUtils\ImageHelper;

$size = ImageHelper::getImageSize('image.jpg');

echo $size->toReadableString();

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.

use AppUtils\ImageHelper;

$average = ImageHelper::createFromFile('image.jpg')
    ->calcAverageColorRGB();

// Not needed anymore? Free up resources.    
$helper->dispose();