http_cache_etag
(PECL pecl_http >= 0.1.0)
http_cache_etag — Caching by ETag
Описание
Attempts to cache the sent entity by its ETag, either supplied or generated by the hash algorithm specified by the INI настройка http.etag.mode.
If the clients If-None-Match header matches the supplied/calculated ETag, the body is considered cached on the clients side and a 304 Not Modified status code is issued.
A log entry is written to the cache log if the INI настройка http.log.cache is set and the cache attempt was successful.
Забележка: Тази функция може да се използва в комбинация с http_send_data(), http_send_file() и http_send_stream().
If this function is used outside the http_send_*() API, it facilitates the ob_etaghandler().
Параметри
- etag
-
custom ETag
Връщани стойности
Връща FALSE или излиза при успех with 304 Not Modified if the entity is cached. Вижте INI настройка http.force_exit за да разберете какво означава "излиза".
Примери
Example #1 A http_cache_etag() example
<?php
http_cache_etag();
http_send_data("data");
?>
Вж. също
- http_cache_last_modified() - Caching by last modification
- ob_etaghandler() - ETag output handler
- http_match_etag() - Match ETag
- класът HttpResponse, ако използвате PHP 5.1.0 или по-нова
http_cache_etag
