• « session_save_path
  • session_set_save_handler »
  • PHP Manual
  • Funções para Sessão
  • Define os parâmetros do cookie de sessão

session_set_cookie_params

(PHP 4, PHP 5, PHP 7, PHP 8)

session_set_cookie_params — Define os parâmetros do cookie de sessão

Descrição

session_set_cookie_params(
    int $lifetime_or_options,
    ?string $path = null,
    ?string $domain = null,
    ?bool $secure = null,
    ?bool $httponly = null
): bool

Alternative signature available as of PHP 7.3.0:

session_set_cookie_params(array $lifetime_or_options): bool

Define parâmetros dos cookies configurados no arquivo php.ini. O efeito desta função é apenas pela duração do script. Então, você precisa chamar session_set_cookie_params() para cada requisição e antes que session_start() seja chamada.

Esta função atualiza os valores em tempo de execução correspondentes às configurações INI que podem ser obetidos com ini_get().

Parâmetros

lifetime_or_options

Ao usar a primeira assinatura, lifetime do cookie de sessão, definido em segundos.

Ao usar a segunda assinatura, um array associativo que pode ter qualquer uma das chaves lifetime, path, domain, secure, httponly e samesite. Os valores têm o mesmo significado descrito para os parâmetros com o mesmo nome. O valor do elemento samesite deve ser ou Lax ou Strict. Se alguma das opções permitidas não for fornecida, seus valores padrão serão os iguais aos valores padrão dos parâmetros explícitos. Se o O elemento samesite é omitido, nenhum cookie SameSite atributo é definido.

path

Caminho no domínio onde o cookie vai funcionar. Use uma única barra ('/') para que funcione em todos os caminhos do domínio.

domain

Domínio do cookie, por exemplo 'www.php.net'. Para tornar os cookies visíveis em todos os subdomínios, o domínio deve ser prefixado com um ponto, como '.php.net'.

secure

Se true, o cookie só será enviado em conexões seguras.

httponly

Se true, então o PHP tentará enviar a flag httponly ao definir o cookie de sessão.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Registro de Alterações

Versão Descrição
8.0.0 path, domain, secure e httponly são anuláveis agora.
7.3.0 Uma assinatura alternativa que suporta um lifetime_or_options array foi adicionado. Esta assinatura suporta também a configuração do Atributo de cookie SameSite.
7.2.0 Retorna true em caso de sucesso ou false em caso de falha. Anteriormente a função retornava void.

Veja Também

  • session.cookie_lifetime
  • session.cookie_path
  • session.cookie_domain
  • session.cookie_secure
  • session.cookie_httponly
  • session.cookie_samesite
  • session_get_cookie_params() - Obtém os parâmetros do cookie da sessão