PostCode
Zend_Validate_PostCode erlaubt es zu eruieren ob ein angegebener
Wert eine gültige Postleitzahl ist. Postleitzahlen sind spezifisch für Städte und in einigen
Gebietsschemata auch als ZIP Codes bezeichnet.
Zend_Validate_PostCode kennt mehr als 160 unterschiedliche Formate
für Postleitzahlen. Um das richtige Format auszuwählen gibt es 2 Wege. Man kann entweder
ein voll qualifiziertes Gebietsschema verwenden, oder ein eigenes Format manuall setzen.
Die Verwendung eines Gebietsschemas ist bequemer da Zend Framework bereits die
entsprechenden Formate für Postleitzahlen für jedes Gebietsschema kennt; aber muss man
ein voll qualifiziertes Gebietsschema verwenden (eines das eine Region spezifiziert) damit
es funktioniert. Das Gebietsschema "de" zum Beispiel ist zwar ein Gebietsschema, kann aber
nicht mit Zend_Validate_PostCode verwendet werden da es keine
Region enthält; "de_AT" andererseits würde ein gültiges Gebietsschema sein da es den
Region Code spezifiziert ("AT", für Österreich).
Wenn man das Gebietsschema nicht selbst setzt, dann verwendet
Zend_Validate_PostCode das anwendungsweit gesetzte Gebietsschema,
oder wenn keines vorhanden ist, das Gebietsschema welches von
Zend_Locale zurückgegeben wird.
Man kann das Gebietsschema auch im Nachhinein ändern, indem man
setLocale() aufruft. Und natürlich kann man das aktuelle
Gebietsschema erhalten indem getLocale() aufgerufen wird.
setLocale('en_GB');
]]>
Postleitzahlen Formate selbst sind einfache Regular Expression Strings. Wenn das
internationale Postleitzahlen Format, welches durch das Setzen des Gebietsschemas verwendet
wird, den eigenen Bedüfnissen nicht entspricht, dann kann man ein Format auch manuell setzen
indem setFormat() aufgerufen wird.
setFormat('AT-\d{5}');
]]>
Konventionen für selbst definierte Formate
Wenn selbst definierte Formate verwendet werden sollten die Start-
('/^') und Endetags ('$/') nicht angegeben werden.
Sie werden automatisch hinzugefügt.
Man sollte darauf achtgeben das Postleitzahlen Werte immer auf einer strikte Art
geprüft werden. Das bedeutet das Sie alleinstehend geschrieben werden müssen, ohne
zusätzliche Zeichen, wenn diese nicht durch das Format abgedeckt werden.
Optionen des Constructors
Grundsätzlich kann man dem Contructor von Zend_Validate_PostCode
entweder ein Zend_Locale Objekt, oder einen String der ein voll
qualifiziertes Gebietsschema repräsentiert, angeben.
Zusätzlich kann man dem Contructor entweder ein Array oder ein
Zend_Config Objekt übergeben. Wenn man das tut, muss man
entweder den Schlüssel "locale" oder "format" verwenden; diese werden verwendet um die
betreffenden Werte im Prüfobjekt zu setzen.
'de_AT',
'format' => 'AT_\d+'
));
]]>
Unterstützte Optionen für Zend_Validate_PostCode
Die folgenden Optionen werden für Zend_Validate_PostCode
unterstützt:
format: Setzt das Postleitzahl-Format
welches für die Prüfung der Eingabe verwendet werden soll.
locale: Setzt ein Gebietsschema von
dem die Postleitzahl genommen wird.