flobbos/laravel-image-cache

Replacement for the now abandoned imagecache package by Intervention

v0.0.3 2025-07-08 15:29 UTC

Requires

• php: ^8.1
• illuminate/cache: ^10.0|^11.0|^12.0
• intervention/image: ^3.0

MIT

• Alexej Krzewitzki

README

Laravel Image Cache is a package that provides an easy-to-use caching mechanism for image manipulation in Laravel. It serves as a replacement for the now-abandoned imagecache package by Intervention.

Features

• Cache manipulated images for improved performance.
• Support for multiple image drivers: GD, Imagick, and Libvips.
• Define custom image manipulation templates.
• Configurable cache lifetime and output formats.
• Dynamic routing for serving cached images.

Installation

1. Install the package via Composer:

   composer require flobbos/laravel-image-cache

2. Publish the configuration file:

   php artisan vendor:publish --tag=config --provider="Flobbos\LaravelImageCache\ImageCacheServiceProvider"

3. Configure the config/imagecache.php file as needed.

Usage

Basic Example

To use the package, you can define templates in the configuration file and use the ImageCache facade to generate cached images.

use Flobbos\LaravelImageCache\Facades\ImageCache;

// Example: Apply the "small" template to an image
$cachedImage = ImageCache::template('path/to/image.jpg', 'small');

Dynamic Image Routes

The package provides a dynamic route for serving cached images. For example:

/images/{template}/{path}

• template: The name of the template defined in the configuration file.
• path: The relative path to the image in the public/images directory.

Example URL:

http://your-app.test/images/small/example.jpg

Custom Templates

You can define custom templates by creating a class that implements a build method. For example:

namespace App\ImageTemplates;

use Intervention\Image\Interfaces\ImageInterface;

class CustomTemplate
{
    public function build(ImageInterface $image)
    {
        $image->resize(800, 600);
    }
}

Then, register the template in the config/imagecache.php file:

'templates' => [
    'custom' => \App\ImageTemplates\CustomTemplate::class,
],

Configuration

The configuration file config/imagecache.php allows you to customize:

• lifetime: Cache lifetime in minutes.
• driver: Image processing driver (gd, imagick, or vips).
• store: Cache store to use (from your Laravel cache config).
• format: Default output format (e.g., jpg, png).
• return_obj: Whether to return an Intervention Image object or a response.
• templates: Image manipulation templates (see above for custom templates).
• paths: Directories to search for images (see below).
• route: The dynamic route name for serving images.

Paths

You can specify one or more directories where the package should look for images.
Example from config/imagecache.php:

'paths' => [
    public_path('images'),
    storage_path('app/public/images'),
],

When a request is made, the package will search these directories for the requested image file in the order listed.

Dynamic Image Routes

By default, the package registers a dynamic route for serving cached images:

/images/{template}/{path}

• template: The name of the template defined in your configuration.
• path: The relative path to the image file.

Example URL:

http://your-app.test/images/small/example.jpg

Customizing the Route

You can change the route prefix by editing the route option in config/imagecache.php:

'dynamic_route' => 'images',

For example, setting 'dynamic_route' => 'imgcache' will make your URLs look like:

http://your-app.test/imgcache/small/example.jpg

Requirements

• PHP 8.1 or higher
• Laravel 10 or higher
• Intervention Image 3.0 or higher

License

This package is open-sourced software licensed under the MIT license.

Credits

• Developed by Alexej Krzewitzki ([e-mail])
• Inspired by the original imagecache package by Intervention