Abschnitt 11 · Lektion 2
Eingaben prüfen
Ein Name aus drei Leerzeichen, mia@example als E-Mail-Adresse und 3 Stück als Menge kommen bei
deinem Programm genauso an wie gültige Werte. Ein Formular nimmt alles entgegen, was jemand
hineinschreibt. Zwischen dem Absenden und dem Speichern steht deshalb immer eine Prüfung.
Die drei Fragen
Zu jedem einzelnen Feld gehören drei Fragen, und sie bauen aufeinander auf.
Die erste ist, ob das Feld überhaupt da ist. Auch ein Feld, das im Formular steht, kann fehlen.
Jemand baut die Anfrage selbst zusammen und lässt es einfach weg. Zuständig ist isset(), und
danach kommt trim(), denn ein Feld mit drei Leerzeichen ist für einen Menschen leer und für PHP
nicht.
Die zweite fragt nach der Form. Sieht die E-Mail-Adresse wie eine aus, ist die Menge eine Zahl, hat die Postleitzahl fünf Stellen? Dafür gibt es fertige Funktionen.
Die dritte fragt, ob der Wert plausibel ist. Die Form kann stimmen und der Wert trotzdem Unsinn sein, etwa eine Menge von minus drei, ein Geburtsdatum im Jahr 2093 oder eine Bestellung über null Stück. Das weiß keine Funktion für dich. Das sind deine Regeln.
Da oder nicht da
<?php
declare(strict_types=1);
// Drei Fragen an dasselbe Feld, und sie haben drei verschiedene
// Antworten. Ganz leer abgeschickt antworten sie anders als mit
// nichts als zwei Leerzeichen im Feld.
$bericht = [];
if ($_SERVER["REQUEST_METHOD"] === "POST") {
$roh = $_POST["name"] ?? null;
$bericht["Feld angekommen (isset)"] = isset($_POST["name"]) ? "ja" : "nein";
$bericht["Roher Wert"] = var_export($roh, true);
$bericht["Nach trim() noch etwas übrig"] = trim((string) $roh) !== "" ? "ja" : "nein";
$bericht["Was empty() sagt"] = empty($roh) ? "leer" : "nicht leer";
}
?>
<!doctype html>
<html lang="de">
<head>
<meta charset="utf-8">
<title>Ist es da</title>
</head>
<body>
<h1>Ist es da, oder sieht es nur so aus</h1>
<form method="post" action="/">
<p><label>Name: <input type="text" name="name"></label></p>
<button type="submit">Absenden</button>
</form>
<ul>
<?php foreach ($bericht as $frage => $antwort) { ?>
<li><?= htmlspecialchars($frage) ?>: <strong><?= htmlspecialchars($antwort) ?></strong></li>
<?php } ?>
</ul>
</body>
</html> isset() beantwortet die erste Frage und sonst nichts. Es prüft, ob der Schlüssel existiert und
nicht null ist. Ein leer abgeschicktes Textfeld existiert sehr wohl, es enthält nur einen leeren
Text, und isset() sagt dafür ja. Ob jemand wirklich etwas hingeschrieben hat, siehst du erst am
Wert selbst. Du holst ihn mit ?? "" ab, befreist ihn mit trim() von Leerzeichen und vergleichst
ihn dann mit "".
empty() fragt wie in Lektion 2.5, ob PHP diesen Wert für falsch hält. Ein leeres Feld ist damit
leer, die Eingabe 0 aber auch. Deshalb ist empty() für Formularfelder eine Falle. Eine Menge von
0 ist eine Angabe und kein fehlendes Feld, zwei Leerzeichen dagegen hält empty() für Inhalt.
Die Form prüfen, ohne sie selbst zu beschreiben
<?php
declare(strict_types=1);
// Beim ersten Aufruf stehen zwei Werte im Formular, die beide
// knapp danebenliegen. Was filter_var dazu sagt, steht unter dem
// Formular, vor und nach dem Absenden.
$istPost = $_SERVER["REQUEST_METHOD"] === "POST";
$email = $istPost ? trim($_POST["email"] ?? "") : "mia@example";
$menge = $istPost ? trim($_POST["menge"] ?? "") : "3 Stück";
// Zurueck kommt der geprueft brauchbare Wert oder false. Bei der
// Zahl ist der Rueckgabewert deshalb interessant: aus dem Text
// "3" wird ein echtes int.
$emailGeprueft = filter_var($email, FILTER_VALIDATE_EMAIL);
$mengeGeprueft = filter_var($menge, FILTER_VALIDATE_INT);
?>
<!doctype html>
<html lang="de">
<head>
<meta charset="utf-8">
<title>filter_var</title>
</head>
<body>
<h1>Hat es die richtige Form?</h1>
<form method="post" action="/">
<p><label>E-Mail: <input type="text" name="email" value="<?= htmlspecialchars($email) ?>"></label></p>
<p><label>Menge: <input type="text" name="menge" value="<?= htmlspecialchars($menge) ?>"></label></p>
<button type="submit">Prüfen</button>
</form>
<ul>
<li>FILTER_VALIDATE_EMAIL gibt zurück:
<strong><?= htmlspecialchars(var_export($emailGeprueft, true)) ?></strong></li>
<li>FILTER_VALIDATE_INT gibt zurück:
<strong><?= htmlspecialchars(var_export($mengeGeprueft, true)) ?></strong></li>
</ul>
<p>Gültig wären etwa <code>mia@example.com</code> und <code>3</code>.</p>
</body>
</html> Eine E-Mail-Adresse mit einem eigenen Muster zu prüfen, ist eine Übung, die man einmal macht und
danach bereut. Die Regeln sind unangenehm, und ein eigenes Muster weist schnell eine gültige Adresse
ab, etwa eine mit Pluszeichen wie mia+notizen@example.com.
filter_var() nimmt dir das ab. Der zweite Parameter sagt, worauf geprüft wird:
FILTER_VALIDATE_EMAIL für Adressen, FILTER_VALIDATE_INT für ganze Zahlen,
FILTER_VALIDATE_FLOAT für Kommazahlen und FILTER_VALIDATE_URL für Adressen im Netz.
Die Funktion gibt den geprüften Wert zurück oder false. Bei der Zahl wird so aus dem Text "3"
ein echtes int, mit dem du sofort rechnen kannst. Bei "3 Stück" kommt false, denn eine Zahl
mit Anhang ist für die Funktion keine Zahl.
Geprüft wird deshalb mit === false und nicht mit !. Eine eingegebene 0 ist gültig, und
filter_var() gibt sie als 0 zurück. ! hält aber gerade diese Zahl für falsch. Mit ! landet
die gültige Eingabe also bei den Fehlern, und keine Meldung sagt dir, warum.
Warum die Prüfung im Browser nicht reicht
Der Browser prüft für den Besucher, der Server prüft für dich. required, type="email" und min
aus dem HTML-Kurs sind weiterhin richtig. Sie sagen dem Besucher sofort Bescheid, statt ihn eine
Seite weiterzuschicken.
Aufhalten tun sie niemanden. Wer die Anfrage selbst zusammenbaut, statt dein Formular zu benutzen,
sieht dein Markup nie. Das ist nicht mal böse gemeint, denn so arbeitet jedes Werkzeug, mit dem man
Schnittstellen ausprobiert. curl im Terminal ist so eines. Mit -d schickt es einen POST mit den
Feldern, die du ihm nennst, an jedem Formular vorbei. Auf demselben Weg laufen seit Abschnitt 10
auch die Prüfungen der Prüfliste.
Alle Fehler auf einmal
<?php
declare(strict_types=1);
// Drei Pruefungen, zweimal ausgewertet. Links bricht die Auswertung
// beim ersten Fehler ab, rechts sammelt sie alles ein. Ein leer
// abgeschicktes Formular zeigt den Unterschied.
$istPost = $_SERVER["REQUEST_METHOD"] === "POST";
$ort = trim($_POST["ort"] ?? "");
$alter = trim($_POST["alter"] ?? "");
$webseite = trim($_POST["webseite"] ?? "");
$alle = [];
if ($ort === "") {
$alle[] = "Bitte trag einen Ort ein";
}
if (filter_var($alter, FILTER_VALIDATE_INT) === false) {
$alle[] = "Das Alter ist keine ganze Zahl";
}
if (filter_var($webseite, FILTER_VALIDATE_URL) === false) {
$alle[] = "Die Webseite ist keine Adresse";
}
$erster = $alle === [] ? [] : [$alle[0]];
?>
<!doctype html>
<html lang="de">
<head>
<meta charset="utf-8">
<title>Fehler sammeln</title>
<style>
.spalten { display: flex; gap: 2rem; }
</style>
</head>
<body>
<h1>Ein Fehler oder alle</h1>
<form method="post" action="/">
<p><label>Ort: <input type="text" name="ort"></label></p>
<p><label>Alter: <input type="text" name="alter"></label></p>
<p><label>Webseite: <input type="text" name="webseite"></label></p>
<button type="submit">Absenden</button>
</form>
<?php if ($istPost) { ?>
<div class="spalten">
<div>
<h2>Beim ersten Fehler abgebrochen</h2>
<ul>
<?php foreach ($erster as $meldung) { ?>
<li><?= htmlspecialchars($meldung) ?></li>
<?php } ?>
</ul>
</div>
<div>
<h2>Alles eingesammelt</h2>
<ul>
<?php foreach ($alle as $meldung) { ?>
<li><?= htmlspecialchars($meldung) ?></li>
<?php } ?>
</ul>
</div>
</div>
<?php } ?>
</body>
</html> Beim ersten Fehler abzubrechen, ist die naheliegende Bauart und die unangenehmste Bedienung, die man sich ausdenken kann. Der Besucher schickt ab, korrigiert eine Kleinigkeit, schickt ab und korrigiert die nächste. Bei drei Feldern sind das drei Runden. Schickst du das Formular im Beispiel leer ab, steht unter „Beim ersten Fehler abgebrochen“ eine Meldung und unter „Alles eingesammelt“ alle drei.
Besser ist ein Array. Jede Prüfung, die scheitert, hängt ihre Meldung hinten an, und danach wird einmal gefragt, ob etwas darin steht. Ist das Array leer, war alles in Ordnung, und es geht weiter.
In der Aufgabe prüfst du die drei Felder einer Bestellseite.
Zum Mitnehmen
Ein Feld kann fehlen, falsch geformt oder unplausibel sein. Gegen das Erste helfen ?? und trim mit dem Vergleich gegen den leeren Text, gegen das Zweite filter_var mit === false und gegen das Dritte nur eigene Regeln. Die Meldungen sammelt ein Array, damit der Besucher alle auf einmal sieht.
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.