Download the PHP package linslin/laravel-coffee-cache without Composer
On this page you can find all versions of the php package linslin/laravel-coffee-cache. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download linslin/laravel-coffee-cache
More information about linslin/laravel-coffee-cache
Files in linslin/laravel-coffee-cache
Package laravel-coffee-cache
Short Description File based lever out cache for laravel. This cache hook in before composer autoload and Laravel boostrapping. It will push your application into light speed.
License MIT
Informations about the package laravel-coffee-cache
☕ laravel-coffee-cache
Store based lever out view cache for Laravel 4.x, 5.x 6.x, 7.x, 8.x, 9.x, 10.x and 11.x. This cache hook in before composer autoload and Laravel bootstrapping. It will push your application into light speed. By default, all GET-Requests will be cached.
It's a coffee cache. You can drink more coffee instead of spending time to optimize your application or server environment. Mokka Mokka!
Why and when should I use laravel-coffee-cache?
Laravel getting bigger and bigger over the years. Today laravel is a very nice framework which helps you to speed up your software development and programming in its best way. On the other hand laravel is slow in handling requests and consumes a lot of memory per request, even if you use View or Database caches. The bootstrapping of laravel takes a bit time also it consumes a lot of memory. E.g. if you want to render an "imprint / disclaimer" page which doesn't have any dynamic data in its view. So, why you want to bootstrap laravel and all its dependencies just for returning a simple HTML page?
☕ laravel-coffee-cache allows you to lever out laravel and composer autoload completely once a cache file has been generated for a specific route (Request URI). In this way it consumes so much less hardware resources (CPU, RAM, Hard Disk) for each request. It will be push your application into light speed.
The difference to existing cache systems for laravel is: You don't need to have a DB cache based on memcached or even a view file based cache placed in a laravel middleware. Hint: It's nice approach is to combine your DB Cache with laravel-coffee-cache. Use your DB Cache even if you have laravel-coffee-cache running in the foreground.
You will be able to create highly frequented web applications and save a lot of hardware resources (which also saves money) with ☕ laravel-coffee-cache. It makes to optimize your applications if your website is too slow or your server / server capacities (CPU, Memory) run at full load. Give it a try.
Installation
composer require --prefer-dist linslin/laravel-coffee-cache "*"
Register Facade
If you want to use the facade to handle the cache files, add
this to your facades in config/app.php
in the alias
array:
'CoffeeCache' => linslin\CoffeeCache\Facades\CoffeeCache::class,
Example ./config/coffeeCache.php
config file
return [
/**
* Cache driver: 'file' or 'redis'
*/
'driver' => 'file',
/*
* Redis connection
*/
'redis' => [
'host' => 'localhost',
'port' => 6000,
'password' => '', //leave empty if no password is given
'timeout' => 0.5
],
];
API Documentation
Initialize instance
Should be placed in your app/public/index.php
file.
$coffeeCache = new CoffeeCache(__DIR__);
Configure enabled hosts for caching [optional]
Matching hosts which should be cached. Default: Cache all domains
$coffeeCache->enabledHosts = [
'www.production.com',
'subdomain.production.com',
];
Configure enabled hosts with sessions for caching [optional]
Matching hosts which should be cached only if a cookie cached=1 is set. Default: Cache all domains
$coffeeCache->enabledCacheHostsWithSession = [
'www.production.com',
'subdomain.production.com',
];
Configure query parameters to exclude from request uri [optional]
Matching query parameters are excluded from the request uri. A request uri with an excluded query param is treated like if the parameter is not set. Default: no query parameter is exclude
$coffeeCache->excludeQueryParam = [
'aQueryParameter',
];
Enable / disable the whole cache [optional|default:true]
Flag for easy disabling the cache.
$coffeeCache->cacheEnabled = true;
Configure the cache driver (file, redis) [optional|default:'file'|'redis']
$coffeeCache->cacheDriver = 'redis';
$coffeeCache->redisConnection = [
'host' => 'localhost',
'port' => 6000,
'password' => '',
'timeout' => 0.5
];
Configure HTTP-Status codes which should be cached [optional]
List of HTTP-Status codes which should be cached. Default: Cache "200" only.
$coffeeCache->enabledHttpStatusCodes = [
'200',
'202',
];
Exclude URL patterns from being cached. [optional]
URL patterns of URLs which should not be cache. This example will exclude URLS which have "/admin" somewhere in the URL.
$coffeeCache->excludeUrls = [
'/admin',
];
Enable minify cache data [optional]
Strip whitespaces after tags, except space. Strip whitespaces before tags, except space. Shorten multiple whitespace sequences. Remove HTML comments
$coffeeCache->minifyCacheFile = true;
Enable cookie handled cache [optional]
The cache only will work if a cookie named "cached" is available and hold the value "1". This is for handling user sessions while running coffeeCache. It allows you to enable / disable cache for logged in users. Create a cookie with cached=1 if a user is not logged in. Create a cookie with cached=0 if a user is logged in.
$coffeeCache->cookieHandledCacheEnabled = true;
Enable compression [optional]
Enable gzip compression for cache data. Default is false
.
$coffeeCache->gzipEnabled = true;
Filter content types from being minified. [optional]
Response content types which will be ignored and not minified.
$coffeeCache->minifyIgnoreContentTypes = [
'image/png',
'image/gif',
'image/jpg',
'image/jpeg',
];
Global replacements [optional]
Will replace some string marker in our cached file. Which allows you to globally manipulate the cache data. You can parse a string or filepath. The file contents will replace the marker string.
$coffeeCache->globalReplacements = [
[
'type' => 'string',
'marker' => '###marker1####',
'value' => 'hallo welt'
], [
'type' => 'file',
'marker' => '###marker2####',
'filePath' => __DIR__.'/../public/test.txt'
], [
'type' => 'file',
'marker' => '###start_marker####',
'markerEnd' => '###end_marker####',
'filePath' => __DIR__.'/../public/test.txt'
]
];
Facade API Documentation
Delete all cache files
CoffeeCache::clearCache();
Manually delete cache files
CoffeeCache::clearCacheFile(route('route.name', [], false));
Check if cache file exist
CoffeeCache::cacheFileExists(route('route.name', [], false));
Get creation date (file driver only)
CoffeeCache::getCacheFileCreatedDate(route('route.name', [], false));
Example: Manually delete cache a specific file
E.g. inside a controller - example:
<?php
namespace App\Http\Controllers\Admin\Shop;
use App\Models\Shop;
use Illuminate\Http\Request;
use linslin\CoffeeCache\Facades\CoffeeCache;
/**
* Class EntryController
* @package App\Http\Controllers\Admin
*/
class EntryController extends ShopBaseController
{
/**
* @param Request $request
* @param Shop $shop
* @return \Illuminate\Contracts\Foundation\Application|\Illuminate\Contracts\View\Factory|\Illuminate\View\View
*/
public function update(Request $request, Shop $shop)
{
//manually delete cache file for a route (if exists)
CoffeeCache::clearCacheFile(route('shop.show', ['shop' => $shop->slug], false));
return view('admin.shop.form',[
'shop' => $shop,
]);
}
}
Setup and usage
- Create a cache folder name
coffeeCache
inapp/storage/
. So you have this folder created:/storage/coffeeCache
. - Add a
.gitignore
in/storage/coffeeCache
and put this contents into. -
Edit your
app/public/index.php
and add this lines on the top of your PHP script:Replace all code lines under
$kernel = $app->make('Illuminate\Contracts\Http\Kernel');
with this lines:You can also compare your edits with this example index.php.
In the end your
app/public/index.php
should look like this: - laravel-coffee-cache should now start to cache your GET Requests and creating cache files in
app/storage/coffeeCache
. - Create a config file in
./config/coffeeCache.php
. An example config can be found in this repository.
Changelog
1.25.0
- Redis now uses max 99% of its memory to avoid memory leak.
- Fixed redis connection timeout exception catch.
1.24.3
- SpaceLeftOnDevice now works as expected.
1.24.2
- SpaceLeftOnDevice statement moved into write on disc part.
1.24.1
- Fixed space left on device statement.
1.24.0
- Shrinked max disk space allowed to use from 95% to 90%.
1.23.1
- Fixed
hostDisabled[]
handling.
1.23.0
- Added
hostDisabled[]
configuration to prevent specific domains from caching.
1.22.2
- Fixed a bug where
excludeQueryParam()
did not his job.
1.22.1
- Fixed minify whitespace issue.
1.22.0
- Added option for HTML comments to keep them in the minified cached file version.
<!--noremove some comment -->
.
1.21.2
- Second mini fix for
globalReplacements
which will keep the markers in the template after replace.
1.21.1
- Mini fix for
globalReplacements
which will keep the markers in the template after replace.
1.21.0
- Made
globalReplacements
markers optional work with end and start markers.
1.20.0
- Added
globalReplacements
option.
1.19.0
- Added redis connection close
1.18.0
- Added mobile detect library for detection of mobile devices
1.17.0
- Fixed mobile detection for tablet devices.
- Added out increment for expire time on redis driver. Each time a key was hit the expire will be increased by
$coffeeCache->cacheTime
.
1.16.0
- Added the detected user agent into the response header state.
1.15.3
- Fixed clear cache facade function for mobile cache data.
1.15.2
- Function
spaceLeftOnDevice
is now only executed if cacheDriver is set to "file".
1.15.1
- Fixed
spaceLeftOnDevice
permission issue.
1.15.0
- Added
gzipEnabled
option.
1.14.0
- Added
enabledCacheHostsWithSession
option. - Added
excludeQueryParam
option. - Many thanks to Marcos (@delacruzsippel)
1.13.1
- Facade fix for mobile/desktop split.
1.13.0
- Added mobile / desktop detection and split for cached files.
- 0 byte / empty responses will be not cached anymore. An empty response body will be ignored.
- Fixed regex
'/(\s)+/s'
on minifyCacheFile for massive whitespace chars.
1.12.2
- Now: Added isset validation on some global vars.
1.12.1
- Added isset validation on some global vars.
1.12.0
- Added a file and redis driver to laravel facade.
- Added option
$coffeeCache->cookieHandledCacheEnabled
to handle the cache via cookies. This can be used to disable the cache for user sessions.
1.11.1
- Fixed content type ignore for minify.
1.11.0
- Added "redis" driver. CoffeeCache now works with 'file' and 'redis' drivers.
- Added a "cacheEnabled" to easy enable and disable coffeeCache.
1.10.0
- Added option for minify to ignore special content types from being minified.
1.9.0
- Added minify option for cache files
1.8.3
- Syntax fix
1.8.2
- Ensured that
spaceLeftOnDevice()
using the route volume to measure space left on the device. - Clear or delete cache functions will now also delete empty cache directories.
1.8.1
- Fixed facade functions
1.8.0
- Added
$coffeeCache->cacheEnabled
flag to disable the whole caching via software switch. Default istrue
. - Added
$coffeeCache->diskSpaceAllowedToUse
disk space percentage used in float on which coffeeCache will stop writing cache files. Default is95.00
. - Added folder handling for cache files.
1.7.2
- Fixed writing empty files on file system.
1.7.1
- Catching exception when cache file was not writeable.
1.7.0
- Added cookie handler to disable cache on a request:
setcookie("disable-cache", "1", time() + (3600*24), "/", $request->getHost());
. Ifdisable-cache
isset as cookie, the request will no respond the cached file and will not create a cache file for this request.
1.6.0
- Added helper function to delete all cache files (clear cache).
1.5.0
- Added more helper functions to facade.
1.4.0
- Added facade to take control of cache files inside the laravel application. E.g. delete cache files.
1.3.0
- Added option to exclude URL patterns from caching. E.g. URLs which include "/admin".
1.2.0
- Added option to enable caching for specific HTTP-Status codes. Default is "200 Ok".
1.1.0
- Added option to enable caching for specific domains. This also works on reverse proxies if "HTTP_X_FORWARDED_HOST" isset.
1.0.0
- First stable release
Credits
Thanks to robre21 and delacruzsippel!