Abschnitt 18 · Lektion 4
Anlegen und anzeigen
Ein Lesezeichen anzulegen heißt ein Formular, eine Prüfung, ein INSERT und eine Weiterleitung, und
drei davon sind Routine. Die Prüfung nicht, denn eine Adresse, die gültig aussieht, kann beim Klick
Code ausführen.
Was eine Adresse zu einer Adresse macht
<?php
declare(strict_types=1);
// Was eine Adresse taugt, entscheidet erst der Klick eines Besuchers.
// Fuer die Form bringt PHP einen Filter mit, und was er durchlaesst,
// steht in der zweiten Spalte der Ausgabe.
$kandidaten = [
"https://astro.example",
"http://example.org/seite?a=1",
"javascript:alert(1)",
"javascript://astro.example/%0aalert(1)",
"ftp://example.org/datei.txt",
"astro.example",
" https://astro.example",
"HTTPS://astro.example",
"",
];
echo str_pad("Adresse", 42), "FILTER_VALIDATE_URL\n";
echo str_repeat("-", 62), "\n";
foreach ($kandidaten as $url) {
echo str_pad('"' . $url . '"', 42),
filter_var($url, FILTER_VALIDATE_URL) === false ? "nein" : "ja", "\n";
} Ein Lesezeichen ist eine Zeile, auf die später jemand klickt, und es zählt, was der Browser dann tut. Wie eine Adresse sieht vieles aus.
PHP bringt dafür filter_var($url, FILTER_VALIDATE_URL) mit. Im ersten Beispiel bekommt der Filter
neun Kandidaten vorgelegt, und er prüft die Form einer Adresse und sonst nichts:
ftp://example.org/datei.txtist eine gültige Adresse, für ein Lesezeichen in dieser Anwendung aber nichts.javascript://astro.example/%0aalert(1)ist ebenfalls gültig. Es hat ein Schema, zwei Schrägstriche und einen Rechnernamen, und ein Klick darauf führt Code aus.
Die Anwendung prüft deshalb selbst, ob die Eingabe mit http:// oder https:// anfängt. Das ist
eine Allowlist, und was nicht ausdrücklich darauf steht, kommt nicht durch. Eine Verbotsliste, die
javascript: abweist, ließe schon JavaScript: in anderer Schreibweise durch, und ein Browser
führt beides aus.
Zwei Kandidaten sind für diese Prüfung Grenzfälle mit Ansage. Vor https://astro.example stehen
Leerzeichen, und an denen bleibt ein Vergleich mit dem Anfang hängen. Deshalb wird die Eingabe
vorher getrimmt. HTTPS://astro.example in Großbuchstaben würde jeder Browser öffnen, ein Vergleich
mit https:// lässt es trotzdem nicht durch. Willst du das ändern, machst du die Eingabe vor dem
Vergleich klein. Es ist die erste Zeile, die man an dieser Funktion ergänzt, sobald sich jemand
beschwert.
Absenden, weiterleiten, anzeigen
<?php
declare(strict_types=1);
// Ein Formular, eine Liste, eine Meldung. Im Reiter Browser kannst du es
// bedienen: etwas eintragen, ein leeres Feld abschicken, danach auf Seite
// neu laden klicken. Die Liste liegt in der Sitzung, eine Datenbank
// braucht es dafuer nicht.
session_start();
$_SESSION["liste"] ??= [];
$pfad = parse_url($_SERVER["REQUEST_URI"], PHP_URL_PATH) ?: "";
if ($pfad === "/eintragen" && $_SERVER["REQUEST_METHOD"] === "POST") {
$text = trim($_POST["text"] ?? "");
if ($text === "") {
// Die Meldung wird gemerkt, nicht ausgegeben. Ausgeben tut sie die
// Seite, auf der der Besucher gleich landet.
$_SESSION["meldung"] = "Da stand nichts drin.";
} else {
$_SESSION["liste"][] = $text;
$_SESSION["meldung"] = "Eingetragen: " . $text;
}
// Das P und das R aus Lektion 11.3: Der POST antwortet nie mit einer
// Seite, sondern mit einer Weiterleitung. Deshalb laedt ein Neuladen die
// Liste und schickt nicht das Formular noch einmal ab.
header("Location: /", true, 302);
exit;
}
// Eine Meldung wird beim Lesen verbraucht, sonst stuende sie ewig da.
$meldung = $_SESSION["meldung"] ?? null;
unset($_SESSION["meldung"]);
?>
<!doctype html>
<html lang="de">
<head><meta charset="utf-8"><title>Absenden und weiterleiten</title>
<style>body{font-family:system-ui,sans-serif;max-width:34rem;margin:2rem auto}
.meldung{background:#eef;padding:.4rem .8rem}</style></head>
<body>
<h1>Einkaufszettel</h1>
<?php if ($meldung !== null) { ?>
<p class="meldung"><?= htmlspecialchars($meldung, ENT_QUOTES, "UTF-8") ?></p>
<?php } ?>
<form method="post" action="/eintragen">
<p><input type="text" name="text" size="30"> <button type="submit">Eintragen</button></p>
</form>
<?php if ($_SESSION["liste"] === []) { ?>
<p>Noch nichts eingetragen.</p>
<?php } else { ?>
<ul>
<?php foreach ($_SESSION["liste"] as $eintrag) { ?>
<li><?= htmlspecialchars($eintrag, ENT_QUOTES, "UTF-8") ?></li>
<?php } ?>
</ul>
<p>Einträge: <?= count($_SESSION["liste"]) ?></p>
<?php } ?>
</body>
</html> Im zweiten Beispiel liegt ein Einkaufszettel in der Sitzung, ohne Datenbank. Daran siehst du die drei Bewegungen, die dein Anlegen gleich auch macht. Im Reiter Browser kannst du etwas eintragen und auch ein leeres Feld abschicken, und ein Klick auf Seite neu laden holt die Liste danach noch einmal.
Auf den POST antwortet die Anwendung mit einer Weiterleitung, und erst die folgende Anfrage bekommt
HTML. Das ist das Muster aus Lektion 11.3, und im Reiter Netzwerk siehst du es nach jedem Eintragen
wieder. Die Seite ist die Antwort auf den GET. Seite neu laden holt deshalb einfach / noch einmal,
und der Browser fragt nicht, ob er das Formular erneut abschicken soll.
Zwischen dem Absenden und der Anzeige liegt eine zweite Anfrage, und die weiß von der ersten nichts. Die Meldung des POST kommt deshalb in die Sitzung. Die Seite danach holt sie ab und löscht sie dabei, so wie die Meldung nach der Weiterleitung im Abschnitt über Sitzungen. Ohne das Löschen stünde sie beim nächsten Aufruf noch einmal da.
Der abgewiesene Fall geht denselben Weg wie der erfolgreiche. Beide leiten weiter und hinterlassen eine Meldung, nur trägt der eine etwas ein und der andere nicht. Die Funktion hat damit einen einzigen Ausgang, und an keiner zweiten Stelle muss jemand daran denken, dass die Antwort eine Weiterleitung sein soll.
Wo maskiert wird
Was jemand einträgt, landet später auf einer Seite. Wie in Abschnitt 15 wird es roh gespeichert und
erst beim Ausgeben maskiert. In der Datenbank steht der Titel so, wie er eingetippt wurde, und die
Vorlage legt e() darum. In diesem Projekt ist ansichten/liste.php gegeben und maskiert jeden
Wert.
Beim Speichern zu maskieren fühlt sich sicherer an, ist aber die falsche Stelle. In der Datenbank
stünde dann & statt &. Die Vorlage maskiert das ein zweites Mal, und auf der Seite steht am
Ende &. In einer E-Mail oder einer Datei stört es genauso.
Im Reiter Praxis geht es um beides, die Prüfung für Adressen und die Funktion, die ein Lesezeichen anlegt.
Zum Mitnehmen
FILTER_VALIDATE_URL prüft nur die Form und lässt eine javascript-Adresse mit Rechnernamen durch. Die Anwendung nimmt deshalb nur Adressen mit http:// oder https:// an und maskiert erst beim Ausgeben.
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 2 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe, dein Code läuft auf einem Server
Öffnet sich mit dem Basis Konto.