array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.session-id.php', 1 => 'session_id', 2 => 'Obtém e/ou define o id de sessão atual', ), 'up' => array ( 0 => 'ref.session.php', 1 => 'Funções para Sessão', ), 'prev' => array ( 0 => 'function.session-get-cookie-params.php', 1 => 'session_get_cookie_params', ), 'next' => array ( 0 => 'function.session-module-name.php', 1 => 'session_module_name', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/session/functions/session-id.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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(?string $id = null): string|false

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 id for especificado e não null, 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,-]!

Nota: Quando estiver usando cookies de sessão, especificar um id para 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