Documentación offline PHP master

ldap_get_values

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

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
```php

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

Lista todas las valores del atributo "mail" de una entrada
"; for ($i=0; $i < $values["count"]; $i++) { echo $values[$i] . "
"; } ?>

```php

Véase también#

ldap_get_values_len