-
Notifications
You must be signed in to change notification settings - Fork 40
/
ldap-read.xml
244 lines (239 loc) · 8.25 KB
/
ldap-read.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b7cbd468cb4c46d55d43a44cade0eb4590d25dea Maintainer: nobody Status: ready -->
<!-- Reviewed: yes -->
<!-- Rev-Revision: fbc6f9055f47d18f8ffb30513b772a32eda1526e Reviewer: samesch -->
<refentry xml:id="function.ldap-read" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>ldap_read</refname>
<refpurpose>Liest einen Eintrag</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>LDAP\Result</type><type>array</type><type>false</type></type><methodname>ldap_read</methodname>
<methodparam><type class="union"><type>LDAP\Connection</type><type>array</type></type><parameter>ldap</parameter></methodparam>
<methodparam><type class="union"><type>array</type><type>string</type></type><parameter>base</parameter></methodparam>
<methodparam><type class="union"><type>array</type><type>string</type></type><parameter>filter</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter>attributes</parameter><initializer>[]</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>attributes_only</parameter><initializer>0</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>sizelimit</parameter><initializer>-1</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>timelimit</parameter><initializer>-1</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>deref</parameter><initializer><constant>LDAP_DEREF_NEVER</constant></initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>array</type><type>null</type></type><parameter>controls</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Führt eine Suche nach dem angegeben <parameter>filter</parameter> im
Verzeichnis mit dem Geltungsbereich <constant>LDAP_SCOPE_BASE</constant>
durch. Somit ist es gleichwertig zum Lesen eines Eintrags aus dem
Verzeichnis.
</para>
&ldap.return-result-array-info;
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>ldap</parameter></term>
<listitem>
<para>
&ldap.parameter.ldap;
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>base</parameter></term>
<listitem>
<para>
Der Basis-DN für das Verzeichnis.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>filter</parameter></term>
<listitem>
<para>
Ein leerer Filter ist nicht erlaubt. Sollen alle Information zu einem
Eintrag ermittelt werden, ist ein
<literal>objectClass=*</literal>-Filter zu verwenden. Wenn bekannt ist,
welche Eintragstypen auf dem Verzeichnis-Server verwendet werden,
könnte ein entsprechender Filter, wie
<literal>objectClass=inetOrgPerson</literal> verwendet werden.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>attributes</parameter></term>
<listitem>
<para>
Ein Array von erforderlichen Merkmalen, &zb; array("mail", "sn", "cn").
Es ist zu beachten, dass der "dn" immer zurückgegeben wird, unabhängig
davon, welche Merkmalstypen angefordert wurden.
</para>
<para>
Die Verwendung dieses Parameters ist effizienter als die Standardaktion
(die alle Merkmale und deren assoziierte Werte zurückgibt). Die
Verwendung dieses Parameters sollte daher als gute Praxis eingestuft
werden.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>attributes_only</parameter></term>
<listitem>
<para>
Sollte auf 1 gesetzt werden, wenn nur Merkmalstypen erwünscht sind.
Wird 0 übergeben, werden sowohl Merkmalstypen als auch Merkmalswerte
abgerufen, was das Standardverhalten ist.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>sizelimit</parameter></term>
<listitem>
<para>
Ermöglicht die Begrenzung der Anzahl der abgerufenen Einträge. Wird
hier 0 übergeben, besteht keine Begrenzung.
</para>
<note>
<para>
Dieser Parameter kann ein serverseitig voreingestelltes sizelimit
NICHT überschreiben. Es kann allerdings kleiner gewählt werden.
</para>
<para>
Verzeichnis-Server können so konfiguriert werden, dass sie nicht mehr
als eine voreingestellte Anzahl von Einträgen zurückgeben. Wenn dies
der Fall ist, dann zeigt der Server an, dass nur eine teilweise
Ergebnismenge zurückgegeben wurde. Das geschieht ebenfalls, wenn
dieser Parameter verwendet wird, um die Zahl der abgerufenen Einträge
zu begrenzen.
</para>
</note>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timelimit</parameter></term>
<listitem>
<para>
Setzt die Anzahl von Sekunden, die auf die Suche verwendet wird. Die
Übergabe von 0 bedeutet keine Begrenzung.
</para>
<note>
<para>
Dieser Parameter kann ein serverseitig voreingestelltes timelimit
NICHT überschreiben. Es kann allerdings kleiner gewählt werden.
</para>
</note>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>deref</parameter></term>
<listitem>
<para>
Gibt an, wie Aliase während der Suche behandelt werden sollen. Es kann
einen der folgenden Werte annehmen:
<itemizedlist>
<listitem>
<simpara>
<constant>LDAP_DEREF_NEVER</constant> - (standard) Aliase werden nie
dereferenziert.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>LDAP_DEREF_SEARCHING</constant> - Aliase sollen während
der Suche dereferenziert werden, aber nicht wenn das Basis-Objekt
der Suche lokalisiert wird.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>LDAP_DEREF_FINDING</constant> - Aliase sollen für die
Lokalisierung des Basis-Objekts dereferenziert werden, aber nicht
während der Suche.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>LDAP_DEREF_ALWAYS</constant> - Aliase sollen immer
dereferenziert werden.
</simpara>
</listitem>
</itemizedlist>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>controls</parameter></term>
<listitem>
<para>
Ein Array von <link linkend="ldap.controls">LDAP-Steuerbefehlen</link>,
die mit der Anfrage versendet werden sollen.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&ldap.return-result-array;
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&ldap.changelog.ldap-object;
&ldap.changelog.return-result-object;
&ldap.changelog.controls-nullable;
<row>
<entry>4.0.5</entry>
<entry>
Die Unterstützung für parallele Suchen wurde hinzugefügt. Siehe
<function>ldap_search</function> für Details.
</entry>
</row>
<row>
<entry>7.3.0</entry>
<entry>
Die Unterstützung für <parameter>controls</parameter> wurde
hinzugefügt.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
</refentry>
<!-- 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:"~/.phpdoc/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
-->