session_id

(PHP 4, PHP 5, PHP 7, PHP 8)

session_idLee y/o modifica el identificador de sesión actual

Descripción

session_id(?string $id = null): string|false

session_id() se utiliza para recuperar o definir el identificador de sesión para la sesión actual.

La constante SID también puede ser utilizada para leer el nombre de la sesión actual y el identificador de sesión a proporcionar en las URL. Véase también Gestión de sesión.

Parámetros

id

Si id es proporcionado y no es null, reemplazará el identificador de sesión actual. session_id() debe ser llamado antes de session_start(). Dependiendo del gestor de sesiones que se utilice, no todos los caracteres serán aceptados en este valor. Por ejemplo, el gestor de sesiones por defecto, basado en archivos, solo acepta caracteres dentro del intervalo [a-zA-Z0-9,-]!

Nota: Cuando se utilizan sesiones con cookies, el hecho de especificar un id para session_id() hará que una nueva cookie siempre sea enviada al llamar a session_start(), independientemente de si el identificador de sesión actual es idéntico al que acaba de ser definido.

Valores devueltos

session_id() devuelve el identificador de sesión para la sesión actual o una cadena vacía ("") si no hay sesión actual (ningún identificador de sesión existe). En caso de error, false es devuelto.

Historial de cambios

Versión Descripción
8.0.0 id ahora es nullable.

Ver también