送信されるエンティティを、その ETag を基準にしてキャッシュしようとします。 ETag は、指定されたものを使用するか、あるいは INI 設定 http.etag.mode で指定したハッシュアルゴリズムにより生成したものを使用します。
クライアントの If-None-Match ヘッダがこの ETag と一致した場合は、その本文はクライアント側でキャッシュされていると判断し、 ステータスコード 304 Not Modified を発行します。
INI 設定 http.log.cache が設定されており、キャッシュの試みが成功した場合は、 キャッシュログにエントリが書き込まれます。
注意: この関数は、 http_send_data() や http_send_file() そして http_send_stream() と組み合わせて使用しすることもあります。
この関数を http_send_*() API の外部で使用すると、 ob_etaghandler() を助けます。
失敗した場合は FALSE を返します。成功した場合は 終了 します。 エンティティがキャッシュされた場合は、304 Not Modified となります。 "終了" の意味については、INI 設定 http.force_exit を参照ください。