array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.ldap-get-values.php', 1 => 'ldap_get_values', 2 => 'Liefert alle Werte eines Eintrags aus einem Ergebnis', ), 'up' => array ( 0 => 'ref.ldap.php', 1 => 'LDAP Funktionen', ), 'prev' => array ( 0 => 'function.ldap-get-option.php', 1 => 'ldap_get_option', ), 'next' => array ( 0 => 'function.ldap-get-values-len.php', 1 => 'ldap_get_values_len', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/ldap/functions/ldap-get-values.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

ldap_get_values

(PHP 4, PHP 5, PHP 7, PHP 8)

ldap_get_values — Liefert alle Werte eines Eintrags aus einem Ergebnis

Beschreibung

ldap_get_values(LDAP\Connection $ldap, LDAP\ResultEntry $entry, string $attribute): array|false

Liest alle Werte eines Merkmals im Ergebniseintrag.

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

Die Anwendung ist entweder hart kodiert, um bestimmte Merkmale (z. B. "Nachname" oder "E-Mail") zu suchen, oder die Funktion ldap_get_attributes() muss verwendet werden, um herauszufinden, welche Merkmale für einen gegebenen Eintrag vorhanden sind.

Parameter-Liste

ldap

Eine LDAP\ConnectionInstanz, die von ldap_connect() zurückgegeben wurde.

entry

Eine LDAP\ResultEntry-Instanz

attribute

Rückgabewerte

Gibt im Erfolgsfall ein Array mit den Werten des Merkmals zurück und false im Fehlerfall. Die Anzahl der zurückgegebenen Werte steht im Index "count" des zurückgegebenen Arrays zur Verfügung. Der Zugriff auf einzelne Werte erfolgt durch einen numerischen Index im Array. Der erste Indexwert ist 0.

LDAP erlaubt mehr als einen Eintrag für ein Merkmal, so dass es z. B. sein kann, dass der Verzeichnis-Eintrag einer Person mehrere E-Mail-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

Changelog

Version Beschreibung
8.1.0 Der Parameter ldap erwartet nun eine LDAP\Connection-Instanz; vorher wurde eine gültige ldap link-Ressource erwartet.
8.1.0 Der Parameter entry erwartet nun eine LDAP\ResultEntry-Instanz; vorher wurde eine gültige ldap result entry-Ressource erwartet.

Beispiele

Beispiel #1 Liste alle Werte des Merkmals "mail" für einen Verzeichnis-Eintrag auf

<?php
// $ds ist eine gültige LDAP\Connection-Instanz für einen Verzeichnis-Server

// $sr ist ein gültiges Suchergebnis eines früheren Aufrufs einer der
// LDAP-Verzeichnis-Suchfunktionen

// $entry ist eine gültige Eintragskennung eines früheren Aufrufs einer
// der Funktionen, die einen Verzeichnis-Eintrag zurückgeben

$values = ldap_get_values($ds, $entry, "mail");

echo $values["count"] . " E-Mail-Adressen für diesen Eintrag.<br />";

for ($i=0; $i < $values["count"]; $i++) {
echo $values[$i] . "<br />";
}
?>

Siehe auch