Abschnitt 12 · Lektion 2
Cookies
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
<?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
<?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.
Was ein Cookie nicht ist
<?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, 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.