Download the PHP package martianatwork/laravel-query-cache without Composer
On this page you can find all versions of the php package martianatwork/laravel-query-cache. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download martianatwork/laravel-query-cache
More information about martianatwork/laravel-query-cache
Files in martianatwork/laravel-query-cache
Package laravel-query-cache
Short Description A laravel query cache
License MIT
Informations about the package laravel-query-cache
Laravel Query Cache
Package description: A package for Caching Eloquent quries
Installation
Install via composer
Usage
Basics
The easiest way to get started with Eloquent is to create an abstract App\Model
which you can extend your application models from. In this base model you can import the rememberable trait which will extend the same caching functionality to any queries you build off your model.
Now, just ensure that your application models from this new App\Model
instead of Eloquent.
Just use following code in your model to cache complete model
The above code will cache all quries from the given model.
Will cache the results for 60 min.
Will add a tag to the cached data which will be later used for clearing the cache
Will clear cache on Update, Create, Delete events of the model
Digging Deeper
If you don't want to cache entire model then just use the Model::remember() method
Using the remember method is super simple. Just pass the number of minutes you want to store the result of that query in the cache for, and whenever the same query is called within that time frame the result will be pulled from the cache, rather than from the database again.
Cache prefix
If you want a unique prefix added to the cache key for each of your queries (say, if your cache doesn't support tagging), you can add prefix('prefix') to your query.
Alternatively, you can add the $rememberCachePrefix property to your model to always use that cache prefix.
Cache driver
If you want to use a custom cache driver (defined in config/cache.php) you can add cacheDriver('cacheDriver') to your query.
Alternatively, you can add the $rememberCacheDriver property to your model to always use that cache driver.
Model wide cache tag
You can set a cache tag for all queries of a model by setting the $rememberCacheTag property with an unique string that should be used to tag the queries.
Relationships
Validating works by caching queries on a query-by-query basis. This means that when you perform eager-loading those additional queries will not be cached as well unless explicitly specified. You can do that by using a callback with your eager-loads.
Always enable
You can opt-in to cache all queries of a model by setting the $rememberFor property with the number of minutes you want to cache results for. Use this feature with caution as it could lead to unexpected behaviour and stale data in your app if you're not familiar with how it works.
Cache flushing
Based on the architecture of the package it's not possible to delete the cache for a single query. But if you tagged any queries using cache tags, you are able to flush the cache for the tag:
If you used the $rememberCacheTag property you can use the method without a parameter and the caches for the tag set by $rememberCacheTag are flushed:
Using in your package
Security
If you discover any security related issues, please email instead of using the issue tracker.
Credits
This package is bootstrapped with the help of melihovv/laravel-package-generator.