ldap_list
(PHP 4, PHP 5, PHP 7)
ldap_list — Single-level search
Description
$link_identifier
, string $base_dn
, string $filter
[, array $attributes
= array("*")
[, int $attrsonly
= 0
[, int $sizelimit
= -1
[, int $timelimit
= -1
[, int $deref
= LDAP_DEREF_NEVER
[, array $serverctrls
= array()
]]]]]] ) : resource
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.)
Parameters
-
link_identifier
-
An LDAP link identifier, returned by ldap_connect().
-
base_dn
-
The base DN for the directory.
-
filter
-
-
attributes
-
An array of the required attributes, e.g. array("mail", "sn", "cn"). Note that the "dn" is always returned irrespective of which attributes types are requested.
Using this parameter is much more efficient than the default action (which is to return all attributes and their associated values). The use of this parameter should therefore be considered good practice.
-
attrsonly
-
Should be set to 1 if only attribute types are wanted. If set to 0 both attributes types and attribute values are fetched which is the default behaviour.
-
sizelimit
-
Enables you to limit the count of entries fetched. Setting this to 0 means no limit.
Note:
This parameter can NOT override server-side preset sizelimit. You can set it lower though.
Some directory server hosts will be configured to return no more than a preset number of entries. If this occurs, the server will indicate that it has only returned a partial results set. This also occurs if you use this parameter to limit the count of fetched entries.
-
timelimit
-
Sets the number of seconds how long is spend on the search. Setting this to 0 means no limit.
Note:
This parameter can NOT override server-side preset timelimit. You can set it lower though.
-
deref
-
Specifies how aliases should be handled during the search. It can be one of the following:
-
LDAP_DEREF_NEVER
- (default) aliases are never dereferenced. -
LDAP_DEREF_SEARCHING
- aliases should be dereferenced during the search but not when locating the base object of the search. -
LDAP_DEREF_FINDING
- aliases should be dereferenced when locating the base object but not during the search. -
LDAP_DEREF_ALWAYS
- aliases should be dereferenced always.
-
-
serverctrls
-
Array of LDAP Controls to send with the request.
Examples
Example #1 Produce a list of all organizational units of an organization
<?php
// $ds is a valid link identifier for a directory server
$basedn = "o=My Company, c=US";
$justthese = array("ou");
$sr = ldap_list($ds, $basedn, "ou=*", $justthese);
$info = ldap_get_entries($ds, $sr);
for ($i=0; $i < $info["count"]; $i++) {
echo $info[$i]["ou"][0];
}
?>
Vertaling niet beschikbaar
De PHP-handleiding is nog niet in het Nederlands vertaald, dus het scherm is in het Engels. Als u wilt, kunt u het ook in het Frans of in het Duits raadplegen.
Als je de moed voelt, kun je je vertaling aanbieden ;-)
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 30/01/2003 gemaakt, de laatste keer de 26/10/2018 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/php-rf-ldap-list.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.