PHP マニュアル: 現在のキャッシュリミッタを取得または設定する

説明

stringfalse session_cache_limiter(stringnull $value = null)

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

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

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

キャッシュリミッタを '' にすると、キャッシュヘッダの自動送信を完全に無効化します。

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

パラメータ

value

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

**取り得る値**
値	送信されるヘッダ
`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 ぶんだけ未来) Last-Modified: (セッションが最後に保存されたときのタイムスタンプ)
`private`	Expires: Thu, 19 Nov 1981 08:52:00 GMT Cache-Control: private, max-age=(session.cache_expire ぶんだけ未来) Last-Modified: (セッションが最後に保存されたときのタイムスタンプ)
`nocache`	Expires: Thu, 19 Nov 1981 08:52:00 GMT Cache-Control: no-store, no-cache, must-revalidate Pragma: no-cache

戻り値

現在のキャッシュリミッタの名前を返します。値の変更に失敗した場合は、false を返します。

変更履歴

バージョン	説明
8.0.0	`value` は、nullable になりました。

例

例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