Abschnitt 16 · Lektion 4
Routen und Parameter
Eine Routentabelle mit festen Pfaden reicht für ein Impressum. Für Notizen reicht sie nicht, denn
niemand schreibt eine Zeile für /notiz/1, /notiz/2 und alles bis /notiz/8391. Du brauchst eine
Zeile für alle. Ein Muster.
Erst einmal von Hand
<?php
declare(strict_types=1);
// Diese Seite zeigt, was aus der Adresse geworden ist. Jeder Pfad in
// der Adresszeile ergibt eine eigene Tabelle, etwa /notiz/12,
// /notiz/12/erledigt, /notiz oder nur ein Schraegstrich.
//
$pfad = parse_url($_SERVER["REQUEST_URI"], PHP_URL_PATH) ?: "";
// trim schneidet die Schraegstriche an den Enden ab, sonst waere das
// erste Stueck immer leer. Und ein leerer Pfad ergibt sonst ein Array
// mit einem leeren Text statt gar keinem Stueck.
$stuecke = $pfad === "/" ? [] : explode("/", trim($pfad, "/"));
function e(?string $wert): string
{
return htmlspecialchars($wert ?? "", ENT_QUOTES, "UTF-8");
}
?>
<!doctype html>
<html lang="de">
<head><meta charset="utf-8"><title>Pfad zerlegen</title>
<style>body{font-family:system-ui,sans-serif;max-width:34rem;margin:2rem auto}
td,th{border:1px solid #ccc;padding:.3rem .6rem;text-align:left}</style></head>
<body>
<h1>Pfad zerlegen</h1>
<p>Angefragt: <code><?= e($pfad) ?></code>.
Stücke: <strong><?= count($stuecke) ?></strong></p>
<table>
<tr><th>Nummer</th><th>Stück</th></tr>
<?php foreach ($stuecke as $nummer => $stueck): ?>
<tr><td><?= $nummer ?></td><td><?= e($stueck) ?></td></tr>
<?php endforeach; ?>
</table>
<p>Eine Notiz wäre also ein erstes Stück <code>notiz</code> und als
zweites die Nummer, etwa bei
<a href="/notiz/12">/notiz/12</a> und
<a href="/notiz/12/erledigt">/notiz/12/erledigt</a>.</p>
</body>
</html> Am nächsten liegt explode aus Lektion 5.6. Der Pfad wird an den Schrägstrichen zerschnitten, und
die Stücke liegen in einem Array. Im ersten Beispiel steht in einer Tabelle, was aus der Adresse in
der Adresszeile wird, und jede neue Adresse dort ergibt eine neue Tabelle.
Zwei Kleinigkeiten nerven schon hier. Ein Pfad fängt mit einem Schrägstrich an, also wäre das erste
Stück ohne trim leer. Und / ergibt nach dem Abschneiden einen leeren Text, aus dem explode ein
Array mit einem einzigen leeren Eintrag macht statt eines leeren Arrays. Deshalb wird / in der
Zeile mit explode extra behandelt.
Mit dieser Zerlegung ließe sich weiterarbeiten. Ist das erste Stück notiz und gibt es ein zweites,
zeigt die Seite die Notiz mit dieser Nummer. Für zwei oder drei Adressen geht das gut. Bei zehn wird
daraus eine Kette aus if, und bei jeder einzelnen musst du die Stücke neu durchzählen. Irgendwann
steht die Adressstruktur der ganzen Anwendung als verschachteltes if in einer Datei.
Ein Muster beschreibt den ganzen Pfad
<?php
declare(strict_types=1);
// Dieselbe Aufgabe, nur beschreibt jetzt ein Muster den ganzen Pfad
// auf einmal. Je Adresse zeigt die Tabelle, welche Zeile trifft und
// welcher Wert dabei herauskommt.
$muster = [
"/" => "Startseite",
"/notiz/{id}" => "eine Notiz ansehen",
"/notiz/{id}/erledigt" => "eine Notiz abhaken",
];
function passtRoute(string $muster, string $pfad): ?array
{
// Aus {id} wird eine Klammer, die genau eine Zahl erlaubt. Alles
// andere im Muster bleibt woertlich, das macht preg_quote.
$regex = "#^" . str_replace('\{id\}', '([0-9]+)', preg_quote($muster, "#")) . "$#";
if (preg_match($regex, $pfad, $treffer) !== 1) {
return null;
}
return array_slice($treffer, 1);
}
$pfad = parse_url($_SERVER["REQUEST_URI"], PHP_URL_PATH) ?: "";
function e(?string $wert): string
{
return htmlspecialchars($wert ?? "", ENT_QUOTES, "UTF-8");
}
?>
<!doctype html>
<html lang="de">
<head><meta charset="utf-8"><title>Muster</title>
<style>body{font-family:system-ui,sans-serif;max-width:34rem;margin:2rem auto}
td,th{border:1px solid #ccc;padding:.3rem .6rem;text-align:left}</style></head>
<body>
<h1>Welche Route passt</h1>
<p>Angefragt: <code><?= e($pfad) ?></code></p>
<table>
<tr><th>Muster</th><th>Ergebnis</th></tr>
<?php foreach ($muster as $eintrag => $bedeutung): ?>
<?php $werte = passtRoute($eintrag, $pfad); ?>
<tr>
<td><code><?= e($eintrag) ?></code></td>
<td><?= $werte === null ? "passt nicht" : $bedeutung . ", Wert: " . e($werte[0] ?? "keiner") ?></td>
</tr>
<?php endforeach; ?>
</table>
<p>Zum Vergleich gibt es <a href="/notiz/12">/notiz/12</a>,
<a href="/notiz/12/erledigt">/notiz/12/erledigt</a> und
<a href="/notiz/abc">/notiz/abc</a>.</p>
</body>
</html> Bequemer ist es, den Pfad in einem Stück zu beschreiben, als /notiz/{id}. Das liest sich wie die
Adresse selbst. Beim Prüfen wird aus dem {id} ein regulärer Ausdruck wie der im Abschnitt über
Composer, und der erlaubt genau eine Zahl.
In der Funktion passtRoute() maskiert preg_quote erst einmal alles im Muster, damit es wörtlich
gilt. Ein Punkt in der Adresse ist dann wirklich ein Punkt und nicht „irgendein Zeichen“. Erst
danach wird aus dem maskierten {id} die Klammer ([0-9]+). Die runden Klammern halten den
gefundenen Wert fest, preg_match legt ihn in $treffer, und array_slice schneidet den ersten
Eintrag weg, denn der ist immer der ganze Treffer.
Mit /notiz/abc passt im zweiten Beispiel kein Muster, denn eine Notiznummer ist eine Zahl.
Schreibst du stattdessen [^/]+, ist alles bis zum nächsten Schrägstrich erlaubt, und damit hast du
das Problem aus dem nächsten Abschnitt.
Warum die Reihenfolge zählt
<?php
declare(strict_types=1);
// Hier steht im Muster absichtlich [^/]+ statt [0-9]+, das Muster
// erlaubt also jedes Stueck ohne Schraegstrich. Damit schluckt
// /notiz/{id} auch die Adresse /notiz/neu, und dann entscheidet die
// Reihenfolge, wer sie bekommt.
function passtRoute(string $muster, string $pfad): ?array
{
$regex = "#^" . str_replace('\{id\}', '([^/]+)', preg_quote($muster, "#")) . "$#";
if (preg_match($regex, $pfad, $treffer) !== 1) {
return null;
}
return array_slice($treffer, 1);
}
function ersteRoute(array $tabelle, string $pfad): string
{
foreach ($tabelle as $route) {
if (passtRoute($route[0], $pfad) !== null) {
return $route[1];
}
}
return "nichts gefunden";
}
$falsch = [
["/notiz/{id}", "seiteNotiz"],
["/notiz/neu", "seiteNeu"],
];
$richtig = [
["/notiz/neu", "seiteNeu"],
["/notiz/{id}", "seiteNotiz"],
];
?>
<!doctype html>
<html lang="de">
<head><meta charset="utf-8"><title>Reihenfolge</title>
<style>body{font-family:system-ui,sans-serif;max-width:36rem;margin:2rem auto}
td,th{border:1px solid #ccc;padding:.3rem .6rem;text-align:left}</style></head>
<body>
<h1>Wer bekommt die Adresse</h1>
<table>
<tr><th>Adresse</th><th>allgemeine Route zuerst</th><th>besondere Route zuerst</th></tr>
<?php foreach (["/notiz/12", "/notiz/neu"] as $pfad): ?>
<tr>
<td><code><?= $pfad ?></code></td>
<td><?= ersteRoute($falsch, $pfad) ?></td>
<td><?= ersteRoute($richtig, $pfad) ?></td>
</tr>
<?php endforeach; ?>
</table>
<p>In der linken Spalte landet <code>/notiz/neu</code> bei der falschen
Funktion, und zwar ohne jede Fehlermeldung: Sie sucht dann eine Notiz
mit der Nummer <code>neu</code>.</p>
</body>
</html> Sobald ein Muster mehr als eine Adresse trifft, kann es einer anderen Route in die Quere kommen.
Angenommen, es gibt /notiz/neu für ein leeres Formular und /notiz/{id} zum Ansehen, und im
Muster steht [^/]+. Dann passt /notiz/{id} auch auf /notiz/neu. Es gewinnt, was in der Tabelle
zuerst steht.
Im dritten Beispiel stehen beide Reihenfolgen nebeneinander. Steht die allgemeine Route oben, landet
/notiz/neu bei seiteNotiz, und die sucht dann ohne jede Fehlermeldung eine Notiz mit der Nummer
neu. Mit der besonderen Route oben bekommt seiteNeu die Adresse.
Im Kurs steht im Muster [0-9]+, und auf /notiz/neu passt /notiz/{id} damit gar nicht erst.
Was ein fertiger Router mehr kann
Der Router aus dieser Lektion ist etwa zwanzig Zeilen lang und deckt ab, was eine kleine Anwendung
braucht. Ein fertiger lohnt sich, sobald du am eigenen mehr baust als mit ihm. nikic/fast-route
aus Lektion 9.4 kann vier Dinge mehr, und die merkt man schnell.
Er kennt Typen im Muster, also {id:\d+} gegen {name}, statt die Entscheidung wie hier fest
einzubauen. Feste Pfade schlägt er in einer Tabelle nach und fasst die übrigen zu wenigen großen
Mustern zusammen, statt für jede Anfrage die ganze Tabelle durchzugehen. Bei fünf Routen ist das
egal. Bei fünfhundert nicht mehr. Er unterscheidet „kein Pfad passt“ von „der Pfad passt, aber nicht
mit dieser Methode“, und das ist der Unterschied zwischen 404 und 405. Und den Fall aus dem dritten
Beispiel lässt er gar nicht erst zu, denn /notiz/neu hinter /notiz/{id} lehnt er mit einer
BadRouteException ab, statt still die falsche Funktion zu nehmen.
In der Aufgabe bekommt jede Route der Notizliste zusätzlich eine Methode.
Zum Mitnehmen
Eine Route mit einem Muster wie /notiz/{id} trifft jede Notiznummer mit einer einzigen Zeile, und preg_match holt den Wert heraus. Passt ein Muster auf mehr, als es soll, gewinnt die Route, die weiter oben in der Tabelle steht.
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.