array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.session-name.php', 1 => 'session_name', ), 'up' => array ( 0 => 'ref.session.php', 1 => 'Funções para Sessão', ), 'prev' => array ( 0 => 'function.session-module-name.php', 1 => 'session_module_name', ), 'next' => array ( 0 => 'function.session-regenerate-id.php', 1 => 'session_regenerate_id', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/session/functions/session-name.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
session_name — Obtém e/ou define o nome da sessão atual
session_name() retorna o nome da sessão
atual. Se name
é informado,
session_name() vai atualizar o nome da sessão e retornar
o nome da sessão antiga.
Se um novo name
de sessão é
fornecido, session_name() modifica o cookie HTTP
(e saída de conteúdo quando session.transid
é
habilitado). Assim que o cookie HTTP é
enviado, session_name() gera erro.
session_name() deve ser chamado
antes de session_start() para a sessão funcionar
apropriadamente.
O nome da sessão é redefinido para o padrão guardado em
session.name
na inicialização da requisição. Então você deve
chamar session_name() para cada requisição (e antes que
session_start() seja chamado).
name
O nome da sessão refere-se ao nome da sessão, que é
usado em cookies e URLs (por exemplo, PHPSESSID
). Ele
deve conter apenas caracteres alfanuméricos; ele deve ser curto e
descritivo (para usuários com avisos de cookie habilitados).
Se name
é informado e não null
, o nome da sessão atual
é modificado para o novo valor.
O nome da sessão não pode consistir apenas de dígitos, pelo menos uma letra deve estar presente. Caso contrário um novo id de sessão é gerado toda vez.
Retorna o nome da sessão atual. Se name
é informado
e a função atualizar o nome da sessão, o nome da sessão antiga
é retornado, ou false
em caso de falha.
Versão | Descrição |
---|---|
8.0.0 |
name é anulável agora.
|
7.2.0 | session_name() verifica o status da sessão, anteriormente, apenas verificava o status do cookie. Portanto, session_name() mais antigo permite chamar session_name() depois de session_start() que pode travar o PHP e pode resultar em mau comportamento. |
Exemplo #1 Exemplo de session_name()
<?php
/* defina o nome da sessão para WebsiteID */
$previous_name = session_name("WebsiteID");
echo "O nome da sessão anterior era $previous_name<br />";
?>