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.
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
tuncdan dot ozdemir dot peng at gmail dot com ¶
9 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.`).
