Obter e/ou definir a expiração do cache atual

# session_cache_expire

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

session_cache_expire — Obter e/ou definir a expiração do cache atual

### Descrição

function session_cache_expire(?int `$value` = `null`): int|false

session_cache_expire() retorna a configuração atual de `session.cache_expire`.

O prazo para o cache expirar é redefinido para o padrão de 180 guardado em session.cache_expire na inicialização da requisição. Então você precisa chamar session_cache_expire() para cada requesição (e antes que session_start() seja utilizada).

### Parâmetros

`value`

  Se `value` é informado e não `null`, a expiração do cache atual é modificado para `value`.

  > Nota: Definir o valor de `value` tem valor apenas se `session.cache_limiter` é definido como um valor diferente de `nocache`.

### Valor Retornado

Retorna a configuração atual de `session.cache_expire`. O valor retornado deve ser lido em minutos, padrão de 180. Caso não seja possível alterar o valor, `false` é retornado.

### Registro de Alterações

Versão | Descrição
--- | ---
8.0.0 | `value` é anulável agora.

### Exemplos

Exemplo #1 Exemplo de session_cache_expire()

    <?php

    /* define o limitador de cache para 'private' */

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

    /* define o prazo do cache em 30 minutos */
    session_cache_expire(30);
    $cache_expire = session_cache_expire();

    /* inicia a sessão */

    session_start();

    echo "O limitador de cache está definido agora como $cache_limiter<br />";
    echo "As sessões em cache irão expirar depois de $cache_expire minutos";
    ?>

### Veja Também

- session.cache_expire
- session.cache_limiter
- session_cache_limiter() - Obtém e/ou define o limitador do cache atual

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open