# session_cache_expire

(PHP 4 >= 4.2.0, PHP 5, PHP 7)

session_cache_expire — 返回当前缓存的到期时间

### 说明

session_cache_expire ([ string `$new_cache_expire` ] ) : int

session_cache_expire() 返回 session.cache_expire 的设定值。

请求开始的时候，缓存到期时间会被重置为 180，并且保存在 session.cache_expire 配置项中。 因此，针对每个请求，需要在 session_start() 函数调用之前 调用 session_cache_expire() 来设置缓存到期时间。

### 参数

`new_cache_expire`

  如果给定 `new_cache_expire` ，就使用 `new_cache_expire` 的值设置当前缓存到期时间。

  > Note: 仅在 session.cache_limiter 的设置值 不是 nocache 的时候， 才可以设置 `new_cache_expire` 参数。

### 返回值

返回 session.cache_expire 的当前设置值， 以分钟为单位，默认值是 180 （分钟）。

### 范例

Example #1 session_cache_expire() 示例

    <?php

    /* 设置缓存限制为 “private” */

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

    /* 设置缓存过期时间为 30 分钟 */
    session_cache_expire(30);
    $cache_expire = session_cache_expire();

    /* 开始会话 */

    session_start();

    echo "The cache limiter is now set to $cache_limiter<br />";
    echo "The cached session pages expire after $cache_expire minutes";
    ?>

### 参见

- session.cache_expire
- session.cache_limiter
- session_cache_limiter() - 读取/设置缓存限制器