Gibt nur dann true zurück wenn $value nur alphabetische und digitale Zeichen enthält. Dieser Prüfer enthält eine Option um auszuwählen ob Leerzeichen als gültig anzusehen sind.

Gibt nur dann true zurück wenn $value nur alphabetische Zeichen enthält. Dieser Prüfer enthält eine Option um auszuwählen ob Leerzeichen als gültig anzusehen sind.

Dieser Prüfer wird mit einem Barcode Typ instanziert gegen den ein Barcode Wert geprüft werden soll. Aktuell werden die "UPC-A" (Universal Product Code) und "EAN-13" (European Article Number) Barcode Typen unterstützt, und die isValid() Methode gibt dann und nur dann true zurück wenn die Eingabe erfolgreich gegen den Barcode Prüfalgorithmus geprüft wurde. Es sollten alle von den Ziffern 0 bis 9 (0-9) unterschiedliche Zeichen vom Eingabewert entfernt werden bevor dieser an den Prüfer übergeben wird.

Gibt nur dann true zurück wenn $value zwischen dem minimalen und maximalen Grenzwert ist. Der Vergleich ist standardmäßig inklusive ($value kann gleich dem Grenzwert sein), kann aber überschrieben werden um einen strikten Vergleich dort durchzuführen wo $value strikt größer als das Minimum und strikt kleiner als das Maximum sein muß.

Gibt nur dann true zurück wenn $value dem Luhn Algorithmus (mod-10 Checksumme) für Kreditkarten Nummern folgt.

Gibt nur dann true zurück wenn $value ein gültiges Datum im Format YYYY-MM-DD ist. Wenn die optionale locale Option gesetzt ist, dann wird das Datum entsprechend dem gesetzten Gebietsschemas geprüft. Und wenn die optionale format Option gesetzt wird, dann wird dieses Format für die Prüfung herangezogen. Für Details über die optionalen Parametern siehe Zend_Date::isDate().

Gibt nur dann true zurück wenn $value nur digitale Zeichen enthält.

Zend_Validate_EmailAddress erlaubt die Prüfung von Email Adressen. Der Prüfer teilt zuerst die Email Adresse in lokalen Teil @ hostname und versucht diese mit bekannten Spezifikationen für Email Adressen und Hostnamen zu prüfen.

Normale Verwendung

Ein Beispiel einer normalen Benutzung ist anbei:

$validator = new Zend_Validate_EmailAddress();
if ($validator->isValid($email)) {
    // Email Adresse scheint gültig zu sein
} else {
    // Email Adresse ist ungültig, drucke die Gründe hierfür
    foreach ($validator->getMessages() as $message) {
        echo "$message\n";
    }
}

        

Komplexe lokale Abschnitte

Zend_Validate_EmailAdress prüft jede gültige Email Adresse mit RFC2822. Gültige Email Adressen sind zum Beispiel bob@domain.com, bob+jones@domain.us, "bob@jones"@domain.com und "bob jones"@domain.com

Einige Email Formate werden aktuell nicht geprüft (z.B. Zeilenumbruch Zeichen oder ein "\" Zeichen in einer Email Adresse).

Prüfen von unterschiedlichen Typen von Hostnamen

Der Teil des Hostnamens einer Email Adresse wird mit Zend_Validate_Host geprüft. Standardmäßig werden nur DNS Hostnamen in der Form domain.com akzeptiert, aber wenn es gewünscht ist, können auch IP Adressen und lokale Hostnamen auch akzeptiert werden.

Um das zu tun, muß eine Zend_Validate_EmailAddress Instanz erstellt werden der ein Parameter übergeben wird, um den Typ des Hostnamens anzugeben der akzeptiert werden soll. Mehr Details sind in Zend_Validate_Hostname inkludiert, zusammen mit einem Beispiel, wie DNS und lokale Hostnamen, akzeptiert werden wie im Beispiel das anbei steht:

$validator = new Zend_Validate_EmailAddress(Zend_Validate_Hostname::ALLOW_DNS | Zend_Validate_Hostname::ALLOW_LOCAL);
if ($validator->isValid($email)) {
    // Email Adresse scheint gültig zu sein
} else {
    // Email ist ungültig; Gründe ausdrucken
    foreach ($validator->getMessages() as $message) {
        echo "$message\n";
    }
}

        

Prüfen ob der Hostname aktuell Emails akzeptiert

Nur weil eine Email Adresse im richtigen Format ist, heißt das notwendigerweise nicht das die Email Adresse aktuell auch existiert. Um dieses Problem zu lösen, kann MX Prüfung verwendet werden um zu prüfen ob ein MX (Email) Eintrag im DNS Eintrag für den Hostnamen der Email existiert. Das zeigt ob der Hostname Emails akzeptiert, sagt aber nicht aus, ob die genaue Email Adresse selbst gültig ist.

Die MX Prüfung ist standardmäßig nicht eingeschaltet und wird aktuell nur durch UNIX Platformen unterstützt. Um die MX Prüfung einzuschalten kann ein zweiter Parameter an den Zend_Validate_EmailAddress Konstruktor übergeben werden.

$validator = new Zend_Validate_EmailAddress(Zend_Validate_Hostname::ALLOW_DNS, true);

        

Durch das einschalten dieser Option werden Netzwerk Funktionen verwendet um zu Prüfen ob ein MX Eintrag am Hostnamen der Email Adresse existiert, welche geprüft werden soll. Vorsicht davor, das hierbei das eigene Skript langsamer wird.

Internationale Domain Namen prüfen

Zend_Validate_EmailAddress prüft auch internationale Zeichen prüfen, die in einigen Domains existieren. Dies ist als Unterstützung für Internationale Domain Namen (IDN) bekannt. Standardmäßig ist das eingeschaltet. Das kann aber ausgeschaltet werden indem eine Einstellung geändert wird über das interne Zend_Validate_Hostname Objekt das innerhalb von Zend_Validate_EmailAddress existiert.

$validator->hostnameValidator->setValidateIdn(false);

        

Es sollte darauf geachtet werden das IDNs nur geprüft werden wenn erlaubt ist DNS Hostnamen zu prüfen.

Top Level Domains prüfen

Standardmäßig wird ein Hostname mit einer List von bekannten TLDs geprüft. Das ist standardmäßig aktiviert, kann aber ausgeschaltet werden indem die Einstellung über das interne Zend_Validate_Hostname geändert wird, das innerhalb von Zend_Validate_EmailAddress existiert.

$validator->hostnameValidator->setValidateTld(false);

        

Es sollte darauf geachtet werden das TLDs nur geprüft werden wenn es auch erlaubt ist DNS Hostnamen zu prüfen.

Gibt nur dann true zurück wenn $value ein Fließkomma Wert ist.

Gibt nur dann true zurück wenn $value größer als die Minimale Grenze ist.

Gibt nur dann true zurück wenn $value nur Hexadezimale Digitale Zeichen enthält.

Zend_Validate_Hostname erlaubt die Prüfung von Hostnamen mit einem Set von bekannten Spezifikationen. Es ist möglich drei verschiedene Typen von Hostnamen zu Prüfen: einen DNS Hostnamen (z.b. domain.com), IP Adressen (z.B. 1.2.3.4), und lokale Hostnamen (z.B. localhost). Standarmäßig werden nur DNS Hostnamen geprüft.

Normale Verwendung

Ein normales Beispiel der Verwendung ist anbei:

$validator = new Zend_Validate_Hostname();
if ($validator->isValid($hostname)) {
    // Hostname scheint gültig zu sein
} else {
    // Hostname ist ungülig; Gründe dafür ausdrucken
    foreach ($validator->getMessages() as $message) {
        echo "$message\n";
    }
}

        

Verschiedene Typen von Hostnamen prüfen

Es kann gewünscht sein auch IP Adressen, lokale Hostnamen, oder eine Kombination aller drei erlaubten Typen zu prüfen. Das kann gemacht werden durch die Übergabe eines Parameters an Zend_Validate_Hostname wenn dieser initialisiert wird. Der Parameter sollte ein Integer sein, welcher die Typen von Hostnamen auswählt die erlaubt sind. Hierfür können die Zend_Validate_Hostname Konstanten verwendet werden.

Die Zend_Validate_Hostname Konstanten sind: ALLOW_DNS um nur DNS Hostnamen zu erlauben, ALLOW_IP um IP Adressen zu erlauben, ALLOW_LOCAL um lokale Hostnmaen zu erlauben, und ALLOW_ALL um alle drei Typen zu erlauben. Um nur IP Adressen zu prüfen kann das folgende Beispiel verwendet werden:

$validator = new Zend_Validate_Hostname(Zend_Validate_Hostname::ALLOW_IP);
if ($validator->isValid($hostname)) {
    // Hostname scheint gültig zu sein
} else {
    // Hostname ist ungülig; Gründe dafür ausdrucken
    foreach ($validator->getMessages() as $message) {
        echo "$message\n";
    }
}

        

Genau wie die Verwendung von ALLOW_ALL alle Typen von Hostnamen akzeptiert, können diese Typen kombiniert werden um Kombinationen zu erlauben. Um zum Beispiel DNS und lokale Hostnamen zu akzeptieren muß das Zend_Validate_Hostname Objekt wie folgt initialisiert werden:

$validator = new Zend_Validate_Hostname(Zend_Validate_Hostname::ALLOW_DNS |
                                        Zend_Validate_Hostname::ALLOW_IP);

        

Internationale Domain Namen prüfen

Einige Länder Code Top Level Domains (ccTLDs), wie 'de' (Deutschland), unterstützen internationale Zeichen in Domain Namen. Diese sind als Internationale Domain Namen (IDN) bekannt. Diese Domains können mit Zend_Validate_Hostname geprüft werden, mit Hilfe von erweiterten Zeichen die im Prüfprozess verwendet werden.

Zur Zeit beinhaltet die Liste der unterstützten ccTLDs:

• at (Österreich)

• ch (Schweiz)

• li (Liechtenstein)

• de (Deutschland)

• fi (Finnland)

• hu (Ungarn)

• no (Norwegen)

• se (Schweden)

Eine IDN Domain zu prüfen ist genauso einfach wie die Verwendung des standard Hostnamen Prüfers da IDN Prüfung standardmäßig eingeschaltet ist. Wenn IDN Prüfung ausgeschaltet werden soll, kann das entweder durch die Übergabe eines Parameters im Zend_Validate_Hostname Konstruktor, oder über die $validator->setValidateIdn() Methode gemacht werden.

Die IDN Prüfung kann ausgeschaltet werden durch die Übergabe eines zweiten Parameters an den Zend_Validate_Hostname Konstruktor auf die folgende Art und Weise.

$validator =
    new Zend_Validate_Hostname(Zend_Validate_Hostname::ALLOW_DNS, false);

        

Es sollte beachtet werden das IDNs nur geprüft werden wenn es erlaubt ist DNS Hostnamen zu prüfen.

Top Leven Domains prüfen

Normalerweise wird ein Hostname gegen eine Liste von bekannten TLDs geprüft. Wenn diese Funktionalität nicht benötigt wird kann das, auf die gleiche Art und Weise wie die IDN Unterstützung, ausgeschaltet werden Die TLD Prüfung kann ausgeschaltet werden indem ein dritter Parameter an den Zend_Validate_Hostname Konstruktor übergeben wird. Im folgenden Beispiel wird die IDN Prüfung durch den zweiten Parameter unterstützt.

$validator =
    new Zend_Validate_Hostname(Zend_Validate_Hostname::ALLOW_DNS,
                               true,
                               false);

        

Es sollte beachtet werden das TLDs nur geprüft werden wenn es erlaubt ist DNS Hostnamen zu prüfen.

Gibt nur dann true zurück wenn ein "needle" $value in einem "haystack" Array enthalten ist. Wenn die Strict Option true ist, wird der Typ von $value auch geprüft.

Gibt nur dann true zurück wenn $value ein gültiger Integer ist.

Gibt nur dann true zurück wenn $value eine gültige IP Adresse ist.

Gibt nur dann true zurück wenn $value kleiner als die Maximale Grenze ist.

Gibt nur dann true zurück wenn $value kein leerer Wert ist.

Gibt nur dann true zurück wenn $value mit einem Regular Expression Pattern geprüft werden kann.

Gibt nur dann true zurück wenn die Länge des Strings von $value mindstens ein Minimum und nicht größer als ein Maximum ist (wenn die max Option nicht null ist). Ab Version 1.5.0 wirft die setMin() Methode eine Ausnahme wenn die minimale Länge auf einen größeren Wert gesetzt wird als die maximale Länge, und die setMax() Methode wirft eine Ausnahme wenn die maximale Länge auf einen kleineren Wert als die minimale Länge gesetzt wird. Seit Version 1.0.2 unterstützt diese Klasse UTF-8 und andere Zeichensätze, basierend auf dem aktuellen Wert von » iconv.internal_encoding.