PHP Manual
Prev |  | Next

# session_register

(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.

See also session_is_registered() and session_unregister().

Prev | Home | Next
session_id | Up | session_unregister