session_register

(PHP 4 )

session_register --  Registriert eine oder mehrere Variablen in der aktuellen Session

Beschreibung

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

session_register() akzeptiert eine variable Anzahl von Argumenten, die jeweils entweder eine Zeichenkette sein können, die den Namen einer Variablen trägt, oder ein Array, das aus solchen Variablennamen oder anderen Arrays besteht. Für jeden Namen registriert session_register() die globale Variable mit diesem Namen in der aktuellen Session.

Achtung

Diese Funktion registriert eine globale Variable. Wenn Sie eine Session-Variable innerhalb einer Funktion registrieren wollen, müssen Sie sicherstellen, dass Sie sie mittels global() global machen oder Sie verwenden die nachstehend vermerkten Session-Arrays.

Achtung

Wenn Sie $HTTP_SESSION_VARS/$_SESSION verwenden, sollten Sie session_register(), session_is_registered() und session_unregister() nicht verwenden.

Diese Funktion gibt TRUE zurück, wenn alle Variablen erfolgreich in der Session registriert wurden.

Wenn session_start() nicht vor dieser Funktion aufgerufen wurde, erfolgt ein impliziter Aufruf von session_start() ohne Parameter.

Sie können eine Session-Variable auch erzeugen, indem Sie das entsprechende Element des $HTTP_SESSION_VARS- oder (PHP >= 4.1.0) $_SESSION-Arrays setzen.

$barney = "A big purple dinosaur.";
session_register("barney");

$HTTP_SESSION_VARS["zim"] = "An invader from another planet.";

# Das auto-global $_SESSION-Array wurde mit PHP 4.1.0 eingeführt
$_SESSION["spongebob"] = "He's got square pants.";

Anmerkung: Gegenwärtig ist es nicht möglich, Ressourcen-Variablen in einer Session zu registrieren. Zum Beispiel können Sie nicht erwarten, dass die als Session-Variable gespeicherte Verbindungs-Kennung der zu einer Datenbank aufgebauten Verbindung bei der nächsten Wiederherstellung der Session noch gültig ist. PHP-Funktionen, die eine Ressource zurückgeben, können daran erkannt werden, dass sie einen Rückgabewert resource in ihrer Funktionsdefinition haben. Eine Liste der Funktionen, die Ressourcen zurückgeben befindet sich im Anhang Liste von PHP Ressourcen.

Bei Verwendung von $_SESSION (oder $HTTP_SESSION_VARS bei PHP 4.0.6 oder niedriger) weisen Sie $_SESSION eine Variable zu, also $_SESSION['var'] = 'ABC';

Siehe auch: session_is_registered() und session_unregister().