betz Fri Jan 18 18:25:28 2002 EDT
Modified files:
/phpdoc/de/functions ldap.xml
Log:
sync with en 1.40
Index: phpdoc/de/functions/ldap.xml
diff -u phpdoc/de/functions/ldap.xml:1.15 phpdoc/de/functions/ldap.xml:1.16
--- phpdoc/de/functions/ldap.xml:1.15 Wed Jan 16 16:28:19 2002
+++ phpdoc/de/functions/ldap.xml Fri Jan 18 18:25:28 2002
@@ -3,73 +3,73 @@
<title>LDAP Funktionen</title>
<titleabbrev>LDAP</titleabbrev>
-<partintro>
-<sect1 id="ldap.intro">
-<title>Einführung zu LDAP</title>
- <para>
- LDAP steht für Lightweight Directory Access Protocol und ist
- 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>
- <para>
- Das Konzept ist dabei ähnlich der Verzeichnisstruktur Ihrer
- Festplatte, mit der Ausnahme, daß in diesem Zusammenhang
- das Wurzelverzeichnis "Die Welt" ist und die
- 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
- vielleicht für Ausstattung oder Dokumente.
- </para>
- <para>
- Um auf eine Datei in einem Unterverzeichnis auf Ihrer
- Festplatte zu verweisen, könnten Sie eine Schreibweise wie
- folgt verwenden
+ <partintro>
+ <sect1 id="ldap.intro">
+ <title>Einführung zu LDAP</title>
+ <para>
+ LDAP steht für Lightweight Directory Access Protocol und ist
+ 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>
+ <para>
+ Das Konzept ist dabei ähnlich der Verzeichnisstruktur Ihrer
+ Festplatte, mit der Ausnahme, daß in diesem Zusammenhang
+ das Wurzelverzeichnis "Die Welt" ist und die
+ 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
+ vielleicht für Ausstattung oder Dokumente.
+ </para>
+ <para>
+ Um auf eine Datei in einem Unterverzeichnis auf Ihrer
+ Festplatte zu verweisen, könnten Sie eine Schreibweise wie
+ folgt verwenden
</para>
<literallayout>
- /usr/local/meine_daten/doku
+ /usr/local/meine_daten/doku
</literallayout>
<para>
- Die Schrägstriche markieren jeden Teil in diesem Verweis und
- die Sequenz wird von links nach rechts gelesen.
+ Die Schrägstriche markieren jeden Teil in diesem Verweis und
+ die Sequenz wird von links nach rechts gelesen.
</para>
<para>
- Das entsprechende Gegenstück zu einer voll qualifizierten
- 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
+ Das entsprechende Gegenstück zu einer voll qualifizierten
+ 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
</para>
<literallayout>
- cn=Hans Mustermann,ou=Buchhaltung,o=Meine Firma,c=DE
+ cn=Hans Mustermann,ou=Buchhaltung,o=Meine Firma,c=DE
</literallayout>
<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 ...
+ 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 ...
</para>
<literallayout>
- Land = DE
- Organisation (organisation) = Meine Firma
- Organisationseinheit (organisational unit) = Buchhaltung
- Einfacher Name (commonName) = Hans Mustermann
+ Land = DE
+ Organisation (organisation) = Meine Firma
+ Organisationseinheit (organisational unit) = Buchhaltung
+ Einfacher Name (commonName) = Hans Mustermann
</literallayout>
<para>
- In der gleichen Weise, in der es keine allgemeinverbindlichen
- Regeln gibt, wie Sie die Verzeichnisstruktur Ihrer Festplatte
- 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.
- </para>
-</sect1>
+ In der gleichen Weise, in der es keine allgemeinverbindlichen
+ Regeln gibt, wie Sie die Verzeichnisstruktur Ihrer Festplatte
+ 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.
+ </para>
+ </sect1>
<sect1 id="ldap-example">
<title>Komplettes Code Beispiel</title>
@@ -82,65 +82,65 @@
<example>
<title>LDAP Such-Beispiel</title>
<programlisting role="php">
- <?php
+<![CDATA[
+<?php
// Grundlegende Abfolge bei LDAP ist verbinden, binden, suchen,
// interpretieren des Sucheergebnisses, Verbindung schließen
- echo "<h3>LDAP query Test</h3>";
+ 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>";
+ echo "Ergebnis der Verbindung: ".$ds."<p>";
if ($ds) {
echo "Bindung ...";
$r=ldap_bind($ds); // das ist ein "anonymer" bind,
// typischerweise nur Lese Zugriff
- echo "Ergebnis der Bindung ".$r."<p>";
+ echo "Ergebnis der Bindung ".$r."<p>";
echo "Suche nach (sn=S*) ...";
// Suchen des Nachnamen-Eintrags
$sr=ldap_search($ds,"o=Meine Firma, c=DE", "sn=S*");
- echo "Ergebnis der Suche ".$sr."<p>";
+ echo "Ergebnis der Suche ".$sr."<p>";
- echo "Anzahl der Einträge, die gefunden wurden
- .ldap_count_entries($ds,$sr)."<p>";
+ echo "Anzahl gefundenen Einträge ".ldap_count_entries($ds,$sr)."<p>";
- echo "Einträge holen ...<p>";
+ echo "Einträge holen ...<p>";
$info = ldap_get_entries($ds, $sr);
- echo "Daten für ".$info["count"]." Items gefunden:<p>";
+ echo "Daten für ".$info["count"]." Items gefunden:<p>";
- for ($i=0; $i<$info["count"]; $i++) {
- echo "dn ist: ". $info[$i]["dn"] ."<br>";
- echo "erster cn Eintrag: ". $info[$i]["cn"][0] ."<br>";
- echo "erster email Eintrag: ". $info[$i]["mail"][0]
- ."<p>";
- }
+ for ($i=0; $i<$info["count"]; $i++) {
+ echo "dn ist: ". $info[$i]["dn"] ."<br>";
+ echo "erster cn Eintrag: ". $info[$i]["cn"][0] ."<br>";
+ echo "erster email Eintrag: ". $info[$i]["mail"][0] ."<p>";
+ }
- echo "Verbindung schließen";
+ echo "Verbindung schließen";
ldap_close($ds);
- } else {
- echo "<h4>Verbindung zu LDAP Server nicht möglich</h4>";
- }
- ?>
+} else {
+ echo "<h4>Verbindung zu LDAP Server nicht möglich</h4>";
+}
+?>
+]]>
</programlisting>
</example>
-<sect2 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
- wissen...
+ <sect2 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
+ wissen...
<itemizedlist>
<listitem>
<para>
@@ -165,9 +165,9 @@
</itemizedlist>
</para>
<para>
- Die typische Abfolge von LDAP Aufrufen in einer Anwendung folgen
- diesem Muster
- <literallayout>
+ Die typische Abfolge von LDAP Aufrufen in einer Anwendung folgen
+ diesem Muster
+<literallayout>
ldap_connect() // Aufbau einer Verbindung zum Server
connection to server
@@ -178,11 +178,12 @@
und stelle das Ergebnis dar
|
ldap_close() // "logout"
-</literallayout></para>
+</literallayout>
+</para>
+ </sect2>
-</sect2>
-<sect2 id="ldap.moreinfo">
-<title>Mehr Informationen</title>
+ <sect2 id="ldap.moreinfo">
+ <title>Mehr Informationen</title>
<para>
Viele Informationen finden Sie unter
</para>
@@ -214,41 +215,40 @@
Das Netscape SDK enthält einen hilfreichen Programmer´s Guide im
.html Format.
</para>
-</sect2>
-</sect1>
+ </sect2>
+ </sect1>
-</partintro>
+ </partintro>
-<refentry id="function.ldap-add">
-<refnamediv>
- <refname>ldap_add</refname>
- <refpurpose>
- Einträge einem LDAP Verzeichnis hinzufügen
- </refpurpose>
-</refnamediv>
+ <refentry id="function.ldap-add">
+ <refnamediv>
+ <refname>ldap_add</refname>
+ <refpurpose>
+ Einträge einem LDAP Verzeichnis hinzufügen
+ </refpurpose>
+ </refnamediv>
<refsect1>
<title>Beschreibung</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>ldap_add</function></funcdef>
- <paramdef>int <parameter>Verbindungs-Kennung</parameter>
- </paramdef>
+ <paramdef>int <parameter>Verbindungs-Kennung</parameter></paramdef>
<paramdef>string <parameter>dn</parameter></paramdef>
<paramdef>array <parameter>eintrag</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
- Rückgabewert: wahr im Erfolgsfall, falsch im Fehlerfall.
+ Rückgabewert: &return.success;
</para>
<para>
Die <function>ldap_add</function> Funktion wird benutzt um
Einträge einem Verzeichnis hinzuzufügen. Die DN des Eintrags, der
- hinzugefügt werden soll wird durch dn bestimmt. Array eintrag
- bestimmt die Informationen des Eintrags. Die Werte in den
- Einträgen werden durch individuelle Merkmale indiziert.
- Im Fall von mehreren Werten für ein Merkmal werden diese durch
- die Verwendung von Zahlen indiziert, die bei 0 beginnen.
+ hinzugefügt werden soll wird durch <parameter>dn</parameter> bestimmt.
+ Das Array <parameter>eintrag</parameter> bestimmt die Informationen
+ des Eintrags. Die Werte in den Einträgen werden durch individuelle
+ Merkmale indiziert. Im Fall von mehreren Werten für ein Merkmal werden
+ diese durch die Verwendung von Zahlen indiziert, die bei 0 beginnen.
</para>
<informalexample>
<literallayout>
@@ -259,9 +259,9 @@
</informalexample>
<example>
<title>Komplettes Beispiel mit authentifiziertem bind</title>
-
-<programlisting role="php">
-<?php
+ <programlisting role="php">
+<![CDATA[
+<?php
$ds=ldap_connect("localhost"); // Annahme: der LDAP Server befindet
// sich auf diesem Host
@@ -276,15 +276,15 @@
$info["objectclass"]="person";
// hinzufügen der Daten zum Verzeichnis
- $r=ldap_add($ds, "cn=Hans Mustermann, o=Meine Firma, c=DE",
- $info);
+ $r=ldap_add($ds, "cn=Hans Mustermann, o=Meine Firma, c=DE", $info);
ldap_close($ds);
} else {
echo "Verbindung zum LDAP Server nicht möglich!";
}
?>
-</programlisting>
+]]>
+ </programlisting>
</example>
</refsect1>
</refentry>
@@ -310,13 +310,14 @@
</funcsynopsis>
<para>
Bindung für ein LDAP Verzeichnis mit angegebenem RDN und
- Kennwort. Rückgabewert: wahr im Erfolgsfall, falsch im
- Fehlerfall.
+ Kennwort. &return.success;
</para>
<para>
Die <function>ldap_bind</function> Funktion führt eine bind
- Operation auf einem Verzeichnis aus. bind_rdn und bind_kennwort
- sind optional, wenn diese fehlen wird ein anonymes bind versucht.
+ Operation auf einem Verzeichnis aus. Die Parameter
+ <parameter>bind_rdn</parameter> und
+ <parameter>bind_kennwort</parameter> sind optional, wenn diese
+ fehlen wird ein anonymes bind versucht.
</para>
</refsect1>
</refentry>
@@ -332,12 +333,11 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>ldap_close</function></funcdef>
- <paramdef>int <parameter>Verbindungs-Kennung</parameter>
- </paramdef>
+ <paramdef>int <parameter>Verbindungs-Kennung</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
- Rückgabewert: wahr im Erfolgsfall, falsch im Fehlerfall.
+ &return.success;
</para>
<para>
Die <function>ldap_close</function> Funktion schließt die
@@ -350,6 +350,11 @@
<function>ldap_unbind</function>, so dass Sie vielleicht diese
Funktion benutzen sollten, anstatt<function>
ldap_close</function> zu verwenden.</para>
+ <note>
+ <para>
+ Diese Funktion ist ein Alias für <function>ldap_unbind</function>.
+ </para>
+ </note>
</refsect1>
</refentry>
@@ -375,9 +380,8 @@
</funcprototype>
</funcsynopsis>
<simpara>
- Rückgabewert: wahr, wenn <parameter>wert</parameter> gefunden
- wird, ansonsten falsch. Tritt ein Fehler auf, wird -1
- zurückgegeben.
+ Rückgabewert: wahr, wenn der <parameter>wert</parameter> gefunden
+ wird, ansonsten &false;. Tritt ein Fehler auf, wird -1 zurückgegeben.
</simpara>
<para>
<function>ldap_compare</function> vergleicht den<parameter>
@@ -393,7 +397,8 @@
<example>
<title>Komplettes Beispiel einer Kennwort-Überprüfung</title>
<programlisting role="php">
-<?php
+<![CDATA[
+<?php
$ds=ldap_connect("localhost"); // Annahme: der LDAP Server befindet
// sich auf diesem Host
@@ -405,10 +410,10 @@
// Daten vobereiten
$dn = "cn=Helga Olsen, ou=Meine Einheit, o=Meine Firma, c=FI";
- $value = "geheimeskennwort";
+ $value = "Geheimes Kennwort";
$attr = "kennwort";
- // vergleiche Werte
+ // vergleiche die Werte
$r=ldap_compare($ds, $dn, $attr, $value);
if ($r === -1) {
@@ -428,16 +433,17 @@
} else {
echo "Keine Verbindung zum LDAP Server möglich.";
}
-?>
+?>
+]]>
</programlisting>
</example>
- <note>
+ <warning>
<para>
<function>ldap_compare</function> kann NICHT für Vergleiche von
BINÄREN Werten benutzt werden!
</para>
- </note>
+ </warning>
<note>
<para>
Diese Funktion wurde in 4.0.2 hinzugefügt.
@@ -465,26 +471,30 @@
</funcsynopsis>
<para>
Rückgabewert: Eine positive Verbindungs-Kennung im Erfolgsfall,
- falsch im Fehlerfall.
+ &false; im Fehlerfall.
</para>
<para>
- Die <function>ldap_connect</function> Funktion öffnet eine
+ Die <function>ldap_connect</function> Funktion stellt eine
Verbindung zu einem LDAP Server auf einem bestimmten<parameter>
- hostname</parameter> und <parameter>port</parameter>. Beide
- Argumente sind optional. Wenn keine Argumente angegeben werden,
- wird die Verbindungs-Kennung einer eventuell schon geöffneten
- Verbindung zurückgeliefert. Wird nur der<parameter>
- hostname</parameter> angegeben, wird für den Port der Standarport
- 389 benutzt.
+ hostname</parameter> und <parameter>port</parameter> her. Beide
+ Argumente sind optional. Werden keine Argumente angegeben ,
+ wird die Verbindungs-Kennung einer schon geöffneten
+ Verbindung zurückgeliefert. Wird nur der
+ <parameter>hostname</parameter> angegeben, wird für den Port der
+ Standarport 389 benutzt.
</para>
<para>
Bei Verwendung von OpenLDAP 2.x.x können Sie eine URL statt des
- Hostnamens angeben.
- Um LDAP mit SSL-Unterstützzung zu verwenden, übersetzen Sie
- OpenLDAP mit SSL-Unterstützung, PHP mit SSL und verwenden
+ Hostnamens angeben. Um LDAP mit SSL-Unterstützzung zu verwenden,
+ übersetzen Sie OpenLDAP mit SSL-Unterstützung, PHP mit SSL und verwenden
ldaps://Hostname/ als Host Argument. Das Port Argument wird bei
der Verwendung von URLs nicht benutzt.
- URL und SSL Unterstützung wurden in 4.0.4 hinzugefügt</para>
+ </para>
+ <note>
+ <simpara>
+ URL und SSL Unterstützung wurden in 4.0.4 hinzugefügt
+ </simpara>
+ </note>
</refsect1>
</refentry>
@@ -492,8 +502,7 @@
<refentry id="function.ldap-count-entries">
<refnamediv>
<refname>ldap_count_entries</refname>
- <refpurpose>Zählt die Anzahl der Einträge bei einer
- Suche</refpurpose>
+ <refpurpose>Zählt die Anzahl der Einträge bei einer Suche</refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
@@ -507,12 +516,12 @@
</funcprototype>
</funcsynopsis>
<para>
- Rückgabewert: Anzahl der Einträge im Ergebnis, falsch im
+ Rückgabewert: Anzahl der Einträge im Ergebnis, &false; im
Fehlerfall.</para>
<para>
Die <function>ldap_count_entries</function> Funktion liefert die
Anzahl der Einträge im gespeicherten Ergebnis einer vorher
- durchgeführten Suchoperation.
+ durchgeführten Suchoperation. Die
<parameter>Ergebnis-Kennung</parameter> bezeichnet das interne
LDAP Ergebnis.
</para>
@@ -537,12 +546,12 @@
</funcprototype>
</funcsynopsis>
<para>
- Rückgabewert: wahr im Erfolgsfall, falsch im Fehlerfall.
+ &return.success;
</para>
<para>
Die <function>ldap_delete</function> Funktion löscht einen
- einzelnen Eintrag aus einem LDAP Verzeichnis, das im dn angegeben
- wurde.
+ einzelnen Eintrag aus einem LDAP Verzeichnis, das im
+ <parameter>dn</parameter> angegeben wurde.
</para>
</refsect1>
</refentry>
@@ -565,8 +574,9 @@
</funcsynopsis>
<para>
Die <function>ldap_dn2ufn</function> Funktion wird verwendet um
- einen DN in einer benutzerfreundlicheren Form darzustellen, wobei
- die Typen-Namen wegfallen.
+ einen DN, angegeben mit <parameter>dn</parameter>, in einer
+ benutzerfreundlicheren Form darzustellen, wobei die Typen-Namen
+ wegfallen.
</para>
</refsect1>
</refentry>
@@ -584,14 +594,14 @@
<funcsynopsis>
<funcprototype>
<funcdef>string <function>ldap_err2str</function></funcdef>
- <paramdef>int <parameter>Fehlernummer</parameter></paramdef>
+ <paramdef>int <parameter>fehlernummer</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Rückgabewert: Fehlertext.</para>
<para>
- Diese Funktion liefert den Fehlertext der die Fehlernummer
- erklärt.
+ Diese Funktion liefert den Fehlertext der die
+ <parameter>fehlernummer</parameter> erklärt.
Während LDAP Fehlernummern standardisiert sind, liefern
unterschiedliche Bibliotheken unterschiedliche oder sogar
lokalspezifische Fehlermeldungen. Deshalb sollten Sie nie auf
@@ -604,13 +614,15 @@
<example>
<title>Aufzählung aller LDAP Fehlermeldungen</title>
-<programlisting role="php">
-<?php
- for($i=0; $i<100; $i++) {
- printf("Fehler $i: %s<br>\n", ldap_err2str($i));
+ <programlisting role="php">
+<![CDATA[
+<?php
+ for($i=0; $i<100; $i++) {
+ printf("Fehler $i: %s<br>\n", ldap_err2str($i));
}
?>
-</programlisting>
+]]>
+ </programlisting>
</example>
</para>
</refsect1>
@@ -640,8 +652,9 @@
<para>
Diese Funktion liefert die standardisierte Fehlernummer des
zuletzt ausgeführten LDAP Kommandos für die angegebene
- Vebindungs-Kennung. Diese Nummer kann mit der Funktion <function>
- ldap_err2str</function> in einen Fehlertext konvertiert werden.
+ Vebindungs-Kennung. Diese Nummer kann mit der Funktion
+ <function>ldap_err2str</function> in einen Fehlertext konvertiert
+ werden.
</para>
<para>
Solange Sie die Stufe der Fehlerwarnungen in Ihrer php.ini nicht
@@ -650,23 +663,27 @@
aufgetretenen Fehler auch in Ihrer HTML Ausgabe zu sehen sein.
<example>
<title>Erzeugen und Abfangen eines Fehlers</title>
-<programlisting role="php">
-<?php
-/* Diese Beispiel enhält einen Fehler, der abgefangen wird.*/
+ <programlisting role="php">
+<![CDATA[
+<?php
+// Dieses Beispiel enhält einen Fehler, der abgefangen wird.
$ld = ldap_connect("localhost");
$bind = ldap_bind($ld);
+
// Syntax Fehler im Filterausdruck (errno 87),
// müsste "objectclass=*" heißen, um zu funktionieren.
+
$res = @ldap_search($ld, "o=Meine Firma, c=DE", "objectclass");
if (!$res) {
- printf("LDAP-Fehlernummer: %s<br>\n", ldap_errno($ld));
- printf("LDAP-Fehler: %s<br>\n", ldap_error($ld));
- die("Argh!<br>\n");
+ printf("LDAP-Fehlernummer: %s<br>\n", ldap_errno($ld));
+ printf("LDAP-Fehler: %s<br>\n", ldap_error($ld));
+ die("Argh!<br>\n");
}
$info = ldap_get_entries($ld, $res);
-printf("%d Übereinstimmende Einträge.<br>\n", $info["count"]);
+printf("%d Übereinstimmende Einträge.<br>\n", $info["count"]);
?>
-</programlisting>
+]]>
+ </programlisting>
</example>
</para>
<para>
@@ -697,16 +714,17 @@
<para>
Diese Funktion liefert den erklärenden Fehlertext für einen
Fehler, der vom zuletzt ausgeführten LDAP Kommando mit der
- angegebenen Verbindungs-Kennung erzeugt wurde.
- Während LDAP Fehlernummern standardisiert sind, liefern
- unterschiedliche Bibliotheken unterschiedliche oder sogar
+ angegebenen <parameter>Verbindungs-Kennung</parameter>
+ erzeugt wurde. Während LDAP Fehlernummern standardisiert sind,
+ liefern unterschiedliche Bibliotheken unterschiedliche oder sogar
lokalspezifische Fehlermeldungen. Deshalb sollten Sie nie auf
eine spezielle Fehlermeldung prüfen, sondern immer eine
Fehlernummer verwenden.
</para>
<para>
- Solange Sie die Stufe der Fehlerwarnungen in Ihrer php.ini nicht
- herabsetzen oder vor Ihre LDAP Komanndos ein @ (at) setzen
+ Solange Sie die Stufe der Fehlerwarnungen in Ihrer
+ <filename>php.ini</filename> nicht herabsetzen oder vor Ihre
+ LDAP Komanndos ein <literal>@</literal> (at) setzen,
um die Ausgabe von Fehlermeldungen zu unterdrücken, werden die
aufgetretenen Fehler auch in Ihrer HTML Ausgabe zu sehen sein.
</para>
@@ -740,10 +758,10 @@
aufzuteilen und in dessen Bestandteile zu zerlegen. Jeder Teil
wird als Relative Distinguished Name, RDN, bezeichnet.
<function>ldap_explode_dn</function> liefert einen Array mit
- allen diesen Bestandteilen
+ allen diesen Bestandteilen.
Der Parameter <parameter>mit_merkmal</parameter> wird benutzt, um
zu bestimmen, ob die RDNs nur mit Werten oder zusätlich mit ihren
- Merkmalen angefragt werden. Um RDNs mit Merkmalen (z.B. Merkmal=
+ Merkmalen angefragt werden. Um RDNs mit Merkmalen (z.B. Merkmal =
Wert Format) zu erhalten, setzen Sie <parameter>
mit_merkmal</parameter> auf 0, um nur Werte zu erhalten auf 1.
</para>
@@ -771,16 +789,16 @@
</funcsynopsis>
<para>
Rückgabewert: im Erfolgsfall das erste Merkmal des Eintrags, im
- Fehlerfall falsch.
+ Fehlerfall &false;.
</para>
<para>
- Ähnlich wie Einträge lesen, Merkmale eines bestimmten Eintrags
- werden eins nach dem anderen gelesen.
+ Ähnlich wie Einträge lesen, werden Merkmale eines bestimmten Eintrags
+ eines nach dem anderen gelesen.
Die <function>ldap_first_attribute</function> Funktion liefert
- das erste Merkmal eines Eintrags der durch Ergebnis-Eintrag-
- Kennung angegeben wurde. Durch erfolgreichen Aufruf von
- <function>ldap_next_attribute</function> erhalten Sie die
- restlichen Merkmale.
+ das erste Merkmal eines Eintrags der durch die
+ <parameter>Ergebnis-Eintrag-Kennung</parameter> angegeben wurde.
+ Durch erfolgreichen Aufruf von <function>ldap_next_attribute</function>
+ erhalten Sie die restlichen Merkmale.
Der Parameter <parameter>ber-Kennung</parameter> ist die Kennung
eines internen Speicherort-Zeiger. Die Übergabe erfolgt per
Referenz. Die gleiche <parameter>ber-Kennung</parameter> wird an
@@ -813,7 +831,7 @@
</funcsynopsis>
<para>
Rückgabewert: im Erfolgsfall die Ergebnis-Eintrag-Kennung
- für den ersten Eintrag, falsch im Fehlerfall.
+ für den ersten Eintrag, &false; im Fehlerfall.
</para>
<para>
Einträge eines LDAP Ergebnisses werden unter Verwendung der
@@ -821,9 +839,9 @@
<function>ldap_next_entry</function> sequentiell gelesen.
Die <function>ldap_first_entry</function> Funktion gibt die
Eintrag-Kennung für den ersten Eintrag im Ergebnis zurück.
- Diese Eintrag-Kennung wird dann an die Funktion <function>
- lap_next_entry</function> weitergegeben, um sukzessiv die
- Einträge des Ergebnisses zu erhalten.
+ Diese Eintrag-Kennung wird dann an die Funktion
+ <function>ldap_next_entry</function> weitergegeben, um sukzessiv
+ die Einträge des Ergebnisses zu erhalten.
</para>
<para>
Siehe auch <function>ldap_get_entries</function>.
@@ -849,20 +867,20 @@
</funcprototype>
</funcsynopsis>
<para>
- Rückgabewert: wahr im Erfolgsfall, falsch im Fehlerfall.
+ &return.success;
</para>
<para>
Um die Ergebnisse zu speichern, wird intern Speicher belegt.
- Diesen Speicher können Sie mit der Funktion <function>
- ldap_free_result</function> unter Angabe der entsprechenden
+ Diesen Speicher können Sie mit der Funktion
+ <function>ldap_free_result</function> mir Angabe der entsprechenden
<parameter>Ergebnis-Kennung</parameter> wieder freigeben.
- Typischerweise wird nach Beendigung des Skripts der gesamte
+ Typischerweise wird nach Beendigung des Skripts wird der gesamte
Ergebnis-Speicher automatisch freigegeben.
</para>
<para>
Falls Ihr Skript sukzessive Suchoperationen durchführt, die
große Ergebnismengen liefern, können Sie <function>
- ldap_free_result</function> benutzen, um den Speicherverbrauch
+ ldap_free_result</function> aufrufen, um den Speicherverbrauch
zur Laufzeit niedrig zu halten.
</para>
</refsect1>
@@ -891,7 +909,7 @@
<para>
Rückgabewert: im Erfolgsfall wird die gesamte Information eines
Eintrags in einem multidimensionalen Array zurückgegeben; im
- Fehlerfall falsch.
+ Fehlerfall &false;.
</para>
<para>
Die <function>ldap_get_attributes</function> Funktion
@@ -906,8 +924,8 @@
Funktion würden Sie in einer Anwendung verwenden, die
Verzeichniseinträge "durchstöbert" und/oder wo Sie die Struktur
der Verzeichniseinträge nicht kennen. In vielen Anwendungen
- suchen Sie nach einem bestimmten Merkmal wie einer email-
- Adresse oder einem Nachnamen und interessieren sich nicht dafür,
+ suchen Sie nach einem bestimmten Merkmal wie einer email-Adresse
+ oder einem Nachnamen und interessieren sich nicht dafür,
welche anderen Daten verfügbar sind.
</para>
<para>
@@ -926,7 +944,8 @@
Anzeigen der Liste der Merkmale für einen ausgewählten
Verzeichnis-Eintrag
</title>
-<programlisting role="php">
+ <programlisting role="php">
+<![CDATA[
// $ds die Verbindungs-Kennung für das Verzeichnis
// $sr ein gültiges Suchergebnis eines früheren Aufrufs einer der ldap
@@ -937,17 +956,18 @@
$attrs = ldap_get_attributes($ds, $entry);
-echo $attrs["count"]." Merkmale für diesen Eintrag:<p>";
-
-for ($i=0; $i<$attrs["count"]; $i++)
- echo $attrs[$i]."<br>";
-</programlisting>
-</example></para>
-
- <para>
- Siehe auch <function>ldap_first_attribute</function> und
- <function>ldap_next_attribute</function></para>
+echo $attrs["count"]." Merkmale für diesen Eintrag:<p>";
+for ($i=0; $i<$attrs["count"]; $i++)
+ echo $attrs[$i]."<br>";
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Siehe auch <function>ldap_first_attribute</function> und
+ <function>ldap_next_attribute</function>
+ </para>
</refsect1>
</refentry>
@@ -970,7 +990,7 @@
</funcsynopsis>
<para>
Rückgabewert: im Erfolgsfall der DN des Ergebnis-Eintrags, im
- Fehlerfall falsch.
+ Fehlerfall &false;.
</para>
<para>
Die <function>ldap_get_dn</function> Funktion wird verwendet, um
@@ -999,11 +1019,12 @@
<para>
Rückgabewert: im Erfolgsfall wird die gesamte Information des
Ergebnisses in einem multidimensionalen Array zurückgegeben; im
- Fehlerfall falsch.
+ Fehlerfall &false;.
</para>
<para>
Die <function>ldap_get_entries</function> Funktion wird verwendet
- um das Lesen mehrfacher Einträge des Ergebnisses zu vereinfachen
+ um das Lesen mehrfacher Einträge des Ergebnisses, angegeben mit
+ <parameter>Ergebnis-Kennung</parameter> zu vereinfachen
und danach werden die Merkmale und mehfachen Werte gelesen.
Durch einen Funktionsaufruf wird die gesamte Information in einem
multidimensionalen Array zurückgegeben. Die Struktur dieses Array
@@ -1019,25 +1040,24 @@
<informalexample>
<literallayout>
return_value["count"] = Anzahl der Einträge im Ergebnis
-return_value[0] : bezieht sich auf Einzelheiten des ersten
- Eintrags
+return_value[0] : bezieht sich auf Einzelheiten des ersten Eintrags
return_value[i]["dn"] = DN des i-ten Eintrags im Ergebnis
return_value[i]["count"] = Anzahl der Merkmale im i-ten Eintrag
-return_value[i][j] = das j-te Merkmal des i-ten Eintrags im Ergebnis
+return_value[i][j] = das j-te Merkmal des i-ten Eintrags im Ergebnis
return_value[i]["merkmal"]["count"] = Anzahl der Werte für das
Merkmal im i-ten Eintrag
-return_value[i]["merkmal"][j] = der j-te Wert des Merkmals im i-ten
- Eintrag
+return_value[i]["merkmal"][j] = der j-te Wert des Merkmals im i-ten
+ Eintrag
</literallayout>
</informalexample>
</para>
-
- <para>
- Siehe auch <function>ldap_first_entry</function> und
- <function>ldap_next_entry</function></para>
+ <para>
+ Siehe auch <function>ldap_first_entry</function> und
+ <function>ldap_next_entry</function>
+ </para>
</refsect1>
</refentry>
@@ -1062,38 +1082,40 @@
</funcsynopsis>
<para>
Setzt <parameter>retval</parameter> auf den Wert der gewählten
- Option.
- Rückgabewert: wahr im Erfolgsfall, falsch im Fehlerfall.
+ Option. &return.success;
</para>
<para>
Der Parameter <parameter>option</parameter> kann einer der
folgenden sein:
LDAP_OPT_DEREF, LDAP_OPT_SIZELIMIT, LDAP_OPT_TIMELIMIT,
LDAP_OPT_PROTOCOL_VERSION, LDAP_OPT_ERROR_NUMBER,
- LDAP_OPT_REFERRALS,
- LDAP_OPT_RESTART, LDAP_OPT_HOST_NAME, LDAP_OPT_ERROR_STRING,
- LDAP_OPT_MATCHED_DN. Beschrieben sind diese unter
+ LDAP_OPT_REFERRALS, LDAP_OPT_RESTART, LDAP_OPT_HOST_NAME,
+ LDAP_OPT_ERROR_STRING, LDAP_OPT_MATCHED_DN. Beschrieben sind diese unter
<ulink url="&url.ldap.openldap-c-api;">draft-ietf-ldapext-ldap-c-
api-xx.txt</ulink>
</para>
- <para>
- Diese Funktion steht nur zur Verfügung, wenn Sie OpenLDAP 2.x.x
- ODER Netscape Directory SDK x.x benutzen.
- Wurde in PHP 4.0.4 hinzugefügt.
- </para>
-
+ <note>
+ <para>
+ Diese Funktion steht nur zur Verfügung, wenn Sie OpenLDAP 2.x.x
+ ODER Netscape Directory SDK x.x benutzen.
+ Wurde in PHP 4.0.4 hinzugefügt.
+ </para>
+ </note>
<para>
<example>
<title>Prüfen der Protokollversion</title>
-<programlisting role="php">
+ <programlisting role="php">
+<![CDATA[
// $ds eine gültige Verbindungs-Kennung für einen Verzeichnis-Server
+
if (ldap_get_option($ds, LDAP_OPT_PROTOCOL_VERSION, $version))
echo "Sie benutzen die Protokollversion $version";
else
echo "Protokollversion konnte nicht bestimmt werden";
-</programlisting>
+]]>
+ </programlisting>
</example>
- </para>
+ </para>
<para>
Siehe auch <function>ldap_set_option</function>.
@@ -1123,17 +1145,17 @@
</funcsynopsis>
<para>
Rückgabewert: im Erfolgsfall ein Array der Werte des Merkmals,
- falsch im Fehlerfall.
+ &false; im Fehlerfall.
</para>
<para>
Die <function>ldap_get_values</function> Funktion wird benutzt um
alle Werte des Merkmals eines Eintrags im Ergebnis zu lesen. Der
Eintrag wird durch
<parameter>Ergebnis-Eintrag-Kennung</parameter> bestimmt. Die
- Anzahl der Werte kann über die
- Indexierung von "count" des resultierenden Arrays bestimmt
- werden. Der Zugriff auf einzelne Werte erfolgt durch einen
- ganzzahligen Index im Array. Der erste Indexwert ist 0.
+ Anzahl der Werte kann über die Indexierung von "count" des
+ resultierenden Arrays bestimmt werden. Der Zugriff auf einzelne Werte
+ erfolgt durch einen ganzzahligen Index im Array. Der erste Indexwert
+ ist 0.
</para>
<para>
Da diese Funktion eine
@@ -1157,8 +1179,8 @@
<informalexample>
<literallayout>
return_value["count"] = Anzahl der Werte eines Merkmals
-return_value[0] = der erste Wert des Merkmals
-return_value[i] = der i-te Wert des Merkmals
+return_value[0] = der erste Wert des Merkmals
+return_value[i] = der i-te Wert des Merkmals
</literallayout>
</informalexample>
@@ -1167,23 +1189,26 @@
Liste aller Werte des Merkmals "mail" für einen Verzeichnis-
Eintrag
</title>
-<programlisting role="php">
-// $ds eine gültige Verbindungs-Kennung für einen Verzeichnis-Server
+ <programlisting role="php">
+<![CDATA[
+// $ds gültige Verbindungs-Kennung für einen Verzeichnis-Server
-// $sr ein gültiges Suchergebnis eines früheren Aufrufs einer der ldap
+// $sr gültiges Suchergebnis eines früheren Aufrufs einer der ldap
// Verzeichnis Suchfunktionen
-// $entry eine gültige Eintrag-Kennung eines früheren Aufrufs einer
+// $entry gültige Eintrag-Kennung eines früheren Aufrufs einer
// der Funktionen, die einen Verzeichnis-Eintrag zurückgeben
$values = ldap_get_values($ds, $entry,"mail");
-echo $values["count"]." Email-Adressen für diesen Eintrag.<p>";
+echo $values["count"]." Email-Adressen für diesen Eintrag.<p>";
-for ($i=0; $i < $values["count"]; $i++)
- echo $values[$i]."<br>";
-</programlisting>
- </example></para>
+for ($i=0; $i < $values["count"]; $i++)
+ echo $values[$i]."<br>";
+]]>
+ </programlisting>
+ </example>
+ </para>
</refsect1>
</refentry>
@@ -1211,7 +1236,7 @@
</funcsynopsis>
<para>
Rückgabewert: im Erfolgsfall ein Array der Werte des Merkmals,
- falsch im Fehlerfall.
+ &false; im Fehlerfall.
</para>
<para>
Die <function>ldap_get_values_len</function> Funktion wird
@@ -1224,7 +1249,7 @@
Indexwert ist 0.
</para>
<para>
- Diese Funktion wird in der genau gleichen Weise benutzt wie die
+ Diese Funktion wird exakt gleich benutzt wie die
Funktion <function>ldap_get_values</function> mit der Aussnahme,
dass hier binäre Daten statt Textdaten behandelt werden.
</para>
@@ -1255,7 +1280,7 @@
<parameter><optional>merkmale</optional></parameter>
</paramdef>
<paramdef>int
- <parameter><optional>attrsonly</optional></parameter>
+ <parameter><optional>nur_merkmmale</optional></parameter>
</paramdef>
<paramdef>int
<parameter><optional>größenbegrenzung</optional></parameter>
@@ -1270,19 +1295,19 @@
</funcsynopsis>
<para>
Rückgabewert: im Erfolgsfall eine Such-Ergebnis-Kennung,im
- Fehlerfall falsch.
+ Fehlerfall &false;.
</para>
<para>
Die <function>ldap_list</function> Funktion führt die Suche für
- einen gegebenen Filter im Verzeichnis mit der Reichweite von
- LDAP_SCOPE_ONELEVEL durch.
+ einen gegebenen <parameter>filter</parameter> im Verzeichnis mit
+ der Reichweite von LDAP_SCOPE_ONELEVEL durch.
</para>
<para>
LDAP_SCOPE_ONELEVEL bedeutet, dass die Suche nur Informationen
liefert, die direkt unterhalb der Stufe liegen, die durch die
- Angabe des Basis dn im Auruf bestimmt wird. (Das entspricht der
- Eingabe von "ls", die eine Liste von Dateien und Verzeichnissen
- des aktuellen Arbeitsverzeichnisses anzeigt.)
+ Angabe des <parameter>basis_dn</parameter> im Auruf bestimmt wird.
+ (Das entspricht der Eingabe von "ls", die eine Liste von Dateien und
+ Verzeichnissen des aktuellen Arbeitsverzeichnisses anzeigt.)
</para>
<para>
Der Aufruf dieser Funktion nimmt 5 optionale Parameter entgegen.
@@ -1302,7 +1327,8 @@
Erzeugung einer Liste aller Organisationseinheiten einer
Organisation
</title>
-<programlisting role="php">
+ <programlisting role="php">
+<![CDATA[
// $ds gültige Verbindungs-Kennung für einen Verzeichnis-Server
$basis_dn = "o=Meine Firma, c=DE";
@@ -1312,15 +1338,18 @@
$info = ldap_get_entries($ds, $sr);
-for ($i=0; $i<$info["count"]; $i++)
+for ($i=0; $i<$info["count"]; $i++)
echo $info[$i]["ou"][0] ;
-</programlisting>
-</example></para>
- <para>
- Seit der Version 4.0.5 ist es außerdem möglich parallele Suchen
- durchzuführen. Für Details siehe
- <function>ldap_search</function>.
+]]>
+ </programlisting>
+ </example>
</para>
+ <note>
+ <para>
+ Seit der Version 4.0.5 ist es außerdem möglich parallele Suchen
+ durchzuführen. Für Details siehe <function>ldap_search</function>.
+ </para>
+ </note>
</refsect1>
</refentry>
@@ -1341,14 +1370,12 @@
<paramdef>array <parameter>eintrag</parameter></paramdef>
</funcprototype>
</funcsynopsis>
- <para>
- Rückgabewert: wahr im Erfolgsfall, falsch im Fehlerfall.
- </para>
+ <para>&return.success;</para>
<para>
Die <function>ldap_modify</function> Funktion wird verwendet, um
bestehende Einträge in einem LDAP-Verzeichnis zu ändern.
- Die Struktur des Eintrags ist die gleiche wie bei <function>
- ldap_add</function>.
+ Die Struktur des Eintrags ist die gleiche wie bei
+ <function>ldap_add</function>.
</para>
</refsect1>
</refentry>
@@ -1372,12 +1399,10 @@
<paramdef>array <parameter>eintrag</parameter></paramdef>
</funcprototype>
</funcsynopsis>
+ <para>&return.success;</para>
<para>
- Rückgabewert: wahr im Erfolgsfall, falsch im Fehlerfall.
- </para>
- <para>
- Diese Funktion fügt Merkmal(e) zum angegebenen dn hinzu.
- Die Änderung wird auf der Merkmalsebene durchgeführt im
+ Diese Funktion fügt Merkmal(e) zum angegebenen <parameter>dn</parameter>
+ hinzu. Die Änderung wird auf der Merkmalsebene durchgeführt im
Gegensatz zur Objektebene. Das Hinzufügen auf der Objektebene
wird durch die Funktion <function>ldap_add</function> geleistet.
</para>
@@ -1402,14 +1427,12 @@
<paramdef>array <parameter>eintrag</parameter></paramdef>
</funcprototype>
</funcsynopsis>
+ <para>&return.success;</para>
<para>
- Rückgabewert: wahr im Erfolgsfall, falsch im Fehlerfall.
- </para>
- <para>
- Diese Funktion entfernt ein oder mehrere Merkmale vom angegebenen
- dn. Die Änderung wird auf der Merkmalsebene durchgeführt im
- Gegensatz zur Objektebene. Das Löschen auf Objektebene wird
- durch die Funktion <function>ldap_delete</function> geleistet.
+ Diese Funktion löscht ein oder mehrere Merkmale vom angegebenen
+ <parameter>dn</parameter>. Die Änderung wird auf der Merkmalsebene
+ durchgeführt im Gegensatz zur Objektebene. Das Löschen auf Objektebene
+ wird durch die Funktion <function>ldap_delete</function> geleistet.
</para>
</refsect1>
</refentry>
@@ -1432,14 +1455,13 @@
<paramdef>array <parameter>eintrag</parameter></paramdef>
</funcprototype>
</funcsynopsis>
- <para>
- Rückgabewert: wahr im Erfolgsfall, falsch im Fehlerfall.
+ <para>&return.success;
</para>
<para>
Diese Funktion ersetzt ein oder mehrere Merkmale vom angegebenen
- dn. Die Änderung wird auf der Merkmalsebene durchgeführt im
- Gegensatz zur Objektebene. Änderungen auf der Objektebene wird
- durch die Funktion <function>ldap_modify</function> geleistet.
+ <parameter>dn</parameter>. Die Änderung wird auf der Merkmalsebene
+ durchgeführt im Gegensatz zur Objektebene. Änderungen auf der Objektebene
+ werden mit der Funktion <function>ldap_modify</function> ausgeführt.
</para>
</refsect1>
</refentry>
@@ -1466,18 +1488,17 @@
</funcsynopsis>
<para>
Rückgabewert: im Erfolgsfall das nächste Merkmal eines Eintrags,
- im Fehlerfall falsch.
+ im Fehlerfall &false;.
</para>
<para>
Die <function>ldap_next_attribute</function> Funktion wird
aufgerufen, um die Merkmale eines Eintrags zu erhalten. Der
- interne Status des Zeigers wird durch die <parameter>
- ber_Kennung</parameter> bestimmt. Diese wird mittels Referenz an
- die Funktion weitergegeben.
- Der erste Aufruf von <function>ldap_next_attribute</function>
+ interne Status des Zeigers wird durch die
+ <parameter>ber_Kennung</parameter> bestimmt. Diese wird mittels
+ Referenz an die Funktion weitergegeben. Der erste Aufruf von
+ <function>ldap_next_attribute</function>
erfolgt mit der <parameter>Ergebnis-Eintrag-Kennung</parameter>,
- die von <function>ldap_first_attribute</function> zurückgegeben
- wurde.
+ die von <function>ldap_first_attribute</function> zurückgegeben wurde.
</para>
<para>
Siehe auch <function>ldap_get_attributes</function>
@@ -1510,18 +1531,17 @@
Einträge wird mit <function>ldap_first_entry</function>
gestartet.
Wenn keine weiteren Einträge im Ergebnis vorhanden sind wird
- falsch zurückgegeben.
+ &false; zurückgegeben.
</para>
<para>
Die <function>ldap_next_entry</function> Funktion wird verwendet,
um die Einträge zu erhalten, die im Ergebnis gespeichert sind.
Wiederholtes aufrufen von <function>ldap_next_entry</function>
liefert einen Eintrag nach dem anderen, solange bis kein Eintrag
- mehr vorliegt. Der erste Aufruf von <function>
- ldap_next_entry</function> erfolgt nach dem Aufruf von
- <function>ldap_first_entry</function> mit der Ergebnis-Kennung,
- die von <function>ldap_first_entry</function> zurückgegeben
- wurde.
+ mehr vorliegt. Der erste Aufruf von <function>ldap_next_entry</function>
+ erfolgt nach dem Aufruf von <function>ldap_first_entry</function>
+ mit der <parameter>Ergebnis-Eintrag-Kennung</parameter>, die von
+ <function>ldap_first_entry</function> zurückgegeben wurde.
</para>
<para>
Siehe auch <function>ldap_get_entries</function>
@@ -1548,7 +1568,7 @@
<parameter><optional>merkmale</optional></parameter>
</paramdef>
<paramdef>int
- <parameter><optional>attrsonly</optional></parameter>
+ <parameter><optional>nur_werte</optional></parameter>
</paramdef>
<paramdef>int
<parameter><optional>größenbegrenzung</optional></parameter>
@@ -1562,13 +1582,13 @@
</funcprototype>
</funcsynopsis>
<para>
- Rückgabewert: Im Erfolgsfall eine Such-Ergebnis-Kennung, falsch
+ Rückgabewert: Im Erfolgsfall eine Such-Ergebnis-Kennung, &false;
im Fehlerfall.
</para>
<para>
Die <function>ldap_read</function> Funktion führt die Suche für
- einen gegebenen Filter im Verzeichnis mit der Reichweite von
- LDAP_SCOPE_BASE durch. Das ist äquivalent zum Lesen eines
+ einen gegebenen <parameter>filter</parameter> im Verzeichnis mit der
+ Reichweite von LDAP_SCOPE_BASE durch. Das entpricht dem Lesen eines
Eintrags in einem Verzeichnis.
</para>
<para>
@@ -1576,8 +1596,8 @@
Informationen für einen Eintrag erhalten möchten, müssen Sie
einen Filter der Art "objectClass=*" verwenden. Kennen Sie die
Typen der Einträge die auf dem Verzeichnis-Server benutzt werden,
- können Sie einen passenden Filter wie z.B."objectClass=
- inetOrgPerson" verwenden.
+ können Sie einen passenden Filter wie z.B."objectClass=inetOrgPerson"
+ verwenden.
</para>
<para>
Der Aufruf dieser Funktion nimmt 5 optionale Argumente
@@ -1586,17 +1606,17 @@
<note>
<para>
Diese wahlfreien Argumente wurden in 4.0.2 hinzugefügt:
- <parameter>attrsonly</parameter>,
+ <parameter>nur_werte</parameter>,
<parameter>größenbegrenzung</parameter>,
<parameter>zeitbegrenzung</parameter>,
<parameter>deref</parameter>.
</para>
- </note>
<para>
Seit der Version 4.0.5 ist es außerdem möglich parallele Suchen
durchzuführen. Für Details siehe
<function>ldap_search</function>.
</para>
+ </note>
</refsect1>
</refentry>
@@ -1624,24 +1644,23 @@
</funcsynopsis>
<para>
Der Eintrag, der durch <parameter>dn</parameter> gegeben ist,
- wird umbenannt/enfernt. Der neue RDN wird durch <parameter>
- neuerrdn</parameter> bestimmt, der neue Eltern-/übergeordnete
+ wird umbenannt/gelöscht. Der neue RDN wird durch
+ <parameter>neuerrdn</parameter> bestimmt, der neue Eltern-/übergeordnete
Eintrag wird durch <parameter>neueeltern</parameter> bestimmt.
- Wenn das Argument <parameter>löschealtenrdn</parameter> wahr ist,
+ Wenn das Argument <parameter>löschealtenrdn</parameter> &true; ist,
wird der alte Wert/die alten Werte von RDN enfernt, andernfalls
- wird der alte Wert/die alten Werte als nicht-eindeutige (non-
- distinguished) Werte des Eintrags beibehalten.
- Rückgabewert: wahr im Erfolgsfall, falsch im Fehlerfall.
- </para>
- <para>Diese Funktion arbeitet zum gegenwärtigen Zeitpunkt nur mit
- LDAPv3. Sie müssen <function>ldap_set_option</function>
- vorher benutzen um für eine Bindung LDAPv3 nutzen zu können.
- </para>
- <para>
- Diese Funktion steht nur zur Verfügung, wenn Sie OpenLDAP 2.x.x
- ODER Netscape Directory SDK x.x benutzen. Wurde in PHP 4.0.5
- hinzugefügt.
+ wird der alte Wert/die alten Werte als nicht-eindeutige(r) (non-
+ distinguished) Werte des Eintrags beibehalten. &return.success;
</para>
+ <note>
+ <para>Diese Funktion arbeitet zum gegenwärtigen Zeitpunkt nur mit
+ LDAPv3. Sie müssen <function>ldap_set_option</function>
+ vorher benutzen um für eine Bindung LDAPv3 nutzen zu können.
+ Diese Funktion steht nur zur Verfügung, wenn Sie OpenLDAP 2.x.x
+ ODER Netscape Directory SDK x.x benutzen. Wurde in PHP 4.0.5
+ hinzugefügt.
+ </para>
+ </note>
</refsect1>
</refentry>
@@ -1664,7 +1683,7 @@
<parameter><optional>merkmale</optional></parameter>
</paramdef>
<paramdef>int
- <parameter><optional>attrsonly</optional></parameter>
+ <parameter><optional>nur_werte</optional></parameter>
</paramdef>
<paramdef>int
<parameter><optional>größenbegrenzung</optional></parameter>
@@ -1678,7 +1697,7 @@
</funcprototype>
</funcsynopsis>
<para>
- Rückgabewert: eine Such-Ergebnis-Kennung im Erfolgsfall, falsch
+ Rückgabewert: eine Such-Ergebnis-Kennung im Erfolgsfall, &false;
im Fehlerfall.
</para>
<para>
@@ -1698,9 +1717,9 @@
die Angabe des vierten Parameters als gute Praxis zu empfehlen.
</para>
<para>
- Der vierte Parameter ist ein Standard PHP Zeichenketten Array der
+ Der vierte Parameter ist ein Standard PHP Array aus Strings der
benötigten Merkmale, z.B. array("mail","sn","cn"). Beachten Sie,
- dass der DN immer zurückgeliefert wird, ohne Rücksicht darauf,
+ dass der "dn" immer zurückgeliefert wird, ohne Rücksicht darauf,
welche Merkmalstypen angefragt wurden.
</para>
<para>
@@ -1714,7 +1733,7 @@
die Anzahl der angefragten Einträge einzuschränken.
</para>
<para>
- Der fünfte Parameter <parameter>attrsonly</parameter> sollte auf
+ Der fünfte Parameter <parameter>nur_werte</parameter> sollte auf
1 gesetzt werden, wenn Sie nur Merkmalstypen erhalten möchten.
Wenn der Wert auf 0 steht, erhalten Sie sowohl Merkmalstypen als
auch Merkmalswerte. Das ist das Standard Verhalten.
@@ -1768,15 +1787,17 @@
</listitem>
</itemizedlist>
</para>
- <para>
+ <note>
+ <para>
Diese optionalen Parameter wurden in 4.0.2 hinzugefügt:
- <parameter>attrsonly</parameter>,
+ <parameter>nur_werte</parameter>,
<parameter>größenbegrenzung</parameter>,
<parameter>zeitbegrenzung</parameter>,
<parameter>deref</parameter>.
- </para>
+ </para>
+ </note>
<para>
- Der Suchfilter kann einfach oder komplizierter sein, wenn sie
+ Der Suchfilter kann einfach oder kompliziert sein, wenn sie
boolsche Operatoren in dem Format verwenden, wie in der LDAP
Dokumentation beschrieben (siehe <ulink url="&url.ldap.filters;">
Netscape Directory SDK</ulink> für die vollständige Information
@@ -1792,11 +1813,11 @@
<example>
<title>LDAP Suche</title>
-<programlisting role="php">
+ <programlisting role="php">
+<![CDATA[
// $ds gültige Verbindungs-Kennung für einen Verzeichnis-Server
-// $person ein Teil oder der vollständige Name einer Person, z.B.
- "Jo"
+// $person ein Teil oder der vollständige Name einer Person, z.B. "Jo"
$dn = "o=Meine Firma, c=DE";
$filter="(|(sn=$person*)(vorname=$person*))";
@@ -1806,7 +1827,8 @@
$info = ldap_get_entries($ds, $sr);
-print $info["count"]." gefundene Einträge<p>";
+print $info["count"]." gefundene Einträge<p>";
+]]>
</programlisting>
</example>
</para>
@@ -1823,11 +1845,11 @@
für eine andere Suche und so weiter. Wenn Sie parallel suchen
erhalten Sie ein Array von Such-Ergebnis-Kennungen, außer im Fall
eines Fehlers, dann liefert der Eintrag zur entsprechenden Suche
- falsch zurück. Das entspricht ganz genau dem Wert der
+ &false; zurück. Das entspricht ganz genau dem Wert der
normalerweise zurückgeliefert wird, außer dass Sie immer eine
Ergebnis-Kennung erhalten, wenn Sie eine Suche durchgeführt
haben. Es treten einige seltene Fälle auf, wo eine normale Suche
- falsch zurückgibt, während die parallele Suche eine Kennung
+ &false; zurückgibt, während die parallele Suche eine Kennung
zurückliefert.
</para>
</refsect1>
@@ -1844,16 +1866,14 @@
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>ldap_set_option</function></funcdef>
- <paramdef>int <parameter>Verbindungs-Kennung</parameter>
- </paramdef>
+ <paramdef>int <parameter>Verbindungs-Kennung</parameter></paramdef>
<paramdef>int <parameter>option</parameter></paramdef>
<paramdef>mixed <parameter>neuerwert</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
- Setzt den Wert der bestimmten Option auf
- <parameter>neuerwert</parameter>.
- Rückgabewert: wahr im Erfolgsfall, falsch im Fehlerfall.
+ Setzt den Wert der bestimmten Option auf
+ <parameter>neuerwert</parameter>.&return.success;
</para>
<para>
Der Parameter <parameter>option</parameter> kann einer der
@@ -1892,26 +1912,31 @@
nichts angeben.
Schauen Sie sich das zweite Beispiel weiter unten an.
</para>
- <para>
- Diese Funktion steht nur zur Verfügung, wenn Sie OpenLDAP 2.x.x
- ODER Netscape Directory SDK x.x verwenden und wurde in PHP 4.0.4
- hinzugefügt.
- </para>
+ <note>
+ <para>
+ Diese Funktion steht nur zur Verfügung, wenn Sie OpenLDAP 2.x.x
+ ODER Netscape Directory SDK x.x verwenden und wurde in PHP 4.0.4
+ hinzugefügt.
+ </para>
+ </note>
<para>
<example>
<title>Setzen der Protokollversion</title>
-<programlisting role="php">
+ <programlisting role="php">
+<![CDATA[
// $ds ist eine gültige Verbindungs-Kennung für einen Verzeichnis-
// Server
if (ldap_set_option($ds, LDAP_OPT_PROTOCOL_VERSION, 3))
echo "Verwenden von LDAPv3";
else
echo "Kann das Protokoll nicht auf Version 3 setzen";
+]]>
</programlisting>
</example>
<example>
<title>Setzen der Server Kontrollen</title>
<programlisting role="php">
+<![CDATA[
// $ds ist eine gültige Verbingund-Kennung für einen Verzeichnis-
// Server
// Kontrolle ohne Wert
@@ -1922,6 +1947,7 @@
if (!ldap_set_option($ds, LDAP_OPT_SERVER_CONTROLS, array($ctrl1,
$ctrl2)))
echo "Kann die Server Kontrollen nicht setzen";
+]]>
</programlisting>
</example>
</para>
@@ -1947,7 +1973,7 @@
</funcprototype>
</funcsynopsis>
<para>
- Rückgabewert: wahr im Erfolgsfall, falsch im Fehlerfall.
+ &return.success;
</para>
<para>
Die <function>ldap_unbind</function> Funktion führt ein unbind
@@ -1955,83 +1981,245 @@
</para>
</refsect1>
</refentry>
- </reference>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"../../manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
--->
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+ <refentry id='function.ldap-8859-to-t61'>
+ <refnamediv>
+ <refname>ldap_8859_to_t61</refname>
+ <refpurpose>
+ Übersetzt 8859 Zeichen nach t61 Zeichen
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>ldap_8859_to_t61</function></funcdef>
+ <paramdef>string <parameter>value</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ &warn.undocumented.func;
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id='function.ldap-first-reference'>
+ <refnamediv>
+ <refname>ldap_first_reference</refname>
+ <refpurpose>
+ Liefert die erste Referenz
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>ldap_first_reference</function></funcdef>
+ <paramdef>int <parameter>link</parameter></paramdef>
+ <paramdef>int <parameter>result</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ &warn.undocumented.func;
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id='function.ldap-next-reference'>
+ <refnamediv>
+ <refname>ldap_next_reference</refname>
+ <refpurpose>
+ Holt die nächste Referenz
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>ldap_next_reference</function></funcdef>
+ <paramdef>int <parameter>link</parameter></paramdef>
+ <paramdef>int <parameter>entry</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ &warn.undocumented.func;
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id='function.ldap-parse-reference'>
+ <refnamediv>
+ <refname>ldap_parse_reference</refname>
+ <refpurpose>
+ Gewinnt Informationen aus einem Referenz-Eintrag
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>boolean <function>ldap_parse_reference</function></funcdef>
+ <paramdef>int <parameter>link</parameter></paramdef>
+ <paramdef>int <parameter>entry</parameter></paramdef>
+ <paramdef>array <parameter>referrals</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ &warn.undocumented.func;
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id='function.ldap-parse-result'>
+ <refnamediv>
+ <refname>ldap_parse_result</refname>
+ <refpurpose>
+ Gewinnt Informationen aus einem Ergebnis
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>boolean <function>ldap_parse_result</function></funcdef>
+ <paramdef>int <parameter>link</parameter></paramdef>
+ <paramdef>int <parameter>result</parameter></paramdef>
+ <paramdef>int <parameter>errcode</parameter></paramdef>
+ <paramdef>string <parameter>matcheddn</parameter></paramdef>
+ <paramdef>string <parameter>errmsg</parameter></paramdef>
+ <paramdef>array <parameter>referrals</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ &warn.undocumented.func;
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id='function.ldap-set-rebind-proc'>
+ <refnamediv>
+ <refname>ldap_set_rebind_proc</refname>
+ <refpurpose>
+ Set a callback function to do re-binds on referral chasing.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>ldap_set_rebind_proc</function></funcdef>
+ <paramdef>int <parameter>link</parameter></paramdef>
+ <paramdef>string <parameter>callback</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ &warn.undocumented.func;
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id='function.ldap-sort'>
+ <refnamediv>
+ <refname>ldap_sort</refname>
+ <refpurpose>
+ Sortiert LDAP Ergebniseinträge
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>ldap_sort</function></funcdef>
+ <paramdef>int <parameter>link</parameter></paramdef>
+ <paramdef>int <parameter>result</parameter></paramdef>
+ <paramdef>string <parameter>sortfilter</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ &warn.undocumented.func;
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id='function.ldap-start-tls'>
+ <refnamediv>
+ <refname>ldap_start_tls</refname>
+ <refpurpose>
+ Startet TLS
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>ldap_start_tls</function></funcdef>
+ <paramdef>int <parameter>link</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ &warn.undocumented.func;
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id='function.ldap-t61-to-8859'>
+ <refnamediv>
+ <refname>ldap_t61_to_8859</refname>
+ <refpurpose>
+ Übersetzt t61 Zeichen nach 8859 Zeichen
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>ldap_t61_to_8859</function></funcdef>
+ <paramdef>string <parameter>value</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ &warn.undocumented.func;
+ </para>
+ </refsect1>
+ </refentry>
+ </reference>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
