Lektion 6.4: Formulare und Aktionen in einer View
Views, die etwas ändern, empfangen ein Formular. Der Kernel macht aus einer gedrückten Schaltfläche eine benannte
Aktion, übergibt der View die abgesendeten Werte und schützt jedes Formular mit einem Formular-Token gegen
Cross-Site Request Forgery. In dieser Lektion fügen die Teilnehmenden der View greet ein kleines Formular hinzu:
Ein Besucher gibt einen Namen ein, die View validiert ihn und leitet zur Begrüßung weiter.
Auf einen Blick
| Kurs | Entwickler |
| Modul | Modul 6: Module und Views |
| Dauer | 55 Minuten (15 Präsentation, 40 Übung) |
| Niveau | Fortgeschrittene |
| Zielgruppe | Entwickler |
| Voraussetzungen | Lektion 6.3 |
Lernziele
Nach dieser Lektion können die Teilnehmenden:
- eine Schaltfläche mit
single_post_actionseiner Aktion und ihre Werte mitpost_action_parameterszuordnen; - die Aktion mit
$Module->isCurrentAction()prüfen und Werte mit$Module->actionParameter()lesen; - Eingaben in der View validieren und im Template einen Fehler anzeigen;
- nach erfolgreichem Absenden mit
$Module->redirectTo()weiterleiten; - erklären, was der Formular-Token (
ezformtoken) tut und was die Seite „Formular abgelaufen“ bedeutet.
Hinweise für Trainer
So präsentieren Sie es
Quellen: kernel/content/module.php (single_post_actions von edit und copy), die Methoden isCurrentAction(),
actionParameter() und redirectTo() in lib/ezutils/classes/ezmodule.php sowie
„Dieses Formular ist abgelaufen“.
- Aktionen (4 Minuten). In
module.phpbedeutet'single_post_actions' => array( 'GreetButton' => 'Greet' ): Ein POST mit einem FeldGreetButtonist die AktionGreet.'post_action_parameters' => array( 'Greet' => array( 'Name' => 'GreetName' ) )stellt das abgesendete FeldGreetNameals AktionsparameterNamebereit. - In der View (4 Minuten).
if ( $Module->isCurrentAction( 'Greet' ) ), dann$Module->actionParameter( 'Name' ). Validieren; bei Erfolgreturn $Module->redirectTo( ... ); bei einem Fehler eine Fehlermeldung für das Template setzen. - Post, Redirect, Get (2 Minuten). Eine Weiterleitung nach erfolgreichem Absenden bedeutet, dass ein Neuladen nicht erneut absendet.
- Der Formular-Token (3 Minuten).
ezformtokenfügt jedem HTML-Formular, das der Kernel ausgibt, ein verstecktes Feldezxform_tokenhinzu und prüft es bei jedem POST. Ein POST ohne dieses Feld wird mit der Seite „Formular abgelaufen“ abgewiesen: Nichts wird gespeichert. JavaScript, das Daten absendet, muss den Token ebenfalls mitschicken. - Der Eingabe niemals vertrauen (2 Minuten). In PHP Leerzeichen abschneiden und Länge und Zeichen prüfen; im Template escapen.
Häufige Fragen
Füge ich das Token-Feld selbst hinzu? Nein, der Ausgabefilter fügt es den Formularen im HTML hinzu. Ajax-Code
muss es mitschicken; das README von ezformtoken erklärt, wie.
Warum redirectTo und nicht einfach das Ergebnis anzeigen? Beim Neuladen einer Seite, die aus einem POST
stammt, fragt der Browser, ob erneut abgesendet werden soll; eine Weiterleitung macht daraus einen normalen
Seitenaufruf.
Kann ich $_POST direkt verwenden? Verwenden Sie eZHTTPTool::instance()->postVariable() oder die
Aktionsparameter; diese nutzt auch der übrige Kernel, und andere Entwickler erwarten sie.
Stolperfallen
- Ein Schaltflächenname, der nicht in
single_post_actionssteht. Die View sieht keine Aktion; nichts passiert. - Mit einer Seite testen, die vor einem Neustart geöffnet wurde. Eine alte Seite kann einen alten Token enthalten: Laden Sie das Formular zuerst neu.
- Eine Weiterleitung auf eine aus der Eingabe gebaute Adresse. Leiten Sie auf Ihre eigene View weiter, niemals auf eine Adresse aus dem Formular (Sichere Weiterleitungen).
Praktische Übung
Auf der Schulungsinstallation, in extension/mysite_hello. Als Administrator angemeldet oder mit der Richtlinie für
Anonymous aus Lektion 6.3.
Erweitern Sie die View in
modules/hello/module.php:$ViewList['greet'] = array( 'functions' => array( 'greet' ), 'script' => 'greet.php', 'params' => array( 'Name' ), 'unordered_params' => array( 'times' => 'Times' ), 'single_post_actions' => array( 'GreetButton' => 'Greet' ), 'post_action_parameters' => array( 'Greet' => array( 'Name' => 'GreetName' ) ) );Fügen Sie die Aktionsverarbeitung am Anfang von
modules/hello/greet.phpein, nach dem einleitenden Kommentar:$error = false; if ( $Module->isCurrentAction( 'Greet' ) ) { $posted = trim( (string)$Module->actionParameter( 'Name' ) ); if ( $posted === '' || mb_strlen( $posted ) > 40 ) { $error = 'Please type a name of 1 to 40 characters.'; } else { return $Module->redirectTo( '/hello/greet/' . rawurlencode( $posted ) ); } }und übergeben Sie sie an das Template:
$tpl->setVariable( 'error', $error );.Fügen Sie das Formular in
design/standard/templates/hello/greet.tplein:if $error<p class="error">$error|wash</p>/if <form method="post" action='/hello/greet'|ezurl> <label for="greet-name">Name</label> <input id="greet-name" type="text" name="GreetName" value="" /> <input type="submit" name="GreetButton" value="Greet" /> </form>Prüfen Sie die Dateien mit
php -lundeztemplatecheck.php; leeren Sie die Cachesini,global_iniund den Template-Cache.Öffnen Sie
/hello/greet, geben Sie einen Namen ein und klicken Sie auf Greet.Senden Sie das Formular leer ab; lesen Sie die Fehlermeldung.
Sehen Sie sich den Seitenquelltext des Formulars an und suchen Sie das versteckte Feld
ezxform_token.Löschen Sie in den Entwicklerwerkzeugen des Browsers das versteckte Token-Feld und senden Sie das Formular dann ab: Lesen Sie die Seite „Formular abgelaufen“.
Committen Sie die Änderungen.
Erwartetes Ergebnis
- Schritt 5 leitet zu
/hello/greet/<name>weiter und begrüßt den Namen. - Schritt 6 zeigt „Please type a name of 1 to 40 characters.“ über dem Formular.
- Schritt 7: ein
<input type="hidden" name="ezxform_token" ...>innerhalb des Formulars. - Schritt 8: die Seite „Formular abgelaufen“; nichts wird verarbeitet.
- Der Trainer prüft das Formular einer Person in den Entwicklerwerkzeugen des Browsers.
Quiz
- Was bewirkt
'single_post_actions' => array( 'GreetButton' => 'Greet' )? - Welche Methode teilt der View mit, dass die Aktion
Greetabgesendet wurde? A.actionParameter()B.isCurrentAction()C.redirectTo()D. nurcurrentAction() - Warum wird nach erfolgreichem Absenden weitergeleitet?
- Wogegen schützt der Formular-Token?
- Wo muss die Fehlermeldung escapt werden?
Antworten
- Ein POST mit dem Feld
GreetButtonwird zur AktionGreet. - B.
$Module->isCurrentAction( 'Greet' ). - Damit ein Neuladen das Formular nicht erneut absendet (Post, Redirect, Get).
- Gegen Cross-Site Request Forgery: Eine andere Website bringt den Browser dazu, ein Formular an Ihre Website abzusenden.
- Im Template, dort, wo sie ausgegeben wird:
{$error|wash}.
Weiterführende Literatur
- „Dieses Formular ist abgelaufen“: Abweisungen durch den Formular-Token.
- Sichere Weiterleitungen: Weiterleitungsziele aus Benutzereingaben.
- Sicherheitsstandard: die Sicherheitsregeln des Projekts für Code.
Verwandte Seiten
- Modul 6: Module und Views
- Entwickler: Kursüberblick
- Trainer: hier beginnen
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.