ldap_get_attributes

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

ldap_get_attributes — Obtém atributos de uma entrada de resultado de pesquisa

Descrição

ldap_get_attributes(LDAP\Connection $ldap, LDAP\ResultEntry $entry): array

Lê atributos e valores de uma entrada no resultado da pesquisa.

Ao localizar uma entrada específica no diretório, pode-se consultar que informação está armazenana nessa entrada usando-se esta chamada. Pode-se usar esta função para uma aplicação que navega por entradas de diretório e/ou onde não se conhece a estrutura das entradas do diretório. Em muitas aplicações, é comum procurar um atributo específico como um e-mail ou um sobrenome, desconsiderando outros dados da entrada. 

return_value["count"] = número da atributos na entrada
return_value[0] = primeiro atributo
return_value[n] = (n+1)-ésimo atributo

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

Parâmetros

ldap

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

entry

Uma instância de LDAP\ResultEntry.

Valor Retornado

Retorna informação completa da entrada em um array multi-dimensional.

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

Example #1 Mostra a lista de atributos armazenados em uma entrada particular do 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 = ldap_first_entry($ds, $sr);

$attrs = ldap_get_attributes($ds, $entry);

echo $attrs["count"] . " atributos mantidos para esta entrada:<p>";

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

Veja Também