session_name
(PHP 4, PHP 5, PHP 7, PHP 8)
session_name — Lee y/o modifica el nombre de la sesión
Descripción
Si se proporciona un nuevo nombre de sesión name
,
session_name() modifica la cookie HTTP
(y el contenido de salida cuando session.transid está
activado). Una vez enviada la cookie HTTP,
llamar a session_name() desencadena un E_WARNING
.
session_name() debe ser llamado
antes de session_start() para que la sesión funcione
correctamente.
El nombre de la sesión se reinicia al valor por defecto, almacenado en
session.name
al inicio. Por lo tanto, debe
llamarse a session_name() para cada petición (y antes de que
session_start() sea llamado).
Parámetros
name
-
El nombre de sesión se utiliza como nombre para las cookies y las URLs
(es decir, PHPSESSID
). Solo debe contener caracteres alfanuméricos;
debe ser corto y descriptivo (especialmente para los usuarios
que tienen activada la alerta de cookies). Si name
se proporciona y no es null
,
el nombre de la sesión actual será reemplazado por este valor.
Advertencia
Los nombres de sesión no pueden contener solo números, al menos una letra
debe estar presente. De lo contrario, se generará un identificador de sesión cada vez.
Valores devueltos
Devuelve el nombre de la sesión actual. Si se proporciona el argumento name
y la función actualiza el nombre de la sesión, entonces
el anterior nombre de sesión será devuelto, o false
si ocurre un error.
Ejemplos
Ejemplo #1 Ejemplo con session_name()
<?php
/* elige el nombre de sesión: WebsiteID */
$previous_name = session_name("WebsiteID");
echo "El nombre anterior de la sesión era $previous_name<br />";
?>