elipzis / laravel-cacheable-model
Automatic query-based model cache for your Laravel app
Fund package maintenance!
elipZis
Installs: 13 501
Dependents: 0
Suggesters: 0
Security: 0
Stars: 110
Watchers: 2
Forks: 11
Open Issues: 0
Requires
- php: ^8.2|^8.3
- illuminate/contracts: ^10.0|^11.0
- spatie/laravel-package-tools: ^1.14
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.8
- nunomaduro/collision: ^6.1
- nunomaduro/larastan: ^2.0.1
- orchestra/testbench: ^8.0
- pestphp/pest: ^1.21
- pestphp/pest-plugin-laravel: ^1.1
- phpstan/extension-installer: ^1.1
- phpstan/phpstan-deprecation-rules: ^1.0
- phpstan/phpstan-phpunit: ^1.0
- phpunit/phpunit: ^9.6
- spatie/laravel-ray: ^1.26
README
Easy and automatic select-query caching for your Eloquent models!
- Get cached query results and reduce your database load automatically
- Configure TTL, prefixes, unique-queries etc.
- No manual cache calls needed
- Automated cache flush in case of updates, inserts or deletions
You can make any Eloquent model cacheable by adding the trait
... use ElipZis\Cacheable\Models\Traits\Cacheable; ... class YourModel extends Model { use Cacheable; ...
and leverage the power of a Redis, memcached or other caches.
Installation
You can install the package via composer:
composer require elipzis/laravel-cacheable-model
You can publish the config file with:
php artisan vendor:publish --tag="cacheable-model-config"
This is the contents of the published config file:
//Default values for the Cacheable trait - Can be overridden per model return [ //How long should cache last in general? 'ttl' => 300, //By what should cache entries be prefixed? 'prefix' => 'cacheable', //What is the identifying, unique column name? 'identifier' => 'id', //Do you need logging? 'logging' => [ 'channel' => null, //Which channel should be used? 'enabled' => false, 'level' => 'debug', ], ];
Usage
Make your model cacheable by adding the trait:
... use ElipZis\Cacheable\Models\Traits\Cacheable; ... class YourModel extends Model { use Cacheable; ...
and then just use your normal model query, for example
YourModel::query()->get();
YourModel::query()->where('field', 'test')->first();
YourModel::query()->insert([...]);
The package overrides the QueryBuilder and scans for the same queries to capture and return the cached values.
You do not need to do anything else but just use your model as you would and leverage the power of cached entries!
Configuration
The following configuration can be overridden per model
public function getCacheableProperties(): array { return [ 'ttl' => 300, 'prefix' => 'cacheable', 'identifier' => 'id', 'logging' => [ 'channel' => 'anotherChannel', 'enabled' => false, 'level' => 'debug', ], ]; }
Disable cache
Depending on your cache and database performance, you might like to retrieve a query without caching sometimes:
YourModel::query()->withoutCache()->get();
Flush cache
If your data is updated outside of this package, you can flush it yourself by calling:
YourModel::query()->flushCache();
Note on using caching
This package overrides the native QueryBuilder and is capturing every database query, therefore it imposes a load and performance burden.
If you use caching intensively on a model, this package and its use can help. If an entity is permanently changing, it
won't make sense to make it Cacheable
.
It is recommended to only make models Cacheable
which have a reasonable caching time in your system. Do not use the
trait on any other or all models out of the box, but think about where it makes sense.
Testing
composer test
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
License
The MIT License (MIT). Please see License File for more information.