Image Caching

This package comes with the default option to automatically store and serve images statically for the requested options within the caching lifetime.

INFO

Having this feature enabled (default behavior) will help to reduce the load on your server and speed up image delivery.

The processed images are stored in the storage/app/private/_cache/image-transform-url directory by default. You can change the disk configuration in the image-transform-url.php configuration file.

IMPORTANT

However when using this option, there is one caveat to be aware of:

Source images are considered to be stale content by their file name and path.

If the content of an original source image changes, but the file name stays the same, the cached images will not be updated automatically until the cache expires. To force a revalidation, you can either:

change the image's file name
move it into another subdirectory, which will change its path
change the version number in the options (e.g. version=2)
or flush the entire cache of your application using the php artisan cache:clear command.

You can configure the caching options in the image-transform-url.php configuration file:

php

/*
    |--------------------------------------------------------------------------
    | Image Cache
    |--------------------------------------------------------------------------
    |
    | Here you may configure the image cache settings. The cache is used to
    | store the transformed images for a certain amount of time. This is
    | useful to prevent reprocessing the same image multiple times.
    | The cache is stored in the configured cache disk.
    |
    */

    'cache' => [
        'enabled' => env('IMAGE_TRANSFORM_CACHE_ENABLED', true),
        'lifetime' => env('IMAGE_TRANSFORM_CACHE_LIFETIME', 60 * 24 * 7), // 7 days
        'disk' => env('IMAGE_TRANSFORM_CACHE_DISK', 'local'),
    ],

Image Caching ​

Image Caching