3 V4.22 15 Apr 2004 (c) 2000-2004 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. See License.txt.
7 Set tabs to 4 for best viewing.
8 Latest version is available at http://php.weblogs.com/
10 // Code contributed by "stefan bogdan" <sbogdan#rsb.ro>
12 define("_ADODB_ODBTP_LAYER", 2 );
14 class ADODB_odbtp extends ADOConnection{
15 var $databaseType = "odbtp";
16 var $dataProvider = "odbtp";
17 var $fmtDate = "'Y-m-d'";
18 var $fmtTimeStamp = "'Y-m-d, h:i:sA'";
19 var $replaceQuote = "''"; // string to use to replace quotes
21 var $hasAffectedRows = true;
22 var $hasInsertID = false;
24 var $hasMoveFirst = true;
26 var $_genSeqSQL = "create table %s (seq_name char(30) not null unique , seq_value integer not null)";
27 var $_dropSeqSQL = "delete from adodb_seq where seq_name = '%s'";
28 var $_autocommit = true;
29 var $_bindInputArray = false;
30 var $_useUnicodeSQL = false;
31 var $_canPrepareSP = false;
33 function ADODB_odbtp()
39 return array('description' => @odbtp_get_attr( ODB_ATTR_DBMSNAME, $this->_connectionID),
40 'version' => @odbtp_get_attr( ODB_ATTR_DBMSVER, $this->_connectionID));
45 if (empty($this->_connectionID)) return @odbtp_last_error();
46 return @odbtp_last_error($this->_connectionID);
51 if (empty($this->_connectionID)) return @odbtp_last_error_state();
52 return @odbtp_last_error_state($this->_connectionID);
58 // Returns the last IDENTITY value inserted into an IDENTITY column in
59 // the same scope. A scope is a module -- a stored procedure, trigger,
60 // function, or batch. Thus, two statements are in the same scope if
61 // they are in the same stored procedure, function, or batch.
62 return $this->GetOne($this->identitySQL);
65 function _affectedrows()
67 if ($this->_queryID) {
68 return @odbtp_affected_rows ($this->_queryID);
73 function CreateSequence($seqname='adodbseq',$start=1)
76 $num = $this->GetOne("select seq_value from adodb_seq");
78 if( $this->odbc_driver == ODB_DRIVER_FOXPRO ) {
79 $path = @odbtp_get_attr( ODB_ATTR_DATABASENAME, $this->_connectionID );
80 //if using vfp dbc file
81 if( !strcasecmp(strrchr($path, '.'), '.dbc') )
82 $path = substr($path,0,strrpos($path,'\/'));
83 $seqtab = $path . '/' . $seqtab;
86 if (empty($this->_genSeqSQL)) return false;
87 $ok = $this->Execute(sprintf($this->_genSeqSQL ,$seqtab));
89 $num = $this->GetOne("select seq_value from adodb_seq where seq_name='$seqname'");
94 return $this->Execute("insert into adodb_seq values('$seqname',$start)");
97 function DropSequence($seqname)
99 if (empty($this->_dropSeqSQL)) return false;
100 return $this->Execute(sprintf($this->_dropSeqSQL,$seqname));
103 function GenID($seq='adodbseq',$start=1)
106 if( $this->odbc_driver == ODB_DRIVER_FOXPRO ) {
107 $path = @odbtp_get_attr( ODB_ATTR_DATABASENAME, $this->_connectionID );
108 //if using vfp dbc file
109 if( !strcasecmp(strrchr($path, '.'), '.dbc') )
110 $path = substr($path,0,strrpos($path,'\/'));
111 $seqtab = $path . '/' . $seqtab;
114 while (--$MAXLOOPS>=0) {
115 $num = $this->GetOne("select seq_value from adodb_seq where seq_name='$seq'");
116 if ($num === false) {
117 //verify if abodb_seq table exist
118 $ok = $this->GetOne("select seq_value from adodb_seq ");
120 //creating the sequence table adodb_seq
121 $this->Execute(sprintf($this->_genSeqSQL ,$seqtab));
125 $ok = $this->Execute("insert into adodb_seq values('$seq',$start)");
126 if (!$ok) return false;
128 $ok = $this->Execute("update adodb_seq set seq_value=seq_value+1 where seq_name='$seq'");
135 if ($fn = $this->raiseErrorFn) {
136 $fn($this->databaseType,'GENID',-32000,"Unable to generate unique id after $MAXLOOPS attempts",$seq,$num);
141 //example for $UserOrDSN
142 //for visual fox : DRIVER={Microsoft Visual FoxPro Driver};SOURCETYPE=DBF;SOURCEDB=c:\YourDbfFileDir;EXCLUSIVE=NO;
143 //for visual fox dbc: DRIVER={Microsoft Visual FoxPro Driver};SOURCETYPE=DBC;SOURCEDB=c:\YourDbcFileDir\mydb.dbc;EXCLUSIVE=NO;
144 //for access : DRIVER={Microsoft Access Driver (*.mdb)};DBQ=c:\path_to_access_db\base_test.mdb;UID=root;PWD=;
145 //for mssql : DRIVER={SQL Server};SERVER=myserver;UID=myuid;PWD=mypwd;DATABASE=OdbtpTest;
146 //if uid & pwd can be separate
147 function _connect($HostOrInterface, $UserOrDSN='', $argPassword='', $argDatabase='')
149 $this->_connectionID = @odbtp_connect($HostOrInterface,$UserOrDSN,$argPassword,$argDatabase);
150 if ($this->_connectionID === false)
152 $this->_errorMsg = $this->ErrorMsg() ;
155 $this->odbc_driver = @odbtp_get_attr(ODB_ATTR_DRIVER, $this->_connectionID);
157 // Set driver specific attributes
158 switch( $this->odbc_driver ) {
159 case ODB_DRIVER_MSSQL:
160 $this->fmtDate = "'Y-m-d'";
161 $this->fmtTimeStamp = "'Y-m-d h:i:sA'";
162 $this->sysDate = 'convert(datetime,convert(char,GetDate(),102),102)';
163 $this->sysTimeStamp = 'GetDate()';
164 $this->ansiOuter = true;
165 $this->leftOuter = '*=';
166 $this->rightOuter = '=*';
167 $this->hasTop = 'top';
168 $this->hasInsertID = true;
169 $this->hasTransactions = true;
170 $this->_bindInputArray = true;
171 $this->_canSelectDb = true;
172 $this->substr = "substring";
173 $this->length = 'len';
174 $this->upperCase = 'upper';
175 $this->identitySQL = 'select @@IDENTITY';
176 $this->metaDatabasesSQL = "select name from master..sysdatabases where name <> 'master'";
179 $this->fmtDate = "#Y-m-d#";
180 $this->fmtTimeStamp = "#Y-m-d h:i:sA#";
181 $this->sysDate = "FORMAT(NOW,'yyyy-mm-dd')";
182 $this->sysTimeStamp = 'NOW';
183 $this->hasTop = 'top';
184 $this->hasTransactions = false;
185 $this->_canPrepareSP = true; // For MS Access only.
187 // Can't rebind ODB_CHAR to ODB_WCHAR if row cache enabled.
188 if ($this->_useUnicodeSQL)
189 odbtp_use_row_cache($this->_connectionID, FALSE, 0);
191 case ODB_DRIVER_FOXPRO:
192 $this->fmtDate = "{^Y-m-d}";
193 $this->fmtTimeStamp = "{^Y-m-d, h:i:sA}";
194 $this->sysDate = 'date()';
195 $this->sysTimeStamp = 'datetime()';
196 $this->ansiOuter = true;
197 $this->hasTop = 'top';
198 $this->hasTransactions = false;
199 $this->replaceQuote = "'+chr(39)+'";
201 $this->false = '.F.';
202 $this->upperCase = 'upper';
204 case ODB_DRIVER_ORACLE:
205 $this->fmtDate = "'Y-m-d 00:00:00'";
206 $this->fmtTimeStamp = "'Y-m-d h:i:sA'";
207 $this->sysDate = 'TRUNC(SYSDATE)';
208 $this->sysTimeStamp = 'SYSDATE';
209 $this->hasTransactions = true;
210 $this->_bindInputArray = true;
211 $this->concat_operator = '||';
213 case ODB_DRIVER_SYBASE:
214 $this->fmtDate = "'Y-m-d'";
215 $this->fmtTimeStamp = "'Y-m-d H:i:s'";
216 $this->sysDate = 'GetDate()';
217 $this->sysTimeStamp = 'GetDate()';
218 $this->leftOuter = '*=';
219 $this->rightOuter = '=*';
220 $this->hasInsertID = true;
221 $this->hasTransactions = true;
222 $this->upperCase = 'upper';
223 $this->identitySQL = 'select @@IDENTITY';
226 if( @odbtp_get_attr(ODB_ATTR_TXNCAPABLE, $this->_connectionID) )
227 $this->hasTransactions = true;
229 $this->hasTransactions = false;
231 @odbtp_set_attr(ODB_ATTR_FULLCOLINFO, TRUE, $this->_connectionID );
232 if ($this->_useUnicodeSQL )
233 @odbtp_set_attr(ODB_ATTR_UNICODESQL, TRUE, $this->_connectionID);
237 function _pconnect($HostOrInterface, $UserOrDSN='', $argPassword='', $argDatabase='')
239 return $this->_connect($HostOrInterface, $UserOrDSN, $argPassword, $argDatabase);
242 function SelectDB($dbName)
244 if (!@odbtp_select_db($dbName, $this->_connectionID)) {
247 $this->databaseName = $dbName;
251 function &MetaTables($ttype='',$showSchema=false,$mask=false)
253 global $ADODB_FETCH_MODE;
255 $savem = $ADODB_FETCH_MODE;
256 $ADODB_FETCH_MODE = ADODB_FETCH_NUM;
257 $arr =& $this->GetArray("||SQLTables||||$ttype");
258 $ADODB_FETCH_MODE = $savem;
261 for ($i=0; $i < sizeof($arr); $i++) {
262 if ($arr[$i][3] == 'SYSTEM TABLE' ) continue;
264 $arr2[] = $showSchema ? $arr[$i][1].'.'.$arr[$i][2] : $arr[$i][2];
269 function &MetaColumns($table,$upper=true)
271 global $ADODB_FETCH_MODE;
274 $this->_findschema($table,$schema);
275 if ($upper) $table = strtoupper($table);
277 $savem = $ADODB_FETCH_MODE;
278 $ADODB_FETCH_MODE = ADODB_FETCH_NUM;
279 $rs = $this->Execute( "||SQLColumns||$schema|$table" );
280 $ADODB_FETCH_MODE = $savem;
282 if (!$rs) return false;
285 //print_r($rs->fields);
286 if (strtoupper($rs->fields[2]) == $table) {
287 $fld = new ADOFieldObject();
288 $fld->name = $rs->fields[3];
289 $fld->type = $rs->fields[5];
290 $fld->max_length = $rs->fields[6];
291 $fld->not_null = !empty($rs->fields[9]);
292 $fld->scale = $rs->fields[7];
293 if (!is_null($rs->fields[12])) {
294 $fld->has_default = true;
295 $fld->default_value = $rs->fields[12];
297 $retarr[strtoupper($fld->name)] = $fld;
298 } elseif (sizeof($retarr)>0)
307 function &MetaPrimaryKeys($table, $owner='')
309 global $ADODB_FETCH_MODE;
311 $savem = $ADODB_FETCH_MODE;
312 $ADODB_FETCH_MODE = ADODB_FETCH_NUM;
313 $arr =& $this->GetArray("||SQLPrimaryKeys||$owner|$table");
314 $ADODB_FETCH_MODE = $savem;
318 for ($i=0; $i < sizeof($arr); $i++) {
319 if ($arr[$i][3]) $arr2[] = $arr[$i][3];
324 function &MetaForeignKeys($table, $owner='', $upper=false)
326 global $ADODB_FETCH_MODE;
328 $savem = $ADODB_FETCH_MODE;
329 $ADODB_FETCH_MODE = ADODB_FETCH_NUM;
330 $constraints =& $this->GetArray("||SQLForeignKeys|||||$owner|$table");
331 $ADODB_FETCH_MODE = $savem;
334 foreach($constraints as $constr) {
336 $arr[$constr[11]][$constr[2]][] = $constr[7].'='.$constr[3];
338 if (!$arr) return false;
342 foreach($arr as $k => $v) {
343 foreach($v as $a => $b) {
344 if ($upper) $a = strtoupper($a);
351 function BeginTrans()
353 if (!$this->hasTransactions) return false;
354 if ($this->transOff) return true;
355 $this->transCnt += 1;
356 $this->_autocommit = false;
357 $rs = @odbtp_set_attr(ODB_ATTR_TRANSACTIONS,ODB_TXN_READUNCOMMITTED,$this->_connectionID);
358 if(!$rs) return false;
362 function CommitTrans($ok=true)
364 if ($this->transOff) return true;
365 if (!$ok) return $this->RollbackTrans();
366 if ($this->transCnt) $this->transCnt -= 1;
367 $this->_autocommit = true;
368 if( ($ret = odbtp_commit($this->_connectionID)) )
369 $ret = @odbtp_set_attr(ODB_ATTR_TRANSACTIONS, ODB_TXN_NONE, $this->_connectionID);//set transaction off
373 function RollbackTrans()
375 if ($this->transOff) return true;
376 if ($this->transCnt) $this->transCnt -= 1;
377 $this->_autocommit = true;
378 if( ($ret = odbtp_rollback($this->_connectionID)) )
379 $ret = @odbtp_set_attr(ODB_ATTR_TRANSACTIONS, ODB_TXN_NONE, $this->_connectionID);//set transaction off
383 function &SelectLimit($sql,$nrows=-1,$offset=-1, $inputarr=false,$secs2cache=0)
385 // TOP requires ORDER BY for Visual FoxPro
386 if( $this->odbc_driver == ODB_DRIVER_FOXPRO ) {
387 if (!preg_match('/ORDER[ \t\r\n]+BY/is',$sql)) $sql .= ' ORDER BY 1';
389 return ADOConnection::SelectLimit($sql,$nrows,$offset,$inputarr,$secs2cache);
392 function Prepare($sql)
394 if (! $this->_bindInputArray) return $sql; // no binding
395 $stmt = odbtp_prepare($sql,$this->_connectionID);
397 // print "Prepare Error for ($sql) ".$this->ErrorMsg()."<br>";
400 return array($sql,$stmt,false);
403 function PrepareSP($sql)
405 if (!$this->_canPrepareSP) return $sql; // Can't prepare procedures
407 $stmt = odbtp_prepare_proc($sql,$this->_connectionID);
408 if (!$stmt) return false;
409 return array($sql,$stmt);
414 $stmt = $db->PrepareSP('SP_RUNSOMETHING'); -- takes 2 params, @myid and @group
416 # note that the parameter does not have @ in front!
417 $db->Parameter($stmt,$id,'myid');
418 $db->Parameter($stmt,$group,'group',false,64);
419 $db->Parameter($stmt,$group,'photo',false,100000,ODB_BINARY);
422 @param $stmt Statement returned by Prepare() or PrepareSP().
423 @param $var PHP variable to bind to. Can set to null (for isNull support).
424 @param $name Name of stored procedure variable name to bind to.
425 @param [$isOutput] Indicates direction of parameter 0/false=IN 1=OUT 2= IN/OUT. This is ignored in odbtp.
426 @param [$maxLen] Holds an maximum length of the variable.
427 @param [$type] The data type of $var. Legal values depend on driver.
429 See odbtp_attach_param documentation at http://odbtp.sourceforge.net.
431 function Parameter(&$stmt, &$var, $name, $isOutput=false, $maxLen=0, $type=0)
433 if ( $this->odbc_driver == ODB_DRIVER_JET ) {
434 $name = '['.$name.']';
435 if( !$type && $this->_useUnicodeSQL
436 && @odbtp_param_bindtype($stmt[1], $name) == ODB_CHAR )
444 return odbtp_attach_param($stmt[1], $name, $var, $type, $maxLen);
448 Insert a null into the blob field of the table first.
449 Then use UpdateBlob to store the blob.
453 $conn->Execute('INSERT INTO blobtable (id, blobcol) VALUES (1, null)');
454 $conn->UpdateBlob('blobtable','blobcol',$blob,'id=1');
457 function UpdateBlob($table,$column,$val,$where,$blobtype='image')
459 $sql = "UPDATE $table SET $column = ? WHERE $where";
460 if( !($stmt = odbtp_prepare($sql, $this->_connectionID)) )
462 if( !odbtp_input( $stmt, 1, ODB_BINARY, 1000000, $blobtype ) )
464 if( !odbtp_set( $stmt, 1, $val ) )
466 return odbtp_execute( $stmt ) != false;
469 function IfNull( $field, $ifNull )
471 switch( $this->odbc_driver ) {
472 case ODB_DRIVER_MSSQL:
473 return " ISNULL($field, $ifNull) ";
475 return " IIF(IsNull($field), $ifNull, $field) ";
477 return " CASE WHEN $field is null THEN $ifNull ELSE $field END ";
480 function _query($sql,$inputarr=false)
483 if (is_array($sql)) {
486 $stmtid = odbtp_prepare($sql,$this->_connectionID);
487 if ($stmtid == false) {
488 $this->_errorMsg = $php_errormsg;
492 $num_params = odbtp_num_params( $stmtid );
493 for( $param = 1; $param <= $num_params; $param++ ) {
494 @odbtp_input( $stmtid, $param );
495 @odbtp_set( $stmtid, $param, $inputarr[$param-1] );
497 if (! odbtp_execute($stmtid) ) {
500 } elseif (is_array($sql)) {
502 if (!odbtp_execute($stmtid)) {
506 $stmtid = @odbtp_query($sql,$this->_connectionID);
508 $this->_lastAffectedRows = 0;
510 $this->_lastAffectedRows = @odbtp_affected_rows($stmtid);
517 $ret = @odbtp_close($this->_connectionID);
518 $this->_connectionID = false;
523 class ADORecordSet_odbtp extends ADORecordSet {
525 var $databaseType = 'odbtp';
528 function ADORecordSet_odbtp($queryID,$mode=false)
530 if ($mode === false) {
531 global $ADODB_FETCH_MODE;
532 $mode = $ADODB_FETCH_MODE;
534 $this->fetchMode = $mode;
535 $this->ADORecordSet($queryID);
540 $this->_numOfFields = @odbtp_num_fields($this->_queryID);
541 if (!($this->_numOfRows = @odbtp_num_rows($this->_queryID)))
542 $this->_numOfRows = -1;
545 function &FetchField($fieldOffset = 0)
547 $off=$fieldOffset; // offsets begin at 0
548 $o= new ADOFieldObject();
549 $o->name = @odbtp_field_name($this->_queryID,$off);
550 $o->type = @odbtp_field_type($this->_queryID,$off);
551 $o->max_length = @odbtp_field_length($this->_queryID,$off);
552 if (ADODB_ASSOC_CASE == 0) $o->name = strtolower($o->name);
553 else if (ADODB_ASSOC_CASE == 1) $o->name = strtoupper($o->name);
559 return @odbtp_data_seek($this->_queryID, $row);
562 function fields($colname)
564 if ($this->fetchMode & ADODB_FETCH_ASSOC) return $this->fields[$colname];
567 $this->bind = array();
568 for ($i=0; $i < $this->_numOfFields; $i++) {
569 $name = @odbtp_field_name( $this->_queryID, $i );
570 $this->bind[strtoupper($name)] = $i;
573 return $this->fields[$this->bind[strtoupper($colname)]];
576 function _fetch_odbtp($type=0)
578 switch ($this->fetchMode) {
579 case ADODB_FETCH_NUM:
580 $this->fields = @odbtp_fetch_row($this->_queryID, $type);
582 case ADODB_FETCH_ASSOC:
583 $this->fields = @odbtp_fetch_assoc($this->_queryID, $type);
586 $this->fields = @odbtp_fetch_array($this->_queryID, $type);
588 return is_array($this->fields);
593 return $this->_fetch_odbtp();
598 if (!$this->_fetch_odbtp(ODB_FETCH_FIRST)) return false;
600 $this->_currentRow = 0;
606 if (!$this->_fetch_odbtp(ODB_FETCH_LAST)) return false;
608 $this->_currentRow = $this->_numOfRows - 1;
612 function NextRecordSet()
614 if (!@odbtp_next_result($this->_queryID)) return false;
615 $this->_inited = false;
617 $this->_currentRow = -1;
624 return @odbtp_free_query($this->_queryID);