Abschnitt 11 · Lektion 3
Nach dem Absenden weiterleiten
Die Bestellung ist raus, und die Seite bedankt sich. Lädt der Besucher sie jetzt neu und bestätigt die Nachfrage des Browsers, geht dieselbe Bestellung ein zweites Mal raus. Dein Programm speichert sie dann noch einmal.
Was beim Neuladen passiert
<?php
declare(strict_types=1);
// Nach dem Absenden antwortet diese Seite direkt mit dem Ergebnis.
// Im Reiter Netzwerk steht dann ein POST, und die Seite ist die
// Antwort darauf. Im Terminal schickt
// curl -s -X POST localhost:3000/ denselben POST noch einmal, und
// der Zaehler zaehlt weiter.
$datei = __DIR__ . "/bestellungen.txt";
if ($_SERVER["REQUEST_METHOD"] === "POST") {
file_put_contents($datei, "eine Bestellung\n", FILE_APPEND);
}
$anzahl = file_exists($datei) ? count(file($datei)) : 0;
?>
<!doctype html>
<html lang="de">
<head>
<meta charset="utf-8">
<title>Bestellen</title>
</head>
<body>
<h1>Bestellen ohne Weiterleitung</h1>
<form method="post" action="/">
<button type="submit">Jetzt bestellen</button>
</form>
<p>Bisher eingegangen: <strong><?= $anzahl ?></strong></p>
<p>Abgeschickt wurde diese Seite mit
<code><?= htmlspecialchars($_SERVER["REQUEST_METHOD"]) ?></code>.</p>
</body>
</html> Ein Browser merkt sich, wie er zu der Seite gekommen ist, die gerade vor ihm steht. Kam sie über einen Link, war das ein GET, und F5 heißt dann einfach, dieselbe Adresse noch einmal zu holen.
Kam sie aber als Antwort auf ein abgeschicktes Formular, war es ein POST. Dann bedeutet F5 etwas ganz anderes, nämlich dieselben Daten noch einmal hinschicken. Der Browser weiß, dass das heikel ist, und fragt vorher nach. Diese Nachfrage kennst du bestimmt, und jetzt weißt du auch, warum sie kommt.
Bestätigt der Besucher die Nachfrage, hat dein Programm nichts falsch gemacht. Es hat zweimal getan, was es sollte.
In der Lektionsansicht siehst du die Nachfrage selbst nicht. F5 lädt hier die ganze Lektion neu und
nicht die Seite im Browser, und der Button Seite neu laden holt die Adresse immer mit einem GET.
Nach einem Klick auf „Jetzt bestellen“ steht im Reiter Netzwerk POST /, und als Antwort auf diesen
POST merkt sich ein Browser die Seite. Im Terminal schickst du denselben POST mit
curl -s -X POST localhost:3000/ | grep eingegangen noch einmal, so wie es der Browser nach der
bestätigten Nachfrage täte. Zweimal ausgeführt, und der Zähler steht auf zwei, ohne dass jemand ein
Formular ausgefüllt hätte.
Weiterleiten statt antworten
<?php
declare(strict_types=1);
// Dieselbe Seite, zwei Zeilen mehr. Nach dem Speichern geht eine
// Weiterleitung hinaus, und der Browser holt die Zielseite mit
// einem ganz gewoehnlichen GET. Im Reiter Netzwerk sind das zwei
// Zeilen statt einer.
$datei = __DIR__ . "/bestellungen.txt";
if ($_SERVER["REQUEST_METHOD"] === "POST") {
file_put_contents($datei, "eine Bestellung\n", FILE_APPEND);
header("Location: /", true, 302);
exit;
}
$anzahl = file_exists($datei) ? count(file($datei)) : 0;
?>
<!doctype html>
<html lang="de">
<head>
<meta charset="utf-8">
<title>Bestellen</title>
</head>
<body>
<h1>Bestellen mit Weiterleitung</h1>
<form method="post" action="/">
<button type="submit">Jetzt bestellen</button>
</form>
<p>Bisher eingegangen: <strong><?= $anzahl ?></strong></p>
<p>Abgeschickt wurde diese Seite mit
<code><?= htmlspecialchars($_SERVER["REQUEST_METHOD"]) ?></code>.</p>
</body>
</html> Die Lösung ist so alt wie das Problem und heißt „nach dem Speichern weiterleiten“ (englisch
Post/Redirect/Get). Der POST kommt an, dein Programm erledigt seine Arbeit, und statt mit einer
Seite antwortet es mit einer Weiterleitung (englisch redirect). Der Browser sieht die Kopfzeile
Location und holt die genannte Adresse mit einem gewöhnlichen GET. Diese zweite Antwort ist die
Seite, die der Besucher sieht.
Damit steht am Ende ein GET vor ihm, und Neuladen ist wieder harmlos. Im Reiter Netzwerk steht der
Klick als zwei Zeilen, erst POST / mit dem Statuscode 302 und Location: / in den
Antwort-Kopfzeilen, darunter GET / mit 200. Auf der Seite selbst steht dazu, dass sie mit GET
abgeschickt wurde.
header() kennst du schon aus Lektion 10.4. Dort hat die Funktion den Content-Type gesetzt, hier
setzt sie Location.
Statuscode 302 heißt „liegt vorübergehend woanders“. Für diesen Fall, die Antwort auf einen POST, sieht der HTTP-Standard eigentlich 303 vor („See Other“). Browser machen aus einer 302 nach einem POST aber seit jeher ein GET, und PHP setzt sie von selbst. Ich bleibe im Kurs deshalb bei 302. Falsch ist 301. Eine 301 merkt sich der Browser und ruft die alte Adresse danach gar nicht mehr auf.
Und wie jede Kopfzeile muss auch diese hinaus, bevor das erste Zeichen der Seite unterwegs ist. Sie gehört also in den PHP-Block ganz oben und nicht irgendwo zwischen das Markup.
Warum das exit dazugehört
<?php
declare(strict_types=1);
// Hier fehlt das exit mit Absicht. Nach header() ist das Programm
// eben nicht zu Ende, und die Zeile darunter schreibt munter
// weiter. Ein Klick auf den Button, zwei Eintraege im Protokoll.
$datei = __DIR__ . "/protokoll.txt";
if ($_SERVER["REQUEST_METHOD"] === "POST") {
file_put_contents($datei, "gespeichert\n", FILE_APPEND);
header("Location: /?fertig=1", true, 302);
// Ohne exit laeuft PHP hier weiter.
file_put_contents($datei, "und aus Versehen noch einmal gespeichert\n", FILE_APPEND);
}
$zeilen = file_exists($datei) ? file($datei, FILE_IGNORE_NEW_LINES) : [];
?>
<!doctype html>
<html lang="de">
<head>
<meta charset="utf-8">
<title>Protokoll</title>
</head>
<body>
<h1>Ein Klick, zwei Einträge</h1>
<form method="post" action="/">
<button type="submit">Einmal speichern</button>
</form>
<ol>
<?php foreach ($zeilen as $zeile) { ?>
<li><?= htmlspecialchars($zeile) ?></li>
<?php } ?>
</ol>
</body>
</html> header() verschickt nichts, es notiert nur, und es beendet dein Programm nicht. Die Zeilen
darunter laufen weiter, als wäre nichts gewesen. Erst exit beendet es. An dieser Stelle hört PHP
auf, und die Antwort geht so hinaus, wie sie bis dahin steht.
Im dritten Beispiel fehlt das exit. Ein Klick auf „Einmal speichern“ legt deshalb zwei Einträge
an. Hier ist die zweite Zeile nur ein Eintrag in einer Textdatei. In einer echten Anwendung ist es
die Zeile, die doppelt bucht, und mit einer Mail wäre es ein zweiter Versand.
Bei Markup fällt das kaum auf, denn der Browser wirft den Rumpf einer Weiterleitung sowieso weg. Im
Terminal zeigt curl -si -X POST localhost:3000/ beim dritten Beispiel trotzdem die Statuszeile mit
der 302, darunter Location: /?fertig=1 und darunter die ganze Seite, die kein Browser je anzeigt.
Wie die Meldung ans Ziel kommt
Nach der Weiterleitung fängt ein neuer Lauf an, und der weiß nichts von dem, was eben passiert ist. Alle Variablen sind weg, wie nach jeder Anfrage seit Abschnitt 10.
Am einfachsten hängst du die Information an die Adresse, also Location: /?gespeichert=1, und die
Zielseite liest sie aus $_GET. Das versteht man sofort. Nur steht die Bestätigung dann in der
Adresszeile, und wer die Adresse kopiert und weitergibt, schickt dem anderen eine Bestätigung für
etwas, das bei ihm nie passiert ist.
Sauberer ist es, die Meldung beim Server abzulegen und am Ziel einmal wieder herauszuholen. Dafür braucht es eine Sitzung, und die kommt in Abschnitt 12.
In der Aufgabe soll eine Notizseite nach dem Speichern auf /?gespeichert=1 weiterleiten, statt
gleich mit der fertigen Seite zu antworten.
Zum Mitnehmen
Nach einem POST leitet die Seite weiter, und der Browser holt die Zielseite mit GET. Neuladen schickt dann nichts mehr doppelt, und hinter der Weiterleitung steht immer exit, weil header() das Programm nicht beendet.
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.