3 V4.98 13 Feb 2008 (c) 2000-2008 John Lim (jlim#natsoft.com.my). 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 Requires ODBC. Works on Windows and Unix.
13 // security - hide paths
14 if (!defined('ADODB_DIR')) die();
16 define("_ADODB_ODBC_LAYER", 2 );
18 /*--------------------------------------------------------------------------------------
19 --------------------------------------------------------------------------------------*/
22 class ADODB_odbc
extends ADOConnection
{
23 var $databaseType = "odbc";
24 var $fmtDate = "'Y-m-d'";
25 var $fmtTimeStamp = "'Y-m-d, h:i:sA'";
26 var $replaceQuote = "''"; // string to use to replace quotes
27 var $dataProvider = "odbc";
28 var $hasAffectedRows = true;
29 var $binmode = ODBC_BINMODE_RETURN
;
30 var $useFetchArray = false; // setting this to true will make array elements in FETCH_ASSOC mode case-sensitive
31 // breaking backward-compat
32 //var $longreadlen = 8000; // default number of chars to return for a Blob/Long field
33 var $_bindInputArray = false;
34 var $curmode = SQL_CUR_USE_DRIVER
; // See sqlext.h, SQL_CUR_DEFAULT == SQL_CUR_USE_DRIVER == 2L
35 var $_genSeqSQL = "create table %s (id integer)";
36 var $_autocommit = true;
37 var $_haserrorfunctions = true;
38 var $_has_stupid_odbc_fetch_api_change = true;
39 var $_lastAffectedRows = 0;
40 var $uCaseTables = true; // for meta* functions, uppercase table names
44 $this->_haserrorfunctions
= ADODB_PHPVER
>= 0x4050;
45 $this->_has_stupid_odbc_fetch_api_change
= ADODB_PHPVER
>= 0x4200;
48 // returns true or false
49 function _connect($argDSN, $argUsername, $argPassword, $argDatabasename)
53 if (!function_exists('odbc_connect')) return null;
55 if ($this->debug
&& $argDatabasename && $this->databaseType
!= 'vfp') {
56 ADOConnection
::outp("For odbc Connect(), $argDatabasename is not used. Place dsn in 1st parameter.");
58 if (isset($php_errormsg)) $php_errormsg = '';
59 if ($this->curmode
=== false) $this->_connectionID
= odbc_connect($argDSN,$argUsername,$argPassword);
60 else $this->_connectionID
= odbc_connect($argDSN,$argUsername,$argPassword,$this->curmode
);
61 $this->_errorMsg
= isset($php_errormsg) ?
$php_errormsg : '';
62 if (isset($this->connectStmt
)) $this->Execute($this->connectStmt
);
64 return $this->_connectionID
!= false;
67 // returns true or false
68 function _pconnect($argDSN, $argUsername, $argPassword, $argDatabasename)
72 if (!function_exists('odbc_connect')) return null;
74 if (isset($php_errormsg)) $php_errormsg = '';
75 $this->_errorMsg
= isset($php_errormsg) ?
$php_errormsg : '';
76 if ($this->debug
&& $argDatabasename) {
77 ADOConnection
::outp("For odbc PConnect(), $argDatabasename is not used. Place dsn in 1st parameter.");
79 // print "dsn=$argDSN u=$argUsername p=$argPassword<br>"; flush();
80 if ($this->curmode
=== false) $this->_connectionID
= odbc_connect($argDSN,$argUsername,$argPassword);
81 else $this->_connectionID
= odbc_pconnect($argDSN,$argUsername,$argPassword,$this->curmode
);
83 $this->_errorMsg
= isset($php_errormsg) ?
$php_errormsg : '';
84 if ($this->_connectionID
&& $this->autoRollback
) @odbc_rollback
($this->_connectionID
);
85 if (isset($this->connectStmt
)) $this->Execute($this->connectStmt
);
87 return $this->_connectionID
!= false;
94 if (!empty($this->host
) && ADODB_PHPVER
>= 0x4300) {
95 $dsn = strtoupper($this->host
);
99 if (!function_exists('odbc_data_source')) return false;
103 $rez = @odbc_data_source
($this->_connectionID
,
104 $first ? SQL_FETCH_FIRST
: SQL_FETCH_NEXT
);
106 if (!is_array($rez)) break;
107 if (strtoupper($rez['server']) == $dsn) {
112 if (!$found) return ADOConnection
::ServerInfo();
113 if (!isset($rez['version'])) $rez['version'] = '';
116 return ADOConnection
::ServerInfo();
121 function CreateSequence($seqname='adodbseq',$start=1)
123 if (empty($this->_genSeqSQL
)) return false;
124 $ok = $this->Execute(sprintf($this->_genSeqSQL
,$seqname));
125 if (!$ok) return false;
127 return $this->Execute("insert into $seqname values($start)");
130 var $_dropSeqSQL = 'drop table %s';
131 function DropSequence($seqname)
133 if (empty($this->_dropSeqSQL
)) return false;
134 return $this->Execute(sprintf($this->_dropSeqSQL
,$seqname));
138 This algorithm is not very efficient, but works even if table locking
141 Will return false if unable to generate an ID after $MAXLOOPS attempts.
143 function GenID($seq='adodbseq',$start=1)
145 // if you have to modify the parameter below, your database is overloaded,
146 // or you need to implement generation of id's yourself!
149 while (--$MAXLOOPS>=0) {
150 $num = $this->GetOne("select id from $seq");
151 if ($num === false) {
152 $this->Execute(sprintf($this->_genSeqSQL
,$seq));
155 $ok = $this->Execute("insert into $seq values($start)");
156 if (!$ok) return false;
158 $this->Execute("update $seq set id=id+1 where id=$num");
160 if ($this->affected_rows() > 0) {
166 if ($fn = $this->raiseErrorFn
) {
167 $fn($this->databaseType
,'GENID',-32000,"Unable to generate unique id after $MAXLOOPS attempts",$seq,$num);
175 if ($this->_haserrorfunctions
) {
176 if ($this->_errorMsg
!== false) return $this->_errorMsg
;
177 if (empty($this->_connectionID
)) return @odbc_errormsg
();
178 return @odbc_errormsg
($this->_connectionID
);
179 } else return ADOConnection
::ErrorMsg();
185 if ($this->_haserrorfunctions
) {
186 if ($this->_errorCode
!== false) {
187 // bug in 4.0.6, error number can be corrupted string (should be 6 digits)
188 return (strlen($this->_errorCode
)<=2) ?
0 : $this->_errorCode
;
191 if (empty($this->_connectionID
)) $e = @odbc_error
();
192 else $e = @odbc_error
($this->_connectionID
);
194 // bug in 4.0.6, error number can be corrupted string (should be 6 digits)
195 // so we check and patch
196 if (strlen($e)<=2) return 0;
198 } else return ADOConnection
::ErrorNo();
203 function BeginTrans()
205 if (!$this->hasTransactions
) return false;
206 if ($this->transOff
) return true;
207 $this->transCnt +
= 1;
208 $this->_autocommit
= false;
209 return odbc_autocommit($this->_connectionID
,false);
212 function CommitTrans($ok=true)
214 if ($this->transOff
) return true;
215 if (!$ok) return $this->RollbackTrans();
216 if ($this->transCnt
) $this->transCnt
-= 1;
217 $this->_autocommit
= true;
218 $ret = odbc_commit($this->_connectionID
);
219 odbc_autocommit($this->_connectionID
,true);
223 function RollbackTrans()
225 if ($this->transOff
) return true;
226 if ($this->transCnt
) $this->transCnt
-= 1;
227 $this->_autocommit
= true;
228 $ret = odbc_rollback($this->_connectionID
);
229 odbc_autocommit($this->_connectionID
,true);
233 function MetaPrimaryKeys($table)
235 global $ADODB_FETCH_MODE;
237 if ($this->uCaseTables
) $table = strtoupper($table);
239 $this->_findschema($table,$schema);
241 $savem = $ADODB_FETCH_MODE;
242 $ADODB_FETCH_MODE = ADODB_FETCH_NUM
;
243 $qid = @odbc_primarykeys
($this->_connectionID
,'',$schema,$table);
246 $ADODB_FETCH_MODE = $savem;
249 $rs = new ADORecordSet_odbc($qid);
250 $ADODB_FETCH_MODE = $savem;
252 if (!$rs) return false;
253 $rs->_has_stupid_odbc_fetch_api_change
= $this->_has_stupid_odbc_fetch_api_change
;
255 $arr =& $rs->GetArray();
259 for ($i=0; $i < sizeof($arr); $i++
) {
260 if ($arr[$i][3]) $arr2[] = $arr[$i][3];
267 function &MetaTables($ttype=false)
269 global $ADODB_FETCH_MODE;
271 $savem = $ADODB_FETCH_MODE;
272 $ADODB_FETCH_MODE = ADODB_FETCH_NUM
;
273 $qid = odbc_tables($this->_connectionID
);
275 $rs = new ADORecordSet_odbc($qid);
277 $ADODB_FETCH_MODE = $savem;
282 $rs->_has_stupid_odbc_fetch_api_change
= $this->_has_stupid_odbc_fetch_api_change
;
284 $arr =& $rs->GetArray();
291 $isview = strncmp($ttype,'V',1) === 0;
293 for ($i=0; $i < sizeof($arr); $i++
) {
294 if (!$arr[$i][2]) continue;
298 if (strncmp($type,'V',1) === 0) $arr2[] = $arr[$i][2];
299 } else if (strncmp($type,'SYS',3) !== 0) $arr2[] = $arr[$i][2];
300 } else if (strncmp($type,'SYS',3) !== 0) $arr2[] = $arr[$i][2];
306 See http://msdn.microsoft.com/library/default.asp?url=/library/en-us/odbc/htm/odbcdatetime_data_type_changes.asp
307 / SQL data type codes /
308 #define SQL_UNKNOWN_TYPE 0
310 #define SQL_NUMERIC 2
311 #define SQL_DECIMAL 3
312 #define SQL_INTEGER 4
313 #define SQL_SMALLINT 5
317 #if (ODBCVER >= 0x0300)
318 #define SQL_DATETIME 9
320 #define SQL_VARCHAR 12
323 / One-parameter shortcuts for date/time data types /
324 #if (ODBCVER >= 0x0300)
325 #define SQL_TYPE_DATE 91
326 #define SQL_TYPE_TIME 92
327 #define SQL_TYPE_TIMESTAMP 93
329 #define SQL_UNICODE (-95)
330 #define SQL_UNICODE_VARCHAR (-96)
331 #define SQL_UNICODE_LONGVARCHAR (-97)
333 function ODBCTypes($t)
335 switch ((integer)$t) {
363 case -11: // uniqidentifier
373 function &MetaColumns($table)
375 global $ADODB_FETCH_MODE;
378 if ($this->uCaseTables
) $table = strtoupper($table);
380 $this->_findschema($table,$schema);
382 $savem = $ADODB_FETCH_MODE;
383 $ADODB_FETCH_MODE = ADODB_FETCH_NUM
;
385 /*if (false) { // after testing, confirmed that the following does not work becoz of a bug
386 $qid2 = odbc_tables($this->_connectionID);
387 $rs = new ADORecordSet_odbc($qid2);
388 $ADODB_FETCH_MODE = $savem;
389 if (!$rs) return false;
390 $rs->_has_stupid_odbc_fetch_api_change = $this->_has_stupid_odbc_fetch_api_change;
394 if ($table == strtoupper($rs->fields[2])) {
403 $qid = odbc_columns($this->_connectionID,$q,$o,strtoupper($table),'%');
406 switch ($this->databaseType
) {
409 $qid = odbc_columns($this->_connectionID
);#,'%','',strtoupper($table),'%');
415 $qid = odbc_columns($this->_connectionID
, "", $schema, $table, $colname);
419 $qid = @odbc_columns
($this->_connectionID
,'%','%',strtoupper($table),'%');
420 if (empty($qid)) $qid = odbc_columns($this->_connectionID
);
423 if (empty($qid)) return $false;
425 $rs =& new ADORecordSet_odbc($qid);
426 $ADODB_FETCH_MODE = $savem;
428 if (!$rs) return $false;
429 $rs->_has_stupid_odbc_fetch_api_change
= $this->_has_stupid_odbc_fetch_api_change
;
450 // adodb_pr($rs->fields);
451 if (strtoupper(trim($rs->fields
[2])) == $table && (!$schema ||
strtoupper($rs->fields
[1]) == $schema)) {
452 $fld = new ADOFieldObject();
453 $fld->name
= $rs->fields
[3];
454 $fld->type
= $this->ODBCTypes($rs->fields
[4]);
456 // ref: http://msdn.microsoft.com/library/default.asp?url=/archive/en-us/dnaraccgen/html/msdn_odk.asp
457 // access uses precision to store length for char/varchar
458 if ($fld->type
== 'C' or $fld->type
== 'X') {
459 if ($this->databaseType
== 'access')
460 $fld->max_length
= $rs->fields
[6];
461 else if ($rs->fields
[4] <= -95) // UNICODE
462 $fld->max_length
= $rs->fields
[7]/2;
464 $fld->max_length
= $rs->fields
[7];
466 $fld->max_length
= $rs->fields
[7];
467 $fld->not_null
= !empty($rs->fields
[10]);
468 $fld->scale
= $rs->fields
[8];
469 $retarr[strtoupper($fld->name
)] = $fld;
470 } else if (sizeof($retarr)>0)
474 $rs->Close(); //-- crashes 4.03pl1 -- why?
476 if (empty($retarr)) $retarr = false;
480 function Prepare($sql)
482 if (! $this->_bindInputArray
) return $sql; // no binding
483 $stmt = odbc_prepare($this->_connectionID
,$sql);
485 // we don't know whether odbc driver is parsing prepared stmts, so just return sql
488 return array($sql,$stmt,false);
491 /* returns queryID or false */
492 function _query($sql,$inputarr=false)
494 GLOBAL $php_errormsg;
495 if (isset($php_errormsg)) $php_errormsg = '';
499 if (is_array($sql)) {
502 $stmtid = odbc_prepare($this->_connectionID
,$sql);
504 if ($stmtid == false) {
505 $this->_errorMsg
= isset($php_errormsg) ?
$php_errormsg : '';
510 if (! odbc_execute($stmtid,$inputarr)) {
511 //@odbc_free_result($stmtid);
512 if ($this->_haserrorfunctions
) {
513 $this->_errorMsg
= odbc_errormsg();
514 $this->_errorCode
= odbc_error();
519 } else if (is_array($sql)) {
521 if (!odbc_execute($stmtid)) {
522 //@odbc_free_result($stmtid);
523 if ($this->_haserrorfunctions
) {
524 $this->_errorMsg
= odbc_errormsg();
525 $this->_errorCode
= odbc_error();
530 $stmtid = odbc_exec($this->_connectionID
,$sql);
532 $this->_lastAffectedRows
= 0;
534 if (@odbc_num_fields
($stmtid) == 0) {
535 $this->_lastAffectedRows
= odbc_num_rows($stmtid);
538 $this->_lastAffectedRows
= 0;
539 odbc_binmode($stmtid,$this->binmode
);
540 odbc_longreadlen($stmtid,$this->maxblobsize
);
543 if ($this->_haserrorfunctions
) {
544 $this->_errorMsg
= '';
545 $this->_errorCode
= 0;
547 $this->_errorMsg
= isset($php_errormsg) ?
$php_errormsg : '';
549 if ($this->_haserrorfunctions
) {
550 $this->_errorMsg
= odbc_errormsg();
551 $this->_errorCode
= odbc_error();
553 $this->_errorMsg
= isset($php_errormsg) ?
$php_errormsg : '';
559 Insert a null into the blob field of the table first.
560 Then use UpdateBlob to store the blob.
564 $conn->Execute('INSERT INTO blobtable (id, blobcol) VALUES (1, null)');
565 $conn->UpdateBlob('blobtable','blobcol',$blob,'id=1');
567 function UpdateBlob($table,$column,$val,$where,$blobtype='BLOB')
569 return $this->Execute("UPDATE $table SET $column=? WHERE $where",array($val)) != false;
572 // returns true or false
575 $ret = @odbc_close
($this->_connectionID
);
576 $this->_connectionID
= false;
580 function _affectedrows()
582 return $this->_lastAffectedRows
;
587 /*--------------------------------------------------------------------------------------
588 Class Name: Recordset
589 --------------------------------------------------------------------------------------*/
591 class ADORecordSet_odbc
extends ADORecordSet
{
594 var $databaseType = "odbc";
595 var $dataProvider = "odbc";
597 var $_has_stupid_odbc_fetch_api_change;
599 function ADORecordSet_odbc($id,$mode=false)
601 if ($mode === false) {
602 global $ADODB_FETCH_MODE;
603 $mode = $ADODB_FETCH_MODE;
605 $this->fetchMode
= $mode;
607 $this->_queryID
= $id;
609 // the following is required for mysql odbc driver in 4.3.1 -- why?
611 $this->_currentRow
= -1;
612 //$this->ADORecordSet($id);
616 // returns the field object
617 function &FetchField($fieldOffset = -1)
620 $off=$fieldOffset+
1; // offsets begin at 1
622 $o= new ADOFieldObject();
623 $o->name
= @odbc_field_name
($this->_queryID
,$off);
624 $o->type
= @odbc_field_type
($this->_queryID
,$off);
625 $o->max_length
= @odbc_field_len
($this->_queryID
,$off);
626 if (ADODB_ASSOC_CASE
== 0) $o->name
= strtolower($o->name
);
627 else if (ADODB_ASSOC_CASE
== 1) $o->name
= strtoupper($o->name
);
631 /* Use associative array to get fields array */
632 function Fields($colname)
634 if ($this->fetchMode
& ADODB_FETCH_ASSOC
) return $this->fields
[$colname];
636 $this->bind
= array();
637 for ($i=0; $i < $this->_numOfFields
; $i++
) {
638 $o = $this->FetchField($i);
639 $this->bind
[strtoupper($o->name
)] = $i;
643 return $this->fields
[$this->bind
[strtoupper($colname)]];
649 global $ADODB_COUNTRECS;
650 $this->_numOfRows
= ($ADODB_COUNTRECS) ? @odbc_num_rows
($this->_queryID
) : -1;
651 $this->_numOfFields
= @odbc_num_fields
($this->_queryID
);
652 // some silly drivers such as db2 as/400 and intersystems cache return _numOfRows = 0
653 if ($this->_numOfRows
== 0) $this->_numOfRows
= -1;
654 //$this->useFetchArray = $this->connection->useFetchArray;
655 $this->_has_stupid_odbc_fetch_api_change
= ADODB_PHPVER
>= 0x4200;
663 // speed up SelectLimit() by switching to ADODB_FETCH_NUM as ADODB_FETCH_ASSOC is emulated
664 function &GetArrayLimit($nrows,$offset=-1)
667 $rs =& $this->GetArray($nrows);
670 $savem = $this->fetchMode
;
671 $this->fetchMode
= ADODB_FETCH_NUM
;
672 $this->Move($offset);
673 $this->fetchMode
= $savem;
675 if ($this->fetchMode
& ADODB_FETCH_ASSOC
) {
676 $this->fields
=& $this->GetRowAssoc(ADODB_ASSOC_CASE
);
681 while (!$this->EOF
&& $nrows != $cnt) {
682 $results[$cnt++
] = $this->fields
;
692 if ($this->_numOfRows
!= 0 && !$this->EOF
) {
693 $this->_currentRow++
;
695 if ($this->_has_stupid_odbc_fetch_api_change
)
696 $rez = @odbc_fetch_into
($this->_queryID
,$this->fields
);
699 $rez = @odbc_fetch_into
($this->_queryID
,$row,$this->fields
);
702 if ($this->fetchMode
& ADODB_FETCH_ASSOC
) {
703 $this->fields
=& $this->GetRowAssoc(ADODB_ASSOC_CASE
);
708 $this->fields
= false;
716 if ($this->_has_stupid_odbc_fetch_api_change
)
717 $rez = @odbc_fetch_into
($this->_queryID
,$this->fields
);
720 $rez = @odbc_fetch_into
($this->_queryID
,$row,$this->fields
);
723 if ($this->fetchMode
& ADODB_FETCH_ASSOC
) {
724 $this->fields
=& $this->GetRowAssoc(ADODB_ASSOC_CASE
);
728 $this->fields
= false;
734 return @odbc_free_result
($this->_queryID
);