PHP Handbuch
Zurück |  | Nach vorne

# XC. Session Funktionen

Die Unterstützung von Sessions in PHP bietet die Möglichkeit, bestimmte Daten während einer Folge von Aufrufen ihrer Website festzuhalten. Damit können Sie persönlichere Applikationen erstellen und Ihre Website ansprechender gestalten.

Falls sie mit dem Sessionmanagment von PHPLIB vertraut sind, werden sie Ähnlichkeiten zu PHP's Session-Unterstützung feststellen.

Einem Besucher wird beim Aufruf ihrer Website eine einzigartige ID, die sogenannte Session-ID, zugeordnet. Diese wird entweder benutzerseitig in einem Cookie abgelegt oder in der URL übermittelt.

Die Unterstützung von Sessions erlaubt Ihnen, eine beliebige Anzahl von Variablen zu registrieren und diese über Anfragen hinweg zu erhalten. Wenn ein Besucher Ihre Website aufruft, überprüft PHP automatisch (falls session.auto_start auf 1 gesetzt ist) oder auf Anfrage (explizit durch session_start() oder implizit durch session_register()), ob mit der Anfrage schon eine bestimmte Session-ID gesendet wurde. Wenn dies der Fall ist, wird die zuvor gespeicherte Umgebung wiederhergestellt.

Alle registrierten Variablen werden serialisiert, nachdem die Anfrage beendet ist. Registrierte Variablen, die nicht definiert sind, werden als nicht definiert gekennzeichnet. Auch bei darauffolgenden Zugriffen werden sie nicht vom Session-Modul definiert, außer der Benutzer definiert sie später.

Die Konfigurationseinstellungen von `track_vars` und `register_globals` beeinflussen, wie die Session-Variablen gespeichert und wiederhergestellt werden.

> Anmerkung: Seit PHP 4.0.3 ist `track_vars` immer aktiviert.

Falls `track_vars` aktiviert und `register_globals` deaktiviert ist, können nur Bestandteile des globalen assoziativen Arrays $HTTP_SESSION_VARS als Session-Variablen registriert werden. Wiederhergestellte Session-Variablen stehen nur im Array $HTTP_SESSION_VARS zur Verfügung.

Beispiel 1. Registrierung einer Variablen bei aktiviertem `track_vars`
    <?php
    session_register("count");
    $HTTP_SESSION_VARS["count"]++;
    ?>

Wenn `register_globals` aktiviert ist, können alle globalen Variablen als Session-Variablen registriert werden und die Session-Variablen werden als entsprechende globale Variablen wiederhergestellt.

Beispiel 2. Registrierung einer Variablen bei aktiviertem `register_globals`
    <?php
    session_register("count");
    $count++;
    ?>

Wenn sowohl `track_vars` als auch `register_globals` aktiviert sind, dann referenzieren die globalen Variablen und die Einträge von $HTTP_SESSION_VARS den selben Wert.

Es gibt zwei Methoden, eine Session-ID zu übermitteln:

- Cookies

- URL Parameter

Das Session-Modul unterstützt beide Methoden. Cookies sind optimal, aber da sie nicht zuverlässig sind (Clients müssen sie nicht unbedingt akzeptieren), können wir uns nicht auf sie verlassen. Die zweite Methode hängt die Session-ID direkt an die URLs.

Wenn PHP mit `--enable-trans-sid` kompiliert wurde, kann es dies transparent machen. Wenn Sie diese Option aktivieren, werden relative URIs automatisch geändert, sodass sie die Session-ID enthalten. Alternativ können sie die Konstante `SID` verwenden, die definiert wird, falls vom Client keinen passendes Cookie gesendet wurde. `SID` hat entweder die Form `session_name=session_id` oder ist eine leere Zeichenkette.

Das folgende Beispiel demonstriert, wie eine Variable registriert wird und wie unter Verwendung einer SID korrekt auf eine andere Seite verwiesen wird.

Beispiel 3. Zählen der Seitenaufrufe eines einzelnen Benutzers
    <?php
    session_register ("count");
    $count++;
    ?>

    Hallo Besucher, Sie haben diese Seite <?php echo $count; ?> Mal
    aufgerufen.<p>

    <?php
    # für den Fall, dass der Benutzer Cookies deaktiviert hat,
    # ist das <?=SID?> nötig, um die Session-ID zu erhalten
    ?>

    Hier gehts <A HREF="nextpage.php?<?=SID?>">weiter</A>

Das `<?=SID?>` ist nicht nötig, wenn PHP mit `--enable-trans-sid` kompiliert wurde.

> Anmerkung: Bei nichtrelativen URLs wird davon ausgegangen, dass sie auf externe Seiten zeigen und, weil es ein Sicherheitsrisiko wäre, die SID an einen anderen Server zu übermitteln, von daher keine SID angehängt.

Wenn Sie die Speicherung in einer Datenbank oder irgendeine andere Art der Speicherung realisieren wollen, müssen Sie session_set_save_handler() verwenden, um eine Reihe von benutzerdefinierten Speicherfunktionen zu erzeugen.

Das Sessionmanagementsystem unterstützt eine Anzahl von Konfigurationsoptionen, die sie in Ihrer php.ini setzen können. Wir geben Ihnen dazu einen kleinen Überblick.

- `session.save_handler` definiert den Namen der Prozedur, die benutzt wird, um die Daten zu speichern und zurückzuholen, die mit der Session in Verbindung stehen. Grundeinstellung `files`.

- `session.save_path` definiert das Argument, das an die Speicherprozedur übergeben wird. Wenn Sie die standardmäßige files Prozedur wählen, ist das der Pfad, unter dem die Dateien erzeugt werden. Grundeinstellung `/tmp`.

  Warnung
  Wenn Sie ein Verzeichnis gewählt haben, für das jeder Leserechte hat, wie das z.B. bei /tmp (Grundeinstellung) der Fall ist, könnten andere Serverbenutzer mit Hilfe der Dateiliste dieses Verzeichnisses Ihre Sessions entführen.

- `session.name` spezifiziert den Namen der Session, der als Cookie-Name verwendet wird. Grundeinstellung `PHPSESSID`.

- `session.auto_start` spezifiziert, ob das Session-Modul zu Beginn einer Anfrage automatisch eine Session startet. Grundeinstellung `0` (deaktiviert).

- `session.cookie_lifetime` spezifiziert die Cookie-Lebensdauer, die an den Browser geschickt wird, in Sekunden. Der Wert 0 bedeutet "bis der Browser geschlossen wird." Grundeinstellung `0`.

- `session.serialize_handler` definiert den Namen der Prozedur, die benutzt wird, um Daten zu serialisieren/deserialisieren. Gegenwärtig wird ein internes PHP-Format (Name `php`) und WDDX (name `wddx`) unterstützt. WDDX steht nur zur Verfügung, wenn PHP mit WDDX support kompiliert wurde. Grundeinstellung `php`.

- `session.gc_probability` spezifiziert die prozentuale Wahrscheinlichkeit, dass die gc (garbage collection) Routine bei jeder Anfrage gestartet wird. Grundeinstellung `1`.

- `session.gc_maxlifetime` spezifiziert die Anzahl der Sekunden, nach denen Daten als 'garbage' ('Müll') betrachtet und entsorgt werden.

- `session.referer_check` enthält die Zeichenkette, auf die Sie jeden HTTP-Referer überprüfen wollen. Wenn der Referer vom Client gesendet und die Zeichenkette nicht gefunden wurde, wird die eingebettete Session-ID als ungültig gekennzeichnet. Grundeinstellung ist eine leere Zeichenkette.

- `session.entropy_file` gibt den Pfad zu einer externen Quelle (Datei) an, die bei der Erzeugung einer Session-ID als zusätzliche Entropiequelle verwendet wird. Beispiele sind `/dev/random` oder `/dev/urandom`, die auf vielen Unix-Systemen zur Verfügung stehen.

- `session.entropy_length` spezifiziert die Anzahl der Bytes, die von der oben spezifizierten Datei gelesen werden. Grundeinstellung `0` (deaktiviert).

- `session.use_cookies` spezifiziert, ob das Modul Cookies verwendet, um die Session-ID clientseitig zu speichern. Grundeinstellung `1` (aktiviert).

- `session.cookie_path` spezifiziert den Pfad, in dem das Session-Cookie gesetzt wird. Grundeinstellung `/`.

- `session.cookie_domain` spezifiziert die Domain, unter der das Session-Cookie gesetzt wird. In der Grundeinstellung überhaupt keine.

- `session.cache_limiter` spezifiziert die Methode der Cacheverwaltung, die bei Session-Seiten benutzt wird (nocache/private/private_no_expire/public). Grundeinstellung `nocache`.

- `session.cache_expire` spezifiziert in Minuten, wie lange Session-Seiten im Cache bleiben. Bei nocache ist diese Angabe wirkungslos. Grundeinstellung `180`.

- `session.use_trans_sid` bestimmt, wenn mit `--enable-trans-sid` kompiliert wurde, ob transparente SID-Unterstützung aktiviert ist oder nicht. Grundeinstellung `1` (aktiviert).

- `url_rewriter.tags` bestimmt, wenn Unterstützung für transparente SID aktiviert ist, welche HTML-Tags so umgeschrieben werden, dass sie die Session-ID beinhalten. Grundeinstellung `a=href,area=href,frame=src,input=src,form=fakeentry`

> Anmerkung: Die Behandlung von Sessions wurde in PHP 4.0 eingeführt.

Zurück | Zum Anfang | Nach vorne
sesam_free_result | Nach oben | session_start