10.3 Erweiterte Möglichkeiten 

Neben dem gezeigten Zugriff auf Formularfelder über das Formularobjekt stellt die Klasse ezcInputForm noch eine Reihe weiterer Methoden bereit:
- getInvalidProperties()
- getValidProperties()
- getOptionalProperties()
- getRequiredProperties()
Diese vier Methoden geben jeweils eine Liste von Formularfeldnamen zurück, die entsprechend valide/invalide oder optional/nicht optional sind. Mit Hilfe der Methode getUnsafeRawData(), die den Namen einer definierten Formularvariablen als Parameter erhält, können Sie explizit auf die nicht entwerteten Daten der Variablen zugreifen. Dies kann zum Beispiel sinnvoll sein, wenn Sie die Originaldaten loggen, analysieren oder dem Benutzer anzeigen wollen, dass ein Fehler aufgetreten ist. Im letzten Fall müssen Sie unbedingt darauf achten, die Daten vor der Ausgabe manuell zu entwerten, zum Beispiel mit Hilfe der PHP-Funktion htmlspecialchars().
Die beiden statischen Methoden hasPostData() und hasGetData() können Sie dazu verwenden, bereits vor der Instanziierung des eigentlichen Formularobjekts zu prüfen, ob überhaupt Daten mit der entsprechenden HTTP-Methode übertragen wurden, und somit etwas Rechenzeit und Speicherplatz sparen, falls dies nicht der Fall ist.
Schließlich bietet Ihnen die statische Methode validateDefinition() die Möglichkeit zu prüfen, ob die von Ihnen erzeugte Formulardefinition korrekt ist und verwendet werden kann. Ist dies nicht der Fall und versuchen Sie ein Formularobjekt mit einer inkorrekten Definition zu erzeugen, wird der ezcInputForm-Konstruktor eine ezcInputFormInvalidDefinitionException werfen. Die Methode validateDefinition() erwartet als einzigen Parameter das Definitions-Array und gibt den Wert true zurück, falls dieses korrekt erscheint. Wird ein Fehler in der Definition erkannt, gibt die Methode ein Array zurück, welches als erstes Element eine Fehlercode-Konstante enthält, die den Fehler charakterisiert, sowie eine passende Fehlermeldung.




Ihre Meinung






