[DOCUMENTATION] German:

- some translations

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@17972 44c647ce-9c0f-0410-b52a-842ac1e357ba

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

@@ -5,9 +5,9 @@
     <title>Zend_Ldap</title>
 
     <para>
-        <classname>Zend_Ldap</classname> is the base interface into a <acronym>LDAP</acronym>
-        server. It provides connection and binding methods as well as methods to operate on the
-        <acronym>LDAP</acronym> tree.
+        <classname>Zend_Ldap</classname> ist das Basisinterface zum <acronym>LDAP</acronym> Server.
+        Es bietet Verbindungs- und Bindungsmethode sowie Methoden um auf dem <acronym>LDAP</acronym>
+        Baum zu arbeiten.
     </para>
 
     <table id="zend.ldap.api.reference.zend-ldap.table">
@@ -16,8 +16,8 @@
         <tgroup cols="2">
             <thead>
                 <row>
-                    <entry>Method</entry>
-                    <entry>Description</entry>
+                    <entry>Methode</entry>
+                    <entry>Beschreibung</entry>
                 </row>
             </thead>
             <tbody>
@@ -26,10 +26,10 @@
                         <code>string filterEscape(string $str)</code>
                     </entry>
                     <entry>
-                        Escapes a value to be used in a <acronym>LDAP</acronym> filter according to
-                        <acronym>RFC</acronym> 2254. This method is <emphasis>deprecated</emphasis>, please use
-                        <methodname>Zend_Ldap_Filter_Abstract::escapeValue()</methodname>
-                        instead.
+                        Escapt einen Wert damit dieser in einem <acronym>LDAP</acronym> Filter
+                        entsprechend <acronym>RFC</acronym> 2254. Diese Methode ist
+                        <emphasis>deprecated</emphasis>, stattdessen sollte
+                        <methodname>Zend_Ldap_Dn::checkDn()</methodname> verwendet werden.
                     </entry>
                 </row>
                 <row>
@@ -37,35 +37,39 @@
                         <code>boolean explodeDn($dn, array &amp;$keys = null, array &amp;$vals = null)</code>
                     </entry>
                     <entry>
-                        Checks if a given DN <varname>$dn</varname> is malformed. If
-                        <varname>$keys</varname> or <varname>$keys</varname> and <varname>$vals</varname> are
-                        given, these arrays will be filled with the appropriate DN keys and
-                        values. This method is <emphasis>deprecated</emphasis>, please use
-                        <methodname>Zend_Ldap_Dn::checkDn()</methodname> instead.
+                        Prüft ob ein angegebener DN <varname>$dn</varname> fehlerhaft ist. Wenn
+                        <varname>$keys</varname> oder <varname>$keys</varname> und
+                        <varname>$vals</varname> angegeben werden, werden diese Arrays mit den
+                        entsprechenden DN Schlüsseln und Werten gefüllt. Diese Methode ist
+                        <emphasis>deprecated</emphasis>, stattdessen sollte
+                        <methodname>Zend_Ldap_Dn::checkDn()</methodname> verwendet werden.
                     </entry>
                 </row>
                 <row>
                     <entry><code>__construct($options)</code></entry>
                     <entry>
-                        Constructor. The <varname>$options</varname> parameter is optional
-                        and can be set to an array or a <classname>Zend_Config</classname> instance.
-                        If no options are provided at instantiation, the connection
-                        parameters must be passed to the instance using
-                        <methodname>Zend_Ldap::setOptions()</methodname>. The allowed options are
-                        specified in <link
-                            linkend="zend.ldap.api.configuration.table">Zend_Ldap
-                            Options</link>
+                        Constructor. Der <varname>$options</varname> Parameter ist Optional und kann
+                        ein Array, oder eine Instanz von <classname>Zend_Config</classname> sein.
+                        Wenn keine Optionen bei der Instanzierung angegeben werden, müssen die
+                        Verbindungsparameter der Instanz übergeben werden indem man
+                        <methodname>Zend_Ldap::setOptions()</methodname> verwendet. Die erlaubten
+                        Optionen werden in <link
+                            linkend="zend.ldap.api.configuration.table">Zend_Ldap Optionen</link>
+                        apezifiziert.
                     </entry>
                 </row>
                 <row>
                     <entry><code>resource getResource()</code></entry>
-                    <entry>Returns the raw <acronym>LDAP</acronym> extension (ext/ldap) resource.</entry>
+                    <entry>
+                        Gibt die rohe Ressource der <acronym>LDAP</acronym> Erweiterung (ext/ldap)
+                        zurück.
+                    </entry>
                 </row>
                 <row>
                     <entry><code>integer getLastErrorCode()</code></entry>
                     <entry>
-                        Returns the <acronym>LDAP</acronym> error number of the last <acronym>LDAP</acronym>
-                        command.
+                        Gibt die <acronym>LDAP</acronym> Fehlernummer des letzten
+                        <acronym>LDAP</acronym> Kommandos zurück.
                     </entry>
                 </row>
                 <row>
@@ -73,36 +77,36 @@
                         <code>string getLastError(integer &amp;$errorCode, array &amp;$errorMessages)</code>
                     </entry>
                     <entry>
-                        Returns the <acronym>LDAP</acronym> error message of the last <acronym>LDAP</acronym> command. The
-                        optional <varname>$errorCode</varname> parameter is set to the <acronym>LDAP</acronym> error
-                        number when given. The optional <varname>$errorMessages</varname> array
-                        will be filled with the raw error messages when given. The various
-                        <acronym>LDAP</acronym> error retrieval functions can return different things, so they
-                        are all collected if <varname>$errorMessages</varname> is given.
+                        Gibt die <acronym>LDAP</acronym> Fehlermeldung des letzten
+                        <acronym>LDAP</acronym> Kommandos zurück. Der optionale
+                        <varname>$errorCode</varname> Parameter ist auf die <acronym>LDAP</acronym>
+                        Fehlernummer gesetzt wenn er angegeben ist. Die verschiedenen
+                        <acronym>LDAP</acronym> Funktionen welche Fehler zurückgeben können
+                        unterschiedliche Dinge zurückgeben, sodas Sie alle gesammelt werden wenn
+                        <varname>$errorMessages</varname> angegeben ist.
                     </entry>
                 </row>
                 <row>
                     <entry><code>Zend_Ldap setOptions($options)</code></entry>
                     <entry>
-                        Sets the <acronym>LDAP</acronym> connection and binding parameters.
-                        <varname>$options</varname> can be an array or an instance of
-                        <classname>Zend_Config</classname>. The allowed options are specified in
-                        <link
-                            linkend="zend.ldap.api.configuration.table">Zend_Ldap Options</link>
+                        Setzt die <acronym>LDAP</acronym> Verbindungs- und Bindungsparameter.
+                        <varname>$options</varname> kann ein Array oder eine Instanz von
+                        <classname>Zend_Config</classname> sein. Die erlauben Optionen werden in
+                        <link linkend="zend.ldap.api.configuration.table">Zend_Ldap Optionen</link>
+                        definiert.
                     </entry>
                 </row>
                 <row>
                     <entry><code>array getOptions()</code></entry>
                     <entry>
-                        Returns the current connection and binding
-                        parameters.
+                        Gibt die aktuellen Verbindungs- und Bindungsparameter zurück.
                     </entry>
                 </row>
                 <row>
                     <entry><code>string getBaseDn()</code></entry>
                     <entry>
-                        Returns the base DN this <acronym>LDAP</acronym> connection is bound
-                        to.
+                        Gibt den Basis DN zurück auf welche diese <acronym>LDAP</acronym> Verbindung
+                        gebunden ist.
                     </entry>
                 </row>
                 <row>
@@ -110,19 +114,20 @@
                         <code>string getCanonicalAccountName(string $acctname, integer $form)</code>
                     </entry>
                     <entry>
-                        Returns the canonical account name of the given account name
-                        <varname>$acctname</varname>. <varname>$form</varname> specifies the <link
-                            linkend="zend.ldap.using.theory-of-operation.account-name-canonicalization.table">format</link>
-                        into which the account name is canonicalized. See <link
-                            linkend="zend.ldap.introduction.theory-of-operations.account-name-canonicalization">Account Name Canonicalization</link>
-                        for more details.
+                        Gibt den kanonischen Account Namen des angegebenen Account Namens
+                        <varname>$acctname</varname> zurück. <varname>$form</varname> spezifiziert
+                        das <link
+                            linkend="zend.ldap.using.theory-of-operation.account-name-canonicalization.table">Format</link>
+                        in das der Account Name kanonisiert wird. Siehe <link
+                            linkend="zend.ldap.introduction.theory-of-operations.account-name-canonicalization">Kanonisierung
+                            des Account Namens</link> für weitere Details.
                     </entry>
                 </row>
                 <row>
                     <entry><code>Zend_Ldap disconnect()</code></entry>
                     <entry>
-                        Disconnects the Zend_Ldap instance from the <acronym>LDAP</acronym>
-                        server.
+                        Trennt die Verbindung der Zend_Ldap Instanz vom <acronym>LDAP</acronym>
+                        Server.
                     </entry>
                 </row>
                 <row>
@@ -130,11 +135,12 @@
                         <code>Zend_Ldap connect(string $host, integer $port, boolean $useSsl, boolean $useStartTls)</code>
                     </entry>
                     <entry>
-                        Connects the Zend_Ldap instance to the given <acronym>LDAP</acronym> server.
-                        All parameters are optional and will be taken from the <acronym>LDAP</acronym>
-                        connection and binding parameters passed to the instance via the
-                        construtor or via <methodname>Zend_Ldap::setOptions()</methodname> when set to
-                        <constant>NULL</constant>.
+                        Verbindet eine Instanz von Zend_Ldap mit dem angegebenen
+                        <acronym>LDAP</acronym> Server. Alle Parameter sind optional, und werden von
+                        den <acronym>LDAP</acronym> Verbindungs- und Bindungsparametern genommen
+                        welche der Instanz über den Constructor oder über
+                        <methodname>Zend_Ldap::setOptions()</methodname> angegeben wurden, wenn
+                        <constant>NULL</constant> angegeben wurde.
                     </entry>
                 </row>
                 <row>
@@ -142,16 +148,17 @@
                         <code>Zend_Ldap bind(string $username, string $password)</code>
                     </entry>
                     <entry>
-                        Authenticates <varname>$username</varname> with
-                        <varname>$password</varname> at the <acronym>LDAP</acronym> server. If both paramaters are
-                        omitted the binding will be carried out with the credentials given
-                        in the connection and binding parameters. If no credentials are
-                        given in the connection and binding parameters an anonymous bind
-                        will be performed. Note that this requires anonymous binds to be
-                        allowed on the <acronym>LDAP</acronym> server. An empty string <code>''</code> can be
-                        passed as <varname>$password</varname> together with a username if, and
-                        only if, <code>allowEmptyPassword</code> is set to
-                        <constant>TRUE</constant> in the connection and binding parameters.
+                        Authentifiziert <varname>$username</varname> mit
+                        <varname>$password</varname> beim <acronym>LDAP</acronym> Server. Wenn
+                        beide Parameter nicht angegeben werden, dann wird die Verbindung mit den
+                        Anmeldeinformationen durchgeführt welche in den Verbindungs- und
+                        Bindungsparametern angegeben wurden, und ein anonymes Binden wird
+                        ausgeführt. Es ist zu beachten dass hierbei anonymes Binden vom
+                        <acronym>LDAP</acronym> Server erlaubt sein muss. Ein leerer String
+                        <code>''</code> kann als <varname>$password</varname> zusammen mit einem
+                        Benutzernamen übergeben werden wenn, und nur wenn,
+                        <code>allowEmptyPassword</code> in den Verdinguns- und Bindungsparametern
+                        auf <constant>TRUE</constant> gesetzt ist.
                     </entry>
                 </row>
                 <row>
@@ -159,8 +166,8 @@
                         <code>Zend_Ldap_Collection search(string|Zend_Ldap_Filter_Abstract $filter, string|Zend_Ldap_Dn $basedn, integer $scope, array $attributes, string $sort, string $collectionClass)</code>
                     </entry>
                     <entry>
-                        Searches the <acronym>LDAP</acronym> tree with the given <varname>$filter</varname>
-                        and the given search parameters.
+                        Durchsucht den <acronym>LDAP</acronym> Baum mit dem angegebenen
+                        <varname>$filter</varname> und den angegebenen Such Parametern.
                         <variablelist>
                             <varlistentry>
                                 <term><code>string|Zend_Ldap_Filter_Abstract
@@ -168,7 +175,7 @@
 
                                 <listitem>
                                     <para>
-                                        The filter string to be used in the search, e.g.
+                                        Der Filterstring kann in der Suche verwendet werden, z.B.
                                         <code>(objectClass=posixAccount)</code>.
                                     </para>
                                 </listitem>
@@ -179,9 +186,10 @@
 
                                 <listitem>
                                     <para>
-                                        The search base for the search. If omitted or
-                                        <constant>NULL</constant>, the <code>baseDn</code> from the
-                                        connection and binding parameters is used.
+                                        Die Suchbasis für die Suche. Wenn Sie nicht, oder
+                                        <constant>NULL</constant> angegeben wird, dann wird die
+                                        <code>baseDn</code> der Verbindungs- und Bindungs Parameter
+                                        verwendet.
                                     </para>
                                 </listitem>
                             </varlistentry>
@@ -191,15 +199,16 @@
 
                                 <listitem>
                                     <para>
-                                        The search scope.
-                                        <constant>Zend_Ldap::SEARCH_SCOPE_SUB</constant> searches the
-                                        complete subtree including the <varname>$baseDn</varname> node.
-                                        <constant>Zend_Ldap::SEARCH_SCOPE_ONE</constant> restricts search
-                                        to one level below <varname>$baseDn</varname>.
-                                        <constant>Zend_Ldap::SEARCH_SCOPE_BASE</constant> restricts search
-                                        to the <varname>$baseDn</varname> itself; this can be used to
-                                        efficiently retrieve a single entry by its DN. The default
-                                        value is
+                                        Der Suchbereich.
+                                        <constant>Zend_Ldap::SEARCH_SCOPE_SUB</constant> durchsucht
+                                        den kompletten Unterbaum inklusive dem
+                                        <varname>$baseDn</varname> Node.
+                                        <constant>Zend_Ldap::SEARCH_SCOPE_ONE</constant> schränkt
+                                        die Suche auf ein Level unter <varname>$baseDn</varname>
+                                        ein. <constant>Zend_Ldap::SEARCH_SCOPE_BASE</constant>
+                                        schränkt die Suche auf <varname>$baseDn</varname> selbst
+                                        ein; das kann verwendet werden um effizient einen einzelnen
+                                        Eintrag durch deinen DN zu erhalten. Der Standardwert ist
                                         <constant>Zend_Ldap::SEARCH_SCOPE_SUB</constant>.
                                     </para>
                                 </listitem>
@@ -210,14 +219,16 @@
 
                                 <listitem>
                                     <para>
-                                        Specifies the attributes contained in the
-                                        returned entries. To include all possible attributes (ACL
-                                        restrictions can disallow certain attribute to be retrieved
-                                        by a given user) pass either an empty array
-                                        <methodname>array()</methodname> or <code>array('*')</code> to the
-                                        method. On some <acronym>LDAP</acronym> servers you can retrieve special
-                                        internal attributes by passing <code>array('*', '+')</code>
-                                        to the method.
+                                        Speifiziert die Attribute welche in den zurückgegebenen
+                                        Einträgen enthalten sind. Um alle möglichen Attribute zu
+                                        inkludieren (ACL Restriktionen können es verhindern das
+                                        bestimmte Attribute von einem angegebenen Benutzer empfangen
+                                        werden) kann entweder ein leeres Array
+                                        <methodname>array()</methodname> oder
+                                        <code>array('*')</code> an die Methode übergeben werden.
+                                        Bei einigen <acronym>LDAP</acronym> Servern kann man
+                                        spezielle interne Attribute erhalten wenn man an die Methode
+                                        <code>array('*', '+')</code> übergibt.
                                     </para>
                                 </listitem>
                             </varlistentry>
@@ -227,10 +238,11 @@
 
                                 <listitem>
                                     <para>
-                                        If given the result collection will be sorted
-                                        after the attribute <varname>$sort</varname>. Results can only be
-                                        sorted after one single attribute as this parameter uses
-                                        the ext/ldap function <methodname>ldap_sort()</methodname>.
+                                        Ob die Sammlung der Ergebnisse nach dem Attribut
+                                        <varname>$sort</varname> sortiert werden soll. Ergebnisse
+                                        können nur nach einem einzelnen Attribut sortiert werden,
+                                        da dieser Parameter die ext/ldap Funktion
+                                        <methodname>ldap_sort()</methodname> verwendet.
                                     </para>
                                 </listitem>
                             </varlistentry>
@@ -240,13 +252,15 @@
 
                                 <listitem>
                                     <para>
-                                        If given the result will be wrapped in an object
-                                        of type <varname>$collectionClass</varname>. By default an object
-                                        of type <classname>Zend_Ldap_Collection</classname> will be returned.
-                                        The custom class must extend
-                                        <classname>Zend_Ldap_Collection</classname> and will be passed a
-                                        <classname>Zend_Ldap_Collection_Iterator_Default</classname> on
-                                        instantiation.
+                                        Ob das Ergebnis in ein Objekt vom Typ
+                                        <varname>$collectionClass</varname> eingebettet werden soll.
+                                        Standardmäßig wird ein Objekt vom Typ
+                                        <classname>Zend_Ldap_Collection</classname> zurückgegeben.
+                                        Die eigene Klasse muß
+                                        <classname>Zend_Ldap_Collection</classname> erweitern und
+                                        wird bei der Instanziierung ein
+                                        <classname>Zend_Ldap_Collection_Iterator_Default</classname>
+                                        übergeben.
                                     </para>
                                 </listitem>
                             </varlistentry>
@@ -260,9 +274,9 @@
                         $scope)</code>
                     </entry>
                     <entry>
-                        Counts the elements returned by the given search parameters.
-                        See <methodname>Zend_Ldap::search()</methodname> for a detailed description of
-                        the method parameters.
+                        Zählt die Elemente welche durch die angegebenen Such Parameter zurückgegeben
+                        werden. Siehe <methodname>Zend_Ldap::search()</methodname> für eine
+                        detailierte Beschreibung der Parameter der Methode.
                     </entry>
                 </row>
                 <row>
@@ -271,15 +285,15 @@
                         $dn)</code>
                     </entry>
                     <entry>
-                        Counts the direct descendants (children) of the entry
-                        identified by the given <varname>$dn</varname>.
+                        Zählt die direkten Abhängigkeiten (Kinder) des Eintrags, der durch den
+                        angegebenen <varname>$dn</varname> identifiziert wird.
                     </entry>
                 </row>
                 <row>
                     <entry><code>boolean exists(string|Zend_Ldap_Dn $dn)</code></entry>
                     <entry>
-                        Checks whether the entry identified by the given
-                        <varname>$dn</varname> exists.
+                        Prüft ob der Eintrag, der durch den angegebenen <varname>$dn</varname>
+                        identifiziert wird, existiert.
                     </entry>
                 </row>
                 <row>
@@ -289,11 +303,11 @@
                         $attributes, string $sort)</code>
                     </entry>
                     <entry>
-                        Performs a search operation and returns the result as an <acronym>PHP</acronym>
-                        array. This is essentially the same method as
-                        <methodname>Zend_Ldap::search()</methodname> except for the return type. See
-                        <methodname>Zend_Ldap::search()</methodname> for a detailed description of the
-                        method parameters.
+                        Führt eine Such Operation durch und gibt als Ergebnis ein
+                        <acronym>PHP</acronym> Array zurück. Das ist notwendigerweise die gleiche
+                        Methode wie <methodname>Zend_Ldap::search()</methodname> ausser beim
+                        Rückgabe Typ. Siehe <methodname>Zend_Ldap::search()</methodname> für eine
+                        detailierte Beschreibung der Parameter der Methode.
                     </entry>
                 </row>
                 <row>
@@ -302,14 +316,15 @@
                         $attributes, boolean $throwOnNotFound)</code>
                     </entry>
                     <entry>
-                        Retrieves the <acronym>LDAP</acronym> entry identified by <varname>$dn</varname> with
-                        the attributes specified in <varname>$attributes</varname>. If
-                        <varname>$attributes</varname> is ommitted, all attributes
-                        (<methodname>array()</methodname>) are included in the result.
-                        <varname>$throwOnNotFound</varname> is <constant>FALSE</constant> by default, so
-                        the method will return <constant>NULL</constant> if the specified entry
-                        cannot be found. If set to <constant>TRUE</constant>, a
-                        <classname>Zend_Ldap_Exception</classname> will be thrown instead.
+                        Gibt den <acronym>LDAP</acronym> Eintrag zurück der von
+                        <varname>$dn</varname> mit den in <varname>$attributes</varname> angegebenen
+                        Attributen identifiziert wird. Wenn <varname>$attributes</varname>
+                        unterdrückt wird (<methodname>array()</methodname>) werden alle Attribute im
+                        Ergebnis ausgegeben. <varname>$throwOnNotFound</varname> ist standardmäßig
+                        <constant>FALSE</constant>, so dass die Methode <constant>NULL</constant>
+                        zurückgibt wemm der spezifizierte Eintrag nicht gefunden wird. Wenn er auf
+                        <constant>TRUE</constant> gesetzt ist, wird statt dessen eine
+                        <classname>Zend_Ldap_Exception</classname> geworfen.
                     </entry>
                 </row>
                 <row>