See Release Notes
Long Term Support Release
<?php /** * Firebird driver. * * Requires firebird client. Works on Windows and Unix. * * This file is part of ADOdb, a Database Abstraction Layer library for PHP. * * @package ADOdb * @link https://adodb.org Project's web site and documentation * @link https://github.com/ADOdb/ADOdb Source code and issue tracker * * The ADOdb Library is dual-licensed, released under both the BSD 3-Clause * and the GNU Lesser General Public Licence (LGPL) v2.1 or, at your option, * any later version. This means you can use it in proprietary products. * See the LICENSE.md file distributed with this source code for details. * @license BSD-3-Clause * @license LGPL-2.1-or-later * * @copyright 2000-2013 John Lim * @copyright 2014 Damien Regad, Mark Newnham and the ADOdb community> * */ > * Driver was cloned from Interbase, so there's quite a lot of duplicated code > * @noinspection DuplicatedCode // security - hide paths > * @noinspection PhpUnusedif (!defined('ADODB_DIR')) die(); class ADODB_firebird extends ADOConnection { var $databaseType = "firebird"; var $dataProvider = "firebird"; var $replaceQuote = "''"; // string to use to replace quotes var $fbird_datefmt = '%Y-%m-%d'; // For hours,mins,secs change to '%Y-%m-%d %H:%M:%S'; var $fmtDate = "'Y-m-d'"; var $fbird_timestampfmt = "%Y-%m-%d %H:%M:%S"; var $fbird_timefmt = "%H:%M:%S"; var $fmtTimeStamp = "'Y-m-d, H:i:s'"; var $concat_operator='||'; var $_transactionID;< var $metaTablesSQL = "select lower(rdb\$relation_name) from rdb\$relations where rdb\$relation_name not like 'RDB\$%'";> > public $metaTablesSQL = "SELECT LOWER(rdb\$relation_name) FROM rdb\$relations";//OPN STUFF start>var $metaColumnsSQL = "select lower(a.rdb\$field_name), a.rdb\$null_flag, a.rdb\$default_source, b.rdb\$field_length, b.rdb\$field_scale, b.rdb\$field_sub_type, b.rdb\$field_precision, b.rdb\$field_type from rdb\$relation_fields a, rdb\$fields b where a.rdb\$field_source = b.rdb\$field_name and a.rdb\$relation_name = '%s' order by a.rdb\$field_position asc"; //OPN STUFF end< var $ibasetrans;> > public $_genSeqSQL = "CREATE SEQUENCE %s START WITH %s"; > > public $_dropSeqSQL = "DROP SEQUENCE %s"; >var $hasGenID = true; var $_bindInputArray = true;< var $buffers = 0; < var $dialect = 3;var $sysDate = "cast('TODAY' as timestamp)"; var $sysTimeStamp = "CURRENT_TIMESTAMP"; //"cast('NOW' as timestamp)"; var $ansiOuter = true; var $hasAffectedRows = true; var $poorAffectedRows = false; var $blobEncodeType = 'C';< var $role = false;> /* > * firebird custom optionally specifies the user role > */ > public $role = false; > /* > * firebird custom optionally specifies the connection buffers > */ > public $buffers = 0; > > /* > * firebird custom optionally specifies database dialect > */ > public $dialect = 3; >var $nameQuote = ''; /// string to use to quote identifiers and names function __construct() {< // Ignore IBASE_DEFAULT we want a more practical transaction! < // if (defined('IBASE_DEFAULT')) $this->ibasetrans = IBASE_DEFAULT; < // else < $this->ibasetrans = IBASE_WAIT | IBASE_REC_VERSION | IBASE_COMMITTED;> parent::__construct(); > $this->setTransactionMode('');}> /** > * Sets the isolation level of a transaction. // returns true or false > * function _connect($argHostname, $argUsername, $argPassword, $argDatabasename,$persist=false) > * The default behavior is a more practical IBASE_WAIT | IBASE_REC_VERSION | IBASE_COMMITTED { > * instead of IBASE_DEFAULT if (!function_exists('fbird_pconnect')) return null; > * if ($argDatabasename) $argHostname .= ':'.$argDatabasename; > * @link https://adodb.org/dokuwiki/doku.php?id=v5:reference:connection:settransactionmode $fn = ($persist) ? 'fbird_pconnect':'fbird_connect'; > * if ($this->role) > * @param string $transaction_mode The transaction mode to set. $this->_connectionID = $fn($argHostname,$argUsername,$argPassword, > * $this->charSet,$this->buffers,$this->dialect,$this->role); > * @return void else > */ $this->_connectionID = $fn($argHostname,$argUsername,$argPassword, > public function setTransactionMode($transaction_mode) $this->charSet,$this->buffers,$this->dialect); > { > $this->_transmode = $transaction_mode;< // returns true or false < function _connect($argHostname, $argUsername, $argPassword, $argDatabasename,$persist=false)> if (empty($transaction_mode)) { > $this->_transmode = IBASE_WAIT | IBASE_REC_VERSION | IBASE_COMMITTED; > } > > } > > /** > * Connect to a database. > * > * @todo add: parameter int $port, parameter string $socket > * > * @param string|null $argHostname (Optional) The host to connect to. > * @param string|null $argUsername (Optional) The username to connect as. > * @param string|null $argPassword (Optional) The password to connect with. > * @param string|null $argDatabasename (Optional) The name of the database to start in when connected. > * @param bool $persist (Optional) Whether or not to use a persistent connection. > * > * @return bool|null True if connected successfully, false if connection failed, or null if the mysqli extension > * isn't currently loaded. > */ > public function _connect($argHostname, $argUsername, $argPassword, $argDatabasename,$persist=false)< if (!function_exists('fbird_pconnect')) return null; < if ($argDatabasename) $argHostname .= ':'.$argDatabasename;> if (!function_exists('fbird_pconnect')) > return null; > > if ($argDatabasename) > $argHostname .= ':'.$argDatabasename; >$this->_handleerror();> return false; > /* } > * Now merge in the standard connection parameters setting > */ // PHP5 change. > foreach ($this->connectionParameters as $options) if (function_exists('fbird_timefmt')) { > { fbird_timefmt($this->fbird_datefmt,fbird_DATE ); > foreach($options as $k=>$v) if ($this->dialect == 1) { > { fbird_timefmt($this->fbird_datefmt,fbird_TIMESTAMP ); > switch($k){ } else { > case 'role': fbird_timefmt($this->fbird_timestampfmt,fbird_TIMESTAMP ); > $this->role = $v; } > break; fbird_timefmt($this->fbird_timefmt,fbird_TIME ); > case 'dialect': > $this->dialect = $v; } else { > break; ini_set("ibase.timestampformat", $this->fbird_timestampfmt); > case 'buffers': ini_set("ibase.dateformat", $this->fbird_datefmt); > $this->buffers = $v; ini_set("ibase.timeformat", $this->fbird_timefmt); > } } > } return true; > } } >< if ($this->dialect != 1) { // http://www.ibphoenix.com/ibp_60_del_id_ds.html < $this->replaceQuote = "''";> if ($this->dialect == 1) { // http://www.ibphoenix.com/ibp_60_del_id_ds.html > $this->replaceQuote = "";< $this->_handleerror();> $this->_handleError();< // PHP5 change. < if (function_exists('fbird_timefmt')) { < fbird_timefmt($this->fbird_datefmt,fbird_DATE ); < if ($this->dialect == 1) { < fbird_timefmt($this->fbird_datefmt,fbird_TIMESTAMP ); < } else { < fbird_timefmt($this->fbird_timestampfmt,fbird_TIMESTAMP ); < } < fbird_timefmt($this->fbird_timefmt,fbird_TIME ); < < } else {< }>< // returns true or false> /** > * Connect to a database with a persistent connection. > * > * @param string|null $argHostname The host to connect to. > * @param string|null $argUsername The username to connect as. > * @param string|null $argPassword The password to connect with. > * @param string|null $argDatabasename The name of the database to start in when connected. > * > * @return bool|null True if connected successfully, false if connection failed, or null if the mysqli extension > * isn't currently loaded. > */< function MetaPrimaryKeys($table,$owner_notused=false,$internalKey=false)> public function metaPrimaryKeys($table,$owner_notused=false,$internalKey=false)FROM RDB$INDICES I JOIN RDB$INDEX_SEGMENTS S ON I.RDB$INDEX_NAME=S.RDB$INDEX_NAME WHERE I.RDB$RELATION_NAME=\''.$table.'\' and I.RDB$INDEX_NAME like \'RDB$PRIMARY%\' ORDER BY I.RDB$INDEX_NAME,S.RDB$FIELD_POSITION'; $a = $this->GetCol($sql,false,true); if ($a && sizeof($a)>0) return $a; return false; }< function ServerInfo()> /** > * Get information about the current Firebird server. > * > * @return array > */ > public function serverInfo(){ $arr['dialect'] = $this->dialect; switch($arr['dialect']) { case '':< case '1': $s = 'Firebird Dialect 1'; break; < case '2': $s = 'Firebird Dialect 2'; break;> case '1': > $s = 'Firebird Dialect 1'; > break; > case '2': > $s = 'Firebird Dialect 2'; > break;default:< case '3': $s = 'Firebird Dialect 3'; break;> case '3': > $s = 'Firebird Dialect 3'; > break;} $arr['version'] = ADOConnection::_findvers($s); $arr['description'] = $s; return $arr; }< function BeginTrans()> /** > * Begin a Transaction. Must be followed by CommitTrans() or RollbackTrans(). > * > * @return bool true if succeeded or false if database does not support transactions > */ > public function beginTrans(){ if ($this->transOff) return true; $this->transCnt += 1; $this->autoCommit = false;< $this->_transactionID = fbird_trans( $this->ibasetrans, $this->_connectionID );> /* > * We manage the transaction mode via fbird_trans > */ > $this->_transactionID = fbird_trans( $this->_transmode, $this->_connectionID );return $this->_transactionID; }< function CommitTrans($ok=true)> > /** > * Commits a transaction. > * > * @param bool $ok false to rollback transaction, true to commit > * > * @return bool > */ > public function commitTrans($ok=true){ if (!$ok) { return $this->RollbackTrans(); } if ($this->transOff) { return true; } if ($this->transCnt) { $this->transCnt -= 1; } $ret = false; $this->autoCommit = true; if ($this->_transactionID) {< //print ' commit ';$ret = fbird_commit($this->_transactionID); } $this->_transactionID = false; return $ret; } function _affectedrows() {< return fbird_affected_rows( $this->_transactionID ? $this->_transactionID : $this->_connectionID );> return fbird_affected_rows($this->_transactionID ?: $this->_connectionID);}< // there are some compat problems with ADODB_COUNTRECS=false and $this->_logsql currently. < // it appears that ibase extension cannot support multiple concurrent queryid's < function _Execute($sql,$inputarr=false) { < global $ADODB_COUNTRECS; < < if ($this->_logsql) { < $savecrecs = $ADODB_COUNTRECS; < $ADODB_COUNTRECS = true; // force countrecs < $ret =& ADOConnection::_Execute($sql,$inputarr); < $ADODB_COUNTRECS = $savecrecs; < } else { < $ret = ADOConnection::_Execute($sql,$inputarr); < } < return $ret; < } < < function RollbackTrans()> /** > * Rollback a smart transaction. > * > * @link https://adodb.org/dokuwiki/doku.php?id=v5:reference:connection:rollbacktrans > * > * @return bool > */ > public function rollbackTrans(){< if ($this->transOff) return true; < if ($this->transCnt) $this->transCnt -= 1;> if ($this->transOff) > return true; > if ($this->transCnt) > $this->transCnt -= 1; >$ret = false; $this->autoCommit = true;>if ($this->_transactionID) { $ret = fbird_rollback($this->_transactionID); } $this->_transactionID = false; return $ret; }< function &MetaIndexes ($table, $primary = FALSE, $owner=false)> /** > * Get a list of indexes on the specified table. > * > * @param string $table The name of the table to get indexes for. > * @param bool $primary (Optional) Whether or not to include the primary key. > * @param bool $owner (Optional) Unused. > * > * @return array|bool An array of the indexes, or false if the query to get the indexes failed. > */ > public function metaIndexes($table, $primary = false, $owner = false){ // save old fetch mode global $ADODB_FETCH_MODE;< $false = false;$save = $ADODB_FETCH_MODE; $ADODB_FETCH_MODE = ADODB_FETCH_NUM;>if ($this->fetchMode !== FALSE) { $savem = $this->SetFetchMode(FALSE); }>$table = strtoupper($table); $sql = "SELECT * FROM RDB\$INDICES WHERE RDB\$RELATION_NAME = '".$table."'"; if (!$primary) { $sql .= " AND RDB\$INDEX_NAME NOT LIKE 'RDB\$%'"; } else { $sql .= " AND RDB\$INDEX_NAME NOT LIKE 'RDB\$FOREIGN%'"; } // get index details< $rs = $this->Execute($sql);> $rs = $this->execute($sql);if (!is_object($rs)) { // restore fetchmode if (isset($savem)) { $this->SetFetchMode($savem); } $ADODB_FETCH_MODE = $save;< return $false;> return false;}<$indexes = array(); while ($row = $rs->FetchRow()) {< $index = $row[0];> > $index = trim($row[0]);if (!isset($indexes[$index])) { if (is_null($row[3])) { $row[3] = 0; } $indexes[$index] = array( 'unique' => ($row[3] == 1), 'columns' => array() ); }< $sql = "SELECT * FROM RDB\$INDEX_SEGMENTS WHERE RDB\$INDEX_NAME = '".$index."' ORDER BY RDB\$FIELD_POSITION ASC"; < $rs1 = $this->Execute($sql);> $sql = sprintf("SELECT * FROM RDB\$INDEX_SEGMENTS WHERE RDB\$INDEX_NAME = '%s' ORDER BY RDB\$FIELD_POSITION ASC",$index); > $rs1 = $this->execute($sql);while ($row1 = $rs1->FetchRow()) {< $indexes[$index]['columns'][$row1[2]] = $row1[1];> $indexes[$index]['columns'][$row1[2]] = trim($row1[1]);} }>// restore fetchmode if (isset($savem)) { $this->SetFetchMode($savem); } $ADODB_FETCH_MODE = $save; return $indexes; }< < // See http://community.borland.com/article/0,1410,25844,00.html < function RowLock($tables,$where,$col=false)> /** > * Lock a table row for a duration of a transaction. > * > * @link https://adodb.org/dokuwiki/doku.php?id=v5:reference:connection:rowlock > * @link https://firebirdsql.org/refdocs/langrefupd21-notes-withlock.html > * > * @param string $table The table(s) to lock rows for. > * @param string $where (Optional) The WHERE clause to use to determine which rows to lock. > * @param string $col (Optional) The columns to select. > * > * @return bool True if the locking SQL statement executed successfully, otherwise false. > */ > public function rowLock($table,$where,$col=false){< if ($this->autoCommit) { < $this->BeginTrans(); < } < $this->Execute("UPDATE $table SET $col=$col WHERE $where "); // is this correct - jlim? < return 1; < } <> if ($this->transCnt==0) > $this->beginTrans();< function CreateSequence($seqname = 'adodbseq', $startID = 1) < { < $ok = $this->Execute(("CREATE GENERATOR $seqname" )); < if (!$ok) return false; < return $this->Execute("SET GENERATOR $seqname TO ".($startID-1));> if ($where) $where = ' where '.$where; > $rs = $this->execute("SELECT $col FROM $table $where FOR UPDATE WITH LOCK"); > return !empty($rs);}< function DropSequence($seqname = 'adodbseq')> /** > * Creates a sequence in the database. > * > * @link https://adodb.org/dokuwiki/doku.php?id=v5:reference:connection:createsequence > * > * @param string $seqname The sequence name. > * @param int $startID The start id. > * > * @return ADORecordSet|bool A record set if executed successfully, otherwise false. > */ > public function createSequence($seqname='adodbseq', $startID = 1){< $seqname = strtoupper($seqname); < return $this->Execute("DROP GENERATOR $seqname");> $sql = sprintf($this->_genSeqSQL,$seqname,$startID); > return $this->execute($sql);}< function GenID($seqname='adodbseq',$startID=1)> /** > * A portable method of creating sequence numbers. > * > * @link https://adodb.org/dokuwiki/doku.php?id=v5:reference:connection:genid > * > * @param string $seqname (Optional) The name of the sequence to use. > * @param int $startID (Optional) The point to start at in the sequence. > * > * @return int > */ > public function genID($seqname='adodbseq',$startID=1){ $getnext = ("SELECT Gen_ID($seqname,1) FROM RDB\$DATABASE"); $rs = @$this->Execute($getnext); if (!$rs) {< $this->Execute(("CREATE GENERATOR $seqname" )); < $this->Execute("SET GENERATOR $seqname TO ".($startID-1).';');> $this->Execute("CREATE SEQUENCE $seqname START WITH $startID");$rs = $this->Execute($getnext); } if ($rs && !$rs->EOF) { $this->genID = (integer) reset($rs->fields); } else { $this->genID = 0; // false } if ($rs) { $rs->Close(); } return $this->genID; }< function SelectDB($dbName)> function selectDB($dbName){ return false; }< function _handleerror()> function _handleError(){> $this->_errorCode = fbird_errcode();$this->_errorMsg = fbird_errmsg(); }< function ErrorNo()> > public function errorNo(){< if (preg_match('/error code = ([\-0-9]*)/i', $this->_errorMsg,$arr)) return (integer) $arr[1]; < else return 0;> return (integer) $this->_errorCode;}< function ErrorMsg()> function errorMsg(){ return $this->_errorMsg; }< function Prepare($sql)> /** > * Prepares an SQL statement and returns a handle to use. > * This is not used by bound parameters anymore > * > * @link https://adodb.org/dokuwiki/doku.php?id=v5:reference:connection:prepare > * @todo update this function to handle prepared statements correctly > * > * @param string $sql The SQL to prepare. > * > * @return bool|array The SQL that was provided and the prepared parameters, > * or false if the preparation fails > */ > public function prepare($sql){ $stmt = fbird_prepare($this->_connectionID,$sql);< if (!$stmt) return false;> if (!$stmt) > return false;return array($sql,$stmt); }< // returns query ID if successful, otherwise false < // there have been reports of problems with nested queries - the code is probably not re-entrant?> /** > * Return the query id. > * > * @param string|array $sql > * @param array $iarr > * > * @return bool|object > */function _query($sql,$iarr=false) {< if ( !$this->isConnected() ) return false;> if (!$this->isConnected()) { > return false; > } >if (!$this->autoCommit && $this->_transactionID) { $conn = $this->_transactionID; $docommit = false; } else { $conn = $this->_connectionID; $docommit = true; }>if (is_array($sql)) {> // Prepared statement$fn = 'fbird_execute';< $sql = $sql[1]; < if (is_array($iarr)) { < if ( !isset($iarr[0]) ) < $iarr[0] = ''; // PHP5 compat hack < $fnarr = array_merge( array($sql) , $iarr); < $ret = call_user_func_array($fn,$fnarr); < } < else { < $ret = $fn($sql); < }> $args = [$sql[1]];} else { $fn = 'fbird_query';< if (is_array($iarr)) < { < if (sizeof($iarr) == 0) < $iarr[0] = ''; // PHP5 compat hack < $fnarr = array_merge( array($conn,$sql) , $iarr); < $ret = call_user_func_array($fn,$fnarr); < } < else { < $ret = $fn($conn, $sql);> $args = [$conn, $sql];}> if (is_array($iarr)) { } > $args = array_merge($args, $iarr);if ($docommit && $ret === true) {> $ret = call_user_func_array($fn, $args); fbird_commit($this->_connectionID); >}< $this->_handleerror();> $this->_handleError();return $ret; } // returns true or false function _close() { if (!$this->autoCommit) { @fbird_rollback($this->_connectionID); } return @fbird_close($this->_connectionID); } //OPN STUFF start function _ConvertFieldType(&$fld, $ftype, $flen, $fscale, $fsubtype, $fprecision, $dialect3) { $fscale = abs($fscale); $fld->max_length = $flen; $fld->scale = null; switch($ftype){ case 7: case 8: if ($dialect3) { switch($fsubtype){ case 0: $fld->type = ($ftype == 7 ? 'smallint' : 'integer'); break; case 1: $fld->type = 'numeric'; $fld->max_length = $fprecision; $fld->scale = $fscale; break; case 2: $fld->type = 'decimal'; $fld->max_length = $fprecision; $fld->scale = $fscale; break; } // switch } else { if ($fscale !=0) { $fld->type = 'decimal'; $fld->scale = $fscale; $fld->max_length = ($ftype == 7 ? 4 : 9); } else { $fld->type = ($ftype == 7 ? 'smallint' : 'integer'); } } break; case 16: if ($dialect3) { switch($fsubtype){ case 0: $fld->type = 'decimal'; $fld->max_length = 18; $fld->scale = 0; break; case 1: $fld->type = 'numeric'; $fld->max_length = $fprecision; $fld->scale = $fscale; break; case 2: $fld->type = 'decimal'; $fld->max_length = $fprecision; $fld->scale = $fscale; break; } // switch } break; case 10: $fld->type = 'float'; break; case 14: $fld->type = 'char'; break; case 27: if ($fscale !=0) { $fld->type = 'decimal'; $fld->max_length = 15; $fld->scale = 5; } else { $fld->type = 'double'; } break; case 35: if ($dialect3) { $fld->type = 'timestamp'; } else { $fld->type = 'date'; } break; case 12: $fld->type = 'date'; break; case 13: $fld->type = 'time'; break; case 37: $fld->type = 'varchar'; break; case 40: $fld->type = 'cstring'; break; case 261: $fld->type = 'blob'; $fld->max_length = -1; break; } // switch } //OPN STUFF end< // returns array of ADOFieldObjects for current table < function MetaColumns($table, $normalize=true)> /** > * Return an array of information about a table's columns. > * > * @param string $table The name of the table to get the column info for. > * @param bool $normalize (Optional) Unused. > * > * @return ADOFieldObject[]|bool An array of info for each column, > * or false if it could not determine the info. > */ > public function metaColumns($table, $normalize = true){>global $ADODB_FETCH_MODE; $save = $ADODB_FETCH_MODE; $ADODB_FETCH_MODE = ADODB_FETCH_NUM;< $rs = $this->Execute(sprintf($this->metaColumnsSQL,strtoupper($table)));> $rs = $this->execute(sprintf($this->metaColumnsSQL,strtoupper($table)));$ADODB_FETCH_MODE = $save;< $false = false;>if ($rs === false) {< return $false;> return false;} $retarr = array(); //OPN STUFF start< $dialect3 = ($this->dialect==3 ? true : false);> $dialect3 = $this->dialect == 3;//OPN STUFF end while (!$rs->EOF) { //print_r($rs->fields); $fld = new ADOFieldObject(); $fld->name = trim($rs->fields[0]); //OPN STUFF start< $this->_ConvertFieldType($fld, $rs->fields[7], $rs->fields[3], $rs->fields[4], $rs->fields[5], $rs->fields[6], $dialect3);> //print_r($rs->fields); > $this->_ConvertFieldType( > $fld, $rs->fields[7], $rs->fields[3], $rs->fields[4], $rs->fields[5], $rs->fields[6], $dialect3);if (isset($rs->fields[1]) && $rs->fields[1]) { $fld->not_null = true; } if (isset($rs->fields[2])) { $fld->has_default = true; $d = substr($rs->fields[2],strlen('default '));< switch ($fld->type) < {> switch ($fld->type) {case 'smallint':< case 'integer': $fld->default_value = (int) $d; break;> case 'integer': > $fld->default_value = (int)$d; > break;case 'char': case 'blob': case 'text':< case 'varchar': $fld->default_value = (string) substr($d,1,strlen($d)-2); break;> case 'varchar': > $fld->default_value = (string)substr($d, 1, strlen($d) - 2); > break;case 'double':< case 'float': $fld->default_value = (float) $d; break; < default: $fld->default_value = $d; break;> case 'float': > $fld->default_value = (float)$d; > break; > default: > $fld->default_value = $d; > break;} // case 35:$tt = 'TIMESTAMP'; break; } if ((isset($rs->fields[5])) && ($fld->type == 'blob')) { $fld->sub_type = $rs->fields[5]; } else { $fld->sub_type = null; } //OPN STUFF end if ($ADODB_FETCH_MODE == ADODB_FETCH_NUM) $retarr[] = $fld; else $retarr[strtoupper($fld->name)] = $fld; $rs->MoveNext(); } $rs->Close();< if ( empty($retarr)) return $false;> if ( empty($retarr)) > return false;else return $retarr; }< function BlobEncode( $blob )> /** > * Retrieves a list of tables based on given criteria > * > * @param string|bool $ttype (Optional) Table type = 'TABLE', 'VIEW' or false=both (default) > * @param string|bool $showSchema (Optional) schema name, false = current schema (default) > * @param string|bool $mask (Optional) filters the table by name > * > * @return array list of tables > */ > public function metaTables($ttype = false, $showSchema = false, $mask = false) > { > $save = $this->metaTablesSQL; > if (!$showSchema) { > $this->metaTablesSQL .= " WHERE (rdb\$relation_name NOT LIKE 'RDB\$%' AND rdb\$relation_name NOT LIKE 'MON\$%' AND rdb\$relation_name NOT LIKE 'SEC\$%')"; > } elseif (is_string($showSchema)) { > $this->metaTablesSQL .= $this->qstr($showSchema); > } > > if ($mask) { > $mask = $this->qstr($mask); > $this->metaTablesSQL .= " AND table_name LIKE $mask"; > } > $ret = ADOConnection::metaTables($ttype,$showSchema); > > $this->metaTablesSQL = $save; > return $ret; > } > > /** > * Encodes a blob, then assigns an id ready to be used > * > * @param string $blob The blob to be encoded > * > * @return bool success > */ > public function blobEncode( $blob ){ $blobid = fbird_blob_create( $this->_connectionID); fbird_blob_add( $blobid, $blob ); return fbird_blob_close( $blobid ); }< // since we auto-decode all blob's since 2.42, < // BlobDecode should not do any transforms < function BlobDecode($blob)> /** > * Manually decode a blob > * > * since we auto-decode all blob's since 2.42, > * BlobDecode should not do any transforms > * > * @param string $blob > * > * @return string the same blob > */ > public function blobDecode($blob){ return $blob; }< // old blobdecode function < // still used to auto-decode all blob's < function _BlobDecode_old( $blob )> /** > * Auto function called on read of blob to decode > * > * @param string $blob Value to decode > * > * @return string Decoded blob > */ > public function _blobDecode($blob){< $blobid = fbird_blob_open($this->_connectionID, $blob ); < $realblob = fbird_blob_get( $blobid,$this->maxblobsize); // 2nd param is max size of blob -- Kevin Boillet <kevinboillet@yahoo.fr> < while($string = fbird_blob_get($blobid, 8192)){ < $realblob .= $string;> if ($blob === null) { > return '';}< fbird_blob_close( $blobid );< return( $realblob ); < } < < function _BlobDecode( $blob ) < {$blob_data = fbird_blob_info($this->_connectionID, $blob );< $blobid = fbird_blob_open($this->_connectionID, $blob );> $blobId = fbird_blob_open($this->_connectionID, $blob);if( $blob_data[0] > $this->maxblobsize ) {< $realblob = fbird_blob_get($blobid, $this->maxblobsize); < < while($string = fbird_blob_get($blobid, 8192)) { < $realblob .= $string;> $realBlob = fbird_blob_get($blobId, $this->maxblobsize); > while ($string = fbird_blob_get($blobId, 8192)) { > $realBlob .= $string;} } else {< $realblob = fbird_blob_get($blobid, $blob_data[0]);> $realBlob = fbird_blob_get($blobId, $blob_data[0]);}< fbird_blob_close( $blobid ); < return( $realblob );> fbird_blob_close($blobId); > return $realBlob;}< function UpdateBlobFile($table,$column,$path,$where,$blobtype='BLOB')> /** > * Insert blob data into a database column directly > * from file > * > * @param string $table table to insert > * @param string $column column to insert > * @param string $path physical file name > * @param string $where string to find unique record > * @param string $blobtype BLOB or CLOB > * > * @return bool success > */ > public function updateBlobFile($table,$column,$path,$where,$blobtype='BLOB'){ $fd = fopen($path,'rb');< if ($fd === false) return false;> if ($fd === false) > return false; >$blob_id = fbird_blob_create($this->_connectionID); /* fill with data */ while ($val = fread($fd,32768)){ fbird_blob_add($blob_id, $val); } /* close and get $blob_id_str for inserting into table */ $blob_id_str = fbird_blob_close($blob_id); fclose($fd); return $this->Execute("UPDATE $table SET $column=(?) WHERE $where",array($blob_id_str)) != false; }< /* < Insert a null into the blob field of the table first. < Then use UpdateBlob to store the blob. < < Usage: < < $conn->Execute('INSERT INTO blobtable (id, blobcol) VALUES (1, null)'); < $conn->UpdateBlob('blobtable','blobcol',$blob,'id=1');> /** > * Insert blob data into a database column > * > * @param string $table table to insert > * @param string $column column to insert > * @param string $val value to insert > * @param string $where string to find unique record > * @param string $blobtype BLOB or CLOB > * > * @return bool success*/< function UpdateBlob($table,$column,$val,$where,$blobtype='BLOB')> public function updateBlob($table,$column,$val,$where,$blobtype='BLOB'){ $blob_id = fbird_blob_create($this->_connectionID); // fbird_blob_add($blob_id, $val); // replacement that solves the problem by which only the first modulus 64K / // of $val are stored at the blob field //////////////////////////////////// // Thx Abel Berenstein aberenstein#afip.gov.ar $len = strlen($val); $chunk_size = 32768; $tail_size = $len % $chunk_size; $n_chunks = ($len - $tail_size) / $chunk_size; for ($n = 0; $n < $n_chunks; $n++) { $start = $n * $chunk_size; $data = substr($val, $start, $chunk_size); fbird_blob_add($blob_id, $data); } if ($tail_size) { $start = $n_chunks * $chunk_size; $data = substr($val, $start, $tail_size); fbird_blob_add($blob_id, $data); } // end replacement ///////////////////////////////////////////////////////// $blob_id_str = fbird_blob_close($blob_id);< return $this->Execute("UPDATE $table SET $column=(?) WHERE $where",array($blob_id_str)) != false;> return $this->execute("UPDATE $table SET $column=(?) WHERE $where",array($blob_id_str)) != false;}< function OldUpdateBlob($table,$column,$val,$where,$blobtype='BLOB')> /** > * Returns a portably-formatted date string from a timestamp database column. > * > * @link https://adodb.org/dokuwiki/doku.php?id=v5:reference:connection:sqldate > * > * Firebird does not support an AM/PM format, so the A indicator always shows AM > * > * @param string $fmt The date format to use. > * @param string|bool $col (Optional) The table column to date format, or if false, use NOW(). > * > * @return string The SQL DATE_FORMAT() string, or empty if the provided date format was empty. > */ > public function sqlDate($fmt, $col=false){< $blob_id = fbird_blob_create($this->_connectionID); < fbird_blob_add($blob_id, $val); < $blob_id_str = fbird_blob_close($blob_id); < return $this->Execute("UPDATE $table SET $column=(?) WHERE $where",array($blob_id_str)) != false; < }> if (!$col) > $col = 'CURRENT_TIMESTAMP';< // Format date column in sql string given an input format that understands Y M D < // Only since Interbase 6.0 - uses EXTRACT < // problem - does not zero-fill the day and month yet < function SQLDate($fmt, $col=false) < { < if (!$col) $col = $this->sysDate;$s = ''; $len = strlen($fmt); for ($i=0; $i < $len; $i++) { if ($s) $s .= '||'; $ch = $fmt[$i];< switch($ch) {> $choice = strtoupper($ch); > switch($choice) {case 'Y':< case 'y': < $s .= "extract(year from $col)";> $s .= "EXTRACT(YEAR FROM $col)";break; case 'M':< case 'm': < $s .= "extract(month from $col)";> $s .= "RIGHT('0' || TRIM(EXTRACT(MONTH FROM $col)),2)";break; case 'W':< case 'w':// The more accurate way of doing this is with a stored procedure // See http://wiki.firebirdsql.org/wiki/index.php?page=DATE+Handling+Functions for details< $s .= "((extract(yearday from $col) - extract(weekday from $col - 1) + 7) / 7)";> $s .= "((EXTRACT(YEARDAY FROM $col) - EXTRACT(WEEKDAY FROM $col - 1) + 7) / 7)";break; case 'Q':< case 'q': < $s .= "cast(((extract(month from $col)+2) / 3) as integer)";> $s .= "CAST(((EXTRACT(MONTH FROM $col)+2) / 3) AS INTEGER)";break; case 'D':< case 'd': < $s .= "(extract(day from $col))";> $s .= "RIGHT('0' || TRIM(EXTRACT(DAY FROM $col)),2)";break; case 'H':< case 'h': < $s .= "(extract(hour from $col))";> $s .= "RIGHT('0' || TRIM(EXTRACT(HOUR FROM $col)),2)";break; case 'I':< case 'i': < $s .= "(extract(minute from $col))";> $s .= "RIGHT('0' || TRIM(EXTRACT(MINUTE FROM $col)),2)";break; case 'S':< case 's': < $s .= "CAST((extract(second from $col)) AS INTEGER)";> //$s .= "CAST((EXTRACT(SECOND FROM $col)) AS INTEGER)"; > $s .= "RIGHT('0' || TRIM(EXTRACT(SECOND FROM $col)),2)"; > break; > case 'A': > $s .= $this->qstr('AM');break;<default: if ($ch == '\\') { $i++; $ch = substr($fmt,$i,1); } $s .= $this->qstr($ch); break; } } return $s; }> /** // Note that Interbase 6.5 uses this ROWS instead - don't you love forking wars! > * Creates a portable date offset field, for use in SQL statements. // SELECT col1, col2 FROM table ROWS 5 -- get 5 rows > * // SELECT col1, col2 FROM TABLE ORDER BY col1 ROWS 3 TO 7 -- first 5 skip 2 > * @link https://adodb.org/dokuwiki/doku.php?id=v5:reference:connection:offsetdate function &SelectLimit($sql,$nrows=-1,$offset=-1,$inputarr=false, $secs=0) > * { > * @param float $dayFraction A day in floating point $nrows = (integer) $nrows; > * @param string|bool $date (Optional) The date to offset. If false, uses CURDATE() $offset = (integer) $offset; > * $str = 'SELECT '; > * @return string if ($nrows >= 0) $str .= "FIRST $nrows "; > */ $str .=($offset>=0) ? "SKIP $offset " : ''; > public function offsetDate($dayFraction, $date=false) > { $sql = preg_replace('/^[ \t]*select/i',$str,$sql); > if (!$date) if ($secs) > $date = $this->sysTimeStamp; $rs = $this->CacheExecute($secs,$sql,$inputarr); > else > $fraction = $dayFraction * 24 * 3600; $rs = $this->Execute($sql,$inputarr); > return sprintf("DATEADD (second, %s, %s) FROM RDB\$DATABASE",$fraction,$date); > } return $rs; > } >< function &SelectLimit($sql,$nrows=-1,$offset=-1,$inputarr=false, $secs=0)> /** > * Executes a provided SQL statement and returns a handle to the result, with the ability to supply a starting > * offset and record count. > * > * @link https://adodb.org/dokuwiki/doku.php?id=v5:reference:connection:selectlimit > * > * @param string $sql The SQL to execute. > * @param int $nrows (Optional) The limit for the number of records you want returned. By default, all results. > * @param int $offset (Optional) The offset to use when selecting the results. By default, no offset. > * @param array|bool $inputarr (Optional) Any parameter values required by the SQL statement, or false if none. > * @param int $secs2cache (Optional) If greater than 0, perform a cached execute. By default, normal execution. > * > * @return ADORecordSet|false The query results, or false if the query failed to execute. > */ > public function selectLimit($sql,$nrows=-1,$offset=-1,$inputarr=false, $secs2cache=0)< if ($secs) < $rs = $this->CacheExecute($secs,$sql,$inputarr);> if ($secs2cache) > $rs = $this->cacheExecute($secs2cache,$sql,$inputarr);< $rs = $this->Execute($sql,$inputarr);> $rs = $this->execute($sql,$inputarr);< /*-------------------------------------------------------------------------------------- < Class Name: Recordset < --------------------------------------------------------------------------------------*/ <> /** > * Class ADORecordset_firebird > */{<var $databaseType = "firebird"; var $bind=false;< var $_cacheType;> > /** > * @var ADOFieldObject[] Holds a cached version of the metadata > */ > private $fieldObjects = false; > > /** > * @var bool Flags if we have retrieved the metadata > */ > private $fieldObjectsRetrieved = false; > > /** > * @var array Cross-reference the objects by name for easy access > */ > private $fieldObjectsIndex = array(); > > /** > * @var bool Flag to indicate if the result has a blob > */ > private $fieldObjectsHaveBlob = false;function __construct($id,$mode=false) { global $ADODB_FETCH_MODE; $this->fetchMode = ($mode === false) ? $ADODB_FETCH_MODE : $mode; parent::__construct($id); }>/**< * Get column information in the Recordset object. < * fetchField() can be used in order to obtain information about fields in < * a certain query result. If the field offset isn't specified, the next < * field that wasn't yet retrieved by fetchField() is retrieved. < * @return object containing field information.> * Returns: an object containing field information. > * > * Get column information in the Recordset object. fetchField() > * can be used in order to obtain information about fields in a > * certain query result. If the field offset isn't specified, > * the next field that wasn't yet retrieved by fetchField() > * is retrieved. > * > * $param int $fieldOffset (optional default=-1 for all > * @return mixed an ADOFieldObject, or array of objects*/< function FetchField($fieldOffset = -1)> private function _fetchField($fieldOffset = -1){> if ($this->fieldObjectsRetrieved) { $fld = new ADOFieldObject; > if ($this->fieldObjects) { $ibf = fbird_field_info($this->_queryID,$fieldOffset); > // Already got the information > if ($fieldOffset == -1) { $name = empty($ibf['alias']) ? $ibf['name'] : $ibf['alias']; > return $this->fieldObjects; > } else { switch (ADODB_ASSOC_CASE) { > return $this->fieldObjects[$fieldOffset]; case ADODB_ASSOC_CASE_UPPER: > } $fld->name = strtoupper($name); > } else { break; > // No metadata available case ADODB_ASSOC_CASE_LOWER: > return false; $fld->name = strtolower($name); > } break; > } case ADODB_ASSOC_CASE_NATIVE: > default: > // Populate the field objects cache $fld->name = $name; > $this->fieldObjectsRetrieved = true; break; > $this->fieldObjectsHaveBlob = false; } > $this->_numOfFields = fbird_num_fields($this->_queryID); > for ($fieldIndex = 0; $fieldIndex < $this->_numOfFields; $fieldIndex++) {< $ibf = fbird_field_info($this->_queryID,$fieldOffset);> $ibf = fbird_field_info($this->_queryID, $fieldIndex);$fld->max_length = $ibf['length'];< /* This needs to be populated from the metadata */> // This needs to be populated from the metadata$fld->not_null = false; $fld->has_default = false; $fld->default_value = 'null';< return $fld;> > $this->fieldObjects[$fieldIndex] = $fld; > $this->fieldObjectsIndex[$fld->name] = $fieldIndex; > > if ($fld->type == 'BLOB') { > $this->fieldObjectsHaveBlob = true; > } > } > > if ($fieldOffset == -1) { > return $this->fieldObjects; > } > > return $this->fieldObjects[$fieldOffset]; > } > > /** > * Fetchfield copies the oracle method, it loads the field information > * into the _fieldobjs array once, to save multiple calls to the > * fbird_ function > * > * @param int $fieldOffset (optional) > * > * @return adoFieldObject|false > */ > public function fetchField($fieldOffset = -1) > { > if ($fieldOffset == -1) { > return $this->fieldObjects; > } > > return $this->fieldObjects[$fieldOffset];} function _initrs() { $this->_numOfRows = -1;< $this->_numOfFields = @fbird_num_fields($this->_queryID);< // cache types for blob decode check < for ($i=0, $max = $this->_numOfFields; $i < $max; $i++) { < $f1 = $this->FetchField($i); < $this->_cacheType[] = $f1->type; < }> /* > * Retrieve all of the column information first. We copy > * this method from oracle > */ > $this->_fetchField(); >} function _seek($row) { return false; }< function _fetch()> public function _fetch(){> // Case conversion function for use in Closure defined below $f = @fbird_fetch_row($this->_queryID); > $localFnCaseConv = null; if ($f === false) { > $this->fields = false; > if ($this->fetchMode & ADODB_FETCH_ASSOC) { return false; > // Handle either associative or fetch both } > $localNumeric = false; // OPN stuff start - optimized > // fix missing nulls and decode blobs automatically > $f = @fbird_fetch_assoc($this->_queryID); > if (is_array($f)) { global $ADODB_ANSI_PADDING_OFF; > // Optimally do the case_upper or case_lower //$ADODB_ANSI_PADDING_OFF=1; > if (ADODB_ASSOC_CASE == ADODB_ASSOC_CASE_LOWER) { $rtrim = !empty($ADODB_ANSI_PADDING_OFF); > $f = array_change_key_case($f, CASE_LOWER); > $localFnCaseConv = 'strtolower'; for ($i=0, $max = $this->_numOfFields; $i < $max; $i++) { > } elseif (ADODB_ASSOC_CASE == ADODB_ASSOC_CASE_UPPER) { if ($this->_cacheType[$i]=="BLOB") { > $f = array_change_key_case($f, CASE_UPPER); if (isset($f[$i])) { > $localFnCaseConv = 'strtoupper'; $f[$i] = $this->connection->_BlobDecode($f[$i]); > } } else { > } $f[$i] = null; > } else { } > // Numeric fetch mode } else { > $localNumeric = true;if (!isset($f[$i])) {> } $f[$i] = null; >} else if ($rtrim && is_string($f[$i])) {><< //$ADODB_ANSI_PADDING_OFF=1;< for ($i=0, $max = $this->_numOfFields; $i < $max; $i++) { < if ($this->_cacheType[$i]=="BLOB") { < if (isset($f[$i])) { < $f[$i] = $this->connection->_BlobDecode($f[$i]);> // For optimal performance, only process if there is a possibility of something to do > if ($this->fieldObjectsHaveBlob || $rtrim) { > $localFieldObjects = $this->fieldObjects; > $localFieldObjectIndex = $this->fieldObjectsIndex; > /** @var ADODB_firebird $localConnection */ > $localConnection = &$this->connection; > > /** > * Closure for an efficient method of iterating over the elements. > * @param mixed $value > * @param string|int $key > * @return void > */ > $rowTransform = function ($value, $key) use ( > &$f, > $rtrim, > $localFieldObjects, > $localConnection, > $localNumeric, > $localFnCaseConv, > $localFieldObjectIndex > ) { > if ($localNumeric) { > $localKey = $key;< $f[$i] = null;> // Cross-reference the associative key back to numeric > // with appropriate case conversion > $index = $localFnCaseConv ? $localFnCaseConv($key) : $key; > $localKey = $localFieldObjectIndex[$index];if ($this->fetchMode == ADODB_FETCH_ASSOC) {> $this->fields = $this->GetRowAssoc(); > // As we iterate the elements check for blobs and padding } else if ($this->fetchMode == ADODB_FETCH_BOTH) { > if ($localFieldObjects[$localKey]->type == 'BLOB') { $this->fields = array_merge($this->fields,$this->GetRowAssoc()); > $f[$key] = $localConnection->_BlobDecode($value);< if (!isset($f[$i])) { < $f[$i] = null; < } else if ($rtrim && is_string($f[$i])) { < $f[$i] = rtrim($f[$i]);> if ($rtrim && is_string($value)) { > $f[$key] = rtrim($value);/* Use associative array to get fields array */> function Fields($colname) > }; { > if ($this->fetchMode & ADODB_FETCH_ASSOC) return $this->fields[$colname]; > // Walk the array, applying the above closure if (!$this->bind) { > array_walk($f, $rowTransform);< // OPN stuff end< $this->fields = $f; < if ($this->fetchMode == ADODB_FETCH_ASSOC) { < $this->fields = $this->GetRowAssoc(); < } else if ($this->fetchMode == ADODB_FETCH_BOTH) { < $this->fields = array_merge($this->fields,$this->GetRowAssoc());> if (!$localNumeric && $this->fetchMode & ADODB_FETCH_NUM) { > // Creates a fetch both > $fNum = array_values($f); > $f = array_merge($f, $fNum);> return $this->fields[$this->bind[strtoupper($colname)]]; > $this->fields = $f; >< /* Use associative array to get fields array */ < function Fields($colname)> /** > * Get the value of a field in the current row by column name. > * Will not work if ADODB_FETCH_MODE is set to ADODB_FETCH_NUM. > * > * @param string $colname is the field to access > * > * @return mixed the value of $colname column > */ > public function fields($colname)< if ($this->fetchMode & ADODB_FETCH_ASSOC) return $this->fields[$colname]; < if (!$this->bind) { < $this->bind = array(); < for ($i=0; $i < $this->_numOfFields; $i++) { < $o = $this->FetchField($i); < $this->bind[strtoupper($o->name)] = $i;> if ($this->fetchMode & ADODB_FETCH_ASSOC) { > return $this->fields[$colname];function MetaType($t,$len=-1,$fieldobj=false)> { > if (!$this->bind) { if (is_object($t)) { > // fieldsObjectIndex populated by the recordset load $fieldobj = $t; > $this->bind = array_change_key_case($this->fieldObjectsIndex, CASE_UPPER);<< function MetaType($t,$len=-1,$fieldobj=false)> public function metaType($t, $len = -1, $fieldObj = false)< $fieldobj = $t; < $t = $fieldobj->type; < $len = $fieldobj->max_length;> $fieldObj = $t; > $t = $fieldObj->type; > $len = $fieldObj->max_length;< switch (strtoupper($t)) {> > $t = strtoupper($t); > > if (array_key_exists($t, $this->connection->customActualTypes)) { > return $this->connection->customActualTypes[$t]; > } > > switch ($t) {case 'TEXT': case 'VARCHAR': case 'VARYING':< if ($len <= $this->blobSize) return 'C';> if ($len <= $this->blobSize) { > return 'C'; > }return 'X'; case 'BLOB': return 'B'; case 'TIMESTAMP':< case 'DATE': return 'D'; < case 'TIME': return 'T';> case 'DATE': > return 'D'; > case 'TIME': > return 'T';//case 'T': return 'T'; //case 'L': return 'L'; case 'INT': case 'SHORT':< case 'INTEGER': return 'I'; < default: return ADODB_DEFAULT_METATYPE;> case 'INTEGER': > return 'I'; > default: > return ADODB_DEFAULT_METATYPE;} } }>