(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
$previous_name = session_name("WebsiteID");
echo "O nome da sessão anterior era $previous_name<br />";
?>