repo_zf1/documentation/manual/de/module_specs/Zend_Validate-Db.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 17170 -->
<!-- Reviewed: no -->
<sect2 id="zend.validate.Db">
    <title>Db_RecordExists und Db_NoRecordExists</title>

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

    <sect3 id="zend.validate.db.basic-usage">
        <title>Grundsätzliche Verwendung</title>

        <para>
            Ein Beispiel der rundsätzlichen Verwendung der Validatoren:
        </para>

        <programlisting language="php"><![CDATA[
// Prüft ob die Email Adresse in der Datenbank existiert
$validator = new Zend_Validate_Db_RecordExists('users', '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";
    }
}
]]></programlisting>

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

        <programlisting language="php"><![CDATA[
// Prüft ob der Benutzername in der Datenbank existiert
$validator = new Zend_Validate_Db_NoRecordExists('users', '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";
    }
}
]]></programlisting>

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

    <sect3 id="zend.validate.db.excluding-records">
        <title>Ausnehmen von Einträgen</title>

        <para>
            <classname>Zend_Validate_Db_RecordExists</classname> und
            <classname>Zend_Validate_Db_NoRecordExists</classname> 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".
        </para>

        <para>
            Wenn ein Array für die Ausnahmeklausel angegeben wird, dann wird der <code>!=</code>
            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).
        </para>

        <programlisting language="php"><![CDATA[
// Prüft ob kein anderer Benutzer diesen Benutzernamen hat
$user_id   = $user->getId();
$validator = new Zend_Validate_Db_NoRecordExists(
    'users',
    'username',
    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";
    }
}
]]></programlisting>

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

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

        <programlisting language="php"><![CDATA[
$post_id   = $post->getId();
$clause    = $db->quoteInto('post_id = ?', $category_id);
$validator = new Zend_Validate_Db_RecordExists(
    'posts_categories',
    'post_id',
    $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";
    }
}
]]></programlisting>

        <para>
            Das obige Beispiel prüft die Tabelle <code>posts_categories</code> und stellt sicher
            das ein Eintrag der <code>post_id</code> einen Wert hat der
            <varname>$category_id</varname> entspricht.
        </para>
    </sect3>

    <sect3 id="zend.validate.db.database-adapters">
        <title>Datenbank Adapter</title>

        <para>
            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:
        </para>

        <programlisting language="php"><![CDATA[
$validator = new Zend_Validate_Db_RecordExists('users', 'id', null, $dbAdapter);
]]></programlisting>
    </sect3>

    <sect3 id="zend.validate.db.database-schemas">
        <title>Datenbank Schemas</title>

        <para>
            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 <code>table</code> und
            <code>schema</code> angegeben wird. Anbei ein Beispiel:
        </para>

        <programlisting language="php"><![CDATA[
$validator = new Zend_Validate_Db_RecordExists(array('table' => 'users',
                                                     'schema' => 'my'), 'id');
]]></programlisting>
    </sect3>
</sect2>