This is an old revision of the document!
LDAP
Description
The ldap
driver provides a small subset of ADOdb commands allowing read-only access to an LDAP database.
Available Methods
The following methods are available for use with the LDAP driver:
Calls to other methods when used with this driver may produce unexpected results or program failure.
Usage
You must use standard LDAP filter terms rather than SQL statements when executing a query. Any value provided in the $bindvars parameter is ignored,
$db = newAdoConnection('ldap'); $baseDN = 'dc=example,dc=com'; $adServer = 'example.com'; $user = 'adodb@example.com'; $password = 'adodb!'; $db->connect($adServer,$user,$password,$baseDN); $result = $db->execute('(samaccountname=adodb)');
URI Connections
The Server definition can be set in the form ldap://server-name
. You must use this if you want to:
- Use an alternate connection port
ldap:⁄⁄server-name:3389
- Use ldap over SSL -
ldaps:⁄⁄server-name
Connection Parameters
The following values may be injected into the connection via the use of setConnectionParameter()
OPTION_NAME | Type |
---|---|
LDAP_OPT_DEREF | integer |
LDAP_OPT_SIZELIMIT | integer |
LDAP_OPT_TIMELIMIT | integer |
LDAP_OPT_PROTOCOL_VERSION | integer |
LDAP_OPT_ERROR_NUMBER | integer |
LDAP_OPT_REFERRALS | boolean |
LDAP_OPT_RESTART | boolean |
LDAP_OPT_HOST_NAME | string |
LDAP_OPT_ERROR_STRING | string |
LDAP_OPT_MATCHED_DN | string |
LDAP_OPT_SERVER_CONTROLS | array |
LDAP_OPT_CLIENT_CONTROLS | array |
From ADOdb 5.22.7, default values set are as follows
Parameter | Value |
---|---|
LDAP_OPT_PROTOCOL_VERSION | 3 |
LDAP_OPT_REFERRALS | 0 |
These values can be changed with setConnectionParameter()
The following usage method is deprecated in PHP8.2 and will not work with PHP 8.3. Use setConnectionParameter() instead.
$LDAP_CONNECT_OPTIONS = Array( Array ( "OPTION_NAME"=>LDAP_OPT_DEREF, "OPTION_VALUE"=>2 ), Array ( "OPTION_NAME"=>LDAP_OPT_SIZELIMIT, "OPTION_VALUE"=>100 ), Array ( "OPTION_NAME"=>LDAP_OPT_TIMELIMIT, "OPTION_VALUE"=>30 ), Array ( "OPTION_NAME"=>, "OPTION_VALUE"=>3 ), Array ( "OPTION_NAME"=>LDAP_OPT_ERROR_NUMBER, "OPTION_VALUE"=>13 ), Array ( "OPTION_NAME"=>LDAP_OPT_REFERRALS, "OPTION_VALUE"=>FALSE ), Array ( "OPTION_NAME"=>LDAP_OPT_RESTART, "OPTION_VALUE"=>FALSE ) );