Skip to content
Image manipulation class using PHP and GD library
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
example
src/Bedeabza
tests
README.md

README.md

PHP Image

This class provides a simple way to resize, crop and add watermarks to images using the PHP GD library. The source is written for PHP 5.3 using namespaces, but it is very easy to adapt the class to PHP < 5.3.

Theory of operation

The class is instantiated with a filename as a parameter. That file is persistent, which means that all subsequent operations are applied to that file. So you can first crop it, then resize it without creating a new object.

$image = new Image('somefile.jpg');

Resizing

Resizing works in 3 ways, depending on what mode is specified when executing resize():

  • RESIZE_TYPE_STRICT - resizes the image to the exact specified dimensions
  • RESIZE_TYPE_RATIO - takes into account the aspect ratio of the image and it will be resized to fit the specified dimensions
  • RESIZE_TYPE_CROP - First crops the image so that aspect ratio of the target size is met, then the cropped image is resized to the specified dimensions (default)

Resizing examples:

$image->resize(200, 200); //will crop the image to fit the aspect ratio and then resize
$image->resize(200, null, Image::RESIZE_TYPE_RATIO); //will resize so that width is 200 keeping original a/r
$image->resize(200, 200, Image::RESIZE_TYPE_STRICT); //will schew the image the the a/r is not 1:1

Cropping

$image->crop($x, $y, $width, $height); //$width and $height are optional
$image->cropFromCenter($width, $height);

Watermark

$image->watermark($watermarkFile); //will add the watermark to the bottom right corner of the image with the original dimensions
$image->watermark($watermarkFile, Image::WM_POS_TOP_LEFT, 50, 50); //also specifies the position of the watermark and the resize dimensions

Possible positions for watermarks are:

  • WM_POS_TOP_LEFT
  • WM_POS_TOP_RIGHT
  • WM_POS_BOTTOM_LEFT
  • WM_POS_BOTTOM_RIGHT
  • WM_POS_CENTER

Rendering and Saving

$image->render(); //will render the image on screen
$image->save(); //saves the image replacing the original file
$image->save($filename, $quality); //saves the image in the specified $filename with the specified quality

Get in touch

You can contact me at bedeabza at gmail dot com or send pull requests for the repo.

You can’t perform that action at this time.