ldap_list

ldap_list -- Single-level search

Description

int ldap_list(int link_identifier, string base_dn, string filter, array [attributes]);

Returns a search result identifier or false on error.

ldap_list() performs the search for a specified filter on the directory with the scope LDAP_SCOPE_ONELEVEL.

LDAP_SCOPE_ONELEVEL means that the search should only return information that is at the level immediately below the base dn given in the call. (Equivalent to typing "ls" and getting a list of files and folders in the current working directory.)

This call takes an optional fourth parameter which is an array of the attributes required. See ldap_search() notes.

Example 1. Produce a list of all organizational units of an organization

  1 
  2 // $ds is a valid link identifier for a directory server
  3 
  4 $basedn = "o=My Company, c=US";
  5 $justthese = array("ou");
  6 
  7 $sr=ldap_list($ds, $basedn, "ou=*", $justthese);
  8 
  9 $info = ldap_get_entries($ds, $sr);
 10 
 11 for ($i=0; $i<$info["count"]; $i++)
 12     echo $info[$i]["ou"][0] ;
 13