(PHP 4, PHP 5, PHP 7, PHP 8)
ldap_get_values — Lee todos los valores de una entrada LDAP
Lee todos los valores del atributo de una entrada en un resultado.
La llamada a esta función requiere una entry
y debe ser precedida por una búsqueda LDAP,
y una de las funciones que permiten acceder a una entrada.
La aplicación debe contener información que permita leer ciertos atributos (como "nombre" o "mail"), o bien deberá utilizarse la función ldap_get_attributes() para saber cuáles son los atributos que existen para una entrada dada.
ldap
An LDAP\Connection instance, returned by ldap_connect().
entry
An LDAP\ResultEntry instance.
attribute
Devuelve un array de valores para el atributo, o false
en caso de error.
El número de valores devueltos está disponible en el índice 'count' del array
devuelto. Los valores son accesibles individualmente, con los índices
numéricos del array. La indexación comienza en 0
.
LDAP permite más de una entrada por atributo, lo que permite almacenar varias direcciones de correo electrónico por persona, utilizando solo una etiqueta "mail":
return_value["count"] = número de valores del atributo return_value[0] = primer valor del atributo return_value[i] = i-ésimo valor del atributo
Versión | Descripción |
---|---|
8.1.0 |
The ldap parameter expects an LDAP\Connection
instance now; previously, a valid ldap link recurso was expected.
|
8.1.0 |
The entry parameter expects an LDAP\ResultEntry
instance now; previously, a valid ldap result entry recurso was expected.
|
Ejemplo #1 Lista todas las valores del atributo "mail" de una entrada
<?php
// $ds debe ser una instancia de conexión LDAP\Connection válida
// $sr debe ser un recurso de resultado válido, obtenido con una de las funciones de
// búsqueda LDAP.
// $entry es una entrada LDAP válida, obtenida con una de las funciones
// LDAP que devuelve una entrada
$values = ldap_get_values($ds, $entry,"mail");
echo $values["count"] . " direcciones de correo para esta entrada.<br />";
for ($i=0; $i < $values["count"]; $i++) {
echo $values[$i] . "<br />";
}
?>