anahkiasen/illuminage

Wrapper for the Imagine library to hook into the Laravel framework

1.2.2 2014-10-20 09:26 UTC

Requires

• php: >=5.3.0
• anahkiasen/html-object: ~1.4.0
• illuminate/cache: ~4.1
• illuminate/config: ~4.1
• illuminate/container: ~4.1
• illuminate/routing: ~4.1
• illuminate/support: ~4.1
• imagine/imagine: ~0.5.0

Requires (Dev)

• mockery/mockery: ~0.9.0

MIT

• Maxime Fabre

• imagine
• images
• laravel
• thumb

README

Illuminage

Setup

First do composer require anahkiasen/illuminage:dev-master.

Then if you're on a Laravel app, add the following to the providers array in app/config/app.php :

'Illuminage\IlluminageServiceProvider',

And this in the facades array in the same file :

'Illuminage' => 'Illuminage\Facades\Illuminage',

And then do artisan asset:publish anahkiasen/illuminage.

Usage

Illuminage is a wrapper for the Imagine library to hook into the Laravel framework. It implements elegant shortcuts around Imagine and a smart cache system.

// This will create a cropped 200x300 thumb, cache it, and display it in an image tag
echo Illuminage::thumb('image.jpg', 200, 300)
// or
echo Illuminage::image('image.jpg')->thumbnail(200, 300)

// Shortcuts
echo Illuminage::square('image.jpg', 300)

What you get from those calls are not direct HTML strings but objects implementing the HtmlObject\Tag abstract, so you can use all sorts of HTML manipulation methods on them :

$thumb = Illuminage::square('image.jpg', 200)->addClass('image-wide');
$thumb = $thumb->wrapWith('figure')->id('avatar');

echo $thumb;
// <figure id="avatar"><img class="image-wide" src="pathToThumbnail.jpg"></figure>

You can at all time access the original Imagine instance used to render the images :

$thumb = Illuminage::image('foo.jpg')->thumbnail(200, 200);

echo $thumb->grayscale()->onImage(function($image) {
  $image->flipVertically()->rotate(45);
});