現在のキャッシュリミッタを取得または設定する

説明

string session_cache_limiter ([ string $cache_limiter ] )

session_cache_limiter() は、現在のキャッシュリミッタの名前を返します。

キャッシュリミッタは、クライアントに送信されるキャッシュ制御用の HTTPヘッダを制御します。これらのヘッダは、ページの内容をクライアントやプロキシがキャッシュする規則を定義します。例えば、キャッシュリミッタを nocacheに設定した場合、クライアント/プロキシのキャッシュは無効になります。しかし、publicの場合は、キャッシュを許可します。privateと設定することも可能で、この場合、プロキシがキャッシュすることは許可しませんがクライアントがキャッシュすることは許可されます。

privateモードにおいて、Expireヘッダがクライアントに送信されます。これは、Mozilla のようないくつかのブラウザを混乱させます。これを避けるには、 private_no_expireモードを使用してください。このモードでは、Expireヘッダはクライアントに送信されません。

キャッシュリミッタは、リクエスト開始時に session.cache_limiterに保存されたデフォルト値にリセットされます。つまり、各リクエスト毎に(アウトプットバッファが無効な場合は、session_start()がコールされる前に) session_cache_limiter()をコールする必要があります。

パラメータ

cache_limiter

cache_limiter が指定された場合、現在のキャッシュリミッタは新しい値に変更されます。

**取り得る値**
値	送信されるヘッダ
public	Expires: (未来のいつか、session.cache_expires による) Cache-Control: public, max-age=(未来のいつか、session.cache_expire による) Last-Modified: (セッションが最後に保存されたときのタイムスタンプ)
private_no_expire	Cache-Control: private, max-age=(session.cache_expire ぶんだけ未来), pre-check=(session.cache_expire ぶんだけ未来) Last-Modified: (セッションが最後に保存されたときのタイムスタンプ)
private	Expires: Thu, 19 Nov 1981 08:52:00 GMT Cache-Control: private, max-age=(session.cache_expire ぶんだけ未来), pre-check=(session.cache_expire ぶんだけ未来) Last-Modified: (セッションが最後に保存されたときのタイムスタンプ)
nocache	Expires: Thu, 19 Nov 1981 08:52:00 GMT Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0 Pragma: no-cache

返り値

現在のキャッシュリミッタの名前を返します。

変更履歴

バージョン	説明
4.2.0	private_no_expire が追加されました。

例

例1 session_cache_limiter() の例


<?php

/* キャッシュリミッタを'private'に設定する */

session_cache_limiter('private');
$cache_limiter = session_cache_limiter();

echo "The cache limiter is now set to $cache_limiter<br />";
?>

参考

session.cache_limiter