ldap_get_values

(PHP 3, 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

Ejemplo 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 />";
}
?>

Hosting by: hurra.com
Generated: 2007-01-26 18:00:44