mitmario.dev

Eingaben ausgeben

PHP Sandbox 3 Min Lesezeit 3 BeispieleLektion 4 von 7

Tippt jemand <b>fett</b> in ein Formular, dessen Seite den Text wieder anzeigt, steht danach ein fettes Wort da statt der spitzen Klammern. Was er geschrieben hat, ist Teil deines Markups geworden.

Warum eine Ausgabe gefährlich ist

Was ein Besucher hineinschreiben kann
<?php

declare(strict_types=1);

// Der Text geht hier unveraendert in die Seite. Im Feld steht
// schon etwas, ein Klick auf Absenden schickt es ab.

$istPost = $_SERVER["REQUEST_METHOD"] === "POST";
$text = $istPost ? trim($_POST["text"] ?? "") : "<b>fett</b> und <em>schräg</em>";

?>
<!doctype html>
<html lang="de">
<head>
    <meta charset="utf-8">
    <title>Roh ausgegeben</title>
</head>
<body>
    <h1>Roh ausgegeben</h1>

    <form method="post" action="/">
        <p><label>Text: <input type="text" name="text" size="40" value="<?= $text ?>"></label></p>
        <button type="submit">Absenden</button>
    </form>

    <p>Du hast geschrieben: <?= $text ?></p>

    <p>Genauso wirken <code>&lt;h1&gt;riesig&lt;/h1&gt;</code>
    oder <code>&lt;hr&gt;</code>.</p>
</body>
</html>

Eine Seite ist Text, und der Browser liest ihn als Anweisung. Er sieht <b> und macht fett. Er sieht <h1> und macht eine Überschrift. Und er sieht <script> und führt aus, was darin steht.

Schreibst du jetzt etwas in diese Seite, das ein Besucher getippt hat, dann schreibt in Wirklichkeit er in dein Markup. Er darf also alles, was du darfst. Ein <b> ist dabei noch das Harmloseste. Im Beispiel steht es nur, weil man es sofort sieht.

Der Fachbegriff dafür ist Cross-Site-Scripting, kurz XSS. Was ein Angreifer damit wirklich anstellt, steht in Lektion 15.2.

Eine Funktion, eine Regel

Dieselbe Seite, maskiert
<?php

declare(strict_types=1);

// Genau dieselbe Seite, nur mit htmlspecialchars an den beiden
// Stellen, an denen der Text hinausgeht.

$istPost = $_SERVER["REQUEST_METHOD"] === "POST";
$text = $istPost ? trim($_POST["text"] ?? "") : "<b>fett</b> und <em>schräg</em>";

$sicher = htmlspecialchars($text, ENT_QUOTES, "UTF-8");

?>
<!doctype html>
<html lang="de">
<head>
    <meta charset="utf-8">
    <title>Maskiert</title>
</head>
<body>
    <h1>Maskiert</h1>

    <form method="post" action="/">
        <p><label>Text: <input type="text" name="text" size="40" value="<?= $sicher ?>"></label></p>
        <button type="submit">Absenden</button>
    </form>

    <p>Du hast geschrieben: <?= $sicher ?></p>

    <p>Und so sieht es im Quelltext aus:</p>
    <pre><?= htmlspecialchars($sicher, ENT_QUOTES, "UTF-8") ?></pre>
</body>
</html>

htmlspecialchars() ersetzt die Zeichen, die im Markup eine Bedeutung haben, durch harmlose Ersatzschreibweisen (HTML-Entities). Aus < wird &lt;, aus > wird &gt;, aus & wird &amp;, und aus " und ' werden &quot; und &#039;.

Der Browser zeigt danach die Zeichen an, die der Besucher getippt hat, und baut kein Markup mehr daraus. Im Beispiel steht der Text deshalb mit seinen spitzen Klammern da. Darunter siehst du, wie er im Quelltext aussieht.

Ab hier gilt eine Regel ohne Ausnahme. Alles, was nicht aus deinem eigenen Code kommt, geht durch htmlspecialchars(), bevor es in eine Seite geschrieben wird. Das sind Formularfelder, Werte aus der Adresse, später Zeilen aus der Datenbank und Text aus einer fremden Schnittstelle.

Was du selbst getippt hast, maskierst du dagegen nicht, denn dein eigenes <h1> soll ja eine Überschrift werden.

Die zwei Argumente dahinter

Im Kurs bekommt die Funktion ab hier immer beide Argumente mit, also htmlspecialchars($wert, ENT_QUOTES, "UTF-8"). So steht es auch in der Hilfsfunktion e() im dritten Beispiel. ENT_QUOTES maskiert die doppelten und die einfachen Anführungszeichen. "UTF-8" sagt, in welcher Kodierung der Text vorliegt, damit Umlaute heil ankommen. Seit PHP 8.1 ist beides auch ohne Angabe der Standardwert. Ich schreibe die Werte trotzdem hin. Auf einem älteren Hosting-Paket ist der Standardwert nämlich ein anderer und lässt die einfachen Anführungszeichen durch. Außerdem sieht man beim Lesen sofort, was gemeint ist.

Der Ausbruch aus dem Attribut

Der Wert mitten in einem Attribut
<?php

declare(strict_types=1);

          // Ein Wert mitten in einem Attribut, einmal mit ENT_COMPAT und einmal
// mit ENT_QUOTES. Im Feld mit ENT_COMPAT bricht er aus und haengt ein
// eigenes style an, das mit ENT_QUOTES zeigt ihn als Text.

function e(?string $wert): string
{
    return htmlspecialchars($wert ?? "", ENT_QUOTES, "UTF-8");
}

$istPost = $_SERVER["REQUEST_METHOD"] === "POST";
$text = $istPost ? trim($_POST["text"] ?? "") : "Mia' style='background:gold";

?>
<!doctype html>
<html lang="de">
<head>
    <meta charset="utf-8">
    <title>Attribute</title>
</head>
<body>
    <h1>Der Wert mitten in einem Attribut</h1>

    <form method="post" action="/">
        <p><label>Text: <input type="text" name="text" size="40" value="<?= e($text) ?>"></label></p>
        <button type="submit">Absenden</button>
    </form>

    <p>Mit ENT_COMPAT, also ohne die einfachen Anführungszeichen:</p>
    <p><input type='text' size='40' value='<?= htmlspecialchars($text, ENT_COMPAT, "UTF-8") ?>'></p>

    <p>Mit ENT_QUOTES:</p>
    <p><input type='text' size='40' value='<?= e($text) ?>'></p>
</body>
</html>

Zwischen zwei Tags fällt ein vergessenes Maskieren sofort auf, in einem Attribut nicht. Dabei ist value="<?= $text ?>" genauso offen. Nur endet der Ausbruch dort mit einem Anführungszeichen statt mit einer spitzen Klammer.

Im Beispiel steht der Wert zweimal in einem Feld, dessen Attribut in einfachen Anführungszeichen steht. Unter „Mit ENT_COMPAT“ lässt htmlspecialchars() die einfachen Anführungszeichen durch. Der Wert schließt damit das Attribut und hängt ein eigenes style an, und das Feld wird gelb. Darin steht auch nur noch Mia, denn der Rest ist zum Attribut geworden. Das Feld unter „Mit ENT_QUOTES“ bleibt weiß und zeigt den ganzen Text.

Eine Hilfsfunktion lohnt sich

Der Aufruf ist lang, und er steht in jeder zweiten Zeile Markup. Deshalb kommt er einmal in eine kurze Funktion mit einem sehr knappen Namen.

Die Funktion aus dem dritten Beispiel heißt e, nimmt ein ?string entgegen und gibt einen string zurück. Das Fragezeichen lässt auch null herein, also den Wert eines Feldes, das fehlt. Ein null direkt an htmlspecialchars() bringt seit PHP 8.1 eine Deprecated-Meldung, und mit declare(strict_types=1) bricht der Lauf dort sogar mit einem TypeError ab. Mit ?? "" in der Funktion ist der Fall an einer Stelle erledigt statt an fünfzig.

e() steht in vielen späteren Aufgaben mit HTML fertig im Code. In Abschnitt 16 liegt sie bei den anderen Hilfsfunktionen der Anwendung in funktionen.php.

Im Reiter Praxis steht ein Gästebuch, das zurückgibt, was der Besucher geschrieben hat, und e() ist dort schon fertig.

Zum Mitnehmen

Was ein Besucher schreibt, wird in deiner Seite zu Markup, solange es roh hinausgeht, zwischen zwei Tags ebenso wie in einem Attribut. htmlspecialchars mit ENT_QUOTES macht daraus Zeichen, und deshalb geht jede fremde Ausgabe durch diese Funktion, im Kurs als kurze Hilfsfunktion e.

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.