array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.ldap-get-attributes.php', 1 => 'ldap_get_attributes', 2 => 'Obtém atributos de uma entrada de resultado de pesquisa', ), 'up' => array ( 0 => 'ref.ldap.php', 1 => 'Funções do LDAP', ), 'prev' => array ( 0 => 'function.ldap-free-result.php', 1 => 'ldap_free_result', ), 'next' => array ( 0 => 'function.ldap-get-dn.php', 1 => 'ldap_get_dn', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/ldap/functions/ldap-get-attributes.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

Exemplo #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