Differences

This shows you the differences between two versions of the page.

--- database:ldap [2015/10/08 03:51] – [Available Methods] mnewnham
+++ v5:database:ldap [2023/11/17 15:39] – mnewnham
@@ Line 1: / Line 1: @@
 ====== LDAP ======
+~~NOTOC~~
+<WRAP right box round 300px>
+== Specification ==
+^Driver Name|ldap|
+^Data Provider|ldap|
+^Status|Inactive((This driver is not actively supported or enhanced by ADOdb project members, but you can provide fixes and enhancements if you have the expertise))|
+^Windows|Yes|
+^Unix|Perhaps((We have never tried it except against Microsoft LDAP servers from Windows))|
+^ADOdb V5|Yes|
+^ADOdb V6|Yes|
+</WRAP>
 ===== Description =====
 The ''ldap'' driver provides a small subset of ADOdb commands allowing **read-only** access to an LDAP database.
-===== Specification =====
-|Driver|ldap|
-|Status|Active|
-|Supported OS|Windows Yes, Other platforms unknown|
 ===== Available Methods =====
 The following methods are available for use with the LDAP driver:
-  * [[reference:getassoc|getAssoc()]]
+  * [[v5:reference:connection:getassoc|execute()]]
-  * [[reference:selectdb|selectDb()]]
+  * [[v5:reference:connection:getassoc|getAssoc()]]
-  * [[dictionary:serverinfo|serverInfo()]]
+  * [[v5:reference:connection:selectdb|selectDb()]]
-  * [[reference:getrowassoc|getRowAssoc()]]
+  * [[v5:reference:connection:serverinfo|serverInfo()]]
+  * [[v5:reference:connection:getrowassoc|getRowAssoc()]]
+  * [[v5:reference:connection:setConnectionParameter|setConnectionParameter()]]
 Calls to other methods when used with this driver may produce unexpected results or program failure.
@@ Line 18: / Line 28: @@
 <code php>
 $db = newAdoConnection('ldap');
+$baseDN   = 'dc=test,dc=loc';
+$adServer = '192.168.1.16';
+$user     = 'adodb@test.loc';
+$password = 'adodb!';
+$db->connect($adServer,$user,$password,$baseDN);
+$result = $db->execute('(samaccountname=adodb)');
 </code>
-===== Custom Functionality =====
+===== Connection Parameters =====
-If defined prior to connection, the following variables will be passed as input bind variables.
-Valid Domain Values for LDAP Options:
+The following values may be injected into the connection via the use of [[v5:reference:connection:getrowassoc|setConnectionParameter()]]
-  LDAP_OPT_DEREF (integer)
-  LDAP_OPT_SIZELIMIT (integer)
-  LDAP_OPT_TIMELIMIT (integer)
+^ OPTION_NAME ^ Type ^
-  LDAP_OPT_PROTOCOL_VERSION (integer)
+| ''LDAP_OPT_DEREF'' | integer |
-  LDAP_OPT_ERROR_NUMBER (integer)
+| ''LDAP_OPT_SIZELIMIT'' | integer |
-  LDAP_OPT_REFERRALS (boolean)
+| ''LDAP_OPT_TIMELIMIT'' | integer |
-  LDAP_OPT_RESTART (boolean)
+| ''LDAP_OPT_PROTOCOL_VERSION'' | integer |
-  LDAP_OPT_HOST_NAME (string)
+| ''LDAP_OPT_ERROR_NUMBER'' | integer |
-  LDAP_OPT_ERROR_STRING (string)
+| ''LDAP_OPT_REFERRALS'' | boolean |
-  LDAP_OPT_MATCHED_DN (string)
+| ''LDAP_OPT_RESTART'' | boolean |
-  LDAP_OPT_SERVER_CONTROLS (array)
+| ''LDAP_OPT_HOST_NAME'' | string |
-  LDAP_OPT_CLIENT_CONTROLS (array)
+| ''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.
-Make sure to set this BEFORE calling Connect()
-Example:
 <code php>
 $LDAP_CONNECT_OPTIONS = Array(
@@ Line 54: / Line 84: @@
 	),
 	Array (
-		"OPTION_NAME"=>LDAP_OPT_PROTOCOL_VERSION,
+		"OPTION_NAME"=>,
 		"OPTION_VALUE"=>3
 	),
@@ Line 71: / Line 101: @@
 );
 </code>
+{{tag>[dormant tier2]}}