cvs: phpdoc-de /reference/ldap reference.xml

betz Sun Jul 28 07:03:40 2002 EDT Modified files: /phpdoc-de/reference/ldap reference.xml Log: sync to en Index: phpdoc-de/reference/ldap/reference.xml diff -u phpdoc-de/reference/ldap/reference.xml:1.3 phpdoc-de/reference/ldap/reference.xml:1.4 --- phpdoc-de/reference/ldap/reference.xml:1.3 Fri May 31 13:24:39 2002 +++ phpdoc-de/reference/ldap/reference.xml Sun Jul 28 07:03:40 2002 @@ -1,16 +1,17 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <reference id="ref.ldap"> <title>LDAP Funktionen</title> <titleabbrev>LDAP</titleabbrev> <partintro> <section id="ldap.intro"> - <title>Einführung zu LDAP</title> + &reftitle.intro; <para> LDAP steht für Lightweight Directory Access Protocol und ist - ein Protokoll um auf "Directory Servers" - "Verzeichnis- - Server" - zuzugreifen. + ein Protokoll um auf "Directory Servers" - Verzeichnis- + Server - zuzugreifen. Das Verzeichnis ist dabei eine spezielle Art einer Datenbank, das Informationen in einer Baumstruktur bereithält. </para> @@ -21,7 +22,7 @@ Unterverzeichnisse der ersten Ebene "Länder" abbilden. Die weiteren Verzeichnisse unterhalb der Länderebene enthalten Einträge für Firmen, Organisationen oder Städte. Noch tiefer - geschachtelt stehen Verzeichniseinträge für Menschen und + geschachtelt stehen Verzeichniseinträge für Personen und vielleicht für Ausstattung oder Dokumente. </para> <para> @@ -38,7 +39,7 @@ </para> <para> Das entsprechende Gegenstück zu einer voll qualifizierten - Dateireferenz ist in LDAP der "Eindeutige Name" + Dateireferenz ist in LDAP der Eindeutige Name ("distinguished name"), der Einfachheit halber als "dn" bezeichnet. Ein Beispiel für einen solchen dn könnte sein @@ -49,12 +50,12 @@ <para> Das Komma markiert jeden Teil in diesem Verweis und die Sequenz wird von rechts nach links gelesen. - Diesen dn würden Sie wie folgt lesen ... + Diesen dn würden Sie wie folgt lesen: </para> <literallayout> Land = DE Organisation (organisation) = Meine Firma - Organisationseinheit (organisational unit) = Buchhaltung + Organisationseinheit (organisationalUnit) = Buchhaltung Einfacher Name (commonName) = Hans Mustermann </literallayout> <para> @@ -63,17 +64,78 @@ organsieren, kann der Verwalter eines Verzeichnis-Servers jede beliebige Struktur implementieren, die für den Einsatzzweck sinnvoll ist. - Trotzdem gibt es einige Konventionen die benutzt werden. Die Botschaft ist folgende: Sie können keinen Code schreiben um auf einen Verzeichnis-Server zuzugreifen, ohne etwas über dessen Struktur zu wissen. Genauso wenig können Sie eine Datenbank nutzen ohne Kenntnis darüber, was in derselben vorhanden ist. + + Viele Informationen finden Sie unter + </para> + + <itemizedlist> + <listitem> + <para> + <ulink url="&url.ldap.netscape;">Netscape</ulink> + </para> + </listitem> + <listitem> + <para> + <ulink url="&url.ldap.michigan;">University of Michigan</ulink> + </para> + </listitem> + <listitem> + <para> + <ulink url="&url.ldap.openldap;">OpenLDAP Project</ulink> + </para> + </listitem> + <listitem> + <para> + <ulink url="&url.ldap.ldapworld;">LDAP World</ulink> + </para> + </listitem> + </itemizedlist> + + <para> + Das Netscape SDK enthält einen hilfreichen Programmer´s Guide im .html + Format. + </para> + + </section> + + <section id="ldap.requirements"> + &reftitle.required; + <para> + Sie müssen sich die LDAP Client Bibliotheken herunterladen und + übersetzen. Sie können entweder das ldap-3.3 Packet von der + University of Michigan oder das Netscape Directory SDK 3.0 + verwenden. + </para> + </section> + + <section id="ldap.installation"> + &reftitle.install; + <para> + LDAP support in PHP is not enabled by default. You will need to + use the <link linkend="install.configure.with-ldap">--with-ldap</link> + configuration option when compiling PHP to enable LDAP support. </para> </section> -<section id="ldap-example"> -<title>Komplettes Code Beispiel</title> + <section id="ldap.configuration"> + &reftitle.runtime; + &no.config; + </section> + + <section id="ldap.resources"> + &reftitle.resources; + &no.resource; + </section> + + &reference.ldap.constants; + + <section id="ldap.examples"> + &reftitle.examples; <para> Informationen von einem Verzeichnis-Server beziehen für alle Einträge bei denen der Nachname mit "S" beginnt. Darstellung @@ -85,17 +147,16 @@ <programlisting role="php"> <![CDATA[ <?php - // Grundlegende Abfolge bei LDAP ist verbinden, binden, suchen, - // interpretieren des Sucheergebnisses, Verbindung schließen - - echo "<h3>LDAP query Test</h3>"; - echo "Verbindung ..."; - $ds=ldap_connect("localhost"); // muss ein gültiger LDAP Server - // sein! +// Grundlegende Abfolge bei LDAP ist verbinden, binden, suchen, +// interpretieren des Sucheergebnisses, Verbindung schließen +echo "<h3>LDAP query Test</h3>"; +echo "Verbindung ..."; +$ds=ldap_connect("localhost"); // muss ein gültiger LDAP Server + // sein! echo "Ergebnis der Verbindung: ".$ds."<p>"; - if ($ds) { +if ($ds) { echo "Bindung ..."; $r=ldap_bind($ds); // das ist ein "anonymer" bind, // typischerweise nur Lese Zugriff @@ -122,22 +183,17 @@ ldap_close($ds); } else { - echo "<h4>Verbindung zu LDAP Server nicht möglich</h4>"; + echo "<h4>Verbindung zum LDAP Server nicht möglich</h4>"; } ?> ]]> </programlisting> </example> + </section> <section id="ldap.using"> <title>Verwenden der PHP LDAP Aufrufe</title> <para> - Sie müssen sich die LDAP Client Bibliotheken herunterladen und - übersetzen. Sie können entweder das ldap-3.3 Packet von der - University of Michigan oder das Netscape Directory SDK 3.0 - verwenden. Ebenso müssen Sie Ihr PHP mit LDAP Unterstützung - aktiviert neu übersetzen bevor die PHP LDAP-Aufrufe - funktionieren. </para> <para> Bevor Sie die LDAP Aufrufe benutzen können, müssen Sie folgendes @@ -180,44 +236,8 @@ | ldap_close() // "logout" </literallayout> -</para> - </section> - - <section id="ldap.moreinfo"> - <title>Mehr Informationen</title> - <para> - Viele Informationen finden Sie unter - </para> - - <itemizedlist> - <listitem> - <para> - <ulink url="&url.ldap.netscape;">Netscape</ulink> - </para> - </listitem> - <listitem> - <para> - <ulink url="&url.ldap.michigan;">University of Michigan</ulink> - </para> - </listitem> - <listitem> - <para> - <ulink url="&url.ldap.openldap;">OpenLDAP Project</ulink> - </para> - </listitem> - <listitem> - <para> - <ulink url="&url.ldap.ldapworld;">LDAP World</ulink> - </para> - </listitem> - </itemizedlist> - - <para> - Das Netscape SDK enthält einen hilfreichen Programmer´s Guide im - .html Format. </para> </section> - </section> </partintro>