mitmario.dev

Sitzungen

PHP Sandbox 4 Min Lesezeit 3 BeispieleLektion 3 von 6

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

Ein Wert, der die Anfrage überlebt
<?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

Wo die Sitzung wirklich liegt
<?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

Die Sitzung beenden
<?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, kostenlos

Zu 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.