mitmario.dev

Mehrere Seiten

PHP Sandbox 4 Min Lesezeit 3 BeispieleLektion 5 von 7

Ein Hofladen mit einer einzigen Seite hat kein Impressum. Für eine zweite Seite gibt es zwei Wege. Beide funktionieren, und beide kommen im echten Leben vor. Der Unterschied zwischen ihnen ist aber größer, als er zuerst aussieht.

Eine Datei je Seite

Zwei Dateien nebeneinander
<?php

declare(strict_types=1);

echo "<!doctype html>\n";
echo "<html lang=\"de\"><head><meta charset=\"utf-8\"><title>Hofladen</title></head>\n";
echo "<body>\n";
echo "<nav><a href=\"/\">Start</a> | <a href=\"/impressum.php\">Impressum</a></nav>\n";
echo "<h1>Startseite</h1>\n";
echo "<p>Diese Seite liegt in index.php.</p>\n";
echo "</body></html>\n";

Der einfachste Weg ist auch der älteste. Du legst impressum.php neben index.php, und schon beantwortet der Server /impressum.php. Dazwischen steht kein Code, und einzurichten ist nichts.

So arbeitet klassisches Hosting bis heute. Du lädst Dateien in einen Ordner, und jede Datei ist eine Adresse. Für eine überschaubare Seite ist das völlig in Ordnung. Eine Vereinsseite braucht nicht mehr.

Zwei Nachteile hat der Weg trotzdem, und beide siehst du im Beispiel. Die Endung .php steht in jeder Adresse. Schlimmer ist, dass die Navigationsleiste jetzt zweimal dasteht. Bei zwei Dateien fällt das nicht auf. Bei acht schon, und spätestens wenn ein Menüpunkt dazukommt, änderst du sieben Dateien und vergisst die achte.

Eine Datei, die selbst entscheidet

Eine Datei, die den Pfad liest
<?php

declare(strict_types=1);

$pfad = parse_url($_SERVER["REQUEST_URI"], PHP_URL_PATH) ?: "";

$titel = match ($pfad) {
    "/" => "Startseite",
    "/impressum" => "Impressum",
    "/preise" => "Preise",
    default => "Unbekannt",
};

?>
<!doctype html>
<html lang="de">
<head><meta charset="utf-8"><title><?= $titel ?></title></head>
<body>
    <nav>
        <a href="/">Start</a> |
        <a href="/impressum">Impressum</a> |
        <a href="/preise">Preise</a> |
        <a href="/unfug">Unfug</a>
    </nav>
    <h1><?= $titel ?></h1>
    <p>Angefragter Pfad: <?= htmlspecialchars($pfad) ?></p>
    <p>Alle vier Adressen landen in derselben Datei.</p>
</body>
</html>

Der zweite Weg nutzt etwas, das du von der ersten Seite kennst. Ein Pfad ohne passende Datei landet auf der index.php, und der echte Pfad steht trotzdem in $_SERVER["REQUEST_URI"]. Mit einem Punkt im letzten Teil des Pfads klappt das erst ab PHP 8.4.

Damit kann eine einzige Datei jede Adresse beantworten. Sie liest den Pfad, entscheidet, was gemeint ist, und baut die passende Seite. Klickst du die vier Links durch, ändert sich jedes Mal die Adresse in der Adresszeile, aber die Datei dahinter bleibt dieselbe. Zurück und Vor in der Browser-Leiste gehen den Weg noch einmal ab, wie in jedem Browser. Im Reiter Netzwerk steht nach jedem Klick die Anfrage dazu. Alle vier tragen eine 200, auch /unfug, denn für den unbekannten Pfad gibt es hier nur einen anderen Titel und noch keinen Statuscode.

Verzweigt wird mit match aus Lektion 4.2. Solange es um feste Pfade geht, liest sich diese Form am besten. Sobald ein Pfad einen Platzhalter hat, etwa eine Notiznummer wie in /notiz/12, reicht sie nicht mehr. Dann braucht es einen Vergleich mit einem Muster, und der kommt in Abschnitt 16.

Fehlt der Arm default, stürzt die Seite bei /unfug ab. match findet keinen passenden Fall und wirft einen UnhandledMatchError mit der Meldung Unhandled match case '/unfug'. Statt der Seite steht dann nur der Fatal error da, und in der Statuszeile trotzdem eine 200.

Warum der Anhang wegmuss

In REQUEST_URI steht der Pfad samt allem hinter dem Fragezeichen. Rufst du /preise?sortierung=name auf, bekommst du also nicht /preise, sondern den ganzen Text, und ein Vergleich mit "/preise" schlägt fehl.

parse_url($adresse, PHP_URL_PATH) schneidet den Anhang ab und gibt dir nur den Pfad. Bei einer kaputten Adresse wie //impressum gibt es null zurück. Deshalb steht im Beispiel ?: "" dahinter, wie in Abschnitt 16 auch. Die Funktion kann noch mehr und zerlegt eine vollständige Adresse auch in Protokoll, Servername und Port, aber in diesem Kurs brauchst du nur den Pfad. Der Anhang selbst ist nicht verloren. Er steht weiterhin in $_GET, so wie bei den Werten aus der Adresse.

Was noch alles in $_SERVER steht

Was der Server dir hinlegt
<?php

declare(strict_types=1);

$felder = ["REQUEST_URI", "SCRIPT_NAME", "PHP_SELF", "QUERY_STRING", "REQUEST_METHOD"];

echo "<!doctype html>\n";
echo "<html lang=\"de\"><head><meta charset=\"utf-8\"><title>Was ankommt</title></head>\n";
echo "<body>\n";
echo "<h1>Was der Server dir hinlegt</h1>\n";
echo "<ul>\n";

foreach ($felder as $feld) {
    $wert = $_SERVER[$feld] ?? "";
    echo "  <li>$feld = \"" . htmlspecialchars($wert) . "\"</li>\n";
}

echo "</ul>\n";
echo "<p><a href=\"/\">/</a> | <a href=\"/notiz/12\">/notiz/12</a> | ";
echo "<a href=\"/suche?ware=Kaffee\">/suche?ware=Kaffee</a></p>\n";
echo "</body></html>\n";

$_SERVER ist wie $_GET ein Array, das PHP für dich füllt, und seine Einträge stellt der Server zusammen. Fünf davon stehen im Beispiel. Zwei wirst du ständig wiedersehen, REQUEST_URI und REQUEST_METHOD.

REQUEST_URI ist der angefragte Pfad samt Anhang und damit der wichtigste für dich. In REQUEST_METHOD steht GET oder POST, und ab Abschnitt 11 hängt jedes Formular daran. QUERY_STRING ist der Anhang allein, unzerlegt. SCRIPT_NAME ist die Datei, die die Arbeit wirklich macht, hier also immer /index.php.

Klickst du auf den Link zu /notiz/12, steht in PHP_SELF der Wert /index.php/notiz/12, also die Datei plus alles, was dahinter noch am Pfad hing. Der Wert kommt damit aus der Adresse und vom Besucher. Schreibst du ihn ungeprüft in eine Seite, hast du eine der klassischen Lücken, dieselbe Sorte wie roher Text aus $_GET.

Welchen Weg dieser Kurs nimmt

Beide, und zwar der Reihe nach. In Abschnitt 16 bekommt der zweite Weg einen Namen, nämlich Front Controller, und dazu eine Struktur, mit der auch dreißig Seiten übersichtlich bleiben.

Der Server in diesem Kurs schickt jede Adresse ohne passende Datei von sich aus an die index.php. Auf einem gemieteten Hosting-Paket mit Apache stehen dafür ein paar Zeilen in einer Datei namens .htaccess.

In der Aufgabe baust du den zweiten Weg, drei Seiten aus einer einzigen Datei, denn auf ihm steht alles Weitere.

Zum Mitnehmen

Mehrere Seiten entstehen aus einer Datei je Seite oder aus einer Datei, die den Pfad liest und selbst entscheidet. Den Pfad ohne Anhang holt parse_url aus REQUEST_URI, und ein match ohne default stürzt bei einem unbekannten Pfad ab.

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.