http_cache_etag
(PECL pecl_http:0.1.0-1.5.5)
http_cache_etag — Caching by ETag
Descrizione
Attempts to cache the sent entity by its ETag, either supplied or generated by the hash algorithm specified by the impostazioni 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 impostazioni INI http.log.cache is set and the cache attempt was successful.
Nota: Questa funzione può essere usata con le funzioni http_send_data(), http_send_file() e http_send_stream().
If this function is used outside the http_send_*() API, it facilitates the ob_etaghandler().
Elenco dei parametri
- etag
-
custom ETag
Valori restituiti
Restituisce FALSE oppure esce in caso di successo with 304 Not Modified if the entity is cached. Vedere impostazioni INI http.force_exit per il significato di "uscita".
Esempi
Example#1 A http_cache_etag() example
<?php
http_cache_etag();
http_send_data("data");
?>
Vedere anche:
- http_cache_last_modified()
- ob_etaghandler()
- http_match_etag()
- la classe HttpResponse se si sta usando PHP-5.1 e successivi