Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/astrotomic/laravel-cachable-attributes
Allows to cache attribute accessor values in an easy way.
https://github.com/astrotomic/laravel-cachable-attributes
accessor cache eloquent hacktoberfest laravel laravel-cachable-attributes trait treeware
Last synced: 3 months ago
JSON representation
Allows to cache attribute accessor values in an easy way.
- Host: GitHub
- URL: https://github.com/astrotomic/laravel-cachable-attributes
- Owner: Astrotomic
- License: mit
- Created: 2019-08-29T13:11:36.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2024-03-02T07:00:10.000Z (11 months ago)
- Last Synced: 2024-11-05T15:28:53.904Z (3 months ago)
- Topics: accessor, cache, eloquent, hacktoberfest, laravel, laravel-cachable-attributes, trait, treeware
- Language: PHP
- Homepage:
- Size: 70.3 KB
- Stars: 31
- Watchers: 4
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Laravel cachable Attributes
[](https://packagist.org/packages/astrotomic/laravel-cachable-attributes)
[](https://github.com/Astrotomic/laravel-cachable-attributes/blob/master/LICENSE)
[](https://plant.treeware.earth/Astrotomic/laravel-cachable-attributes)
[](https://www.larabelles.com/)
[](https://packagist.org/packages/astrotomic/laravel-cachable-attributes)
[](https://github.com/Astrotomic/laravel-cachable-attributes/actions?query=workflow%3Arun-tests)
[](https://styleci.io/repos/205167128)
**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.
```php
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.
```php
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](CHANGELOG.md) for more information on what has changed recently.
## Contributing
Please see [CONTRIBUTING](https://github.com/Astrotomic/.github/blob/master/CONTRIBUTING.md) for details. You could also be interested in [CODE OF CONDUCT](https://github.com/Astrotomic/.github/blob/master/CODE_OF_CONDUCT.md).
### Security
If you discover any security related issues, please check [SECURITY](https://github.com/Astrotomic/.github/blob/master/SECURITY.md) for steps to report it.
## Credits
- [Tom Witkowski](https://github.com/Gummibeer)
- [All Contributors](https://github.com/Astrotomic/laravel-cachable-attributes/graphs/contributors)
## 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](https://www.bbc.co.uk/news/science-environment-48870920). 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](https://plant.treeware.earth/Astrotomic/laravel-cachable-attributes)
Read more about Treeware at [treeware.earth](https://treeware.earth)