Download the PHP package flobbos/laravel-image-cache without Composer

Laravel Image Cache

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 via a clean interface.
• Configurable cache lifetime and output formats (JPEG, PNG, GIF, WebP, AVIF).
• Dynamic routing for serving cached images.

Installation

1. Install the package via Composer:

2. Publish the configuration file:

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.

Dynamic Image Routes

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

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

Example URL:

Custom Templates

Create a class that implements TemplateInterface:

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

Configuration

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

• lifetime: Cache lifetime in minutes. Set to 0 to cache forever.
• driver: Image processing driver (gd, imagick, or libvips).
• store: Cache store to use (from your Laravel cache config).
• format: Default output format (jpg, png, gif, webp, avif).
• quality: Encoder quality (1–100) for JPEG/WebP/AVIF. null uses Intervention defaults.
• return_object: Whether to return an Intervention Image object or the encoded bytes.
• templates: Image manipulation templates (must implement TemplateInterface).
• paths: Directories to search for images (see below).
• dynamic_route: The URL prefix for the dynamic image route.

Paths

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

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:

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

Example URL:

Customizing the Route

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

This will make your URLs look like:

The route is named imagecache.serve, so you can also generate URLs with:

Security

The dynamic route resolves the requested image against the configured paths using realpath() and refuses any request whose canonical path escapes the configured base directories. Path traversal attempts (e.g. ../../etc/passwd) return a 404.

Requirements

• PHP 8.2 or higher
• Laravel 10, 11, 12, or 13
• Intervention Image 3.0 or higher

Supported versions

The package declares broad version constraints, but the actual PHP × Laravel matrix exercised in CI is:

License

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

Credits

• Developed by Alexej Krzewitzki ([email protected])
• Inspired by the original imagecache package by Intervention