Obtém todos os valores de uma entrada de resultado

# ldap_get_values

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

ldap_get_values — Obtém todos os valores de uma entrada de resultado

### Descrição

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

Lê todos os valores do atributo na entrada do resultado.

Esta função usa uma entrada informada no parâmetro `entry`, portanto precisa ser precedidade por uma das funções de pesquisa LDAP e uma das funções de obtenção de uma entrada individual.

A aplicação poderá ser codificada especificamente para pesquisar por certos atributos (como "surname" ou "mail") ou pode-se usar a função ldap_get_attributes() para descobrir quais atributos existem para uma entrada informada.

### Parâmetros

`ldap`

  Uma instância de LDAP\Connection, retornada por ldap_connect().

`entry`

  Uma instância de LDAP\ResultEntry.

`attribute`

### Valor Retornado

Retorna um array de valores para o atributo em caso de sucesso ou `false` em caso de erro. O número de valores pode ser encontrado indexando-se "count" no array resultante. Valores individuais são acessados por índice inteiro no array. O primeiro índice é 0.

LDAP permite mais de um valor por atributo, por isso pode, por exemplo, armazenar um número de endereços de e-mail para uma entrada de diretório de uma pessoa, todos etiquetados com o atributo "mail".

        return_value["count"] = número de valores para o atributo
        return_value[0] = primeiro valor do atributo
        return_value[i] = (i+1)-ésimo valor do atributo

### Registro de Alterações

Versão | Descrição
--- | ---
8.1.0 | O parâmetro `ldap` agora espera uma instância de LDAP\Connection; anteriormente, um resource `ldap link` válido era esperado.
8.1.0 | O parâmetro `entry` agora espera uma instância de LDAP\ResultEntry; anteriormente, um resource `ldap result entry` válido era esperado.

### Exemplos

Exemplo #1 Lista todos os valores do atributo "mail" para uma entrada de diretório

    <?php
    // $ds é uma instância válida de LDAP\Connection para um servidor de diretório

    // $sr é um resultado de pesquisa válido de uma chamada anterior a
    // uma das funções de pesquisa de diretório LDAP

    // $entry é um identificador válido de uma entrada de uma chamada anterior a
    // uma das funções que retornam uma entrada de diretório

    $values = ldap_get_values($ds, $entry, "mail");

    echo $values["count"] . " endereços de e-mail para esta entrada.<br />";

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

### Veja Também

- ldap_get_values_len() - Obtém todos os valores binários de uma entrada de resultado

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open