session_cache_expire

Get and/or set current cache expire

&reftitle.description; ``int``false```session_cache_expire` ``int``null```value`&null;

`session_cache_expire` returns the current setting of `session.cache_expire`.

The cache expire is reset to the default value of 180 stored in session.cache_expire at request startup time. Thus, you need to call `session_cache_expire` for every request (and before `session_start` is called).

&reftitle.parameters;

`value`

- If `value` is given and not &null;, the current cache expire is replaced with `value`.

  Setting `value` is of value only, if `session.cache_limiter` is set to a value different from `nocache`.

&reftitle.returnvalues;

Returns the current setting of `session.cache_expire`. The value returned should be read in minutes, defaults to 180. On failure to change the value, &false; is returned.

&reftitle.changelog;

&Version; | &Description;
8.0.0 | `value` is nullable now.

&reftitle.examples;

### `session_cache_expire` example

    <?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";
    ?>

&reftitle.seealso;

- session.cache_expire
- session.cache_limiter
- `session_cache_limiter`