Sessionen

HTTP ist ein zustandsloses Protokoll, aber fast jede Anwendung muss zwischen den Anfragen einen Zustand beibehalten, z. B. den Inhalt eines Warenkorbs. Hierfür wird eine Session verwendet. Schauen wir mal

  • wie man Sessions verwendet
  • wie man Benennungskonflikte vermeiden kann
  • wie man eine Ablaufzeit festlegt

Bei der Verwendung von Sessionen erhält jeder Benutzer eine eindeutige Kennung, die sogenannte Sessions-ID, die in einem Cookie übergeben wird. Dieser dient als Schlüssel zu den Sessionsdaten. Im Gegensatz zu Cookies, die auf der Browserseite gespeichert werden, werden Sessionsdaten auf der Serverseite gespeichert.

Wir konfigurieren die Session in der Konfiguration, die Wahl der Ablaufzeit ist wichtig.

Die Session wird durch das Nette\Http\Session Objekt verwaltet, das Sie durch Übergabe mittels Dependency Injection erhalten. In Presentern rufen Sie einfach $session = $this->getSession() auf.

Installation und Anforderungen

Session starten

Standardmäßig startet Nette eine Session automatisch, sobald wir beginnen, Daten aus ihr zu lesen oder in sie zu schreiben. Um eine Session manuell zu starten, verwenden Sie $session->start().

PHP sendet beim Starten der Session HTTP-Header, die die Zwischenspeicherung beeinflussen, siehe session_cache_limiter, und möglicherweise ein Cookie mit der Sessions-ID. Daher ist es immer notwendig, die Session zu starten, bevor irgendeine Ausgabe an den Browser gesendet wird, da sonst eine Ausnahme ausgelöst wird. Wenn Sie also wissen, dass eine Session während des Renderns der Seite verwendet wird, starten Sie sie vorher manuell, zum Beispiel im Präsentator.

Im Entwicklermodus startet Tracy die Session, weil es sie zur Anzeige von Umleitungs- und AJAX-Anforderungsleisten in der Tracy-Leiste verwendet.

Abschnitt

In reinem PHP ist der Sessionsdatenspeicher als Array implementiert, das über eine globale Variable $_SESSION zugänglich ist. Das Problem ist, dass Anwendungen normalerweise aus einer Reihe unabhängiger Teile bestehen, und wenn alle nur ein einziges Array zur Verfügung haben, kommt es früher oder später zu einer Namenskollision.

Nette Framework löst das Problem, indem es den gesamten Raum in Abschnitte (Objekte Nette\Http\SessionSection) unterteilt. Jede Einheit verwendet dann ihren eigenen Abschnitt mit einem eindeutigen Namen, so dass keine Kollisionen auftreten können.

Wir erhalten den Abschnitt vom Sessionsmanager:

$section = $session->getSection('unique name');

Im Präsentator genügt es, getSession() mit dem Parameter aufzurufen:

// $this ist Presenter
$section = $this->getSession('eindeutiger Name');

Das Vorhandensein des Abschnitts kann mit der Methode $session->hasSection('unique name') überprüft werden.

Der Abschnitt selbst ist mit den Methoden set(), get() und remove() sehr einfach zu bearbeiten:

// Schreiben von Variablen
$section->set('benutzername', 'franta');

// Lesen einer Variable, gibt null zurück, wenn sie nicht existiert
echo $section->get('benutzername');

// Entfernen von Variablen
$section->remove('benutzername');

Es ist möglich, den Zyklus foreach zu verwenden, um alle Variablen von section zu erhalten:

foreach ($section as $key => $val) {
	echo "$key = $val";
}

Wie man den Verfall einstellt

Die Gültigkeitsdauer kann für einzelne Bereiche oder sogar einzelne Variablen festgelegt werden. Wir können die Anmeldung des Benutzers in 20 Minuten ablaufen lassen, aber den Inhalt eines Warenkorbs trotzdem speichern.

// Der Abschnitt läuft nach 20 Minuten ab
$section->setExpiration('20 minutes');

Der dritte Parameter der Methode set() wird verwendet, um das Verfallsdatum für einzelne Variablen festzulegen:

// Die Variable "flash" läuft nach 30 Sekunden ab
$section->set('flash', $message, '30 seconds');

Beachten Sie, dass die Verfallszeit der gesamten Session (siehe Sessionskonfiguration) gleich oder höher sein muss als die für einzelne Abschnitte oder Variablen eingestellte Zeit.

Die Aufhebung des zuvor eingestellten Verfalls kann mit der Methode removeExpiration() erreicht werden. Die sofortige Löschung des gesamten Abschnitts wird durch die Methode remove() gewährleistet.

Ereignisse $onStart, $onBeforeWrite

Das Objekt Nette\Http\Session hat die Ereignisse $onStart und $onBeforeWrite, so dass Sie Rückrufe hinzufügen können, die nach dem Start der Session oder vor dem Schreiben auf die Festplatte und dem anschließenden Beenden der Session aufgerufen werden.

$session->onBeforeWrite[] = function () {
	// Daten in die Session schreiben
	$this->section->set('basket', $this->basket);
};

Sessionsverwaltung

Überblick über die Methoden der Klasse Nette\Http\Session zur Sessionsverwaltung:

start(): void

Startet eine Session.

isStarted(): bool

Ist die Session gestartet?

close(): void

Beendet die Session. Die Session wird automatisch am Ende des Skripts beendet.

destroy(): void

Beendet und löscht die Session.

exists(): bool

Enthält die HTTP-Anfrage ein Cookie mit einer Sessions-ID?

regenerateId(): void

Erzeugt eine neue zufällige Sessions-ID. Die Daten bleiben unverändert.

getId(): string

Gibt die Sessions-ID zurück.

Konfiguration

Wir konfigurieren die Session in der Konfiguration. Wenn Sie eine Anwendung schreiben, die keinen DI-Container verwendet, verwenden Sie diese Methoden, um sie zu konfigurieren. Sie müssen vor dem Start der Session aufgerufen werden.

setName (string $name): static

Legt den Namen des Cookies fest, der zur Übertragung der Sessions-ID verwendet wird. Der Standardname ist PHPSESSID. Dies ist nützlich, wenn Sie mehrere verschiedene Anwendungen auf derselben Website ausführen.

getName(): string

Gibt den Namen des Session-Cookies zurück.

setOptions (array $options)static

Konfiguriert die Session. Es ist möglich, alle PHP-Session-Direktiven zu setzen (im camelCase-Format, z.B. savePath statt session.save_path zu schreiben) und auch readAndClose.

setExpiration (?string $time)static

Legt die Zeit der Inaktivität fest, nach der die Session abläuft.

setCookieParameters (string $path, ?string $domain=null, ?bool $secure=null, ?string $samesite=null)static

Legt Parameter für Cookies fest. Sie können die Standardparameterwerte in configuration ändern.

setSavePath (string $path)static

Legt das Verzeichnis fest, in dem Sessionsdateien gespeichert werden.

setHandler (\SessionHandlerInterface $handler)static

Legt einen eigenen Handler fest, siehe PHP-Dokumentation.

Sicherheit zuerst

Der Server geht davon aus, dass er mit demselben Benutzer kommuniziert, solange die Anfragen dieselbe Sessionskennung enthalten. Die Aufgabe von Sicherheitsmechanismen ist es, sicherzustellen, dass dieses Verhalten auch wirklich funktioniert und dass es keine Möglichkeit gibt, eine Kennung zu ersetzen oder zu stehlen.

Aus diesem Grund konfiguriert Nette Framework die PHP-Direktiven so, dass die Sessions-ID nur in Cookies übertragen wird, der Zugriff von JavaScript vermieden wird und die Identifikatoren in der URL ignoriert werden. Außerdem wird in kritischen Momenten, z. B. bei der Anmeldung eines Benutzers, eine neue Sessions-ID generiert.

Die Funktion ini_set wird für die Konfiguration von PHP verwendet, aber leider ist ihre Verwendung bei einigen Webhosting-Diensten verboten. Wenn dies bei Ihnen der Fall ist, versuchen Sie, Ihren Hosting-Anbieter zu bitten, diese Funktion für Sie zuzulassen oder zumindest seinen Server richtig zu konfigurieren.

Version: 4.0