Skip to content

[Cache] Mention some details about cache.adapter.system #18846

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Sep 8, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions cache.rst
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,8 @@ of:
Redis and Memcached are examples of such adapters. If a DSN is used as the
provider then a service is automatically created.

.. _cache-app-system:

There are two pools that are always enabled by default. They are ``cache.app`` and
``cache.system``. The system cache is used for things like annotations, serializer,
and validation. The ``cache.app`` can be used in your code. You can configure which
Expand Down Expand Up @@ -119,6 +121,13 @@ The Cache component comes with a series of adapters pre-configured:

``cache.adapter.redis_tag_aware`` has been introduced in Symfony 5.2.

.. note::

There's also a special ``cache.adapter.system`` adapter. It's recommended to
use it for the :ref:`system cache <cache-app-system>`. This adapter uses some
logic to dynamically select the best possible storage based on your system
(either PHP files or APCu).

Some of these adapters could be configured via shortcuts. Using these shortcuts
will create pools with service IDs that follow the pattern ``cache.[type]``.

Expand Down