Abschnitt 10 · Lektion 3
Werte aus der Adresse
In /suche?ware=Kaffee&menge=3 steckt eine Frage, nämlich nach drei Packungen Kaffee. Eine Seite,
die für jeden dasselbe zeigt, kann sie nicht beantworten. Hinter dem Fragezeichen folgt eine Liste
aus Schlüsseln und Werten, verbunden mit &. PHP liest die beiden Werte heraus und legt sie dir
hin.
Das Array heißt $_GET
<?php
declare(strict_types=1);
// Alles hinter dem Fragezeichen landet in $_GET. Die beiden Links
// zeigen es, und jede Adresse aus der Adresszeile zeigt es genauso.
echo "<!doctype html>\n";
echo "<html lang=\"de\">\n";
echo "<head><meta charset=\"utf-8\"><title>Adresse</title></head>\n";
echo "<body>\n";
echo "<h1>Was in \$_GET steht</h1>\n";
echo "<p>Angefragt: " . htmlspecialchars($_SERVER["REQUEST_URI"]) . "</p>\n";
if ($_GET === []) {
echo "<p>Nichts. An der Adresse hängt kein Fragezeichen.</p>\n";
} else {
echo "<ul>\n";
foreach ($_GET as $schluessel => $wert) {
$zeile = htmlspecialchars("$schluessel = $wert");
echo " <li>$zeile, Typ: " . get_debug_type($wert) . "</li>\n";
}
echo "</ul>\n";
}
echo "<p><a href=\"/?ware=Kaffee&menge=3\">Mit zwei Werten</a> | ";
echo "<a href=\"/\">ganz ohne</a></p>\n";
echo "</body>\n";
echo "</html>\n"; $_GET ist ein ganz normales Array. Du kannst also alles damit machen, was du aus Abschnitt 5
kennst, mit foreach darüber laufen, mit count() zählen, einzelne Schlüssel abfragen. Anders ist
nur, wo es herkommt. PHP füllt es, bevor deine erste Zeile läuft. Deshalb gehört $_GET zu den
Superglobals, den Variablen, die PHP selbst füllt und die überall im Programm da sind, auch in
jeder Funktion.
Den Namen hat es von der Methode GET. In Abschnitt 11 kommt $_POST dazu, für das, was ein
Formular hinschickt, und das ist genauso aufgebaut.
Hinter den Werten steht in der Ausgabe ihr Typ. Bei beiden ist es string, auch bei der Menge. Was
aus der Adresse kommt, ist Text, denn eine Adresse ist Text. Willst du damit rechnen, wandelst du
vorher selbst um, etwa mit (int). Eine Typangabe an einer Funktion nimmt dir das nicht ab, denn
mit declare(strict_types=1) ist "3" für einen int-Parameter ein TypeError.
"3" + 1 ergibt brav 4. "drei" + 1 bricht mit einem TypeError ab. Und "12,50" + 1 ergibt
13 plus eine Warnung, weil PHP am Komma aufhört zu lesen. Was in der Adresse steht, bestimmst
nicht du.
Auch in der Ausgabe landet nichts davon roh in der Seite. Schlüssel, Wert und angefragte Adresse
gehen durch htmlspecialchars(), und was die Funktion tut, siehst du im letzten Beispiel.
Ein Parameter, der fehlen darf
<?php
declare(strict_types=1);
$mitDoppelfrage = $_GET["ware"] ?? "alles";
$mitKurzform = ($_GET["ware"] ?? "") ?: "alles";
?>
<!doctype html>
<html lang="de">
<head><meta charset="utf-8"><title>Fehlt oder leer</title></head>
<body>
<h1>Fehlt oder ist leer</h1>
<p>Angefragt: <?= htmlspecialchars($_SERVER["REQUEST_URI"]) ?></p>
<ul>
<li>isset: <?= isset($_GET["ware"]) ? "ja" : "nein" ?></li>
<li>Ohne ??: <?= htmlspecialchars(var_export($_GET["ware"], true)) ?></li>
<li>Mit ?? gefüllt: "<?= htmlspecialchars($mitDoppelfrage) ?>"</li>
<li>Mit ?: gefüllt: "<?= htmlspecialchars($mitKurzform) ?>"</li>
</ul>
<p>
<a href="/">ohne Parameter</a> |
<a href="/?ware=">leerer Parameter</a> |
<a href="/?ware=Kaffee">mit Wert</a>
</p>
</body>
</html> Niemand zwingt einen Besucher, deine Adresse vollständig einzutippen. Fragst du einen Schlüssel ab,
den es nicht gibt, meldet PHP Undefined array key und liefert null. Im Beispiel passiert das in
der Zeile „Ohne ??“, sobald / ohne Parameter kommt.
Die Meldung steht dort mitten auf der Seite. Der Server in diesem Kurs zeigt Fehler nämlich da an,
wo sie passieren, und warum das so ist, steht in der nächsten Lektion. Beim Prüfen steht die Meldung
zusätzlich im Terminal auf dem Fehlerkanal. Die Seite läuft trotzdem weiter und zeigt Unsinn. Das
ist die gefährliche Sorte Warnung aus dem Abschnitt über Fehler. Mit declare(strict_types=1)
bricht der Lauf erst ab, wenn das null in eine Funktion geht, die Text verlangt, etwa in
htmlspecialchars(). Dort kommt dann ein TypeError.
Der Doppelfragezeichen-Operator löst den Fall in einem Ausdruck. $_GET["ware"] ?? "alles" liefert
den Wert, falls er da ist, und sonst den Ersatz.
Nur reicht das oft nicht. Bei den drei Links kommt es auf die Zeile „Mit ?? gefüllt“ an. Bei
/?ware= existiert der Schlüssel, sein Wert ist nur der leere Text. ?? fragt aber nach dem
Vorhandensein und nicht nach dem Inhalt, und deshalb greift es hier nicht. Heraus kommt eine leere
Angabe, wo „alles“ stehen sollte.
Dafür gibt es die Kurzform des Fragezeichen-Operators aus Lektion 4.1. $wert ?: "alles" nimmt den
Ersatz, sobald der Wert als falsch gilt, und dazu gehört der leere Text (Lektion 2.5). Beides
zusammen deckt in einer Zeile beide Fälle ab, erst ?? gegen den fehlenden Schlüssel und dann ?:
gegen den leeren Wert.
Für PHP ist allerdings auch der Text "0" falsch. Wo eine Null ein gültiger Wert wäre, ist ?:
also die falsche Wahl. Dann fragt man lieber ausdrücklich mit trim($wert) === "".
Was ankommt, ist fremder Text
<?php
declare(strict_types=1);
$text = $_GET["text"] ?? "<b>fett</b> und <em>schief</em>";
?>
<!doctype html>
<html lang="de">
<head><meta charset="utf-8"><title>Roh und maskiert</title></head>
<body>
<h1>Derselbe Text, zweimal eingesetzt</h1>
<p>Roh eingesetzt: <?= $text ?></p>
<p>Maskiert: <?= htmlspecialchars($text) ?></p>
<p>
<a href="/?text=Kaffee">harmlos</a> |
<a href="/?text=%3Cb%3Efett%3C%2Fb%3E">mit Markup</a>
</p>
</body>
</html> Klickst du auf den Link mit dem Markup, ist das Wort in der ersten Zeile wirklich fett. In der zweiten stehen die spitzen Klammern als Zeichen da.
Der Unterschied ist eine Funktion. htmlspecialchars() maskiert (englisch escaping) die fünf
Zeichen, die in HTML eine Bedeutung haben. Sie ersetzt jedes durch seine Ersatzschreibweise
(englisch HTML entity), aus < wird <, aus & wird & und so weiter. Der Browser zeigt
sie dann an, statt sie auszuführen.
In der ersten Zeile hat der Besucher deiner Seite Markup untergeschoben. Bei <b> ist das lustig.
Mit einem <script>-Element ist es das nicht mehr, denn dann läuft fremder Code im Browser deiner
Besucher, und zwar so, als käme er von dir. Der Angriff heißt XSS (Cross-Site Scripting) und kommt
in Abschnitt 15 ausführlich dran.
Warum man Werten auch inhaltlich nicht traut
htmlspecialchars hält einen Wert davon ab, deine Seite kaputtzumachen. Ob der Wert stimmt, ist
damit noch lange nicht gesagt.
In der Adresse steht, was jemand hineinschreibt. Eine Seitennummer kann -4 sein, eine Menge
999999, eine Artikelnummer die eines fremden Kunden. Ein Formular im Browser schützt dich davor
nicht, denn die Adresse lässt sich von Hand ändern. Wer das einmal gemerkt hat, tut es auch.
Du musst also selbst prüfen, ob der Wert überhaupt da ist, ob er die erwartete Form hat, ob er im erlaubten Bereich liegt und ob dieser Besucher ihn sehen darf. Wie das aussieht, steht in Abschnitt 11. Ob ein Besucher eine fremde Nummer sehen darf, ist eine Frage des Abschlussprojekts.
In der Aufgabe kommt ein Name über die Adresse herein und landet in einer Begrüßung.
Zum Mitnehmen
Werte aus der Adresse kommen als Text in $_GET an, und ?? fängt einen fehlenden Schlüssel ab, ?: auch einen leeren Wert. Bevor so ein Wert in die Seite geht, macht htmlspecialchars aus seinem Markup sichtbare Zeichen.
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.