devfactory/imagecache

Laravel package for generating thumbnails of images and caching them in your public files folder.

Friday, January 12, 2018
by devfactory
Repository
5 Watchers
13 Stars
10,051 Installations

PHP
1 Dependents
0 Suggesters
6 Forks
0 Open issues
30 Versions
3 % Grown

The README.md

, _(*1)

Imagecache

Laravel 4/5 package that allows you to create image thumbnails according to predefined presets, and store them in your Laravel public folder to serve them up without generating them on each page load., _(*2)

Installation

Using Composer, edit your composer.json file to require devfactory/imagecache., _(*3)

Laravel 5

"require": {
    "devfactory/imagecache": "3.0.*"
}

Laravel 4

"require": {
    "devfactory/imagecache": "2.1.*"
}

Then from the terminal run, _(*4)

composer update

Then in your app/config/app.php file register the following service providers:, _(*5)

'Intervention\Image\ImageServiceProvider',
'Devfactory\Imagecache\ImagecacheServiceProvider',

And the Facade:, _(*6)

'Imagecache'      => 'Devfactory\Imagecache\Facades\ImagecacheFacade',

Publish the config:, _(*7)

Laravel 5

php artisan vendor:publish

Laravel 4

php artisan config:publish devfactory/imagecache

Usage

Define some presets in:, _(*8)

Laravel 5

config/imagecache.presets.php, _(*9)

Laravel 4

app/config/packages/devfactory/imagecache/presets.php, _(*10)

<?php

return array(
  'teaser' => array(
    'width' => 150,
    'height' => 100,
    'method' => 'crop',
  ),
  '465x320' => array(
    'width' => 465,
    'height' => 320,
    'method' => 'resize',
    'background_color' => '#FFFFFF',
  ),
);

get($filename, $preset, $args = NULL)

Parameter	Description
`$filename`	The FILENAME passed to the `get()` method is relative to the `files_directory` that you set in the config file (which itself is relative to the `public_path` config). So if you pass `images/sunset.jpg`, it will actually look for `PUBLIC_PATH/uplaods/images/sunset.jpg` with the default config. I haven't tried, but if you set `public_path` and `files_directory` to `''`, you should be able to pass aa absolute path to the file.
`$preset`	One of the presets defined in the presets.php config file
`$args` (optional)	An array of additional properties.

$args properties

Property	Description
`base_dir`	If you don't want to use the base folder you have setup in the config file because you are referencing a file that might be stored in your assets, you can pass an absolute path here to override the defaults
`class`	A string containing any classes you want the `<img>` tag to contain
`alt`	The `alt` text for the image
`title`	The `title` text for the image

Return Value:

Property	Description
`src`	The URL to the image to be used inside the `<img src="">` attribute
`img`	The full `<img>` tag to display the image
`img_nosize`	The full `<img>` tag without width and height attributes for use with responsive themes
`path`	The full path to the image on storage

Example usages:, _(*11)

$image = Imagecache::get('images/sunset.jpg', 'teaser');
echo $image->img;
echo '<img src="'. $image->src .'">

// Directly in a blade template
{{ Imagecache::get('uploads/images/sunset.jpg', 'teaser')->img }}

You can also directly access one of the properties as such without needing to if gate the call to get(). If using Laravel 5 you'll need to use the new raw notation instead of the double curly braces {{ ... }}., _(*12)

{!! Imagecache::get('uploads/images/sunset.jpg', 'teaser')->img !!}

If you set the use_placeholders variable to TRUE in the imagecache.config.php file, and your image doesn't exist or doesn't generate a cached version. Where you would normally receive an array with empty values, you can get a placeholder image matching the preset that you requested. This is very useful during developement when you might not have images for all your content., _(*13)

get_original($filename, $args = NULL)

If you don't want to apply any preset to the image, but still want to use the call to generate the <img> tag, accepts same parameters and works the same way as get(), just without $preset, _(*14)

delete($filename)

Deletes all the cached images for each preset for the given filename., _(*15)

Presets

When defining your presets, these are the options you can set:, _(*16)

Property		Description
`width`	required	The width of the generated image in pixels.
`height`	required	The height of the generated image in pixels.
`method`	required	Defines the way the image will be transformed. See the table below for accepted methods
`background_color`	optional	The color of the canvas which will be used as a background when using the method `resize`. e.g. `'#FFFFFF'`.

The method property accepts the following types of transformations:, _(*17)

Method	Description
`crop`	Will smart crop an image to make it fit the desired dimensions. It will cut content of the image off the top/bottom and sides if required to preserve the aspect ratio.
`resize`	Will create a canvas of the desired dimensions and will then resize the image to fit within the bounds without cropping. Images will not be upscaled if they are smaller then the dimensions. The optional property `background_color`can be used here to define the color of the canvas which the image will be placed on.

The Versions

12/01 2018

3.0.x-dev

3.0.9999999.9999999-dev

Laravel package for generating thumbnails of images and caching them in your public files folder.

library imagecache

Laravel package for generating thumbnails of images and caching them in your public files folder.

devfactory/imagecache

The README.md

Imagecache

Installation

Laravel 5

Laravel 4

Laravel 5

Laravel 4

Usage

Laravel 5

Laravel 4

get($filename, $preset, $args = NULL)

$args properties

Return Value:

get_original($filename, $args = NULL)

delete($filename)

Presets

The Versions

3.0.x-dev

The Requires

by DevFactory Sarl

dev-master

The Requires

by DevFactory Sarl

3.0.11

The Requires

by DevFactory Sarl

3.0.10

The Requires

by DevFactory Sarl

3.0.9

The Requires

by DevFactory Sarl

3.0.8

The Requires

by DevFactory Sarl

2.1.x-dev

The Requires

by DevFactory Sarl

2.1.8

The Requires

by DevFactory Sarl

2.1.7

The Requires

by DevFactory Sarl

3.0.7

The Requires

by DevFactory Sarl

3.0.6

The Requires

by DevFactory Sarl

3.0.5

The Requires

by DevFactory Sarl

3.0.4

The Requires

by DevFactory Sarl

2.1.6

The Requires

by DevFactory Sarl

2.0.x-dev

The Requires

by DevFactory Sarl

2.0.5

The Requires

by DevFactory Sarl

3.0.3

The Requires

by DevFactory Sarl

2.1.5

The Requires

by DevFactory Sarl

3.0.2

The Requires

by DevFactory Sarl

2.0.4

The Requires

by DevFactory Sarl