http_cache_etag

(PECL pecl_http >= 0.1.0)

http_cache_etag — Caching by ETag

Beschreibung

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 INI-Einstellungen 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-Einstellungen http.log.cache is set and the cache attempt was successful.

Hinweis: Diese Funktion kann zusammen mit http_send_data(), http_send_file() und http_send_stream() benutzt werden.

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

Parameter-Liste

etag: custom ETag

Rückgabewerte

Liefert FALSE oder beendet bei Erfolg with 304 Not Modified if the entity is cached. INI-Einstellungen http.force_exit beschreibt, was "exits" bedeutet.

Beispiele

Beispiel #1 A http_cache_etag() example


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

Siehe auch

http_cache_last_modified() - Caching by last modification
ob_etaghandler() - ETag output handler
http_match_etag() - Match ETag
die HttpResponse-Klasse, wenn sie PHP 5.1 oder höher benutzen