session_cache_expire
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
session_cache_expire — 現在のキャッシュの有効期限を取得/設定する
説明
session_cache_expire() は現在の
session.cache_expire
の設定を返します。
リクエストがあった時点で、キャッシュの有効期限は session.cache_expire で設定されたデフォルト値にリセットされます。 そのため、すべてのリクエストにおいて (そしてsession_start() をコールする前に) session_cache_expire() をコールする必要があります。
パラメータ
value
-
value
が指定され、null
でない場合、 現在のキャッシュの有効期限は、value
で置換されます。注意:
session.cache_limiter
がnocache
以外の値にセットされている場合にのみvalue
が有効となります。
戻り値
session.cache_expire
の現在の設定を返します。
戻り値は分単位で、デフォルトは 180 です。
値の変更に失敗した場合は、false
を返します。
変更履歴
バージョン | 説明 |
---|---|
8.0.0 |
value は、nullable になりました。
|
例
例1 session_cache_expire() の例
<?php
/* set the cache limiter to 'private' */
session_cache_limiter('private');
$cache_limiter = session_cache_limiter();
/* set the cache expire to 30 minutes */
session_cache_expire(30);
$cache_expire = session_cache_expire();
/* start the session */
session_start();
echo "The cache limiter is now set to $cache_limiter<br />";
echo "The cached session pages expire after $cache_expire minutes";
?>
+add a note
User Contributed Notes 2 notes
Anonymous ¶
16 years ago
The manual probably doesn't stress this enough:
** This has nothing to do with lifetime of a session **
Whatever you set this setting to, it won't change how long sessions live on your server.
This only changes HTTP cache expiration time (Expires: and Cache-Control: max-age headers), which advise browser for how long it can keep pages cached in user's cache without having to reload them from the server.
tuncdan dot ozdemir dot peng at gmail dot com ¶
10 months ago
Using PHP 8.2
session_start();
$result1 = session_cache_expire( 30 ); // setter, results in Warning: Session cache expiration cannot be changed when a session is active in ...
$result2 = session_cache_expire(); // getter
var_dump( $result1, $result2 ); // prints out: int(180) int(180) [note: 180 is the default value]
Because the session was already started, cache expiration could not be changed (warning message). However, the return value is NOT false, it is still the original, unchanged value!
So I do not know what is considered a failure to change the value as per the documentation (`On failure to change the value, false is returned.`).
↑ and ↓ to navigate •
Enter to select •
Esc to close
Press Enter without
selection to search using Google