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 />";
}
?>
기타
- ldap_get_values_len() - 결과 항목에서 모든 이진 값 가져오기