array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.ldap-get-values.php', 1 => 'ldap_get_values', 2 => 'Lee todos los valores de una entrada LDAP', ), 'up' => array ( 0 => 'ref.ldap.php', 1 => 'LDAP Funciones', ), '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' => 'es', '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 — Lee todos los valores de una entrada LDAP

Descripción

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

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

Versión Descripción
8.1.0 El parámetro ldap ahora espera una instancia de LDAP\Connection; anteriormente, se esperaba un resource ldap link válido.
8.1.0 El parámetro entry ahora espera una instancia de LDAP\ResultEntry; anteriormente, se esperaba un resource ldap result entry válido.

Ejemplos

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

Ver también