3
V4.65 22 July 2005 (c) 2000-2005 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);
b'\\ No newline at end of file'