mirror of
https://github.com/shlinkio/shlink.git
synced 2024-12-24 08:00:13 -06:00
60 lines
2.7 KiB
Markdown
60 lines
2.7 KiB
Markdown
# Migrate to a new caching library
|
|
|
|
* Status: Accepted
|
|
* Date: 2021-08-05
|
|
|
|
## Context and problem statement
|
|
|
|
Shlink has always used the `doctrine/cache` library to handle anything related with cache.
|
|
|
|
It was convenient, as it provided several adapters, and it was the library used by other doctrine packages.
|
|
|
|
However, after the creation of the caching PSRs ([PSR-6 - Cache](https://www.php-fig.org/psr/psr-6) and [PSR-16 - Simple cache](https://www.php-fig.org/psr/psr-16)), most library authors have moved to those interfaces, and the doctrine team has decided to recommend using any other existing package and decommission their own solution.
|
|
|
|
Also, Shlink needs support for Redis clusters and Redis sentinels, which is not supported by `doctrine/cache` Redis adapters.
|
|
|
|
## Considered options
|
|
|
|
After some research, the only packages that seem to support the capabilities required by Shlink and also seem healthy, are these:
|
|
|
|
* [Symfony cache](https://symfony.com/doc/current/components/cache.html)
|
|
* 🟢 PSR-6 compliant: **yes**
|
|
* 🟢 PSR-16 compliant: **yes**
|
|
* 🟢 APCu support: **yes**
|
|
* 🟢 Redis support: **yes**
|
|
* 🟢 Redis cluster support: **yes**
|
|
* 🟢 Redis sentinel support: **yes**
|
|
* 🟢 Can use redis through Predis: **yes**
|
|
* 🔴 Individual packages per adapter: **no**
|
|
* [Laminas cache](https://docs.laminas.dev/laminas-cache/)
|
|
* 🟢 PSR-6 compliant: **yes**
|
|
* 🟢 PSR-16 compliant: **yes**
|
|
* 🟢 APCu support: **yes**
|
|
* 🟢 Redis support: **yes**
|
|
* 🟢 Redis cluster support: **yes**
|
|
* 🔴 Redis sentinel support: **no**
|
|
* 🔴 Can use redis through Predis: **no**
|
|
* 🟢 Individual packages per adapter: **yes**
|
|
|
|
## Decision outcome
|
|
|
|
Even though Symfony packs all their adapters in a single component, which means we will install some code that will never be used, Laminas relies on the native redis extension for anything related with redis.
|
|
|
|
That would make Shlink more complex to install, so it seems Symfony's package is the option where it's easier to migrate to.
|
|
|
|
Also, it's important that the cache component can share the Redis integration (through `Predis`, in this case), as it's also used by other components (the lock component, to name one).
|
|
|
|
## Pros and Cons of the Options
|
|
|
|
### Symfony cache
|
|
|
|
* Good because it supports Redis Sentinel.
|
|
* Good because it allows using a external `Predis` instance.
|
|
* Bad because it packs all the adapters in a single component.
|
|
|
|
### Laminas cache
|
|
|
|
* Good because allows installing only the adapters you are going to use, through separated packages.
|
|
* Bad because it requires the php-redis native extension in order to interact with Redis.
|
|
* Bad because it does ot seem to support Redis Sentinels.
|