Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.0.x will end 8 May 2023 (12 months).
  • Bug fixes for security issues in 4.0.x will end 13 November 2023 (18 months).
  • PHP version: minimum PHP 7.3.0 Note: the minimum PHP version has increased since Moodle 3.10. PHP 7.4.x is also supported.
<?php
/**
 * Data Dictionary for Firebird.
 *
 * 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
 */

// security - hide paths
if (!defined('ADODB_DIR')) die();

< class ADODB2_firebird extends ADODB_DataDict { <
> class ADODB2_firebird extends ADODB_DataDict > {
var $databaseType = 'firebird'; var $seqField = false; var $seqPrefix = 's_'; var $blobSize = 40000; var $renameColumn = 'ALTER TABLE %s ALTER %s TO %s'; var $alterCol = ' ALTER'; var $dropCol = ' DROP';
< function ActualType($meta)
> function actualType($meta)
{
< switch($meta) { < case 'C': return 'VARCHAR'; < case 'XL': < case 'X': return 'BLOB SUB_TYPE TEXT';
< case 'C2': return 'VARCHAR(32765)'; // up to 32K < case 'X2': return 'VARCHAR(4096)';
> $meta = strtoupper($meta);
< case 'V': return 'CHAR'; < case 'C1': return 'CHAR(1)';
> // Add support for custom meta types. > // We do this first, that allows us to override existing types > if (isset($this->connection->customMetaTypes[$meta])) { > return $this->connection->customMetaTypes[$meta]['actual']; > }
< case 'B': return 'BLOB';
> switch($meta) { > case 'C': > return 'VARCHAR'; > case 'XL': > return 'BLOB SUB_TYPE BINARY'; > case 'X': > return 'BLOB SUB_TYPE TEXT'; > > case 'C2': > return 'VARCHAR(32765)'; // up to 32K > case 'X2': > return 'VARCHAR(4096)'; > > case 'V': > return 'CHAR'; > case 'C1': > return 'CHAR(1)';
< case 'D': return 'DATE'; < case 'TS': < case 'T': return 'TIMESTAMP';
> case 'B': > return 'BLOB';
< case 'L': return 'SMALLINT'; < case 'I': return 'INTEGER'; < case 'I1': return 'SMALLINT'; < case 'I2': return 'SMALLINT'; < case 'I4': return 'INTEGER'; < case 'I8': return 'BIGINT';
> case 'D': > return 'DATE'; > case 'TS': > case 'T': > return 'TIMESTAMP';
< case 'F': return 'DOUBLE PRECISION'; < case 'N': return 'DECIMAL';
> case 'L': > case 'I1': > case 'I2': > return 'SMALLINT'; > case 'I': > case 'I4': > return 'INTEGER'; > case 'I8': > return 'BIGINT'; > > case 'F': > return 'DOUBLE PRECISION'; > case 'N': > return 'DECIMAL';
default: return $meta; } }
< function NameQuote($name = NULL,$allowBrackets=false)
> function nameQuote($name = null, $allowBrackets = false)
{ if (!is_string($name)) {
< return FALSE;
> return false;
} $name = trim($name); if ( !is_object($this->connection) ) { return $name; } $quote = $this->connection->nameQuote; // if name is of the form `name`, quote it if ( preg_match('/^`(.+)`$/', $name, $matches) ) { return $quote . $matches[1] . $quote; } // if name contains special characters, quote it if ( !preg_match('/^[' . $this->nameRegex . ']+$/', $name) ) { return $quote . $name . $quote; } return $quote . $name . $quote; }
< function CreateDatabase($dbname, $options=false)
> function createDatabase($dbname, $options = false)
{
< $options = $this->_Options($options);
$sql = array(); $sql[] = "DECLARE EXTERNAL FUNCTION LOWER CSTRING(80) RETURNS CSTRING(80) FREE_IT ENTRY_POINT 'IB_UDF_lower' MODULE_NAME 'ib_udf'"; return $sql; }
< function _DropAutoIncrement($t)
> function _dropAutoIncrement($tabname)
{
< if (strpos($t,'.') !== false) { < $tarr = explode('.',$t); < return 'DROP GENERATOR '.$tarr[0].'."s_'.$tarr[1].'"';
> if (strpos($tabname, '.') !== false) { > $tarr = explode('.', $tabname); > return 'DROP SEQUENCE ' . $tarr[0] . '."s_' . $tarr[1] . '"';
}
< return 'DROP GENERATOR s_'.$t;
> return 'DROP SEQUENCE s_' . $tabname;
}
< function _CreateSuffix($fname,&$ftype,$fnotnull,$fdefault,$fautoinc,$fconstraint,$funsigned)
> function _createSuffix($fname, &$ftype, $fnotnull, $fdefault, $fautoinc, $fconstraint, $funsigned)
{ $suffix = '';
< if (strlen($fdefault)) $suffix .= " DEFAULT $fdefault"; < if ($fnotnull) $suffix .= ' NOT NULL'; < if ($fautoinc) $this->seqField = $fname;
> if (strlen($fdefault)) { > $suffix .= " DEFAULT $fdefault"; > } > if ($fnotnull) { > $suffix .= ' NOT NULL'; > } > if ($fautoinc) { > $this->seqField = $fname; > }
$fconstraint = preg_replace("/``/", "\"", $fconstraint);
< if ($fconstraint) $suffix .= ' '.$fconstraint;
> if ($fconstraint) { > $suffix .= ' ' . $fconstraint; > }
return $suffix; } /**
< Generate the SQL to create table. Returns an array of sql strings.
> * Generate the SQL to create table. Returns an array of sql strings.
*/
< function CreateTableSQL($tabname, $flds, $tableoptions=array())
> function createTableSQL($tabname, $flds, $tableoptions = array())
{ list($lines,$pkey,$idxs) = $this->_GenFields($flds, true); // genfields can return FALSE at times
< if ($lines == null) $lines = array();
> if ($lines == null) { > $lines = array(); > }
$taboptions = $this->_Options($tableoptions); $tabname = $this->TableName ($tabname); $sql = $this->_TableSQL($tabname,$lines,$pkey,$taboptions);
< if ($this->autoIncrement && !isset($taboptions['DROP'])) < { $tsql = $this->_Triggers($tabname,$taboptions); < foreach($tsql as $s) $sql[] = $s;
> if ($this->autoIncrement && !isset($taboptions['DROP'])) { > $tsql = $this->_Triggers($tabname, $taboptions); > foreach ($tsql as $s) { > $sql[] = $s; > }
} if (is_array($idxs)) { foreach($idxs as $idx => $idxdef) { $sql_idxs = $this->CreateIndexSql($idx, $tabname, $idxdef['cols'], $idxdef['opts']); $sql = array_merge($sql, $sql_idxs); } } return $sql; } /* CREATE or replace TRIGGER jaddress_insert before insert on jaddress for each row begin IF ( NEW."seqField" IS NULL OR NEW."seqField" = 0 ) THEN NEW."seqField" = GEN_ID("GEN_tabname", 1); end; */
< function _Triggers($tabname,$tableoptions)
> function _triggers($tabname, $taboptions)
{
< if (!$this->seqField) return array();
> if (!$this->seqField) { > return array(); > }
$tab1 = preg_replace( '/"/', '', $tabname ); if ($this->schema) { $t = strpos($tab1,'.');
< if ($t !== false) $tab = substr($tab1,$t+1); < else $tab = $tab1;
> if ($t !== false) { > $tab = substr($tab1, $t + 1); > } else { > $tab = $tab1; > }
$seqField = $this->seqField; $seqname = $this->schema.'.'.$this->seqPrefix.$tab; $trigname = $this->schema.'.t_'.$this->seqPrefix.$tab; } else { $seqField = $this->seqField; $seqname = $this->seqPrefix.$tab1; $trigname = 't_'.$seqname; }
< if (isset($tableoptions['DROP'])) < { $sql[] = "DROP GENERATOR $seqname"; < } < elseif (isset($tableoptions['REPLACE'])) < { $sql[] = "DROP GENERATOR \"$seqname\""; < $sql[] = "CREATE GENERATOR \"$seqname\"";
> if (isset($taboptions['DROP'])) { > $sql[] = "DROP SEQUENCE $seqname"; > } elseif (isset($taboptions['REPLACE'])) { > $sql[] = "DROP SEQUENCE \"$seqname\""; > $sql[] = "CREATE SEQUENCE \"$seqname\"";
$sql[] = "ALTER TRIGGER \"$trigname\" BEFORE INSERT OR UPDATE AS BEGIN IF ( NEW.$seqField IS NULL OR NEW.$seqField = 0 ) THEN NEW.$seqField = GEN_ID(\"$seqname\", 1); END";
< } < else < { $sql[] = "CREATE GENERATOR $seqname";
> } else { > $sql[] = "CREATE SEQUENCE $seqname";
$sql[] = "CREATE TRIGGER $trigname FOR $tabname BEFORE INSERT OR UPDATE AS BEGIN IF ( NEW.$seqField IS NULL OR NEW.$seqField = 0 ) THEN NEW.$seqField = GEN_ID($seqname, 1); END"; } $this->seqField = false; return $sql; } /** * Change the definition of one column *
< * As some DBM's can't do that on there own, you need to supply the complete definition of the new table, < * to allow, recreating the table and copying the content over to the new table
* @param string $tabname table-name * @param string $flds column-name and type for the changed column
< * @param string $tableflds='' complete definition of the new table, eg. for postgres, default '' < * @param array/string $tableoptions='' options for the new table see CreateTableSQL, default ''
> * @param string $tableflds Unused > * @param array|string $tableoptions Unused > *
* @return array with SQL strings */
< function AlterColumnSQL($tabname, $flds, $tableflds='',$tableoptions='')
> public function alterColumnSQL($tabname, $flds, $tableflds = '', $tableoptions = '')
{ $tabname = $this->TableName ($tabname); $sql = array();
< list($lines,$pkey,$idxs) = $this->_GenFields($flds);
> list($lines, , $idxs) = $this->_GenFields($flds);
// genfields can return FALSE at times
< if ($lines == null) $lines = array();
> > if ($lines == null) { > $lines = array(); > } >
$alter = 'ALTER TABLE ' . $tabname . $this->alterCol . ' ';
>
foreach($lines as $v) {
> /* $sql[] = $alter . $v; > * The type must be preceded by the keyword 'TYPE' } > */ if (is_array($idxs)) { > $vExplode = explode(' ', $v); foreach($idxs as $idx => $idxdef) { > $vExplode = array_filter($vExplode); $sql_idxs = $this->CreateIndexSql($idx, $tabname, $idxdef['cols'], $idxdef['opts']); > array_splice($vExplode, 1, 0, array('TYPE')); $sql = array_merge($sql, $sql_idxs); > $v = implode(' ', $vExplode);
}
>
} return $sql; } }