jackardios/laravel-file-cache

Fetch and cache files from local filesystem, cloud storage or public webservers in Laravel

v3.0.3 2025-03-28 22:48 UTC

Requires

• php: ^8.0
• ext-curl: *
• guzzlehttp/guzzle: ^7.0
• illuminate/console: ^10.0
• illuminate/filesystem: ^10.0
• illuminate/support: ^10.0
• symfony/finder: ^6.0

Requires (Dev)

• laravel/laravel: ^10.0
• mockery/mockery: ^1.2
• php-mock/php-mock-phpunit: ^2.13
• phpunit/phpunit: ^9.0

MIT

• Martin Zurowietz

README

Fetch and cache files from local filesystem, cloud storage or public webservers in Laravel or Lumen.

The file cache is specifically designed for use in concurrent processing with multiple parallel queue workers.

Installation

composer require jackardios/laravel-file-cache

Laravel

The service provider and FileCache facade are auto-discovered by Laravel.

Usage

Take a look at the FileCache contract to see the public API of the file cache. Example:

use FileCache;
use Jackardios\FileCache\GenericFile;

// Implements Jackardios\FileCache\Contracts\File.
$file = new GenericFile('https://example.com/images/image.jpg');

FileCache::get($file, function ($file, $path) {
    // do stuff
});

If the file URL specifies another protocol than http or https (e.g. mydisk://images/image.jpg), the file cache looks for the file in the appropriate storage disk configured at filesystems.disks. You can not use a local file path as URL (e.g. /vol/images/image.jpg). Instead, configure a storage disk with the local driver.

Configuration

The file cache comes with a sensible default configuration. You can override it in the file-cache namespace or with environment variables.

file-cache.max_file_size

Default: -1 (any size) Environment: FILE_CACHE_MAX_FILE_SIZE

Maximum allowed size of a cached file in bytes. Set to -1 to allow any size.

file-cache.max_age

Default: 60 Environment: FILE_CACHE_MAX_AGE

Maximum age in minutes of a file in the cache. Older files are pruned.

file-cache.max_size

Default: 1E+9 (1 GB) Environment: FILE_CACHE_MAX_SIZE

Maximum size (soft limit) of the file cache in bytes. If the cache exceeds this size, old files are pruned.

file-cache.path

Default: 'storage/framework/cache/files'

Directory to use for the file cache.

file-cache.timeout

Default: 0 (indefinitely) Environment: FILE_CACHE_TIMEOUT

Total connection timeout when reading remote files in seconds. If loading the file takes longer than this, it will fail. Set to 0 to wait indefinitely.. Set to 0 to wait indefinitely.

file-cache.connect_timeout

Default: 30 (30 seconds) Environment: FILE_CACHE_CONNECT_TIMEOUT

Timeout to initiate a connection to load a remote file in seconds. If it takes longer, it will fail. Set to 0 to wait indefinitely.. Set to 0 to wait indefinitely.

file-cache.read_timeout

Default: 30 (30 seconds) Environment: FILE_CACHE_READ_TIMEOUT

Timeout for reading a stream of a remote file in seconds. If it takes longer, it will fail. Set to -1 to wait indefinitely.

file-cache.prune_interval

Default '*/5 * * * *' (every five minutes)

Interval for the scheduled task to prune the file cache.

file-cache.mime_types

Default: [] (allow all types)

Array of allowed MIME types for cached files. Caching of files with other types will fail.

Clearing

The file cache is cleared when you call php artisan cache:clear.

Testing

The FileCache facade provides a fake for easy testing. The fake does not actually fetch and store any files, but only executes the callback function with a faked file path.

use FileCache;
use Jackardios\FileCache\GenericFile;

FileCache::fake();
$file = new GenericFile('https://example.com/image.jpg');
$path = FileCache::get($file, function ($file, $path) {
    return $path;
});

$this->assertFalse($this->app['files']->exists($path));