(PHP 4 >= 4.0.0)
session_register -- Register one or more variables with the current session
Description
bool session_register (mixed name [, mixed ...])
session_register() accepts a variable number of arguments, any of which can be
either a string holding the name of a variable or an array consisting of variable names or other
arrays. For each name, session_register() registers the global variable with that name in
the current session.
| Caution |
|
This registers a global variable. If you want to register a session variable
inside a function, you need to make sure to make it global using global() or use the session
arrays as noted below.
|
This function returns TRUE when all of the variables are successfully
registered with the session.
If session_start() was not called before
this function is called, an implicit call to
session_start() with no parameters will be made.
You can also create a session variable by simply setting the appropriate member of the
$HTTP_SESSION_VARS or $_SESSION (PHP >= 4.1.0) array.
$barney = "A big purple dinosaur.";
session_register("barney");
$HTTP_SESSION_VARS["zim"] = "An invader from another planet.";
# the auto-global $_SESSION array was introduced in PHP 4.1.0
$_SESSION["spongebob"] = "He's got square pants.";
|
Note: It is not currently possible to register resource variables in a session. For
example, you can not create a connection to a database and store the connection id as a session
variable and expect the connection to still be valid the next time the session is restored. PHP
functions that return a resource are identified by having a return type of resource in
their function definitions. A list of functions that return resources are available in the resource types appendix.
If $_SESSION (or $HTTP_SESSION_VARS for PHP 4.0.6 or less) is used, assign variable to
$_SESSION. i.e. $_SESSION['var'] = 'ABC';
See also session_is_registered()
and session_unregister().
|
