ldap_get_values

ldap_get_values -- Liefert alle Werte eines Ergebnis-Eintrags

Beschreibung

array ldap_get_values ( resource Verbindungs-Kennung, resource Ergebnis-Eintrag-Kennung, string merkmal)

Rückgabewert : im Erfolgsfall ein Array der Werte des Merkmals , FALSE im Fehlerfall .

Die ldap_get_values( ) Funktion wird benutzt um alle Werte des Merkmals eines Eintrags im Ergebnis zu lesen . Der Eintrag wird durch Ergebnis-Eintrag-Kennung 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 .

Da diese Funktion eine Ergebnis-Eintrag-Kennung benötigt , muss ein Aufruf einer der LDAP Suchfunktionen und einer der Funktionen , die einen einzelnen Eintrag liefern , vorausgehen .

Ihre Anwendung wird entweder hart codiert sein , um bestimmte Merkmale ( wie z.B. : "Nachname " oder "Mail" ) zu suchen , oder Sie müssen die Funktion ldap_get_attributes( ) benutzen , um herauszufinden , welche Merkmale für einen gegebenen Eintrag vorhanden sind .

LDAP erlaubt mehr als einen Eintrag für ein Merkmal , so dass es z.B . sein kann , dass der Verzeichnis-Eintrag einer Person mehrere Email-Adressen enthält , die alle mit dem Merkmal " mail " bezeichnet sind .


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


Beispiel 1 . Liste aller Werte des Merkmals " mail " für einen Verzeichnis - Eintrag

 
/

 
/

 
$ds

 
gültige

 
Verbindungs-Kennung

 
für

 
einen

 
Verzeichnis-Server

 
/

 
/

 
$sr

 
gültiges

 
Suchergebnis

 
eines

 
früheren

 
Aufrufs

 
einer

 
der

 
ldap

 
/

 
/

 
Verzeichnis

 
Suchfunktionen

 
/

 
/

 
$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

 
"

 
;

 
for

 
($i=0

 
;

 
$i

 
$values["count"]

 
;

 
$i++

 
)

 
echo

 
$values[$i]

 
.

 
"

 
br

 
"

 
;