• « 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

Assinatura alternativa disponível a partir do 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 obtidos com ini_get().

Parâmetros

lifetime_or_options

Ao usar a primeira assinatura, este parâmetro indica o tempo de vida do cookie de sessão, definido em segundos.

Ao usar a segunda assinatura, este parâmetro deve conter um array associativo que pode ter qualquer uma das chaves lifetime (tempo de vida), path (caminho), domain (domínio), secure (seguro), httponly (somente http) e samesite (mesmo site). Os valores têm o mesmo significado descrito para os parâmetros com o mesmo nome. O valor do elemento samesite deve ser 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 for omitido, nenhum atributo SameSite do cookie é definido.

path

Caminho no domínio onde o cookie irá 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 opção 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 lifetime_or_options array foi adicionada. 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