3 V5.14 8 Sept 2011 (c) 2000-2011 John Lim (jlim#natsoft.com). All rights reserved.
4 Released under both BSD license and Lesser GPL library license.
5 Whenever there is any discrepancy between the two licenses,
6 the BSD license will take precedence.
7 Set tabs to 4 for best viewing.
9 Latest version is available at http://adodb.sourceforge.net
11 Microsoft ADO data driver. Requires ADO. Works only on MS Windows. PHP5 compat version.
14 // security - hide paths
15 if (!defined('ADODB_DIR')) die();
17 define("_ADODB_ADO_LAYER", 1 );
18 /*--------------------------------------------------------------------------------------
19 --------------------------------------------------------------------------------------*/
22 class ADODB_ado
extends ADOConnection
{
23 var $databaseType = "ado";
24 var $_bindInputArray = false;
25 var $fmtDate = "'Y-m-d'";
26 var $fmtTimeStamp = "'Y-m-d, h:i:sA'";
27 var $replaceQuote = "''"; // string to use to replace quotes
28 var $dataProvider = "ado";
29 var $hasAffectedRows = true;
30 var $adoParameterType = 201; // 201 = long varchar, 203=long wide varchar, 205 = long varbinary
31 var $_affectedRows = false;
32 var $_thisTransactions;
33 var $_cursor_type = 3; // 3=adOpenStatic,0=adOpenForwardOnly,1=adOpenKeyset,2=adOpenDynamic
34 var $_cursor_location = 3; // 2=adUseServer, 3 = adUseClient;
36 var $_execute_option = -1;
37 var $poorAffectedRows = true;
42 $this->_affectedRows
= new VARIANT
;
47 if (!empty($this->_connectionID
)) $desc = $this->_connectionID
->provider
;
48 return array('description' => $desc, 'version' => '');
51 function _affectedrows()
53 if (PHP_VERSION
>= 5) return $this->_affectedRows
;
55 return $this->_affectedRows
->value
;
58 // you can also pass a connection string like this:
60 // $DB->Connect('USER ID=sa;PASSWORD=pwd;SERVER=mangrove;DATABASE=ai',false,false,'SQLOLEDB');
61 function _connect($argHostname, $argUsername, $argPassword,$argDBorProvider, $argProvider= '')
64 // - if $argProvider is empty, we assume that $argDBorProvider holds provider -- this is for backward compat
65 // - if $argProvider is not empty, then $argDBorProvider holds db
69 $argDatabasename = $argDBorProvider;
71 $argDatabasename = '';
72 if ($argDBorProvider) $argProvider = $argDBorProvider;
73 else if (stripos($argHostname,'PROVIDER') === false) /* full conn string is not in $argHostname */
74 $argProvider = 'MSDASQL';
82 if (!empty($this->charPage
))
83 $dbc = new COM('ADODB.Connection',null,$this->charPage
);
85 $dbc = new COM('ADODB.Connection');
87 if (! $dbc) return false;
89 /* special support if provider is mssql or access */
90 if ($argProvider=='mssql') {
91 $u = 'User Id'; //User parameter name for OLEDB
93 $argProvider = "SQLOLEDB"; // SQL Server Provider
96 //if ($argDatabasename) $argHostname .= ";Initial Catalog=$argDatabasename";
98 //use trusted conection for SQL if username not specified
99 if (!$argUsername) $argHostname .= ";Trusted_Connection=Yes";
100 } else if ($argProvider=='access')
101 $argProvider = "Microsoft.Jet.OLEDB.4.0"; // Microsoft Jet Provider
103 if ($argProvider) $dbc->Provider
= $argProvider;
105 if ($argProvider) $argHostname = "PROVIDER=$argProvider;DRIVER={SQL Server};SERVER=$argHostname";
108 if ($argDatabasename) $argHostname .= ";DATABASE=$argDatabasename";
109 if ($argUsername) $argHostname .= ";$u=$argUsername";
110 if ($argPassword)$argHostname .= ";$p=$argPassword";
112 if ($this->debug
) ADOConnection
::outp( "Host=".$argHostname."<BR>\n version=$dbc->version");
113 // @ added below for php 4.0.1 and earlier
114 @$dbc->Open((string) $argHostname);
116 $this->_connectionID
= $dbc;
118 $dbc->CursorLocation
= $this->_cursor_location
;
119 return $dbc->State
> 0;
120 } catch (exception
$e) {
121 if ($this->debug
) echo "<pre>",$argHostname,"\n",$e,"</pre>\n";
127 // returns true or false
128 function _pconnect($argHostname, $argUsername, $argPassword, $argProvider='MSDASQL')
130 return $this->_connect($argHostname,$argUsername,$argPassword,$argProvider);
134 adSchemaCatalogs = 1,
135 adSchemaCharacterSets = 2,
136 adSchemaCollations = 3,
138 adSchemaCheckConstraints = 5,
139 adSchemaConstraintColumnUsage = 6,
140 adSchemaConstraintTableUsage = 7,
141 adSchemaKeyColumnUsage = 8,
142 adSchemaReferentialContraints = 9,
143 adSchemaTableConstraints = 10,
144 adSchemaColumnsDomainUsage = 11,
145 adSchemaIndexes = 12,
146 adSchemaColumnPrivileges = 13,
147 adSchemaTablePrivileges = 14,
148 adSchemaUsagePrivileges = 15,
149 adSchemaProcedures = 16,
150 adSchemaSchemata = 17,
151 adSchemaSQLLanguages = 18,
152 adSchemaStatistics = 19,
154 adSchemaTranslations = 21,
155 adSchemaProviderTypes = 22,
157 adSchemaViewColumnUsage = 24,
158 adSchemaViewTableUsage = 25,
159 adSchemaProcedureParameters = 26,
160 adSchemaForeignKeys = 27,
161 adSchemaPrimaryKeys = 28,
162 adSchemaProcedureColumns = 29,
163 adSchemaDBInfoKeywords = 30,
164 adSchemaDBInfoLiterals = 31,
166 adSchemaDimensions = 33,
167 adSchemaHierarchies = 34,
169 adSchemaMeasures = 36,
170 adSchemaProperties = 37,
175 function MetaTables()
178 $dbc = $this->_connectionID
;
180 $adors=@$dbc->OpenSchema(20);//tables
182 $f = $adors->Fields(2);//table/view name
183 $t = $adors->Fields(3);//table type
184 while (!$adors->EOF
){
185 $tt=substr($t->value
,0,6);
186 if ($tt!='SYSTEM' && $tt !='ACCESS')
188 //print $f->value . ' ' . $t->value.'<br>';
197 function MetaColumns($table, $normalize=true)
199 $table = strtoupper($table);
201 $dbc = $this->_connectionID
;
203 $adors=@$dbc->OpenSchema(4);//tables
206 $t = $adors->Fields(2);//table/view name
207 while (!$adors->EOF
){
210 if (strtoupper($t->Value
) == $table) {
212 $fld = new ADOFieldObject();
213 $c = $adors->Fields(3);
214 $fld->name
= $c->Value
;
215 $fld->type
= 'CHAR'; // cannot discover type in ADO!
216 $fld->max_length
= -1;
217 $arr[strtoupper($fld->name
)]=$fld;
228 /* returns queryID or false */
229 function _query($sql,$inputarr=false)
231 try { // In PHP5, all COM errors are exceptions, so to maintain old behaviour...
233 $dbc = $this->_connectionID
;
241 if (!empty($this->charPage
))
242 $oCmd = new COM('ADODB.Command',null,$this->charPage
);
244 $oCmd = new COM('ADODB.Command');
245 $oCmd->ActiveConnection
= $dbc;
246 $oCmd->CommandText
= $sql;
247 $oCmd->CommandType
= 1;
249 while(list(, $val) = each($inputarr)) {
250 $type = gettype($val);
252 if ($type == 'boolean')
253 $this->adoParameterType
= 11;
254 else if ($type == 'integer')
255 $this->adoParameterType
= 3;
256 else if ($type == 'double')
257 $this->adoParameterType
= 5;
258 elseif ($type == 'string')
259 $this->adoParameterType
= 202;
260 else if (($val === null) ||
(!defined($val)))
263 $this->adoParameterType
= 130;
265 // name, type, direction 1 = input, len,
266 $p = $oCmd->CreateParameter('name',$this->adoParameterType
,1,$len,$val);
268 $oCmd->Parameters
->Append($p);
272 $rs = $oCmd->Execute();
274 if ($dbc->Errors
->Count
> 0) return $false;
278 $rs = @$dbc->Execute($sql,$this->_affectedRows
, $this->_execute_option
);
280 if ($dbc->Errors
->Count
> 0) return $false;
281 if (! $rs) return $false;
283 if ($rs->State
== 0) {
285 return $true; // 0 = adStateClosed means no records returned
289 } catch (exception
$e) {
296 function BeginTrans()
298 if ($this->transOff
) return true;
300 if (isset($this->_thisTransactions
))
301 if (!$this->_thisTransactions
) return false;
303 $o = $this->_connectionID
->Properties("Transaction DDL");
304 $this->_thisTransactions
= $o ?
true : false;
305 if (!$o) return false;
307 @$this->_connectionID
->BeginTrans();
308 $this->transCnt +
= 1;
311 function CommitTrans($ok=true)
313 if (!$ok) return $this->RollbackTrans();
314 if ($this->transOff
) return true;
316 @$this->_connectionID
->CommitTrans();
317 if ($this->transCnt
) @$this->transCnt
-= 1;
320 function RollbackTrans() {
321 if ($this->transOff
) return true;
322 @$this->_connectionID
->RollbackTrans();
323 if ($this->transCnt
) @$this->transCnt
-= 1;
327 /* Returns: the last error message from previous database operation */
331 if (!$this->_connectionID
) return "No connection established";
335 $errc = $this->_connectionID
->Errors
;
336 if (!$errc) return "No Errors object found";
337 if ($errc->Count
== 0) return '';
338 $err = $errc->Item($errc->Count
-1);
339 $errmsg = $err->Description
;
340 }catch(exception
$e) {
347 $errc = $this->_connectionID
->Errors
;
348 if ($errc->Count
== 0) return 0;
349 $err = $errc->Item($errc->Count
-1);
350 return $err->NativeError
;
353 // returns true or false
356 if ($this->_connectionID
) $this->_connectionID
->Close();
357 $this->_connectionID
= false;
364 /*--------------------------------------------------------------------------------------
365 Class Name: Recordset
366 --------------------------------------------------------------------------------------*/
368 class ADORecordSet_ado
extends ADORecordSet
{
371 var $databaseType = "ado";
372 var $dataProvider = "ado";
373 var $_tarr = false; // caches the types
374 var $_flds; // and field objects
376 var $hideErrors = true;
378 function ADORecordSet_ado($id,$mode=false)
380 if ($mode === false) {
381 global $ADODB_FETCH_MODE;
382 $mode = $ADODB_FETCH_MODE;
384 $this->fetchMode
= $mode;
385 return $this->ADORecordSet($id,$mode);
389 // returns the field object
390 function FetchField($fieldOffset = -1) {
391 $off=$fieldOffset+
1; // offsets begin at 1
393 $o= new ADOFieldObject();
394 $rs = $this->_queryID
;
395 if (!$rs) return false;
397 $f = $rs->Fields($fieldOffset);
400 $o->type
= $this->MetaType($t);
401 $o->max_length
= $f->DefinedSize
;
405 //print "off=$off name=$o->name type=$o->type len=$o->max_length<br>";
409 /* Use associative array to get fields array */
410 function Fields($colname)
412 if ($this->fetchMode
& ADODB_FETCH_ASSOC
) return $this->fields
[$colname];
414 $this->bind
= array();
415 for ($i=0; $i < $this->_numOfFields
; $i++
) {
416 $o = $this->FetchField($i);
417 $this->bind
[strtoupper($o->name
)] = $i;
421 return $this->fields
[$this->bind
[strtoupper($colname)]];
427 $rs = $this->_queryID
;
430 $this->_numOfRows
= $rs->RecordCount
;
431 } catch (Exception
$e) {
432 $this->_numOfRows
= -1;
435 $this->_numOfFields
= $f->Count
;
439 // should only be used to move forward as we normally use forward-only cursors
442 $rs = $this->_queryID
;
443 // absoluteposition doesn't work -- my maths is wrong ?
444 // $rs->AbsolutePosition->$row-2;
446 if ($this->_currentRow
> $row) return false;
447 @$rs->Move((integer)$row - $this->_currentRow
-1); //adBookmarkFirst
464 DBTYPE_IDISPATCH = 9,
468 DBTYPE_IUNKNOWN = 13,
471 DBTYPE_ARRAY = 0x2000,
472 DBTYPE_BYREF = 0x4000,
479 DBTYPE_VECTOR = 0x1000,
480 DBTYPE_RESERVED = 0x8000,
484 DBTYPE_NUMERIC = 131,
488 DBTYPE_DBTIMESTAMP = 135
497 adUnsignedTinyInt = 17,
498 adUnsignedSmallInt = 18,
500 adUnsignedBigInt = 21,
523 adLongVarWChar = 203,
526 adLongVarBinary = 205,
533 function MetaType($t,$len=-1,$fieldobj=false)
537 $t = $fieldobj->type
;
538 $len = $fieldobj->max_length
;
541 if (!is_numeric($t)) return $t;
554 if ($len <= $this->blobSize
) return 'C';
564 case 133: return 'D';
567 case 135: return 'T';
571 case 16:// adTinyInt = 16,
572 case 2://adSmallInt = 2,
573 case 3://adInteger = 3,
574 case 4://adBigInt = 20,
575 case 17://adUnsignedTinyInt = 17,
576 case 18://adUnsignedSmallInt = 18,
577 case 19://adUnsignedInt = 19,
578 case 20://adUnsignedBigInt = 21,
584 // time stamp not supported yet
587 $rs = $this->_queryID
;
588 if (!$rs or $rs->EOF
) {
589 $this->fields
= false;
592 $this->fields
= array();
597 for ($i=0,$max = $this->_numOfFields
; $i < $max; $i++
) {
598 $f = $rs->Fields($i);
602 // bind types and flds only once
603 $this->_tarr
= $tarr;
604 $this->_flds
= $flds;
606 $t = reset($this->_tarr
);
607 $f = reset($this->_flds
);
609 if ($this->hideErrors
) $olde = error_reporting(E_ERROR|E_CORE_ERROR
);// sometimes $f->value be null
610 for ($i=0,$max = $this->_numOfFields
; $i < $max; $i++
) {
611 //echo "<p>",$t,' ';var_dump($f->value); echo '</p>';
613 case 135: // timestamp
614 if (!strlen((string)$f->value
)) $this->fields
[] = false;
616 if (!is_numeric($f->value
)) # $val = variant_date_to_timestamp($f->value);
617 // VT_DATE stores dates as (float) fractional days since 1899/12/30 00:00:00
618 $val= (float) variant_cast($f->value
,VT_R8
)*3600*24-2209161600;
621 $this->fields
[] = adodb_date('Y-m-d H:i:s',$val);
624 case 133:// A date value (yyyymmdd)
625 if ($val = $f->value
) {
626 $this->fields
[] = substr($val,0,4).'-'.substr($val,4,2).'-'.substr($val,6,2);
628 $this->fields
[] = false;
631 if (!strlen((string)$f->value
)) $this->fields
[] = false;
633 if (!is_numeric($f->value
)) $val = variant_date_to_timestamp($f->value
);
634 else $val = $f->value
;
636 if (($val %
86400) == 0) $this->fields
[] = adodb_date('Y-m-d',$val);
637 else $this->fields
[] = adodb_date('Y-m-d H:i:s',$val);
641 $this->fields
[] = false;
644 case 21: // bigint (64 bit)
645 $this->fields
[] = (float) $f->value
; // if 64 bit PHP, could use (int)
647 case 6: // currency is not supported properly;
648 ADOConnection
::outp( '<b>'.$f->Name
.': currency type not supported by PHP</b>');
649 $this->fields
[] = (float) $f->value
;
653 if(is_bool($f->value
)) {
654 if($f->value
==true) $val = 1;
657 if(is_null($f->value
)) $val = null;
659 $this->fields
[] = $val;
662 $this->fields
[] = $f->value
;
665 //print " $f->value $t, ";
666 $f = next($this->_flds
);
667 $t = next($this->_tarr
);
669 if ($this->hideErrors
) error_reporting($olde);
670 @$rs->MoveNext(); // @ needed for some versions of PHP!
672 if ($this->fetchMode
& ADODB_FETCH_ASSOC
) {
673 $this->fields
= $this->GetRowAssoc(ADODB_ASSOC_CASE
);
678 function NextRecordSet()
680 $rs = $this->_queryID
;
681 $this->_queryID
= $rs->NextRecordSet();
682 //$this->_queryID = $this->_QueryId->NextRecordSet();
683 if ($this->_queryID
== null) return false;
685 $this->_currentRow
= -1;
686 $this->_currentPage
= -1;
688 $this->fields
= false;
689 $this->_flds
= false;
690 $this->_tarr
= false;
692 $this->_inited
= false;
698 $this->_flds
= false;
700 @$this->_queryID
->Close();// by Pete Dishman (peterd@telephonetics.co.uk)
701 } catch (Exception
$e) {
703 $this->_queryID
= false;