Abschnitt 11 · Lektion 1
Ein Formular abschicken
Ein Formular aus reinem HTML schickt beim Klick seine Felder ab, und dann passiert nichts Sinnvolles. Am anderen Ende nimmt niemand die Werte an. Dafür braucht es ein PHP-Programm, das sie entgegennimmt und eine Antwort daraus macht.
Wohin und wie die Daten gehen
<?php
declare(strict_types=1);
// Eine Datei, zwei Faelle. Ohne Absenden steht hier das Formular,
// nach dem Absenden zusaetzlich die Antwort.
$name = "";
if ($_SERVER["REQUEST_METHOD"] === "POST") {
$name = trim($_POST["name"] ?? "");
}
?>
<!doctype html>
<html lang="de">
<head>
<meta charset="utf-8">
<title>Wer bist du?</title>
</head>
<body>
<h1>Wer bist du?</h1>
<form method="post" action="/">
<p><label>Dein Name: <input type="text" name="name"></label></p>
<button type="submit">Absenden</button>
</form>
<?php if ($name !== "") { ?>
<p>Hallo, <?= htmlspecialchars($name) ?>. Diesen Satz hat dein Server
gerade zusammengesetzt, in dem Moment, in dem du auf Absenden gedrückt hast.</p>
<?php } ?>
<p>Angefragt wurde diese Seite gerade mit
<code><?= htmlspecialchars($_SERVER["REQUEST_METHOD"]) ?></code>.</p>
</body>
</html> Am <form>-Element stehen zwei Attribute, und die bestimmen zusammen, was beim Klick passiert.
In action steht, wohin die Daten gehen. Bei / geht es an die Startseite, also an dieselbe Datei,
die das Formular ausgeliefert hat. Das ist im Kurs der Normalfall, denn eine Datei, die beide Fälle
beherrscht, hält Formular und Auswertung beieinander. Lässt du action ganz weg, geht es ebenfalls
an die aktuelle Adresse. Nur sieht man das dem Formular dann nicht mehr an.
method legt fest, wie die Daten gehen. post packt sie in den Rumpf der Anfrage, get hängt sie
an die Adresse. Technisch ist das schon der ganze Unterschied, und trotzdem hängt ziemlich viel
daran.
Das dritte Attribut, name, steht an jedem einzelnen Feld. Es ist der Schlüssel, unter dem der Wert
bei dir ankommt, aus <input name="ort"> wird $_POST["ort"].
Eine Datei, zwei Fälle
Beim ersten Aufruf hat der Besucher noch nichts abgeschickt. Er will das Formular sehen. Nach dem Klick auf Absenden kommt dieselbe Adresse noch einmal dran, diesmal mit Daten, und jetzt soll etwas anderes passieren.
Auseinanderhalten kannst du die beiden an $_SERVER["REQUEST_METHOD"]. Beim Aufruf über einen Link
oder die Adresszeile steht dort GET, nach dem Absenden eines POST-Formulars POST. Im Beispiel
steht die Methode unter dem Formular, und so siehst du beide Fälle.
Tippst du einen Namen ins Feld und klickst auf Absenden, steht unter dem Formular ein Satz, den es
eine Sekunde vorher noch nicht gab. Im Reiter Netzwerk kommt eine Zeile dazu, und zum ersten Mal in
diesem Kurs heißt die Methode dort POST. Die Adresse ist dieselbe geblieben. Der Name steht nicht
darin, denn er ist im Rumpf der Anfrage mitgereist. Klappst du die Zeile auf, findest du ihn unter
dem Anfrage-Rumpf, als name= mit dem, was im Feld stand.
GET fragt ab, POST verändert
<?php
declare(strict_types=1);
// Dasselbe Formular, nur mit method="get". Nach dem Absenden steht
// das Suchwort in der Adresszeile.
$suche = trim($_GET["ware"] ?? "");
$waren = ["Apfel", "Birne", "Brot", "Butter", "Kaffee", "Milch"];
$treffer = [];
foreach ($waren as $ware) {
if ($suche !== "" && stripos($ware, $suche) !== false) {
$treffer[] = $ware;
}
}
?>
<!doctype html>
<html lang="de">
<head>
<meta charset="utf-8">
<title>Suche</title>
</head>
<body>
<h1>Was suchst du?</h1>
<form method="get" action="/">
<p><label>Ware: <input type="text" name="ware" value="<?= htmlspecialchars($suche) ?>"></label></p>
<button type="submit">Suchen</button>
</form>
<p>In der Adresse steht gerade:
<code><?= htmlspecialchars($_SERVER["REQUEST_URI"]) ?></code></p>
<?php if ($suche !== "") { ?>
<p><?= count($treffer) ?> Treffer:</p>
<ul>
<?php foreach ($treffer as $ware) { ?>
<li><?= htmlspecialchars($ware) ?></li>
<?php } ?>
</ul>
<?php } ?>
</body>
</html> Eine Suche, eine Sortierung, ein Filter und eine Seitenzahl fragen etwas ab und gehen mit GET. Eine Bestellung, eine neue Notiz, eine Anmeldung und ein Löschen verändern etwas und gehen mit POST.
Das ist keine Geschmackssache. Was per GET geht, steht in der Adresse. Eine Adresse landet im Verlauf des Browsers, in den Lesezeichen und im Protokoll des Servers, und man kann sie jederzeit kopieren und an jemand anderen weiterschicken. Für eine Suche ist das ein Vorteil, denn so landet der andere direkt beim Suchergebnis. Für ein Passwort ist es eine Katastrophe, weil es danach im Verlauf und im Protokoll des Servers stünde.
Suchst du im zweiten Beispiel, steht im Reiter Netzwerk nach dem Absenden GET und dahinter die
Adresse mit ?ware= am Ende. Was im Feld stand, ist diesmal Teil der Adresse geworden.
Daran hängt auch eine Eigenheit des Browsers, und um die geht es in der Lektion über das Weiterleiten. Eine Seite, die per GET geladen wurde, lädt er beim Neuladen einfach noch einmal. Bei einer Seite aus einem POST fragt er erst nach, ob er die Daten wirklich noch einmal schicken soll.
Wo die Werte landen
Für beide Wege füllt PHP ein Array, $_GET aus der Adresse wie in Lektion 10.3 und $_POST aus dem
Rumpf der Anfrage. Die Schlüssel sind die name-Attribute aus deinem Markup. Die Werte sind immer
Text, auch bei einem Zahlenfeld.
Die beiden Arrays sind unabhängig voneinander. Zeigt bei einem Formular mit method="post" die
action auf /suche?seite=2, werden beide gefüllt. Die Felder landen in $_POST und die seite
in $_GET.
Was ohne name passiert
<?php
declare(strict_types=1);
// Zwei Felder, beide ausgefuellt, und trotzdem kommt nur eines an.
// Der Unterschied steht im Markup unten.
$angekommen = [];
if ($_SERVER["REQUEST_METHOD"] === "POST") {
$angekommen = $_POST;
}
?>
<!doctype html>
<html lang="de">
<head>
<meta charset="utf-8">
<title>Was ankommt</title>
</head>
<body>
<h1>Was ankommt</h1>
<form method="post" action="/">
<p><label>Mit name: <input type="text" name="ort" value="Kiel"></label></p>
<p><label>Ohne name: <input type="text" value="Hamburg"></label></p>
<button type="submit">Absenden</button>
</form>
<p>Von den beiden Feldern sind <?= count($angekommen) ?> angekommen.</p>
<ul>
<?php foreach ($angekommen as $schluessel => $wert) { ?>
<li><?= htmlspecialchars($schluessel) ?> = <?= htmlspecialchars($wert) ?></li>
<?php } ?>
</ul>
</body>
</html> Ein Feld ohne name schickt der Browser gar nicht erst mit. Es taucht weder in $_POST noch sonst
irgendwo auf. PHP verliert kein Wort darüber, und so sucht man den Fehler zuerst im eigenen Code.
Im Beispiel sind beide Felder vorausgefüllt. Nach dem Absenden steht darunter, wie viele davon
angekommen sind, und in der Liste steht nur ort.
Was ankommt, hat jemand anderes geschickt
Alles, was in $_POST ankommt, hat jemand anderes bestimmt. Und dieser Jemand muss weder dein
Formular benutzt noch überhaupt einen Browser verwendet haben. Ein Feld kann leer sein, doppelt so
lang wie gedacht, Markup enthalten oder ganz fehlen, obwohl es im Formular steht.
Darum geht es in den nächsten drei Lektionen. Was ankommt, wird geprüft, nach dem Speichern wird weitergeleitet, und was wieder auf die Seite geht, wird maskiert.
In der Aufgabe fragt ein Gästebuch nach Name und Ort und antwortet mit einem Satz.
Zum Mitnehmen
Ein Formular schickt seine Felder an die Adresse in action, mit post im Rumpf der Anfrage und mit get in der Adresse, und PHP legt sie unter ihrem name in $_POST oder $_GET ab. Abfragen gehen mit GET, Änderungen mit POST, und was ankommt, kann jeder geschickt haben.
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.