byjg/imageutil

A wrapper collection for GD library in PHP.

5.0.0 2024-10-29 22:16 UTC

Requires

• ext-gd: *
• meyfa/php-svg: ^v0.15

Requires (Dev)

• php: >=8.1 <8.4
• ext-imagick: *
• phpunit/phpunit: ^9.6
• vimeo/psalm: ^5.9

MIT

README

ImageUtil is a PHP library that provides a collection of operations for image manipulation using the GD library. It simplifies tasks such as flipping, cropping, resizing, stamping, and more.

Installation

To install ImageUtil, use the following composer command:

composer require "byjg/imageutil"

Supported Formats

ImageUtil supports the following image formats:

• GIF
• JPEG
• PNG
• BMP
• WEBP
• SVG (Partial support. Primarily for converting SVG to other formats, not for SVG manipulation.)

Creating an Image

You can create an image from a file, URL, existing resource, or create an empty image:

<?php
use ByJG\ImageUtil\ImageUtil;

// From a file
$img = ImageUtil::fromFile('path_to_image.png');

// From a URL
$img2 = ImageUtil::fromFile('https://somesite/someimage.jpg');

// From an existing resource image
$resourceImg = imagecreatetruecolor(200, 300);
$img3 = ImageUtil::fromResource($resourceImg);

// Or an empty image
$img4 = ImageUtil::empty(200, 300, new Color(255, 255, 255));

SVG Files

ImageUtil provides basic support for SVG files, primarily for converting SVG images to other GD-supported formats. It does not support all SVG features and does not support operations like resize, flip, etc.

<?php
use ByJG\ImageUtil\ImageUtil;

$img = ImageUtil::fromFile('path_to_image.svg');
$img->save('path_to_image.png');

Image Manipulation

ImageUtil provides several methods for image manipulation:

• Flip: Mirror the image vertically or horizontally.
• Rotate: Rotate the image by a specified angle.
• Resize: Resize the image to specified dimensions.
• Resize Square: Resize the image to a square format while maintaining the aspect ratio. Any extra space is filled with the provided RGB color.
• Resize AspectRatio: Resize the image while maintaining the aspect ratio. Any extra space is filled with the provided RGB color.
• Stamp Image: Stamp another image onto the current image.
• Write Text: Write text onto the image.
• Crop Image: Crop the image from a specified point to another point.
• Make Transparent: Make the image transparent. The transparent color must be provided.

See some examples here.

Saving and Restoring Changes

You can save the changes to the image, restore the image to its original state, or destroy the image resource:

<?php
$img->save('filename.gif');
$img->restore();
$img->destroy();

Other Functions

ImageUtil also provides methods to get the image dimensions and the image resource:

<?php
$width = $img->getWidth();
$height = $img->getHeight();
$resource = $img->getResource();

Dependencies

ImageUtil depends on the GD extension for PHP:

Open source ByJG