(PHP 4, PHP 5, PHP 7, PHP 8)
session_set_cookie_params — Define os parâmetros do cookie de sessão
$lifetime_or_options
,$path
= null
,$domain
= null
,$secure
= null
,$httponly
= null
Assinatura alternativa disponível a partir do PHP 7.3.0:
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().
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
httponly
Se true
, então o PHP tentará enviar a opção
httponly
ao definir o cookie de sessão.
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.
|