mitmario.dev

Anlegen und anzeigen

PHP Sandbox 3 Min Lesezeit 2 BeispieleLektion 4 von 8

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

Welche Adresse durchkommt
<?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.txt ist 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

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 &amp; statt &. Die Vorlage maskiert das ein zweites Mal, und auf der Seite steht am Ende &amp;. 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, 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 2 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.

  • Aufgabe, dein Code läuft auf einem Server

    Öffnet sich mit dem Basis Konto.