http_cache_etag
(PECL pecl_http >= 0.1.0)
http_cache_etag — Mise en cache en fonction de l'ETag
Description
$etag
] )Tente de mettre en cache l'entité envoyée en fonction de l'ETag soit fourni, soit généré par l'algorithme de hashage spécifié par l'directive de configuration INI http.etag.mode.
Si l'en-tête If-None-Match du client correspond à l'ETag fourni/calculé, le corps est considéré comme étant en cache côté client et un code statut 304 Not Modified est émis.
Une entrée dans l'historique est écrite dans l'historique de cache si le directive de configuration INI http.log.cache est défini et que la mise en cache est un succès.
Note: Cette fonction doit être utilisée avec les fonctions http_send_data(), http_send_file() et http_send_stream().
Si cette fonction est utilisée en dehors de l'API http_send_*(), il facilite ob_etaghandler().
Liste de paramètres
-
etag
-
ETag personnalisé
Valeurs de retour
Retourne FALSE
ou exits en cas de succès avec un en-tête 304 Not Modified
si l'entité est mis en cache. Voir la directive de configuration INI
http.force_exit pour savoir ce que signifie "exits".
Exemples
Exemple #1 Exemple avec http_cache_etag()
<?php http_cache_etag(); http_send_data("data"); ?>
Voir aussi
- http_cache_last_modified() - Mise en cache en fonction de la date de dernière modification
- ob_etaghandler() - Gestionnaire de sortie ETag
- http_match_etag() - Cherche un ETag particulier
- la classe HttpResponse si vous utilisez PHP 5.1 et supérieur