http_cache_etag
(PECL pecl_http >= 0.1.0)
http_cache_etag — Кэширует с помощью ETag
Описание
$etag
] )Пытается закэшировать переданный запрос с помощью ETag, который либо передан, либо вычислен с помощью хэш-функции, заданной через INI-опцию http.etag.mode.
Если переданное клиентом значение заголовка If-None-Match совпадает с переданным в функцию/вычисленным ETag, то тело ответа считается закэшированным на стороне клиента и будет возвращён статус ответа 304 Not Modified.
Журнал запроса пишется в лог кэша, если задать INI-опцию http.log.cache и если попытка получения кеша была успешной.
Замечание: Эта функция может быть использована совместно с http_send_data(), http_send_file() и http_send_stream().
Если данная функция используется вне http_send_*() API, то для простоты можно воспользоваться callback-функцией обработчиком буферизации вывода ob_etaghandler().
Список параметров
-
etag -
Произвольный ETag
Возвращаемые значения
Возвращает FALSE или выходит при успешном завершении работы со статусом 304 Not Modified если запрос закэширован.
Смотрите INI-опцию
http.force_exit для пояснения термина "выходит".
Примеры
Пример #1 Пример использования http_cache_etag()
<?php
http_cache_etag();
http_send_data("data");
?>
Смотрите также
- http_cache_last_modified() - Кэширует с помощью даты последнего изменения
- ob_etaghandler() - ETag обработчик вывода
- http_match_etag() - Проверяет совпадение ETag
- класс HttpResponse если вы используете PHP 5.1.0 и выше
add a note
