ldap_get_values

(PHP 4, PHP 5)

ldap_get_values — Obtiene todos los valores de una entrada de un resultado

Descripción

array ldap_get_values ( resource $identificador_de_conexion , resource $identificador_de_entrada_de_resultado , string $atributo )

Devuelve un array de valores del atributo o FALSE en caso de error.

La función ldap_get_values() se emplea para obtener todos los valores de un atributo de una entrada de un resultado. La entrada del resultado es especificada por el parámetro identificador_de_entrada_de_resultado . El número de valores se puede obtener haciendo una llamada a la función count() sobre el array devuelto. Los valores individuales se almacenan en el array con índices enteros. El primer índice es 0.

Esta función necesita un identificador_de_entrada_de_resultado , por lo que previamente se deben realizar llamadas a las funciones de búsqueda LDAP y una llamada a la función que obtiene una entrada particular del resultado.

La aplicación debe ser o bien programada específicamente para buscar ciertos atributos (como apellidos o email) o bien utilizar la función ldap_get_attributes() para averiguar que atributos existen para una entrada dada, antes de llamar a ldap_get_values().

LDAP permite mas de un valor para cada atributo, por lo que se puede, por ejemplo, almacenar varias direcciones de email para una persona en el directorio y nombrar a ese atributo como "mail".

valor_devuelto["count"] = numero de valores del atributo
valor_devuelto[0] = primer valor del atributo
valor_devuelto[i] = iesimo valor del atributo

Example#1 Listar todos los valores del atributo "mail" de una entrada de un directorio


<?php
// $ds es un identificador de conexion al directorio

// $sr es un resultado de busqueda valido de una llamada
// anterior a una de las funciones de b&usqueda en directorios
// LDAP.

// $entrada es un identificador de entrada valido de una llamada
// anterior a una de las funciones que devuelven una entrada de
// directorio

$valores = ldap_get_values($ds, $entrada,"mail");

echo $valores["count"]." direcciones de email para esta entrada.<br />";

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