ldap_get_values

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

ldap_get_values — Lee todos los valores de una entrada LDAP

Descripción

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.

Parámetros

ldap

Una instancia de LDAP\Connection , devuelta por ldap_connect() .

entry

Una instancia de LDAP\ResultEntry .

attribute

Valores devueltos

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
 

Historial de cambios

Ejemplos

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

Véase también

• ldap_get_values_len() - Lee todos los valores binarios de una entrada