Forum und email

http_cache_etag

(PECL pecl_http:0.1.0-1.5.5)

http_cache_etag — Caching by ETag

Descrierea

bool http_cache_etag ([ string $etag ] )

Attempts to cache the sent entity by its ETag, either supplied or generated by the hash algorithm specified by the setarea 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 setarea INI http.log.cache is set and the cache attempt was successful.

Notă: Această funcţie ar putea fi utilizată împreună cu http_send_data(), http_send_file() şi http_send_stream().

If this function is used outside the http_send_*() API, it facilitates the ob_etaghandler().

Parametri

etag

custom ETag

Valorile întroarse

Întoarce FALSE sau iese în caz de succes with 304 Not Modified if the entity is cached. Vedeţi setarea INI http.force_exit pentru a afla ce înseamnă "iese".

Exemple

Example#1 A http_cache_etag() example

<?php
http_cache_etag
();
http_send_data("data");
?>

Vedeţi de asemenea