session_register

(PHP 4, PHP 5 < 5.4.0)

session_registerRegistrar una o más variables globales con la sesión actual

Descripción

session_register ( mixed $name [, mixed $... ] ) : bool

session_register() acepta un número variable de argumentos, cualquiera que pueda ser o una cadena que contenga el nombre de una variable o una matriz que consista en nombres de variables u otras matrices. Por cada nombre, session_register() registra la variable global con ese nombre en la sesión actual.

También se puede crear una variable de sesión estableciendo simplemente el miembro apropiado de la matriz $_SESSION o $HTTP_SESSION_VARS (PHP < 4.1.0).

<?php
// El uso de session_register() está obsoleto
$barney "Un gran dinosaurio púrpura.";
session_register("barney");

// Se prefiere el uso de $_SESSION, a partir de PHP 4.1.0
$_SESSION["zim"] = "Un invasor de otro planeta.";

// La forma antigua era usar $HTTP_SESSION_VARS
$HTTP_SESSION_VARS["bobesponja"] = "Tiene pantalones cuadrados.";
?>

Si no se llamó a session_start() antes de llamar a esta función, se hará una llamada implícita a session_start() sin parámetros. $_SESSION no imita este comportamiento y requiere que session_start() se use antes.

Advertencia

Esta función ha sido declarada OBSOLETA desde PHP 5.3.0 y ELIMINADA a partir de PHP 5.4.0.

Parámetros

name

Una cadena de contiene el nombre de una variable o una matriz que consiste en nombres de variables u otras matrices.

...

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error.

Notas

Precaución

Si quiere que su script funcione sin tener en cuenta register_globals, necesita usar en su lugar la matriz $_SESSION ya que las entradas de $_SESSION se registran automáticamente. Si su script usa session_register(), no funcionará en entornos donde la directiva de PHP register_globals esté deshabilitada.

Nota: register_globals: Observación importante

Desde PHP 4.2.0, el valor por defecto de la directiva register_globals es off. La comunidad de PHP desaconseja el uso de esta directiva y sugiere el uso de otras formas como superglobals.

Precaución

Esto registra una variable global. Si no desea registrar una variable de sesión desde dentro de una función, necesita asegurarse de hacerla global usando la palabra clave global o la matriz $GLOBALS[], o use las matrices de sesión especiales como está anotado debajo.

Precaución

Si está usando $_SESSION (o $HTTP_SESSION_VARS), no use session_register(), session_is_registered(), y session_unregister().

Nota:

Actualmente es imposible registrar variables de recursos en una sesión. Por ejemplo, no se puede crear una conexión a una base de datos y almacenar el id de conexión como una variable de sesión y esperar que la conexión aún sea válida la siguiente vez que se restaure la sesión. Las funciones de PHP que devuelven un recurso están identificadas por tener un tipo de retorno de resource en sus definiciones de función. Una lista de funciones que devuelven recursos está disponible en el apéndice tipos de recursos.

Si se usa $_SESSION (o $HTTP_SESSION_VARS para PHP 4.0.6 o anterior), asigne valores a $_SESSION. Por ejemplo: $_SESSION['var'] = 'ABC';

Ver también