repo_zf1/documentation/manual/de/module_specs/Zend_Ldap-API-Ldap-Dn.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 17133 -->
<!-- Reviewed: no -->
<sect3 id="zend.ldap.api.reference.zend-ldap-dn">
    <title>Zend_Ldap_Dn</title>

    <para>
        <classname>Zend_Ldap_Dn</classname> bietet ein objektorientiertes Interface für die
        Manipulation von <acronym>LDAP</acronym> Distinguished Names (DN). Der Parameter
        <code>$caseFold</code> wird in verschiedenen Methoden verwendet um festzustellen wie DN
        Attribute betreffend Ihres Schreibweise behandelt werden. Die erlaubten Werte für diesen
        Parameter sind:
    </para>

    <variablelist>
        <varlistentry>
            <term><code>Zend_Ldap_Dn::ATTR_CASEFOLD_NONE</code></term>
            <listitem><para>Es wird keine Änderung der Schreibweise durchgeführt.</para></listitem>
        </varlistentry>

        <varlistentry>
            <term><code>Zend_Ldap_Dn::ATTR_CASEFOLD_UPPER</code></term>
            <listitem><para>Alle Attribute werden zur Großschreibung konvertiert.</para></listitem>
        </varlistentry>

        <varlistentry>
            <term><code>Zend_Ldap_Dn::ATTR_CASEFOLD_LOWER</code></term>
            <listitem><para>Alle Attribute werden zur Kleinschreibung konvertiert.</para></listitem>
        </varlistentry>
    </variablelist>

    <para>
        Die Standardmäßige Schreibweise ist <code>Zend_Ldap_Dn::ATTR_CASEFOLD_NONE</code> und kann
        mit <methodname>Zend_Ldap_Dn::setDefaultCaseFold()</methodname> gesetzt werden. Jede
        Instanz von <classname>Zend_Ldap_Dn</classname> kann Ihre eigenen Einstellungen für die
        Schreibweise haben. Wenn der Parameter <code>$caseFold</code> beim Methodenaufruf nicht
        angegeben wird dann ist er standardmäßig die Einstellung der Schreibweise von der Instanz.
    </para>

    <para>
        Die Klasse implementiert <code>ArrayAccess</code> um den indizierten Zugriff auf die
        unterschiedlichen Teile der DN zu gestatten. Die <code>ArrayAccess</code> Methoden verweisen
        für <code>offsetGet(integer $offset)</code> auf
        <methodname>Zend_Ldap_Dn::get($offset, 1, null)</methodname>, für
        <methodname>offsetSet()</methodname> auf
        <methodname>Zend_Ldap_Dn::set($offset, $value)</methodname> und für
        <methodname>offsetUnset()</methodname> auf
        <methodname>Zend_Ldap_Dn::remove($offset, 1)</methodname>.
        <methodname>offsetExists()</methodname> prüft einfach ob der Index innerhalb der Grenzen
        ist.
    </para>

    <table id="zend.ldap.api.reference.zend-ldap-dn.table">
        <title>Zend_Ldap_Dn API</title>

        <tgroup cols="2">
            <thead>
                <row>
                    <entry>Methode</entry>
                    <entry>Beschreibung</entry>
                </row>
            </thead>
            <tbody>
                <row>
                    <entry>
                        <emphasis><code>Zend_Ldap_Dn factory(string|array $dn,
                        string|null $caseFold)</code> </emphasis>
                    </entry>
                    <entry>
                        Erstellt eine <classname>Zend_Ldap_Dn</classname> Instanz von einem Array
                        oder String. Das Array muß der unter
                        <methodname>Zend_Ldap_Dn::implodeDn()</methodname> beschriebenen
                        Arraystruktur entsprechen.
                    </entry>
                </row>
                <row>
                    <entry>
                        <emphasis><code>Zend_Ldap_Dn fromString(string $dn,
                        string|null $caseFold)</code> </emphasis>
                    </entry>
                    <entry>
                        Erstellt eine <classname>Zend_Ldap_Dn</classname> Instanz von einem String.
                    </entry>
                </row>
                <row>
                    <entry>
                        <emphasis><code>Zend_Ldap_Dn fromArray(array $dn,
                        string|null $caseFold)</code> </emphasis>
                    </entry>
                    <entry>
                        Erstellt eine <classname>Zend_Ldap_Dn</classname> Instanz von einem
                        Array. Das Array muß der Arraystruktur entsprechen welche unter
                        <methodname>Zend_Ldap_Dn::implodeDn()</methodname> beschrieben ist.
                    </entry>
                </row>
                <row>
                    <entry><code>array getRdn(string|null $caseFold)</code></entry>
                    <entry>
                        Gibt den <acronym>RDN</acronym> des aktuellen DN zurück. Der zurückgegebene
                        Wert ist ein Array wobei die Namen der Attribute von <acronym>RDN</acronym>
                        im Schlüssel gesetzt sind und die <acronym>RDN</acronym> Attribute als Wert.
                    </entry>
                </row>
                <row>
                    <entry>
                        <code>string getRdnString(string|null
                        $caseFold)</code>
                    </entry>
                    <entry>
                        Gibt den <acronym>RDN</acronym> vom aktuellen DN zurück. Der zurückgegebene
                        Wert ist ein String.
                    </entry>
                </row>
                <row>
                    <entry>
                        <code>Zend_Ldap_Dn getParentDn(integer
                        $levelUp)</code>
                    </entry>
                    <entry>
                        Gibt den DN des aktuellen DN Knotens, <code>$levelUp</code> Levels höher,
                        zurück. <code>$levelUp</code> ist standardmäßig <code>1</code>.
                    </entry>
                </row>
                <row>
                    <entry>
                        <code>array get(integer $index, integer $length, string|null
                        $caseFold)</code>
                    </entry>
                    <entry>
                        Gibt einen Teil des aktuellen DN zurück der von <code>$index</code> und
                        <code>$length</code> eingegrenzt wird. <code>$index</code> beginnt mit
                        <code>0</code> und der DN Teil von links.
                    </entry>
                </row>
                <row>
                    <entry>
                        <code>Zend_Ldap_Dn set(integer $index, array
                        $value)</code>
                    </entry>
                    <entry>
                        Ersetzt den DN Teil im aktuellen DN. Diese Operation manipuliert die
                        aktuelle Instanz.
                    </entry>
                </row>
                <row>
                    <entry>
                        <code>Zend_Ldap_Dn remove(integer $index, integer
                        $length)</code>
                    </entry>
                    <entry>
                        Entfernt einen DN Teil vom aktuellen DN. Diese Operation manipuliert die
                        aktuelle Instanz. <code>$length</code> ist standardmäßig <code>1</code>.
                    </entry>
                </row>
                <row>
                    <entry><code>Zend_Ldap_Dn append(array $value)</code></entry>
                    <entry>
                        Fügt einen DN Teil zum aktuellen DN hinzu, Diese Operation manipuliert die
                        aktuelle Instanz.
                    </entry>
                </row>
                <row>
                    <entry><code>Zend_Ldap_Dn prepend(array $value)</code></entry>
                    <entry>
                        Fügt einen DN Teil vor dem aktuellen DN hinzu. Diese Operation manipuliert
                        die aktuelle Instanz.
                    </entry>
                </row>
                <row>
                    <entry>
                        <code>Zend_Ldap_Dn insert(integer $index, array
                        $value)</code>
                    </entry>
                    <entry>
                        Fügt einen DN Teil nach dem Index <code>$index</code> in den aktuellen DN
                        ein. Diese Operation manipuliert die aktuelle Instanz.
                    </entry>
                </row>
                <row>
                    <entry><code>void setCaseFold(string|null $caseFold)</code></entry>
                    <entry>
                        Setzt die Option für die Schreibweise auf der aktuellen DN Instanz. Wenn
                        <code>$caseFold</code> null ist dann wird die standardmäßige Einstellung
                        der Schreibweise (standardmäßig ist
                        <code>Zend_Ldap_Dn::ATTR_CASEFOLD_NONE</code> oder über
                        <methodname>Zend_Ldap_Dn::setDefaultCaseFold()</methodname> gesetzt)
                        für die aktuelle Instanz gesetzt.
                    </entry>
                </row>
                <row>
                    <entry><code>string toString(string|null $caseFold)</code></entry>
                    <entry>Gibt den DN als String zurück.</entry>
                </row>
                <row>
                    <entry><code>array toArray(string|null $caseFold)</code></entry>
                    <entry>Gibt den DN als Array zurück.</entry>
                </row>
                <row>
                    <entry><code>string __toString()</code></entry>
                    <entry>
                        Gibt den DN als String zurück - verweist auf
                        <methodname>Zend_Ldap_Dn::toString(null)</methodname>.
                    </entry>
                </row>
                <row>
                    <entry>
                        <emphasis><code>void setDefaultCaseFold(string
                        $caseFold)</code> </emphasis>
                    </entry>
                    <entry>
                        Setzt die standardmäßige Option für die Schreibweise welche von allen
                        Instanzen bei der Erstellung standardmäßig verwendet wird. Bereits
                        existierende Instanzen sind von dieser Einstellung nicht betroffen.
                    </entry>
                </row>
                <row>
                    <entry>
                        <emphasis><code>array escapeValue(string|array
                        $values)</code> </emphasis>
                    </entry>
                    <entry>Escapt einen DN Wert entsprechend RFC 2253.</entry>
                </row>
                <row>
                    <entry>
                        <emphasis><code>array unescapeValue(string|array
                        $values)</code> </emphasis>
                    </entry>
                    <entry>
                        Macht die Konvertierung von
                        <methodname>Zend_Ldap_Dn::escapeValue()</methodname> rückgängig.
                    </entry>
                </row>
                <row>
                    <entry>
                        <emphasis><code>array explodeDn(string $dn, array
                        &amp;$keys, array &amp;$vals, string|null $caseFold)</code>
                        </emphasis>
                    </entry>
                    <entry>
                        Zerteilt den DN <code>$dn</code> in ein Array das alle Teile des
                        angegebenen DN enthält. <code>$keys</code> sind optional die DN
                        Schlüssel (z.B. CN, OU, DC, ...). <code>$vals</code> sind optional die
                        DN Werte. Das zurückgegebene Array ist vom Typ
                    <programlisting language="php"><![CDATA[
array(
array("cn" => "name1", "uid" => "user"),
array("cn" => "name2"),
array("dc" => "example"),
array("dc" => "org")
)
]]></programlisting> für einen DN von <code>cn=name1+uid=user,cn=name2,dc=example,dc=org</code>.
                    </entry>
                </row>
                <row>
                    <entry>
                        <emphasis><code>boolean checkDn(string $dn, array
                        &amp;$keys, array &amp;$vals, string|null $caseFold)</code>
                        </emphasis>
                    </entry>
                    <entry>
                        Prüft ob der gegebene DN <code>$dn</code> fehlerhaft ist. Wenn
                        <code>$keys</code> oder <code>$keys</code> und <code>$vals</code>
                        angegeben sind, werden diese Arrays mit dem betreffenden DN Schlüssel und
                        Werten gefüllt.
                    </entry>
                </row>
                <row>
                    <entry>
                        <emphasis><code>string implodeRdn(array $part, string|null
                        $caseFold)</code> </emphasis>
                    </entry>
                    <entry>
                        Gibt den DN Teil in der Form <code>$attribute=$value</code> zurück.
                    </entry>
                </row>
                <row>
                    <entry>
                        <emphasis><code>string implodeDn(array $dnArray,
                        string|null $caseFold, string $separator)</code>
                        </emphasis>
                    </entry>
                    <entry>
                        Implodiert ein Array der Form die von
                        <methodname>Zend_Ldap_Dn::explodeDn()</methodname> kommt in einen DN
                        String. <code>$separator</code> ist standardmäßig <code>','</code> aber
                        einige LDAP Server verstehen auch <code>';'</code>. <code>$dnArray</code>
                        muß von folgendem Typ sein:
                    <programlisting language="php"><![CDATA[
array(
array("cn" => "name1", "uid" => "user"),
array("cn" => "name2"),
array("dc" => "example"),
array("dc" => "org")
)
]]></programlisting>
                    </entry>
                </row>
                <row>
                    <entry>
                        <emphasis><code>boolean isChildOf(string|Zend_Ldap_Dn
                        $childDn, string|Zend_Ldap_Dn $parentDn)</code> </emphasis>
                    </entry>
                    <entry>
                        Prüft ob der angegebene <code>$childDn</code> unter dem
                        <code>$parentDn</code> Subbaum ist.
                    </entry>
                </row>
            </tbody>
        </tgroup>
    </table>
</sect3>