mitmario.dev

Werte aus der Adresse

PHP Sandbox 4 Min Lesezeit 3 BeispieleLektion 3 von 7

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

Was hinter dem Fragezeichen ankommt
<?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&amp;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

Fehlt oder ist leer
<?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

Roh eingesetzt und maskiert
<?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 &lt;, aus & wird &amp; 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, 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.