Function.session-set-save-handler

Aus PHP-Wiki

session_set_save_handler — Setzt benutzerdefinierte Session-Speicherfunktionen

Beschreibung

bool session_set_save_handler (callback  $öffnen ,callback  $schließen ,callback  $lesen ,callback  $schreiben ,callback  $löschen ,callback  $gc )

session_set_save_handler() setzt die benutzerdefinierten Session-Speicherfunktionen, die zur Speicherung und Wiederherstellung von zur Session gehörigen Daten verwendet werden. Dies ist äußerst nützlich, wenn eine andere als die mit PHP-Sessions zur Verfügung stehende Art der Speicherung, z.B. die Speicherung der Session-Daten in einer lokalen Datenbank, bevorzugt wird.

Parameter-Liste

öffnen

• Die öffnen-Routine funktionert wie ein Konstruktor in einer Klasse und wird ausgeführt, wenn die Session geöffnet wird. Sie erwartet zwei Parameter: als Ersten den Speicherpfad und als Zweiten den Namen der Session.

schließen

• Die schließen-Routine funktionert wie ein Destruktor in einer Klasse und wird am Ende der Session ausgeführt.

lesen

• Damit die Speicherroutine funktioniert wie erwartet, muss die lesen-Routine immer eine Zeichenkette zurückgeben. Wenn es keine Daten zu lesen gibt, geben Sie eine leere Zeichenkette zurück. Rückgabewerte anderer Routinen werden in boolesche Ausdrücke umgewandelt. TRUE für einen Erfolg, FALSE für einen Fehler.

schreiben

• Hinweis: Die schreiben-Routine wird nicht ausgeführt, bevor die Ausgabe abgeschlossen ist. Deshalb werden auch niemals Fehlermeldungen der schreiben-Routine im Browser erscheinen. Wenn die Ausgabe von Fehlermeldungen nötig ist, sollte diese stattdessen in eine Datei geschrieben werden.
  

löschen

• Die löschen-Routine wird ausgeführt, wenn eine Session mittels session_destroy() gelöscht wird. Sie erwartet die Session-ID als einzigen Parameter.

gc

• Der Speicherbereiniger (garbage collector) wird ausgeführt, wenn der Session-Speicherbereiniger ausgeführt wird. Er erwartet die maximale Session-Verfallszeit als einzigen Parameter.

Rückgabewerte

Gibt bei Erfolg TRUE zurück, im Fehlerfall FALSE.

Beispiele

=== #1 session_set_save_handler() Beispiel

     Das folgende Beispiel liefert eine dateibasierte Session===
 
 
 
 
 
 
 
 
 
 
==Anmerkungen==
 
 
  Warnung
 
    Ab PHP 5.0.5 werden die Routinen ''schreiben''
 und
    ''schließen''
 nach dem Zerstören von Objekten
    aufgerufen und können deshalb keine Objekte verwenden oder Exceptions
    (Fehler-, Ausnahmesituationen) auslösen. Objekt-Destruktoren können
    aber Sessions verwenden.
 
 
    Es ist möglich, [[function.session-write-close|session_write_close()]] über den
    Destruktor aufzurufen, um dieses Henne-Ei Problem zu lösen.
 
 
  Warnung
 
    Bei manchen SAPIs ändert sich das aktuelle Arbeitsverzeichnis, falls die
    Session durch die Beendigung des Skripts geschlossen wird. Mittels
    [[function.session-write-close|session_write_close()]] ist es möglich, die Session schon
    früher zu schließen.
 
 
 
 
 
 
 
==Siehe auch==
 
 
 
 
 
     Die [[session.configuration.php#ini.session.save-handler|session.save_handler]]
     Konfigurationsanweisung
 
 
 
 
 
 
 
 
[[Kategorie:PHP 4|S]]
[[Kategorie:PHP 5|S]]
[[Kategorie:Session-Funktionen|S]]