LDAP ldap_read

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

ldap_read — Read an entry


설명

ldap_read(
    LDAP\Connection|array $ldap,
    array|string $base,
    array|string $filter,
    array $attributes = [],
    int $attributes_only = 0,
    int $sizelimit = -1,
    int $timelimit = -1,
    int $deref = LDAP_DEREF_NEVER,
    ?array $controls = null
): LDAP\Result|array|false
                

범위가 LDAP_SCOPE_BASE인 디렉토리에서 지정된 filter에 대한 검색을 수행합니다. 따라서 디렉토리에서 항목을 읽는 것과 같습니다.

병렬 검색을 수행하는 것도 가능합니다. 이 경우 첫 번째 인수는 단일 인스턴스가 아니라 LDAP\Connection 인스턴스의 배열이어야 합니다. 모든 검색에서 동일한 기본 DN과 필터를 사용하지 않아야 하는 경우 기본 DN 배열 및/또는 필터 배열을 대신 인수로 전달할 수 있습니다. 배열의 첫 번째 항목은 한 검색에 사용되고 두 번째 항목은 다른 검색에 사용되는 식이므로 이러한 배열은 LDAP\Connection 인스턴스 배열과 크기가 같아야 합니다. 병렬 검색을 수행하면 반환 값이 false인 오류의 경우를 제외하고 LDAP\Result 인스턴스의 배열이 반환됩니다.


매개변수

ldap
ldap_connect()에 의해 반환된 LDAP\Connection 인스턴스입니다.
base
디렉토리의 기본 DN입니다.
filter
빈 필터는 허용되지 않습니다. 이 항목에 대한 모든 정보를 절대적으로 검색하려면 objectClass=* 필터를 사용하십시오. 디렉토리 서버에서 사용되는 항목 유형을 알고 있으면 objectClass=inetOrgPerson과 같은 적절한 필터를 사용할 수 있습니다.
attributes
필수 속성의 배열, 예: 배열("mail", "sn", "cn"). "dn"은 요청된 속성 유형에 관계없이 항상 반환됩니다.

이 매개변수를 사용하는 것이 기본 조치(모든 속성 및 연관된 값을 리턴하는 것)보다 훨씬 더 효율적입니다. 따라서 이 매개변수의 사용은 모범 사례로 간주되어야 합니다.

attributes_only
속성 유형만 원하는 경우 1로 설정해야 합니다. 0으로 설정하면 기본 동작인 속성 유형과 속성 값을 모두 가져옵니다.
sizelimit
가져온 항목 수를 제한할 수 있습니다. 이것을 0으로 설정하면 제한이 없음을 의미합니다.
메모:

이 매개변수는 서버 측 사전 설정 크기 제한을 재정의할 수 없습니다. 더 낮게 설정할 수 있습니다.

일부 디렉토리 서버 호스트는 사전 설정된 항목 수만 반환하도록 구성됩니다. 이 경우 서버는 부분적 결과 집합만 반환했음을 나타냅니다. 이 매개변수를 사용하여 페치된 항목 수를 제한하는 경우에도 발생합니다.

timelimit
검색에 소요되는 시간(초)을 설정합니다. 이것을 0으로 설정하면 제한이 없음을 의미합니다.

메모: 이 매개변수는 서버 측 사전 설정 시간 제한을 무시할 수 없습니다. 더 낮게 설정할 수 있습니다.

deref
검색 중에 별칭을 처리하는 방법을 지정합니다. 다음 중 하나일 수 있습니다.
  • LDAP_DEREF_NEVER - (기본값) 별칭은 역참조되지 않습니다.
  • LDAP_DEREF_SEARCHING - 별칭은 검색 중에 역참조되어야 하지만 검색의 기본 개체를 찾을 때는 그렇지 않습니다.
  • LDAP_DEREF_FINDING - 별칭은 기본 개체를 찾을 때 역참조되어야 하지만 검색 중에는 참조하지 않아야 합니다.
  • LDAP_DEREF_ALWAYS - 별칭은 항상 역참조되어야 합니다.
controls
요청과 함께 보낼 LDAP Controls의 배열입니다.

반환 값

LDAP\Result 인스턴스, LDAP\Result 인스턴스의 배열을 반환하거나 실패 시 false를 반환합니다.


변경 로그

버전 설명
8.1.0 ldap 매개변수는 이제 LDAP\Connection 인스턴스를 예상합니다. 이전에는 리소스가 필요했습니다.
8.1.0 지금 LDAP\Result 인스턴스를 반환합니다. 이전에는 리소스가 반환되었습니다.
8.0.0 controls은 이제 nullable입니다. 이전에는 []로 기본 설정되었습니다.
4.0.5 병렬 검색 지원이 추가되었습니다. 자세한 내용은 ldap_search()를 참조하십시오.
7.3.0 controls 지원 추가됨