Nov 5, 2016 · Oct 21, 2016
diff --git a/components/cache/cache_invalidation.rst b/components/cache/cache_invalidation.rst
 items deletion. But when the state of a primary resource has spread accross
 several cached items, keeping them in sync can be difficult.

 The Symfony Cache component provides two mechanisms to helpsolve this problem:
 The Symfony Cache component provides two mechanisms to helpsolving this problem:

 * Tags based invalidation for managing data dependencies;
 * Expiration based invalidation for time related dependencies.
 *:ref:`Tags based invalidation<cache-component-tags>` for managing data dependencies;
 *:ref:`Expiration based invalidation<cache-component-expiration>` for time related dependencies.

 ..versionadded::3.2
    Tags based invalidation was introduced in Symfony 3.2.
 .. _cache-component-tags:

 Using Cache Tags
 ----------------

 ..versionadded::3.2
    Tags based invalidation was introduced in Symfony 3.2.

 To benefit from tags based invalidation, you need to attach the proper tags to
 each cacheditems. Each tag is a plain string identifier that you can use at any
 time to trigger the removal of all itemsthat had this tag attached to them.
 each cacheditem. Each tag is a plain string identifier that you can use at any
 time to trigger the removal of all itemsassociated with this tag.

 To attach tags to cached items, you need to use the
 :method:`Symfony\\Component\\Cache\\CacheItem::tag` method that is implemented by
    $item->tag(array('tag_2', 'tag_3'));
    $cache->save($item);

 If ``$cache`` implements:class:`Symfony\\Component\\Cache\\TagAwareAdapterInterface`,
 If ``$cache`` implements:class:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapterInterface`,
 you can invalidate the cached items by calling
 :method:`Symfony\\Component\\Cache\\TagAwareAdapterInterface::invalidateTags`::
 :method:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapterInterface::invalidateTags`::

    // invalidate all items related to `tag_1` or `tag_3`
    $cache->invalidateTags(array('tag_1', 'tag_3'));

    // if you know the cache key, you canof coursedelete directly
    // if you know the cache key, you canalsodelete the item directly
    $cache->deleteItem('cache_key');

 Using tags invalidation is very useful when tracking cache keys becomes difficult.
        new RedisAdapter('redis://localhost')
    );

 .. _cache-component-expiration:

 Using Cache Expiration
 ----------------------

diff --git a/components/cache/cache_pools.rst b/components/cache/cache_pools.rst
 PDO & Doctrine DBAL Cache Adapter
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 ..versionadded::3.2
    The PDO & Doctrine DBAL adapter was introduced in Symfony 3.2.

 This adapter stores the cached items a SQL database accessed through a PDO or a
 Doctrine DBAL connection::

        $options = array()
    );

 ..versionadded::3.2
    The PDO & Doctrine DBAL adapter was introduced in Symfony 3.2.

 Chain Cache Adapter
 ~~~~~~~~~~~~~~~~~~~
Original file line number	Diff line number	Diff line change
Expand Up		@@ -10,20 +10,22 @@ change in the state of your model. The most basic kind of invalidation is direct
		items deletion. But when the state of a primary resource has spread accross
		several cached items, keeping them in sync can be difficult.

		The Symfony Cache component provides two mechanisms to helpsolve this problem:
		The Symfony Cache component provides two mechanisms to helpsolving this problem:

		* Tags based invalidation for managing data dependencies;
		* Expiration based invalidation for time related dependencies.
		*:ref:`Tags based invalidation<cache-component-tags>` for managing data dependencies;
		*:ref:`Expiration based invalidation<cache-component-expiration>` for time related dependencies.

		..versionadded::3.2
		Tags based invalidation was introduced in Symfony 3.2.
		.. _cache-component-tags:

		Using Cache Tags
		----------------

		..versionadded::3.2
		Tags based invalidation was introduced in Symfony 3.2.

		To benefit from tags based invalidation, you need to attach the proper tags to
		each cacheditems. Each tag is a plain string identifier that you can use at any
		time to trigger the removal of all itemsthat had this tag attached to them.
		each cacheditem. Each tag is a plain string identifier that you can use at any
		time to trigger the removal of all itemsassociated with this tag.

		To attach tags to cached items, you need to use the
		:method:`Symfony\\Component\\Cache\\CacheItem::tag` method that is implemented by
Expand All		@@ -36,14 +38,14 @@ cache items, as returned by cache adapters::
		$item->tag(array('tag_2', 'tag_3'));
		$cache->save($item);

		If ``$cache`` implements:class:`Symfony\\Component\\Cache\\TagAwareAdapterInterface`,
		If ``$cache`` implements:class:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapterInterface`,
		you can invalidate the cached items by calling
		:method:`Symfony\\Component\\Cache\\TagAwareAdapterInterface::invalidateTags`::
		:method:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapterInterface::invalidateTags`::

		// invalidate all items related to `tag_1` or `tag_3`
		$cache->invalidateTags(array('tag_1', 'tag_3'));

		// if you know the cache key, you canof coursedelete directly
		// if you know the cache key, you canalsodelete the item directly
		$cache->deleteItem('cache_key');

		Using tags invalidation is very useful when tracking cache keys becomes difficult.
Expand DownExpand Up		@@ -78,6 +80,8 @@ your fronts and have very fast invalidation checks::
		new RedisAdapter('redis://localhost')
		);

		.. _cache-component-expiration:

		Using Cache Expiration
		----------------------

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -113,6 +113,9 @@ See the method's docblock for more options.
		PDO & Doctrine DBAL Cache Adapter
		~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

		..versionadded::3.2
		The PDO & Doctrine DBAL adapter was introduced in Symfony 3.2.

		This adapter stores the cached items a SQL database accessed through a PDO or a
		Doctrine DBAL connection::

Expand All		@@ -130,9 +133,6 @@ Doctrine DBAL connection::
		$options = array()
		);

		..versionadded::3.2
		The PDO & Doctrine DBAL adapter was introduced in Symfony 3.2.

		Chain Cache Adapter
		~~~~~~~~~~~~~~~~~~~

Expand Down