Abschnitt 11 · Lektion 4
Eingaben ausgeben
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
<?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><h1>riesig</h1></code>
oder <code><hr></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
<?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 <, aus > wird >, aus & wird &,
und aus " und ' werden " und '.
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
<?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, 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.