LDAP ldap_get_values

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

ldap_get_values — 결과 항목에서 모든 값 가져오기


설명

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

결과의 항목에 있는 속성의 모든 값을 읽습니다.

이 호출에는 entry이 필요하므로 ldap 검색 호출 중 하나와 개별 항목을 가져오기 위한 호출 중 하나가 선행되어야 합니다.

애플리케이션은 특정 속성(예: "surname" 또는 "mail")을 찾도록 하드 코딩되거나 주어진 항목에 대해 어떤 속성이 존재하는지 알아내기 위해 ldap_get_attributes() 호출을 사용해야 합니다.


매개변수

ldap
ldap_connect()에 의해 반환된 LDAP\Connection 인스턴스입니다.
entry
LDAP\ResultEntry 인스턴스입니다.
eattribute

반환 값

성공 시 속성 값의 배열을 반환하고 오류 시 false를 반환합니다. 결과 배열에서 "count"를 인덱싱하여 값의 수를 찾을 수 있습니다. 개별 값은 배열의 정수 인덱스로 액세스됩니다. 첫 번째 인덱스는 0입니다.

LDAP는 속성에 대해 둘 이상의 항목을 허용하므로 예를 들어 속성 ​​"mail"로 레이블이 지정된 한 사람의 디렉토리 항목에 대한 여러 이메일 주소를 저장할 수 있습니다.

return_value["count"] = number of values for attribute
return_value[0] = first value of attribute
return_value[i] = ith value of attribute
                

변경 로그

버전 설명
8.1.0 ldap 매개변수는 이제 LDAP\Connection 인스턴스를 예상합니다. 이전에는 리소스가 필요했습니다.
8.1.0 entry 매개변수는 이제 LDAP\ResultEntry 인스턴스를 예상합니다. 이전에는 리소스가 필요했습니다.

Examples

예제 #1 디렉토리 항목에 대한 "mail" 속성의 모든 값 나열

                  
<?php
// $ds is a valid LDAP\Connection instance for a directory server

// $sr is a valid search result from a prior call to
//     one of the ldap directory search calls

// $entry is a valid entry identifier from a prior call to
//        one of the calls that returns a directory entry

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

echo $values["count"] . " email addresses for this entry.<br />";

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

기타