mitmario.dev

Cookies

PHP Sandbox 4 Min Lesezeit 3 BeispieleLektion 2 von 6

Beim zweiten Aufruf soll eine Seite ihren Besucher wiedererkennen. In der Hand hat sie dafür nur seine Anfrage. Steht darin nichts, was der Server ihm vorher mitgegeben hat, ist jeder Besuch der erste.

Hin und zurück

Ein Cookie setzen und wiedererkennen
<?php

declare(strict_types=1);

// Diese Seite legt beim ersten Aufruf ein Cookie an und erkennt dich
// beim naechsten daran wieder.
//
// Wichtig ist die Reihenfolge: $_COOKIE ist das, was der Browser
// MITGESCHICKT hat. setcookie() bittet ihn um etwas fuer BEIM
// NAECHSTEN MAL. Deshalb steht beim ersten Aufruf noch nichts drin.

$schonDa = isset($_COOKIE["besuch"]);

setcookie("besuch", "1", ["path" => "/", "httponly" => true, "samesite" => "Lax"]);

?>
<!doctype html>
<html lang="de">
<head>
    <meta charset="utf-8">
    <title>Wiedererkennen</title>
</head>
<body>
    <h1><?= $schonDa ? "Wir kennen uns schon" : "Guten Tag, das erste Mal hier?" ?></h1>

    <p>Der Browser hat mitgeschickt:
        <code><?= htmlspecialchars($_SERVER["HTTP_COOKIE"] ?? "(nichts)", ENT_QUOTES, "UTF-8") ?></code></p>

    <p><a href="/">Noch einmal aufrufen</a></p>
</body>
</html>

Ein Cookie ist ein Name mit einem Wert. Du schickst ihn mit setcookie() an den Browser, der Browser legt ihn ab, und ab da hängt er ihn an jede weitere Anfrage an deine Seite. Du liest ihn mit $_COOKIE["name"], so wie in Abschnitt 11 $_POST.

In $_COOKIE steht, was der Browser bei dieser Anfrage mitgeschickt hat. setcookie() bittet ihn dagegen um etwas für die nächste. Beide haben mit demselben Cookie zu tun und meinen doch zwei verschiedene Zeitpunkte.

Ein gerade gesetztes Cookie steht im selben Lauf noch nicht in $_COOKIE. Setzt du es und fragst direkt darunter danach, bekommst du nichts und suchst den Fehler an der falschen Stelle. Im Beispiel siehst du es an der Überschrift. Beim ersten Aufruf steht dort die Frage, beim zweiten der Satz, der dich wiedererkennt. Im Reiter Netzwerk steht bei der ersten Anfrage Set-Cookie: besuch=1 unter den Antwort-Kopfzeilen, mit ein paar Angaben mehr, als im Code stehen. Bei der zweiten steht cookie: besuch=1 unter den Anfrage-Kopfzeilen.

setcookie() schreibt eine Kopfzeile. Der Aufruf muss also hinaus, bevor das erste Zeichen der Seite unterwegs ist, wie bei header() in Lektion 10.4.

Die vier Angaben, die heute dazugehören

Was wirklich hinausgeht
<?php

declare(strict_types=1);

// Vier Cookies mit vier verschiedenen Angaben, und darunter die
// Kopfzeilen, die dein Code daraus gemacht hat. So sieht ein Cookie
// aus, wenn es die Leitung entlanggeht.

setcookie("nackt", "1");

setcookie("mitpfad", "2", ["path" => "/"]);

setcookie("gesichert", "3", [
    "path" => "/",
    "secure" => true,
    "httponly" => true,
    "samesite" => "Lax",
]);

setcookie("mitablauf", "4", [
    "expires" => time() + 60 * 60 * 24 * 7,
    "path" => "/",
]);

// Die Liste wird HIER gelesen, vor dem ersten Zeichen der Seite. Sobald
// die Seite anfaengt, sind die Kopfzeilen verschickt.
$gesetzt = array_filter(headers_list(), fn($kopf) => stripos($kopf, "Set-Cookie:") === 0);

?>
<!doctype html>
<html lang="de">
<head>
    <meta charset="utf-8">
    <title>Kopfzeilen</title>
    <style>
        body { font-family: system-ui, sans-serif; }
        li { margin-bottom: .6rem; }
        code { background: #eee; padding: .1rem .3rem; }
    </style>
</head>
<body>
    <h1>Das schickt dein Code hinaus</h1>

    <ul>
<?php foreach ($gesetzt as $kopf) { ?>
        <li><code><?= htmlspecialchars($kopf, ENT_QUOTES, "UTF-8") ?></code></li>
<?php } ?>
    </ul>
</body>
</html>

setcookie("name", "wert") funktioniert. Nur fehlen dem Cookie dann vier Angaben, die fast immer dabei sein sollten. Sie stehen in einem Array hinter dem Wert.

path sagt, für welche Adressen der Browser das Cookie wieder mitschickt. "/" heißt „für die ganze Seite“ und ist fast immer richtig. Ohne die Angabe nimmt der Browser das Verzeichnis der aktuellen Seite. Dann fehlt das Cookie plötzlich auf Seiten außerhalb dieses Verzeichnisses, etwa auf der Startseite.

httponly verbietet dem JavaScript im Browser, also den Programmen in den <script>-Blöcken einer Seite, das Cookie zu lesen. Das klingt nach einer Kleinigkeit und ist die wichtigste Angabe von allen. Schafft es fremdes Skript auf deine Seite, kommt es damit nicht an die Sitzungskennung deiner angemeldeten Besucher heran. Wie fremdes Skript überhaupt auf deine Seite kommt, steht in Lektion 11.4, und in Abschnitt 15 geht es damit weiter.

secure heißt „nur über eine verschlüsselte Verbindung“. Ohne die Angabe schickt der Browser das Cookie auch über eine unverschlüsselte, und dann kann jeder im selben Netz mitlesen.

samesite entscheidet, ob der Browser das Cookie auch dann mitschickt, wenn die Anfrage von einer fremden Seite ausgelöst wurde. Mit "Lax" schickt er es bei einem gewöhnlichen Klick auf einen Link mit. Bei einem Formular, das von woanders per POST abgeschickt wird, schickt er es nicht. Das ist schon die halbe Miete gegen einen Angriff, den du in Abschnitt 15 kennenlernst.

Dazu kommt expires, die Laufzeit. Ohne die Angabe ist es ein Sitzungscookie, das lebt, bis der Besucher den Browser schließt. Mit time() + 60 * 60 * 24 * 7 lebt es eine Woche.

Im zweiten Beispiel siehst du auf der Seite die Kopfzeilen, die der Code erzeugt hat. Bei mitablauf stehen zwei Schreibweisen derselben Laufzeit, ein Datum hinter expires und die Sekunden hinter Max-Age. Gelesen wird die Liste im PHP-Block oben, bevor die Seite anfängt, und was dort steht, geht so hinaus.

Was die Lernplattform an deinen Cookies ändert

Die Seite im Browser läuft in einem Rahmen, und der Rahmen liegt auf einer anderen Adresse als die Lektionsansicht drumherum. Für einen Browser ist das der Fall, den samesite meint, also eine fremde Seite. Ein Cookie mit Lax käme dort nie an, und dann stünde in dieser Lektion eine Behauptung, die du nicht nachprüfen könntest.

Deshalb wird jede Set-Cookie-Zeile umgeschrieben, bevor sie in den Rahmen geht. samesite steht danach auf None. Dazu kommen Secure, weil None ohne Secure nicht erlaubt ist, und Partitioned, damit der Browser das Cookie in einer eingebetteten Seite überhaupt noch annimmt. Im Reiter Netzwerk trägt jedes Cookie unter den Antwort-Kopfzeilen diese drei Angaben, auch nackt=1 aus dem zweiten Beispiel, dem im Code gar keine mitgegeben sind.

Auf der Seite des Beispiels stehen dagegen die Zeilen aus dem Code, denn der PHP-Block liest die Liste, bevor irgendetwas hinausgeht. Die Anfragen der Prüfliste laufen ohne Rahmen und ohne Sonderbehandlung, also zählt auch dort, was dein Code schreibt. Auf deinem eigenen Server gilt sowieso, was du schreibst.

Ein Cookie ist kein Tresor
<?php

declare(strict_types=1);

// Diese Seite macht den Fehler, den man nie machen darf: Sie legt
// eine Berechtigung in ein Cookie und glaubt ihr danach.
//
// Nach einem Klick auf den zweiten Link bist du Chef, ohne dass dich
// jemand gefragt hat. Dasselbe kann jeder Besucher auch, und zwar in
// den Entwicklerwerkzeugen seines Browsers.

if (isset($_GET["rolle"])) {
    setcookie("rolle", $_GET["rolle"], ["path" => "/"]);
    header("Location: /", true, 302);
    exit;
}

$rolle = $_COOKIE["rolle"] ?? "gast";

?>
<!doctype html>
<html lang="de">
<head>
    <meta charset="utf-8">
    <title>Rollen</title>
</head>
<body>
    <h1>Angemeldet als: <?= htmlspecialchars($rolle, ENT_QUOTES, "UTF-8") ?></h1>

<?php if ($rolle === "chef") { ?>
    <p>Umsatz des Monats: 84.120 Euro</p>
<?php } else { ?>
    <p>Du siehst hier nur das, was alle sehen.</p>
<?php } ?>

    <p>
        <a href="/?rolle=gast">Als Gast</a> ·
        <a href="/?rolle=chef">Als Chef</a>
    </p>
</body>
</html>

Ein Cookie liegt beim Besucher. Er kann es lesen, ändern, löschen und erfinden, und dafür braucht er kein Werkzeug außer dem, was in jedem Browser eingebaut ist.

In ein Cookie gehört deshalb nichts, worauf du dich verlassen musst. Eine Sprachwahl, ein zugeklapptes Hinweisfeld oder ein dunkles Farbschema passen hinein. Eine Berechtigung, ein Preis oder ein „ist bezahlt“ nie.

Im dritten Beispiel steckt der Fehler trotzdem drin. Der Code legt eine Rolle in ein Cookie und glaubt ihr danach, und ein Klick auf „Als Chef“ zeigt den Umsatz. Im Reiter Netzwerk steht dazu nur eine Antwort mit Set-Cookie: rolle=chef, und schon die nächste Anfrage trägt cookie: rolle=chef. Es geht sogar ohne den Link. curl -s -H 'Cookie: rolle=chef' localhost:3000/ behauptet die Rolle einfach und bekommt den Umsatz zu sehen.

In der Aufgabe merkt sich eine Kaffeerösterei in einem Cookie, welche Sorte zuletzt gewählt wurde.

Zum Mitnehmen

setcookie schickt ein Cookie an den Browser, und in $_COOKIE steht es erst bei der nächsten Anfrage. path, httponly, secure und samesite gehören fast immer dazu, und weil der Besucher jedes Cookie ändern kann, gehört keine Berechtigung hinein.

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.