session_register
Manual de PHP
AnteriorSiguiente

session_register

(PHP 4, PHP 5)

session_register --  Registrar una o m谩s variables globales con la sesi贸n actual

Descripci贸n

bool session_register ( mixed nombre [, mixed ...] )

session_register() acepta un n煤mero variable de argumentos, cualquiera de los cuales puede ser o una cadena que contiene el nombre de una variable, o una matriz que consista de nombres de variables u otras matrices. Para cada nombre, session_register() registra la variable global con ese nombre en la sesi贸n actual.

Atenci贸n

Si desea que su script funcione independientemente de register_globals, necesita usar en su lugar la matriz $_SESSION, dado que las entradas de $_SESSION son registradas autom谩ticamente. Si su script usa session_register(), no funcionar谩 en entornos en donde la directiva PHP register_globals est茅 deshabilitada.

register_globals: Nota importante: Desde PHP 4.2.0 el valor por defecto de la directiva register_globals es off. La comunidad PHP anima a todos a no confiar en esta directiva y usar en su lugar superglobals.

Atenci贸n

Esto registra una variable global. Si desea registrar una variable de sesi贸n desde el interior de una funci贸n, necesita asegurarse de hacerla global usando la palabra clave global o la matriz $GLOBALS[], o usar las matrices de sesi贸n especiales, como se anota a continuaci贸n.

Atenci贸n

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

Esta funci贸n devuelve TRUE cuando todas las variables son registradas satisfactoriamente en la sesi贸n.

Si session_start() no fue llamada antes de que 茅sta funci贸n sea llamada, se realizar谩 un llamado impl铆cito a session_start() sin par谩metro alguno. $_SESSION no imita este comportamiento y requiere session_start() antes de su uso.

Puede crear tambi茅n una variable de sesi贸n, simplemente definiendo el miembro apropiado de $_SESSION o la matriz $HTTP_SESSION_VARS (PHP < 4.1.0).

<?php
// El uso de session_register() es considerado obsoleto
$barney = "Un dinosaurio grande y violeta.";
session_register("barney");

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

// El modo antiguo era usar $HTTP_SESSION_VARS
$HTTP_SESSION_VARS["bob_esponja"] = "&Eacute;l tiene pantalones cuadrados.";
?>

Nota: Actualmente es imposible registrar variables de recurso en una sesi贸n. Por ejemplo, no puede crear una conexi贸n a una base de datos y almacenar la id de conexi贸n como una variable de sesi贸n y esperar que la conexi贸n aun sea v谩lida la pr贸xima vez que la sesi贸n sea restaurada. Las funciones PHP que devuelven un recurso se identifican por tener un tipo de retorno de resource en su definic贸n de funci贸n. Una lista de funciones que devuelven recursos est谩 disponible en el ap茅ndice tipos de recurso.

Si $_SESSION (o $HTTP_SESSION_VARS para PHP 4.0.6 o versiones anteriores) es usado, asigne valores a $_SESSION. Por ejemplo: $_SESSION['var'] = 'ABC';

Vea tambi茅n session_is_registered(), session_unregister(), y $_SESSION.

AnteriorInicioSiguiente
session_regenerate_idSubirsession_save_path