session_id
(PHP 4, PHP 5, PHP 7, PHP 8)
session_id — Obtém e/ou define o id de sessão atual
Descrição
session_id() é usado para obter ou definir o id de sessão para a sessão atual.
A constante SID também pode ser usada para
obter o nome e id da sessão atual como uma string adequado para
adicionar em URLs. Veja também Manipulação
de Sessão.
Parâmetros
id-
Se
idfor especificado e nãonull, ele substituirá o id de sessão atual. session_id() precisa ser chamado antes de session_start() para este fim. Dependendo do manipulador de sessão, nem todos os caracteres são permitidos em um id de sessão. Por exemplo, o manipulador de sessão em arquivo permite apenas caracteres no intervalo[a-zA-Z0-9,-]!Note: Quando estiver usando cookies de sessão, especificar um
idpara session_id() sempre enviará um novo cookie quando session_start() for chamada, sem importar se o id da sessão atual for idêntico ao que está sendo definido.
Valor Retornado
session_id() retorna o id de sessão para a sessão
atual ou uma string vazia ("") se não houver sessão
atual (não existe um id de sessão atual).
Em caso de falha, false é retornado.
Registro de Alterações
| Versão | Descrição |
|---|---|
| 8.0.0 |
id é anulável agora.
|
Veja Também
- session_regenerate_id() - Atualiza o id da sessão atual com um novo id gerado
- session_start() - Inicia uma nova sessão ou continua uma sessão existente
- session_set_save_handler() - Define funções de armazenamento de sessão à nível de usuário
- session.save_handler