Заголовок Vary определяет какой из заголовков запроса должен рассматриваться механизмом кэширования. Например, если содержимое страницы зависит от языковой настройки пользователя, страница укажет на это с помощью заголовка.

По умолчанию механизм кэширования Django создаёт записи в кэше, используя заданный путь (т.е., /stories/2005/jun/23/bank_robbed/). Это означает, что каждый запрос по этому URL будет использовать версию страницы из кэша, независимо от разницы между агентами пользователя (user-agent), такими как cookie или языковые настройки. Тем не менее, если эта страница генерирует различное содержание, основываясь на информации из заголовков запроса, таких как cookie или язык или другой агент пользователя, вам потребуется использовать заголовок Vary, чтобы механизм кэширования знал эту зависимость.

Для использования этого в Django следует использовать удобный декоратор для представления vary_on_headers, вот такой:

from django.views.decorators.vary import vary_on_headers

# Синтаксис для Python 2.3.
def my_view(request):
    # ...
my_view = vary_on_headers(my_view, 'User-Agent')

# Синтаксис для Python 2.4+.
@vary_on_headers('User-Agent')
def my_view(request):
    # ...

В данном случае механизм кэширования (такой как в Django) сохраняет отдельную версию страницы для каждого уникального агента пользователя.

Преимущество в использовании декоратора vary_on_headers вместо ручного указания заголовка Vary (как-то так response['Vary'] = 'user-agent') в том, что декоратор добавляет информацию к заголовку Vary (а он может уже существовать), а не перезаписывает уже имеющиеся в нём данные.

Вы можете передать несколько заголовков в vary_on_headers():

@vary_on_headers('User-Agent', 'Cookie')
def my_view(request):
    # ...

Это указывает кэшу верхнего уровня, что ему надо учитывать оба варианта, что означает любую комбинацию агента пользователя и cookie. Например, запрос от агента Mozilla с cookie foo=bar будет рассматриваться отдельно от запроса агента Mozilla и cookie foo=ham.

Так как обычно все используют cookie для различения запросов, нашлось место и для декоратора vary_on_cookie. Представления, приведённые ниже, эквивалентны:

@vary_on_cookie
def my_view(request):
    # ...

@vary_on_headers('Cookie')
def my_view(request):
    # ...

Регистр заголовков, передаваемых в vary_on_headers(), не имеет значения. Заголовок User-Agent эквивалентен user-agent.

Вы также можете напрямую использовать вспомогательную функцию django.utils.cache.patch_vary_headers. Эта функция устанавливает или добавляет заголовок Vary, например:

from django.utils.cache import patch_vary_headers

def my_view(request):
    # ...
    response = render_to_response('template_name', context)
    patch_vary_headers(response, ['Cookie'])
    return response

Метод patch_vary_headers() принимает экземпляр HttpResponse в качестве первого аргумента и список или кортеж регистронезависимых имён заголовков в качестве второго аргумента.

Другими проблемами при использовании кэширования являются секретность данных и вопрос хранения данных в каскадных кэшах.

Пользователь обычно сталкивается с двумя видами кэшей: кэш браузера (частный кэш) и кэш провайдера (общий кэш). Общий кэш используется рядом пользователей и находится под контролем третьего лица. Это вызывает проблему надёжности данных. Скажем, вам не захочется, чтобы номер вашего банковского счета был сохранён в общем кэше. Таким образом веб приложения должны иметь способ указать кэшу, какие данные являются частными, а какие нет.

Решением будет указание кэшу, что страница будет частной. Для того, чтобы сделать это в Django следует использовать декоратор cache_control:

from django.views.decorators.cache import cache_control

@cache_control(private=True)
def my_view(request):
    # ...

Этот декоратор заботится об автоматической отправке соответствующих HTTP заголовков.

Существует несколько способов управления параметрами кэша. Например, HTTP позволяет приложения выполнять следующее:

Используйте декоратор cache_control в Django для определения этих параметров кэширования. В этом примере cache_control указывает, что требуется проверять наличие изменений в оригинальной странице при каждом доступе к ней и сохранять в кэше копии максимум 3600 секунд:

from django.views.decorators.cache import cache_control
@cache_control(must_revalidate=True, max_age=3600)
def my_view(request):
    ...

Любая разрешённая HTTP директива для Cache-Control разрешена и для cache_control(). Приведём полный список: