intervention/imagecache

Caching extension for the Intervention Image Class

Monday, July 31, 2017
by olivervogel
Repository
7 Watchers
380 Stars
1,072,557 Installations

PHP
113 Dependents
6 Suggesters
67 Forks
29 Open issues
32 Versions
7 % Grown

The README.md

This package is abandoned and will no longer be maintained., _(*1)

Intervention Image Cache (Abandoned)

Intervention Image Cache extends the Intervention Image Class package to be capable of image caching functionality., _(*2)

The library uses the Illuminate/Cache package and can be easily integrated into the Laravel Framework. Based on your Laravel cache configuration you are able to choose between Filesystem, Database, Memcached or Redis for the temporary buffer store., _(*3)

The principle is simple. Every method call to the Intervention Image class is captured and checked by the caching interface. If this particular sequence of operations already have taken place, the data will be loaded directly from the cache instead of a resource-intensive image operation., _(*4)

Installation

You can install this package quickly and easily with Composer., _(*5)

Require the package via Composer:, _(*6)

$ composer require intervention/imagecache

Now you are able to require the vendor/autoload.php file to PSR-4 autoload the library., _(*7)

Laravel Integration

The Image Cache class supports Laravel integration. Best practice to use the library in Laravel is to add the ServiceProvider and Facade of the Intervention Image Class., _(*8)

Open your Laravel config file config/app.php and add the following lines., _(*9)

In the $providers array add the service providers for this package., _(*10)

'providers' => array(

    [...]

    'Intervention\Image\ImageServiceProvider'
),

Add the facade of this package to the $aliases array., _(*11)

'aliases' => array(

    [...]

    'Image' => 'Intervention\Image\Facades\Image'
),

Usage

The Image Cache is best called by the static method Image::cache from the Intervention Image class., _(*12)

To create cached images just use the static method Image::cache and pass the image manipulations via closure. The method will automatically detect if a cached file for your particular operations exists., _(*13)

// run the operations on the image or read a file
// for the particular operations from cache
$img = Image::cache(function($image) {
   return $image->make('public/foo.jpg')->resize(300, 200)->greyscale();
});

Determine a lifetime in minutes for the cache file as an optional second parameter. Pass a boolean true as optional third parameter to return an Intervention Image object instead of a image stream., _(*14)

// determine a lifetime and return as object instead of string
$img = Image::cache(function($image) {
   return $image->make('public/foo.jpg')->resize(300, 200)->greyscale();
}, 10, true);

Server configuration

If you have Static Resources caching enabled on Nginx please add your cache directory ({route} in config) to static resources handler exclusion:, _(*15)

# where "cache" is {route}
location ~* ^\/(?!cache).*\.(?:jpg|jpeg|gif|png|ico|cur|gz|svg|svgz|mp4|ogg|ogv|webm|htc|webp|woff|woff2)$ {
  expires max;
  access_log off;
  add_header Cache-Control "public";
}

License

Intervention Imagecache Class is licensed under the MIT License., _(*16)

The Versions

31/07 2017

dev-master

9999999-dev http://image.intervention.io

Caching extension for the Intervention Image Class

library imagecache

Caching extension for the Intervention Image Class