# Db_RecordExists und Db_NoRecordExists

`Zend_Validate_Db_RecordExists` und `Zend_Validate_Db_NoRecordExists` bieten die Möglichkeit zu testen ob ein Eintrag in einer angegebenen Tabelle einer Datenbank, mit einem gegebenen Wert, existiert.

## Grundsätzliche Verwendung

Ein Beispiel der rundsätzlichen Verwendung der Validatoren:

    // Prüft ob die Email Adresse in der Datenbank existiert
    $validator = new Zend_Validate_Db_RecordExists(
        array(
            'table' => 'users',
            'field' => 'emailaddress'
        )
    );

    if ($validator->isValid($emailaddress)) {
        // Die Email Adresse scheint gültig zu sein
    } else {
        // Die Email Adresse ist ungültig; gib die Gründe an
        foreach ($validator->getMessages() as $message) {
            echo "$message\n";
        }
    }

Das oben stehende testet ob eine gegebene Email Adresse in der Datenbanktabelle vorhanden ist. Wenn kein Eintrag gefunden wird der den Wert von `$emailaddress` in der spezifizierten Spalte hat, wird eine Fehlermeldung angezeigt.

    // Prüft ob der Benutzername in der Datenbank existiert
    $validator = new Zend_Validate_Db_NoRecordExists(
        array(
            'table' => 'users',
            'field' => 'username'
        )
    );
    if ($validator->isValid($username)) {
        // Der Benutzername scheint gültig zu sein
    } else {
        // Der Benutzername ist ungültig; gib die Gründe an
        $messages = $validator->getMessages();
        foreach ($messages as $message) {
            echo "$message\n";
        }
    }

Das oben stehende testet ob ein angegebener Benutzername nicht in der Datenbanktabelle vorhanden ist. Wenn ein Eintrag gefunden wird, der den der von `$username` in der spezifizierten Spalte enthält, dann wird eine Fehlermeldung angezeigt.

## Ausnehmen von Einträgen

`Zend_Validate_Db_RecordExists` und `Zend_Validate_Db_NoRecordExists` bieten auch die Möglichkeit die Datenbank zu testen, wobei Teile der Tabelle hiervon ausgenommen werden, entweder indem eine where Klausel als String angegeben wird, oder ein Array mit den Schlüsseln "field" und "value".

Wenn ein Array für die Ausnahmeklausel angegeben wird, dann wird der `!=` Operator verwenden. Damit kann der Rest einer Tabelle auf einen Wert geprüft werden bevor ein Eintrag geändert wird (zum Beispiel in einem Formular für ein Benutzerprofil).

    // Prüft ob kein anderer Benutzer diesen Benutzernamen hat
    $user_id   = $user->getId();
    $validator = new Zend_Validate_Db_NoRecordExists(
        array(
            'table'   => 'users',
            'field'   => 'username',
            'exclude' => array(
                'field' => 'id',
                'value' => $user_id
            )
        )
    );

    if ($validator->isValid($username)) {
        // Der Benutzername scheint gültig zu sein
    } else {
        // Der Benutzername ist ungültig; zeige den Grund
        $messages = $validator->getMessages();
        foreach ($messages as $message) {
            echo "$message\n";
        }
    }

Das obige Beispiel prüft die Tabelle um sicherzustellen das keine anderen Einträge existieren bei denen `id = $user_id` als Wert $username enthalten.

Man kann auch einen String an die Ausnahmeklausel angeben damit man einen anderen Operator als `!=` verwenden kann. Das kann nützlich sein um bei geteilten Schlüsseln zu testen.

    $post_id   = $post->getId();
    $clause    = $db->quoteInto('post_id = ?', $category_id);
    $validator = new Zend_Validate_Db_RecordExists(
        array(
            'table'   => 'posts_categories',
            'field'   => 'post_id',
            'exclude' => $clause
    );

    if ($validator->isValid($username)) {
        // Der Benutzername scheint gültig zu sein
    } else {
        // Der Benutzername ist ungültig; die Gründe ausgeben
        $messages = $validator->getMessages();
        foreach ($messages as $message) {
            echo "$message\n";
        }
    }

Das obige Beispiel prüft die Tabelle `posts_categories` und stellt sicher das ein Eintrag der `post_id` einen Wert hat der `$category_id` entspricht.

## Datenbank Adapter

Man kann auch einen Adapter, als vierten Parameter, spezifizieren wenn man die Prüfung instanziiert. Das erlaubt es mit Anwendungen zu arbeiten die mehrere Datenbankadapter verwenden, oder wo kein Standardadapter gesetzt wird. Als Beispiel:

    $validator = new Zend_Validate_Db_RecordExists(
        array(
            'table'   => 'users',
            'field'   => 'id',
            'adapter' => $dbAdapter
        )
    );

## Datenbank Schemas

Man kann für die eigene Datenbank bei Adaptern wie PostgreSQL und DB/2 ein Schema spezifizieren indem einfach ein Array mit den Schlüsseln `table` und `schema` angegeben wird. Anbei ein Beispiel:

    $validator = new Zend_Validate_Db_RecordExists(
        array(
            'table'  => 'users',
            'schema' => 'my',
            'field'  => 'id'
        )
    );