Download the PHP package bedrockstreaming/stale-cache-bundle without Composer
On this page you can find all versions of the php package bedrockstreaming/stale-cache-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download bedrockstreaming/stale-cache-bundle
More information about bedrockstreaming/stale-cache-bundle
Files in bedrockstreaming/stale-cache-bundle
Package stale-cache-bundle
Short Description Add a stale mode into Symfony cache
License proprietary
Informations about the package stale-cache-bundle
Bedrock Stale cache Bundle
Introduction
This bundle aims to provide a stale cache feature to the symfony/cache
component.
Basically, it does the following steps:
- extending the lifetime of cache items with a "stale period"
- during the stale period, if a cache item is fetched, try to regenerate it
- if the regeneration fails with a specifically marked error, give back the initially cached value
Usage
Configuration
First, you should configure each stale cache service:
It will declare a @stale_cache_service_id
, that you can use as an injected dependency.
The stale service will implement Symfony\Contracts\Cache\CacheInterface
, so you'll need to use the get
method to fetch cache items.
You can use Symfony\Contracts\Cache\TagAwareCacheInterface
if you need tagging capabilities.
It's not compatible with the old Symfony\Component\Cache\Adapter\AdapterInterface
.
Allow stale cache for some errors
To use stale cache, you'll have to implement Bedrock\StaleCacheBundle\Exception\UnavailableResourceException
on a custom, thrown error.
The method allowStaleCacheUsage
can be used for some custom logic, or you can hard code a return true
.
Events
A Bedrock\StaleCacheBundle\Event\StaleCacheUsage
event is sent on stale cache usage. It is strongly advised to log it, with the associated error.
Logs
Debug logs can be enabled to ensure correct stale cache usage. It should not be enabled in a production environment since it can cause performance issue.
Contribute
You can execute make quality test
to execute quality checks and tests.
There is also a few make targets that can help you check this bundle is correctly supported on every Symfony versions
make composer-install-sf4
make composer-install-sf5
make composer-install-sf6
All versions of stale-cache-bundle with dependencies
psr/event-dispatcher Version ^1.0
psr/log Version ^1 || ^2 || ^3
symfony/dependency-injection Version ^5.4 || ^6.0
symfony/http-kernel Version ^5.4 || ^6.0
symfony/cache-contracts Version ^2.0 || ^3.0
symfony/cache Version ^5.4 || ^6.0
symfony/config Version ^5.4 || ^6.0