(PHP 4, PHP 5, PHP 7)
ldap_get_values — Liefert alle Werte eines Ergebnis-Eintrags
$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
<?php
// $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>";
?>