Schnellstart mit Zend_FormDiese Anleitung soll die Grundsätze der Erstellung, Validierung und Darstellung von Formularen mit Zend_Form zeigen. Ein Form Objekt erstellenDie Erstellung eines Formular Objektes ist sehr einfach: nur Zend_Form instanzieren: Für fortgeschrittene Anwendungsfälle, kann man eine Zend_Form Unterklasse erstellen, aber für einfache Formulare, kann ein Formular programmtechnisch mit einem Zend_Form erstellt werden. Wenn man bei einem Formular Aktion und Methode spezifizieren will (immer eine gute Idee), kann das mit den setAction() und setMethod() Methoden gemacht werden:
Der obige Code setzt die Formular Aktion zu der partiellen URL "/resource/process" und die Formular Methode zu HTTP POST. Das wird während der endgültigen Darstellung berücksichtigt. Man kann zusätzliche HTML Attribute für das <form> Tag setzen, indem die setAttrib() oder setAttribs() Methoden verwendet werden. Zum Beispiel wenn man die ID setzen will, setzt man das "id" Attribut:
Elemente einer Form hinzufügenEin Formular ist nichts ohne seine Elemente. Zend_Form kommt mit einigen Standardelementen die XHTML über Zend_View Helfer darstellen. Das sind die folgenden:
Es gibt zwei Optionen für das Hinzufügen von Elementen zu einem Formular: Man kann ein konkretes Element instanzieren und dieses dem Objekt übergeben, oder man kann den Typ des Elements übergeben und Zend_Form ein Objekt des richtigen Typs für einen instanzieren lassen. Einige Beispiele:
Standardmäßig haben diese Elemente keine Prüfer oder Filter. Das bedeutet, dass man eigene Elemente mit minimalen Prüfern und potentiellen Filtern konfigurieren muss. Man kann das entweder (a) vor der Übergabe des Elements an das Formular machen, (b) über Konfigurationsoptionen die bei der Erstellung des Elements über Zend_Form angegeben werden, oder (c), durch beziehen des Elements vom Formular Objekt und dessen Konfiguration im nachhinein. Betrachten wir zuerst die Erstellung eines Prüfers für eine konkrete Instanz eines Elements. Es können entweder Zend_Validate_* Instanzen übergeben werden, oder der Name des Prüfers, der verwendet werden soll:
Wenn die zweite Option verwendet wird, kann, wenn der Prüfer Argumente im Konstruktor akzeptiert, diesem ein Array als dritter Parameter übergeben werden:
(Der zweite Parameter wird verwendet um anzuzeigen, ob spätere Prüfer bei einem Fehler dieses Prüfers ausgeführt werden sollen oder nicht; standardmäßig ist er FALSE.) Es kann auch gewünscht sein, ein Element als benötigt zu spezifizieren. Das kann durch Verwendung eines Accessors getan werden, oder durch die Übergabe einer Option bei der Erstellung des Elements. Im ersteren Fall:
Wenn ein Element benötigt wird, wird ein 'NotEmpty' Prüfer ganz oben in der Prüfkette definiert, um sicherzustellen, dass dieses Element einen Wert hat wenn er benötigt wird. Filter werden grundsätzlich auf dem gleichen Weg, wie die Prüfer, definiert. Zu Anschauungszwecken, wird ein Filter hinzugefügt, der den endgültigen Wert klein schreibt:
Das endgültige Setup, des Elements, könnte wie folgt aussehen:
So einfach das ist, ist das für jedes einzelne Elemet in einer Form sehr aufwendig. Versuchen wir es also mit Option (b) von oben. Wenn wir ein neues Element erstellen wird Zend_Form::addElement() als Factory verwendet, und wir können optional Konfigurationsoptionen übergeben. Diese können Prüfer und Filter enthalten die angepasst werden können. Um alles von oben implizit durchzuführen, versuchen wir folgendes:
Ein Formular darstellen
Die Darstellung eines Formulars ist einfach. Die meisten Elemente verwenden einen
Zend_View Helfer, um sich selbst darzustellen und benötigen
deshalb ein View Objekt, um dargestellt zu werden. Dafür gibt es zwei unterschiedliche
Varianten: Die
Standardmäßig versuchen Zend_Form und Zend_Form_Element ein im ViewRenderer initialisiertes View Objekt zu verwenden, was bedeutet, dass die View nicht manuell gesetzt werden muss, wenn das MVC des Zend Frameworks verwendet wird. Die Darstellung eines Formulars in einem View Skript ist sehr einfach: Unter der Hand verwendet Zend_Form "Dekoratoren" um die Darstellung durchzuführen. Diese Dekoratoren können Inhalte ersetzen, anfügen oder voranstellen, und haben eine volle Introspektive des Elements das Ihnen übergeben wurde. Als Ergebnis können mehrere Dekoratoren kombiniert werden, um eigene Effekte zu ermöglichen. Standardmüßig kombiniert Zend_Form_Element View Dekoratoren um seine Ausgaben zu erstellen; das Setup sieht ähnlich diesem aus:
(Wobei <HELPERNAME> der Name des View Helfers ist der verwendet wird, und variiert basierend auf dem Element.) Das obige Beispiel erstellt eine Ausgabe, ähnlich der folgenden:
(Wenngleich nicht mit der gleichen Formatierung.) Die Dekoratoren die von einem Element verwendet werden, können geändert werden, um eine andere Ausgabe zu erzeugen; seihe dazu das Kapitel über Dekoratoren für mehr Informationen. Das Formular selbst, geht alle Elemente durch, und fügt diese in eine HTML <form> ein. Die Aktion und Methode, die bei der Erstellung des Formulars angegeben wurden, werden dem <form> Tag angegeben, wie wenn sie Attribute wären, die über setAttribs() und ähnliche gesetzt werden. Elemente werden, entweder in der Reihenfolge in der sie registriert wurden durchlaufen, oder, wenn ein Element ein 'order' Attribut enthält, in dieser Reihenfolge. Die Reihenfolge eines Elements kann, wie folgt, gesetzt werden: Oder bei der Erstellung des Elements durch Übergabe als Option:
Prüfen, ob ein Formular gültig istNachdem ein Formular übermittelt wurde, muss diese geprüft werden, um zu sehen ob sie alle Prüfungen besteht. Jedes Element wird gegen die angegebenen Daten geprüft; wenn ein Schlüssel, der dem Elementnamen entspricht, nicht vorhanden ist, und das Element als benötigt markiert ist, werden die Prüfungen mit einem NULL Wert ausgeführt. Wo kommen die Daten her? Man kann $_POST oder $_GET verwenden, oder jede andere Datenquelle die man bei der Hand hat (Web Service Anfragen zum Beispiel):
Mit AJAX Anfragen kann man manchmal davon abweichen einzelne Elemente oder Gruppen von Elementen zu prüfen. isValidPartial() prüft einen Teil des Formulars. Anders, als isValid(), werden, wenn ein spezieller Schlüssel nicht vorhanden ist, Prüfungen für dieses spezielle Element nicht durchgeführt:
Eine zusätzliche Methode, processAjax(), kann auch dafür verwendet werden, um Teilformen zu prüfen. Anders als isValidPartial(), gibt sie eine JSON formatierten Zeichenkette zurück, die bei einem Fehler, die Fehlermeldungen enthält. Angenommen die Prüfungen sind durchgeführt worden, dann können jetzt die gefilterten Werte geholt werden: Wenn an irgendeinem Punkt die ungefilterten Werte benötigt werden, kann man folgendes verwenden: Wenn man andererseits alle gültigen und gefilterten Werte eines teilweise gültigen Formulars benötigt kann folgendes aufgerufen werden: Fehlerstatus holenDas Formular hat die Prüfungen nicht bestanden? In den meisten Fällen, kann das Formular neu dargestellt werden, und Fehler werden angezeigt wenn Standardekoratoren verwendet werden:
Wenn die Fehler inspiziert werden sollen, gibt es zwei Methoden. getErrors() gibt ein assoziatives Array von Elementnamen/Codes zurück (wobei Codes ein Array von Fehlercodes ist). getMessages() gibt ein assoziatives Array von Elementnamen/Nachrichten zurück (wobei Nachrichten ein assoziatives Array von Fehlercodes/Fehlernachrichten Paaren ist). Wenn ein gegebenes Element keinen Fehler hat, wird es dem Array nicht angefügt. Alles zusammenfügenBauen wir also ein Login Formular. Es benötigt Elemente die folgendes repräsentieren:
Für unsere Zwecke nehmen wir an, dass ein gültiger Benutzername nur alphanumerische Zeichen enthalten soll und mit einem Buchstaben beginnt, eine Mindestlänge von 6 und eine Maximallänge von 20 Zeichen hat; er wird zu Kleinschreibung normalisiert. Passwörter müssen mindestens 6 Zeichen lang sein. Der submit Wert wird einfach ignoriert wenn wir fertig sind, er kann also ungeprüft bleiben. Wir verwenden die Stärke von Zend_Form's Konfigurationsoptionen um die Form zu erstellen:
Als nächstes wird ein Controller erstellt der das Formular behandelt:
Und ein View Skript für die Darstellung des Formulars: Wie man im Controller Code sieht, gibt es mehr Arbeit zu tun: Während die Übertragung gültig sein muss, kann es trotzdem notwendig sein, zum Beispiel, ein Authentifizierung mit Hilfe von Zend_Auth durchzuführen. Ein Zend_Config Objekt verwendenAlle Zend_Form's sind konfigurierbar, indem Zend_Config verwendet wird; es kann entweder ein Zend_Config Objekt an den Kontruktor oder über setConfig() übergeben werden. Sehen wir uns an, wie das obige Formular erstellt werden kann, wenn wir eine INI Datei verwenden. Zuerst folgen wir den Notwendigkeiten und platzieren die Konfigurationen in Sektionen, die den Ort des Releases reflektieren, und fokusieren auf die 'development' Sektion. Als nächstes wird eine Sektion für den gegebenen Controller ('user') definiert und ein Schlüssel für das Formular ('login'):
Das kann dann an den Contruktor des Formulars übergeben werden:
und das komplette Formular wird definiert werden. SchlussfolgerungHoffentlich ist, mit dieser kleinen Anleitung der Weg klar, um die Leistung und Flexibilität von Zend_Form einzusetzen. Für detailiertere Informationen lesen Sie weiter!
|
|