Awesome Open Source
Awesome Open Source

Watimage: GD Image Helper PHP Class

Build status Code coverage License Latest Stable Version Total Downloads Code Climate

Watimage is a group of PHP classes to help you resize, rotate, apply filters, watermarks and a lot more of things to your images using the PHP's GD library.

It was initially a CakePHP component, later became a simple Vendor class and now is a powerful set of classes to alter images.

And it maintains the transparencies in every scenario.


You need php > 5.4 and the php GD package installed.

With aptitude:

sudo apt-get install php5-gd

With yum:

sudo yum install php-gd


With composer:

composer require elboletaire/watimage:~2.0.0

Check out the Watimage pages for more information about installation.


See all the information you need to know at the Watimage pages


Check out the API at the Watimage pages.


There are lot of examples at the examples folder, plus a lot more of examples and tutorials in the Watimage pages.

Before running the given examples, you need to composer install from Watimage root folder in order to get composer's autoloader downloaded into vendor folder.

composer install
cd examples
php Image.php
php Watermark.php
php Watimage.php

You can also put the Watimage folder in your local webhost webroot dir and point there your browser.


Please, see the information about testing in the Watimage pages.

Patches & Features

  • Fork
  • Mod, fix
  • Test - this is important, so it's not unintentionally broken
  • Commit - do not mess with license, todo, version, etc. (if you do change any, bump them into commits of their own that I can ignore when I pull)
  • Pull request - bonus point for topic branches

Bugs & Feedback

See the issues section.


Check out the releases on github. They have different order than expected because I've created tags recently to not loose them and to have the whole changelog there.



Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
php (16,545
image (489
image-manipulation (97
class (36
gd (17