Abschnitt 12 · Lektion 3
Sitzungen
Ein Cookie kann der Besucher ändern. Eine Datei auf deinem Server nicht. Deshalb legt eine Sitzung ihre Daten in so eine Datei und gibt dem Besucher nur eine Kennung mit.
Zwei Zeilen, und der Wert bleibt
<?php
declare(strict_types=1);
// Ein abgeschickter Name bleibt auf allen drei verlinkten Seiten
// stehen, obwohl jede dieser Seiten ein eigener Lauf deines
// Programms ist.
session_start();
if (isset($_GET["name"]) && $_GET["name"] !== "") {
$_SESSION["name"] = $_GET["name"];
}
$name = $_SESSION["name"] ?? null;
?>
<!doctype html>
<html lang="de">
<head>
<meta charset="utf-8">
<title>Sitzung</title>
</head>
<body>
<h1><?= $name === null ? "Wir kennen uns noch nicht" : "Hallo, " . htmlspecialchars($name, ENT_QUOTES, "UTF-8") ?></h1>
<form method="get" action="/">
<p><label>Dein Name: <input type="text" name="name"></label></p>
<button type="submit">Merken</button>
</form>
<p>
<a href="/">Start</a> ·
<a href="/preise">Preise</a> ·
<a href="/kontakt">Kontakt</a>
</p>
</body>
</html> session_start() am Anfang, danach ist $_SESSION ein ganz gewöhnliches Array. Du legst etwas
hinein, und beim nächsten Aufruf ist es noch da. Mehr ist es aus deiner Sicht nicht.
Schickst du im ersten Beispiel einmal einen Namen ab, steht er auf jeder der drei verlinkten Seiten. Dabei ist jede ein eigener Lauf deines Programms, mit eigenen Variablen, die es vorher nicht gab.
Was dabei wirklich passiert
<?php
declare(strict_types=1);
// Eine Sitzung ist am Ende nur eine Datei. Diese Seite legt zwei
// Werte hinein und liest die Datei danach im Klartext vor.
//
// session_write_close() schreibt sie sofort, statt bis zum Ende des
// Programms zu warten. Nur deshalb steht unten schon etwas drin.
session_start();
$_SESSION["name"] = "Mia";
$_SESSION["korb"] = ["Kaffee", "Filter"];
$kennung = session_id();
// Ohne eigene Angabe legt PHP die Dateien in das Verzeichnis fuer
// Temporaeres, unter Linux also nach /tmp.
$ordner = session_save_path() !== "" ? session_save_path() : sys_get_temp_dir();
$datei = $ordner . "/sess_" . $kennung;
session_write_close();
?>
<!doctype html>
<html lang="de">
<head>
<meta charset="utf-8">
<title>Die Sitzungsdatei</title>
<style>
body { font-family: system-ui, sans-serif; }
pre { background: #eee; padding: .6rem; overflow-x: auto; }
</style>
</head>
<body>
<h1>Deine Sitzung auf der Platte</h1>
<p>Kennung: <code><?= htmlspecialchars($kennung, ENT_QUOTES, "UTF-8") ?></code></p>
<p>Datei: <code><?= htmlspecialchars($datei, ENT_QUOTES, "UTF-8") ?></code></p>
<pre><?= htmlspecialchars(is_readable($datei) ? file_get_contents($datei) : "nicht lesbar", ENT_QUOTES, "UTF-8") ?></pre>
<p>Der Browser kennt davon nur die Kennung ganz oben.</p>
</body>
</html> session_start() tut zwei Dinge auf einmal, und beide sind einfach.
Erstens sucht es nach einer Kennung. Hat der Browser eine mitgeschickt, nimmt PHP sie. Hier nimmt es
sogar eine ausgedachte, die es nie vergeben hat, denn session.use_strict_mode ist aus. Was dieser
Schalter ändert, steht in der Lektion über die Anmeldung. Hat der Browser keine Kennung, würfelt PHP
eine neue aus und schickt sie als Cookie zurück, unter dem Namen PHPSESSID. Mehr als diesen
langen, zufälligen Text bekommt der Besucher nie zu sehen.
Nach dem ersten Set-Cookie kommt kein neues mehr, und der Browser schickt die Kennung bei jeder
Anfrage als cookie: PHPSESSID=… mit. Außerdem schickt session_start() bei jeder Antwort drei
Zeilen mit, die dem Browser das Zwischenspeichern der Seite verbieten, nämlich Cache-Control,
Pragma und Expires mit einem Datum von 1981. Eine Seite, die zu einer Sitzung gehört, soll er
jedes Mal frisch holen.
Zweitens sucht PHP die Datei, die zu dieser Kennung gehört, liest sie und legt den Inhalt in
$_SESSION. Am Ende deines Programms schreibt es sie zurück. Im zweiten Beispiel steht der Inhalt
dieser Datei auf der Seite, im Klartext, mit dem Namen Mia und dem Warenkorb aus Kaffee und Filter
darin. Sie liegt auf der Platte deines Servers, und dorthin kommt der Besucher nicht. Das Terminal
läuft dagegen auf derselben Maschine wie der Server. Dort zeigt ls -la /tmp/sess_* die Datei und
cat /tmp/sess_* ihren Inhalt, Zeichen für Zeichen das, was auch auf der Seite steht. Stehen dort
mehrere Dateien, sind das die Sitzungen, die auf dieser Maschine vorher schon angefangen haben.
An das Cookie mit der Kennung hängt PHP von sich aus kein httponly, obwohl gerade dort die
Kennung steht, um die es einem Angreifer geht. In der Prüfliste der Aufgabe siehst du das unter der
Prüfung zur Kennung. Dort steht nur PHPSESSID=…; path=/. Auf einem echten Server schaltet man das
ein, entweder in der php.ini mit session.cookie_httponly = 1 und session.cookie_samesite = Lax
oder mit session_set_cookie_params() vor dem session_start(). In Abschnitt 15 kommt das noch
einmal.
In einer Sitzung darf liegen, was in einem Cookie nichts zu suchen hat. Der Besucher kann seine Kennung natürlich ändern. Nur landet er damit bei einer anderen Datei oder bei gar keiner und nicht bei einer Datei mit dem Inhalt, den er gerne hätte.
Warum die Zeile ganz oben stehen muss
session_start() schickt Kopfzeilen hinaus, allen voran das Cookie mit der Kennung. Damit gilt
dieselbe Regel wie bei header() in Lektion 10.4 und bei setcookie(). Sobald das erste Zeichen
deiner Seite unterwegs ist, sind die Kopfzeilen weg. PHP meldet dann
session_start(): Session cannot be started after headers have already been sent, in diesem Kurs
mitten auf der Seite und im Protokoll. Eine Sitzung entsteht dabei gar nicht. Der Browser bekommt
keine Kennung, auf dem Server liegt keine Datei, und was du in $_SESSION schreibst, ist nach dem
Lauf vergessen.
Die Zeile gehört vor jedes echo, vor jedes Leerzeichen und vor jeden schließenden PHP-Tag. Aus
demselben Grund bekommt eine reine PHP-Datei am Ende kein ?>. Ein Leerzeichen oder eine Leerzeile
hinter dem schließenden PHP-Tag wäre schon Ausgabe, das kennst du aus Lektion 1.3.
Dass die Meldung hier sofort kommt, liegt am Ausgabepuffer, der auf dem Server dieses Kurses aus ist
(output_buffering = 0). Die php.ini-Vorlagen, die PHP mitbringt, setzen
output_buffering = 4096, und dann geht ein spätes session_start() still durch, solange davor
weniger als 4096 Bytes ausgegeben sind.
Wie eine Sitzung endet
<?php
declare(strict_types=1);
// Jeder Aufruf zaehlt hoch, und der Link zum Beenden raeumt auf. Nach
// dem Aufraeumen faengt der Zaehler wieder bei eins an, und in der
// Adresszeile aendert sich nichts.
session_start();
if (isset($_GET["ende"])) {
// Drei Schritte, und alle drei gehoeren dazu.
$_SESSION = [];
setcookie(session_name(), "", ["expires" => time() - 3600, "path" => "/"]);
session_destroy();
header("Location: /", true, 302);
exit;
}
$_SESSION["stand"] = ($_SESSION["stand"] ?? 0) + 1;
?>
<!doctype html>
<html lang="de">
<head>
<meta charset="utf-8">
<title>Aufräumen</title>
</head>
<body>
<h1>Stand: <?= $_SESSION["stand"] ?></h1>
<p>
<a href="/">Weiterzählen</a> ·
<a href="/?ende=1">Sitzung beenden</a>
</p>
</body>
</html> Eine Sitzung endet auf drei Wegen.
Von selbst, wenn eine Weile nichts passiert. Dann räumt PHP die Datei irgendwann weg, der Standardwert dafür liegt bei 24 Minuten.
Wenn der Browser zugeht. Das Cookie mit der Kennung hat keine Laufzeit, und ist der Browser zu, ist es weg. Der Besucher findet seine Sitzung dann nicht mehr, auch wenn die Datei noch eine Weile daliegt.
Und wenn dein Programm es sagt, in drei Schritten. $_SESSION = [] leert die Daten im laufenden
Programm, setcookie() mit einem Zeitpunkt in der Vergangenheit nimmt dem Browser die Kennung
wieder ab, und session_destroy() löscht die Datei. Rufst du nur session_destroy() auf, bleibt
dem Besucher eine Kennung, die auf nichts mehr zeigt. Das ist meistens harmlos und manchmal der
Fehler, den man sucht.
Im Beispiel zum Beenden stehen alle drei Schritte nebeneinander. Der Link „Sitzung beenden“ holt
/?ende=1, und die Antwort ist eine 302 mit Location: / und Set-Cookie: PHPSESSID=deleted samt
einem Ablaufdatum im Jahr 1970. Danach holt der Browser / und bekommt eine frische Kennung. In der
Adresszeile steht wieder /, als wäre nichts gewesen. Den Umweg siehst du nur im Reiter Netzwerk.
Der Einkaufszettel in der Aufgabe ist nach jedem Klick wieder leer, bis er in die Sitzung kommt.
Zum Mitnehmen
Bei einer Sitzung bekommt der Browser nur eine Kennung, alles andere liegt in einer Datei auf dem Server. session_start schickt diese Kennung als Kopfzeile und steht deshalb vor der ersten Ausgabe, und wer eine Sitzung beendet, leert sie, nimmt dem Browser das Cookie ab und löscht die Datei.
Jetzt du
Basis Konto, kostenlosZu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.
Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.
In diesem Kurs läuft dein Code auf einem Server. Dafür hat das Basis Konto 1 Stunde im Monat, mehr Zeit gibt es mit dem Premium Konto.
Was in dieser Lektion steckt
-
Artikel mit 3 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe, dein Code läuft auf einem Server
Öffnet sich mit dem Basis Konto.