# session_name

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

session_name — Obtener y/o establecer el nombre de la sesión actual

### Descripción

session_name(string `$name` = ?): string

session_name() devuelve el nombre de la sesión actual. Si se da el nombre `name`, session_name() actualizará el nombre de la sesión y devolverá el nombre antiguo de la sesión.

El nombre de la sesión se reinicia al valor predeterminado almacenado en `session.name` en el momento de iniciar una petición. Por lo tanto, se necesita llamar a session_name() por cada petición (y antes de llamar a session_start() o session_register()).

### Parámetros

`name`

  El nombre de la sesión hace referencia al nombre de la sesión usado cookies y URLs (p.ej. `PHPSESSID`). Debería contener sólo caracteres alfanuméricos; debería ser corto y descriptivo (esto es, para usuarios con las advertencias de cookies habilitadas). Si se especifica `name`, el nombre de la sesión actual se cambia por su valor.

  Advertencia

  El nombre de la sesión no puede consistir en dígitos solamente, debe de estar presente al menos una letra. De otro modo se genera un nuevo id de sesión cada vez.

### Valores devueltos

Devuelve el nombre de la sesión actual. Si se proporciona `name` y una función actualiza el nombre de la sesión, se devolverá el nombre antiguo de la sesión.

### Ejemplos

Ejemplo #1 Ejemplo de session_name()

`<?php
/* establecer el nombre de la sesión a WebsiteID */
$nombre_anterior = session_name("WebsiteID");
echo "El nombre anterior de la sesión era $nombre_anterior<br />";
?>`

### Ver también

- La directiva de configuración session.name