ldap_read

參數

ldap

一個 LDAP\Connection 實例，由 ldap_connect() 返回。

base

目錄的 base DN。

filter

不允許空的過濾器。如果您想擷取此項目的所有資訊，請使用 objectClass=* 的過濾器。如果您知道目錄伺服器上使用了哪些項目類型，則可以使用適當的過濾器，例如 objectClass=inetOrgPerson。

attributes

所需屬性的陣列，例如 array("mail", "sn", "cn")。請注意，無論請求哪種類型的屬性，都會返回 "dn"。

使用此參數比預設動作（返回所有屬性及其關聯值）更有效率。因此，使用此參數應被視為良好的實務作法。

attributes_only

如果只需要屬性類型，則應設為 1。如果設為 0，則會擷取屬性類型和屬性值，這是預設行為。

sizelimit

讓您可以限制擷取的項目數量。將此設定為 0 表示沒有限制。

注意:

此參數無法覆寫伺服器端預設的 sizelimit。但是您可以將其設定為更低的值。

某些目錄伺服器主機會設定為最多只返回預設數量的項目。如果發生這種情況，伺服器會指出它只返回了部分結果集。如果您使用此參數來限制擷取的項目數量，也會發生這種情況。

timelimit

設定搜尋花費的時間（以秒為單位）。將此設定為 0 表示沒有限制。

注意:

此參數無法覆寫伺服器端預設的 timelimit。但是您可以將其設定為更低的值。

deref

指定在搜尋期間應如何處理別名。可以是以下其中之一

• LDAP_DEREF_NEVER - （預設）絕不取消參考別名。
• LDAP_DEREF_SEARCHING - 搜尋時應取消參考別名，但在定位搜尋的基礎物件時則不應取消參考。
• LDAP_DEREF_FINDING - 定位基礎物件時應取消參考別名，但在搜尋期間則不應取消參考。
• LDAP_DEREF_ALWAYS - 應始終取消參考別名。

控制項

LDAP 控制項的陣列，用於隨請求一起發送。