astrotomic / laravel-cachable-attributes
Allows to cache attribute accessor values in an easy way.
Fund package maintenance!
Gummibeer
SarahSibert
Issuehunt
forest.astrotomic.info
Installs: 34 238
Dependents: 0
Suggesters: 0
Security: 0
Stars: 31
Watchers: 4
Forks: 4
Open Issues: 2
Requires
- php: ^7.2 || ^8.0
- illuminate/cache: 5.8.* || ^6.0 || ^7.0 || ^8.0 || ^9.0 || ^10.0
- illuminate/contracts: 5.8.* || ^6.0 || ^7.0 || ^8.0 || ^9.0 || ^10.0
- illuminate/database: 5.8.* || ^6.0 || ^7.0 || ^8.0 || ^9.0 || ^10.0
Requires (Dev)
- illuminate/support: 5.8.* || ^6.0 || ^7.0 || ^8.0 || ^9.0 || ^10.0
- orchestra/testbench: 3.8.* || ^4.0 || ^5.0 || ^6.0 || ^7.0 || ^8.0
- phpunit/phpunit: ^8.3 || ^9.0
README
If you want to cache your heavy attribute accessors - this package is for you!
This Laravel package provides a trait to use in your models which provides methods to cache your complex, long running, heavy model accessor results.
Installation
You just have to run composer require astrotomic/laravel-cachable-attributes
. There's no ServiceProvider or config or anything else.
Quick Example
Sometimes you have properties which run addition database queries, do heavy calculations or have to retrieve data from somewhere. This slows down your application and if you access the attribute multiple times the accessor is also executed multiple times.
class Gallery extends Model { public function images(): HasMany { return $this->hasMany(Image::class, 'gallery_id'); } public function getStorageSizeAttribute(): int { return $this->images()->sum('file_size'); } }
This example would run the sum query every time you access $gallery->storage_size
.
By using the trait you can prevent this.
use Astrotomic\CachableAttributes\CachableAttributes; use Astrotomic\CachableAttributes\CachesAttributes; class Gallery extends Model implements CachableAttributes { use CachesAttributes; protected $cachableAttributes = [ 'storage_size', ]; public function images(): HasMany { return $this->hasMany(Image::class, 'gallery_id'); } public function getStorageSizeAttribute(): int { return $this->remember('storage_size', 0, function(): int { return $this->images()->sum('file_size'); }); } }
This will run the database query only once per request. The ttl of 0
means to cache only for the current runtime. You could also use null
or rememberForever()
to remember the value forever (until manually deleted). Or use any positive number to cache for the amount of seconds.
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details. You could also be interested in CODE OF CONDUCT.
Security
If you discover any security related issues, please check SECURITY for steps to report it.
Credits
Treeware
You're free to use this package, but if it makes it to your production environment I would highly appreciate you buying the world a tree.
It’s now common knowledge that one of the best tools to tackle the climate crisis and keep our temperatures from rising above 1.5C is to plant trees. If you contribute to my forest you’ll be creating employment for local families and restoring wildlife habitats.
You can buy trees at offset.earth/treeware
Read more about Treeware at treeware.earth