Commit7e04d5a

committed

Merge branch '4.4' into 5.1

* 4.4: Minor: Rename ref. refs#14081 Add documentation about RedisTagAwareAdapter

2 parents60c44f2 +caa6858 commit7e04d5aCopy full SHA for 7e04d5a

File tree

+19

-0

lines changed

+19

-0

lines changed

Lines changed: 14 additions & 0 deletions

Original file line number	Diff line number	Diff line change
`@@ -180,6 +180,20 @@ Available Options`
`180`	`180`	When using the `Predis`_ library some additional Predis-specific options are available.
`181`	`181`	Reference the `Predis Connection Parameters`_ documentation for more information.
`182`	`182`
	`183`	`+.. _redis-tag-aware-adapter:`
	`184`	`+`
	`185`	`+Working with Tags`
	`186`	`+-----------------`
	`187`	`+`
	`188`	+In order to use tag-based invalidation, you can wrap your adapter in:class:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapter`, but when Redis is used as backend, it's often more interesting to use the dedicated:class:`Symfony\\Component\\Cache\\Adapter\\RedisTagAwareAdapter`. Since tag invalidation logic is implemented in Redis itself, this adapter offers better performance when using tag-based invalidation::
	`189`	`+`
	`190`	`+ use Symfony\Component\Cache\Adapter\RedisAdapter;`
	`191`	`+ use Symfony\Component\Cache\Adapter\RedisTagAwareAdapter;`
	`192`	`+`
	`193`	`+ $client = RedisAdapter::createConnection('redis://localhost');`
	`194`	`+ $cache = new RedisTagAwareAdapter($client);`
	`195`	`+`
	`196`	`+`
`183`	`197`	.. _`Data Source Name (DSN)`:https://en.wikipedia.org/wiki/Data_source_name
`184`	`198`	.. _`Redis server`:https://redis.io/
`185`	`199`	.. _`Redis`:https://github.com/phpredis/phpredis

Lines changed: 5 additions & 0 deletions

Original file line number	Diff line number	Diff line change
`@@ -58,6 +58,11 @@ To store tags, you need to wrap a cache adapter with the`
`58`	`58`	:method:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapterInterface::invalidateTags`
`59`	`59`	`method.`
`60`	`60`
	`61`	`+..note::`
	`62`	`+`
	`63`	+ When using a Redis backend, consider using:ref:`RedisTagAwareAdapter<redis-tag-aware-adapter>`
	`64`	`+ which is optimized for this purpose.`
	`65`	`+`
`61`	`66`	The:class:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapter` class implements
`62`	`67`	instantaneous invalidation (time complexity is ``O(N)`` where ``N`` is the number
`63`	`68`	`of invalidated tags). It needs one or two cache adapters: the first required`

Comments

(0)