mirror of
https://github.com/django/django.git
synced 2025-04-17 22:04:38 +00:00
[1.6.x] Fixed #24035 -- Clarified docs on CACHE_MIDDLEWARE_KEY_PREFIX vs KEY_PREFIX
Backport of 446b50b90e9e60760618b236d8b0ea75a3b19d5a from master
This commit is contained in:
parent
d237aaa929
commit
70c965ad4f
docs
@ -272,7 +272,8 @@ CACHE_MIDDLEWARE_ALIAS
|
||||
|
||||
Default: ``default``
|
||||
|
||||
The cache connection to use for the cache middleware.
|
||||
The cache connection to use for the :ref:`cache middleware
|
||||
<the-per-site-cache>`.
|
||||
|
||||
.. setting:: CACHE_MIDDLEWARE_ANONYMOUS_ONLY
|
||||
|
||||
@ -301,7 +302,9 @@ CACHE_MIDDLEWARE_KEY_PREFIX
|
||||
|
||||
Default: ``''`` (Empty string)
|
||||
|
||||
The cache key prefix that the cache middleware should use.
|
||||
A string which will be prefixed to the cache keys generated by the :ref:`cache
|
||||
middleware <the-per-site-cache>`. This prefix is combined with the
|
||||
:setting:`KEY_PREFIX <CACHES-KEY_PREFIX>` setting; it does not replace it.
|
||||
|
||||
See :doc:`/topics/cache`.
|
||||
|
||||
@ -312,8 +315,8 @@ CACHE_MIDDLEWARE_SECONDS
|
||||
|
||||
Default: ``600``
|
||||
|
||||
The default number of seconds to cache a page when the caching middleware or
|
||||
``cache_page()`` decorator is used.
|
||||
The default number of seconds to cache a page for the :ref:`cache middleware
|
||||
<the-per-site-cache>`.
|
||||
|
||||
See :doc:`/topics/cache`.
|
||||
|
||||
|
@ -411,6 +411,8 @@ of 60 seconds, and a maximum capacity of 1000 items::
|
||||
Invalid arguments are silently ignored, as are invalid values of known
|
||||
arguments.
|
||||
|
||||
.. _the-per-site-cache:
|
||||
|
||||
The per-site cache
|
||||
==================
|
||||
|
||||
@ -537,9 +539,9 @@ setting for the middleware. It can be used like this::
|
||||
def my_view(request):
|
||||
...
|
||||
|
||||
The two settings can also be combined. If you specify a ``cache`` *and*
|
||||
a ``key_prefix``, you will get all the settings of the requested cache
|
||||
alias, but with the key_prefix overridden.
|
||||
The ``key_prefix and ``cache`` arguments may be specified together. The
|
||||
``key_prefix`` argument and the :setting:`KEY_PREFIX <CACHES-KEY_PREFIX>`
|
||||
specified under :setting:`CACHES` will be concatenated.
|
||||
|
||||
Specifying per-view cache in the URLconf
|
||||
----------------------------------------
|
||||
|
Loading…
x
Reference in New Issue
Block a user