Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.2.x will end 22 April 2024 (12 months).
  • Bug fixes for security issues in 4.2.x will end 7 October 2024 (18 months).
  • PHP version: minimum PHP 8.0.0 Note: minimum PHP version has increased since Moodle 4.1. PHP 8.1.x is supported too.
<?php
<
/**
< @version v5.20.16 12-Jan-2020 < @copyright (c) 2000-2013 John Lim (jlim#natsoft.com). All rights reserved. < @copyright (c) 2014 Damien Regad, Mark Newnham and the ADOdb community < Released under both BSD license and Lesser GPL library license. < Whenever there is any discrepancy between the two licenses, < the BSD license will take precedence. < < Set tabs to 4 for best viewing. < < DOCUMENTATION: < < See adodb/tests/test-datadict.php for docs and examples. < */ < < /* < Test script for parser
> * ADOdb Data Dictionary base class. > * > * 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();
< function Lens_ParseTest()
> /** > * Test script for parser > */ > function lens_ParseTest()
{ $str = "`zcol ACOL` NUMBER(32,2) DEFAULT 'The \"cow\" (and Jim''s dog) jumps over the moon' PRIMARY, INTI INT AUTO DEFAULT 0, zcol2\"afs ds"; print "<p>$str</p>";
< $a= Lens_ParseArgs($str);
> $a= lens_ParseArgs($str);
print "<pre>"; print_r($a); print "</pre>"; } if (!function_exists('ctype_alnum')) { function ctype_alnum($text) { return preg_match('/^[a-z0-9]*$/i', $text); } } //Lens_ParseTest(); /** Parse arguments, treat "text" (text) and 'text' as quotation marks. To escape, use "" or '' or )) Will read in "abc def" sans quotes, as: abc def Same with 'abc def'. However if `abc def`, then will read in as `abc def` @param endstmtchar Character that indicates end of statement @param tokenchars Include the following characters in tokens apart from A-Z and 0-9 @returns 2 dimensional array containing parsed tokens. */
< function Lens_ParseArgs($args,$endstmtchar=',',$tokenchars='_.-')
> function lens_ParseArgs($args,$endstmtchar=',',$tokenchars='_.-')
{ $pos = 0; $intoken = false; $stmtno = 0; $endquote = false; $tokens = array(); $tokens[$stmtno] = array(); $max = strlen($args); $quoted = false; $tokarr = array(); while ($pos < $max) { $ch = substr($args,$pos,1); switch($ch) { case ' ': case "\t": case "\n": case "\r": if (!$quoted) { if ($intoken) { $intoken = false; $tokens[$stmtno][] = implode('',$tokarr); } break; } $tokarr[] = $ch; break; case '`': if ($intoken) $tokarr[] = $ch; case '(': case ')': case '"': case "'": if ($intoken) { if (empty($endquote)) { $tokens[$stmtno][] = implode('',$tokarr); if ($ch == '(') $endquote = ')'; else $endquote = $ch; $quoted = true; $intoken = true; $tokarr = array(); } else if ($endquote == $ch) { $ch2 = substr($args,$pos+1,1); if ($ch2 == $endquote) { $pos += 1; $tokarr[] = $ch2; } else { $quoted = false; $intoken = false; $tokens[$stmtno][] = implode('',$tokarr); $endquote = ''; } } else $tokarr[] = $ch; }else { if ($ch == '(') $endquote = ')'; else $endquote = $ch; $quoted = true; $intoken = true; $tokarr = array(); if ($ch == '`') $tokarr[] = '`'; } break; default: if (!$intoken) { if ($ch == $endstmtchar) { $stmtno += 1; $tokens[$stmtno] = array(); break; } $intoken = true; $quoted = false; $endquote = false; $tokarr = array(); } if ($quoted) $tokarr[] = $ch; else if (ctype_alnum($ch) || strpos($tokenchars,$ch) !== false) $tokarr[] = $ch; else { if ($ch == $endstmtchar) { $tokens[$stmtno][] = implode('',$tokarr); $stmtno += 1; $tokens[$stmtno] = array(); $intoken = false; $tokarr = array(); break; } $tokens[$stmtno][] = implode('',$tokarr); $tokens[$stmtno][] = $ch; $intoken = false; } } $pos += 1; } if ($intoken) $tokens[$stmtno][] = implode('',$tokarr); return $tokens; } class ADODB_DataDict {
> /** @var ADOConnection */
var $connection; var $debug = false; var $dropTable = 'DROP TABLE %s'; var $renameTable = 'RENAME TABLE %s TO %s'; var $dropIndex = 'DROP INDEX %s'; var $addCol = ' ADD'; var $alterCol = ' ALTER COLUMN'; var $dropCol = ' DROP COLUMN'; var $renameColumn = 'ALTER TABLE %s RENAME COLUMN %s TO %s'; // table, old-column, new-column, column-definitions (not used by default) var $nameRegex = '\w'; var $nameRegexBrackets = 'a-zA-Z0-9_\(\)'; var $schema = false; var $serverInfo = array(); var $autoIncrement = false; var $dataProvider;
< var $invalidResizeTypes4 = array('CLOB','BLOB','TEXT','DATE','TIME'); // for changetablesql
> var $invalidResizeTypes4 = array('CLOB','BLOB','TEXT','DATE','TIME'); // for changeTableSQL
var $blobSize = 100; /// any varchar/char field this size or greater is treated as a blob
< /// in other words, we use a text area for editting.
> /// in other words, we use a text area for editing. > /** @var string Uppercase driver name */ > var $upperName; > > /* > * Indicates whether a BLOB/CLOB field will allow a NOT NULL setting > * The type is whatever is matched to an X or X2 or B type. We must > * explicitly set the value in the driver to switch the behaviour on > */ > public $blobAllowsNotNull; > /* > * Indicates whether a BLOB/CLOB field will allow a DEFAULT set > * The type is whatever is matched to an X or X2 or B type. We must > * explicitly set the value in the driver to switch the behaviour on > */ > public $blobAllowsDefaultValue;
< function GetCommentSQL($table,$col)
> /** > * @var string String to use to quote identifiers and names > */ > public $quote; > > function getCommentSQL($table,$col)
{ return false; }
< function SetCommentSQL($table,$col,$cmt)
> function setCommentSQL($table,$col,$cmt)
{ return false; }
< function MetaTables()
> function metaTables()
{
< if (!$this->connection->IsConnected()) return array(); < return $this->connection->MetaTables();
> if (!$this->connection->isConnected()) return array(); > return $this->connection->metaTables();
}
< function MetaColumns($tab, $upper=true, $schema=false)
> function metaColumns($tab, $upper=true, $schema=false)
{
< if (!$this->connection->IsConnected()) return array(); < return $this->connection->MetaColumns($this->TableName($tab), $upper, $schema);
> if (!$this->connection->isConnected()) return array(); > return $this->connection->metaColumns($this->tableName($tab), $upper, $schema);
}
< function MetaPrimaryKeys($tab,$owner=false,$intkey=false)
> function metaPrimaryKeys($tab,$owner=false,$intkey=false)
{
< if (!$this->connection->IsConnected()) return array(); < return $this->connection->MetaPrimaryKeys($this->TableName($tab), $owner, $intkey);
> if (!$this->connection->isConnected()) return array(); > return $this->connection->metaPrimaryKeys($this->tableName($tab), $owner, $intkey);
}
< function MetaIndexes($table, $primary = false, $owner = false)
> function metaIndexes($table, $primary = false, $owner = false)
{
< if (!$this->connection->IsConnected()) return array(); < return $this->connection->MetaIndexes($this->TableName($table), $primary, $owner);
> if (!$this->connection->isConnected()) return array(); > return $this->connection->metaIndexes($this->tableName($table), $primary, $owner);
}
< function MetaType($t,$len=-1,$fieldobj=false)
> function metaType($t,$len=-1,$fieldobj=false)
{ static $typeMap = array( 'VARCHAR' => 'C', 'VARCHAR2' => 'C', 'CHAR' => 'C', 'C' => 'C', 'STRING' => 'C', 'NCHAR' => 'C', 'NVARCHAR' => 'C', 'VARYING' => 'C', 'BPCHAR' => 'C', 'CHARACTER' => 'C', 'INTERVAL' => 'C', # Postgres 'MACADDR' => 'C', # postgres 'VAR_STRING' => 'C', # mysql ## 'LONGCHAR' => 'X', 'TEXT' => 'X', 'NTEXT' => 'X', 'M' => 'X', 'X' => 'X', 'CLOB' => 'X', 'NCLOB' => 'X', 'LVARCHAR' => 'X', ## 'BLOB' => 'B', 'IMAGE' => 'B', 'BINARY' => 'B', 'VARBINARY' => 'B', 'LONGBINARY' => 'B', 'B' => 'B', ## 'YEAR' => 'D', // mysql 'DATE' => 'D', 'D' => 'D', ## 'UNIQUEIDENTIFIER' => 'C', # MS SQL Server ## 'TIME' => 'T', 'TIMESTAMP' => 'T', 'DATETIME' => 'T', 'TIMESTAMPTZ' => 'T', 'SMALLDATETIME' => 'T', 'T' => 'T', 'TIMESTAMP WITHOUT TIME ZONE' => 'T', // postgresql ## 'BOOL' => 'L', 'BOOLEAN' => 'L', 'BIT' => 'L', 'L' => 'L', ## 'COUNTER' => 'R', 'R' => 'R', 'SERIAL' => 'R', // ifx 'INT IDENTITY' => 'R', ## 'INT' => 'I', 'INT2' => 'I', 'INT4' => 'I', 'INT8' => 'I', 'INTEGER' => 'I', 'INTEGER UNSIGNED' => 'I', 'SHORT' => 'I', 'TINYINT' => 'I', 'SMALLINT' => 'I', 'I' => 'I', ## 'LONG' => 'N', // interbase is numeric, oci8 is blob 'BIGINT' => 'N', // this is bigger than PHP 32-bit integers 'DECIMAL' => 'N', 'DEC' => 'N', 'REAL' => 'N', 'DOUBLE' => 'N', 'DOUBLE PRECISION' => 'N', 'SMALLFLOAT' => 'N', 'FLOAT' => 'N', 'NUMBER' => 'N', 'NUM' => 'N', 'NUMERIC' => 'N', 'MONEY' => 'N', ## informix 9.2 'SQLINT' => 'I', 'SQLSERIAL' => 'I', 'SQLSMINT' => 'I', 'SQLSMFLOAT' => 'N', 'SQLFLOAT' => 'N', 'SQLMONEY' => 'N', 'SQLDECIMAL' => 'N', 'SQLDATE' => 'D', 'SQLVCHAR' => 'C', 'SQLCHAR' => 'C', 'SQLDTIME' => 'T', 'SQLINTERVAL' => 'N', 'SQLBYTES' => 'B', 'SQLTEXT' => 'X', ## informix 10 "SQLINT8" => 'I8', "SQLSERIAL8" => 'I8', "SQLNCHAR" => 'C', "SQLNVCHAR" => 'C', "SQLLVARCHAR" => 'X', "SQLBOOL" => 'L' );
< if (!$this->connection->IsConnected()) {
> if (!$this->connection->isConnected()) {
$t = strtoupper($t); if (isset($typeMap[$t])) return $typeMap[$t];
< return 'N';
> return ADODB_DEFAULT_METATYPE;
}
< return $this->connection->MetaType($t,$len,$fieldobj);
> return $this->connection->metaType($t,$len,$fieldobj);
}
< 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 $regex = ($allowBrackets) ? $this->nameRegexBrackets : $this->nameRegex; if ( !preg_match('/^[' . $regex . ']+$/', $name) ) { return $quote . $name . $quote; } return $name; }
< function TableName($name)
> function tableName($name)
{ if ( $this->schema ) {
< return $this->NameQuote($this->schema) .'.'. $this->NameQuote($name);
> return $this->nameQuote($this->schema) .'.'. $this->nameQuote($name);
}
< return $this->NameQuote($name);
> return $this->nameQuote($name);
}
< // Executes the sql array returned by GetTableSQL and GetIndexSQL < function ExecuteSQLArray($sql, $continueOnError = true)
> // Executes the sql array returned by getTableSQL and getIndexSQL > function executeSQLArray($sql, $continueOnError = true)
{ $rez = 2; $conn = $this->connection; $saved = $conn->debug; foreach($sql as $line) { if ($this->debug) $conn->debug = true;
< $ok = $conn->Execute($line);
> $ok = $conn->execute($line);
$conn->debug = $saved; if (!$ok) {
< if ($this->debug) ADOConnection::outp($conn->ErrorMsg());
> if ($this->debug) ADOConnection::outp($conn->errorMsg());
if (!$continueOnError) return 0; $rez = 1; } } return $rez; } /** Returns the actual type given a character code. C: varchar X: CLOB (character large object) or largest varchar size if CLOB is not supported C2: Multibyte varchar X2: Multibyte CLOB B: BLOB (binary large object) D: Date T: Date-time L: Integer field suitable for storing booleans (0 or 1) I: Integer F: Floating point number N: Numeric or decimal number */
< function ActualType($meta)
> function actualType($meta)
{
> $meta = strtoupper($meta); return $meta; > } > /* > * Add support for custom meta types. We do this function CreateDatabase($dbname,$options=false) > * first, that allows us to override existing types { > */ $options = $this->_Options($options); > if (isset($this->connection->customMetaTypes[$meta])) $sql = array(); > return $this->connection->customMetaTypes[$meta]['actual']; >
< function CreateDatabase($dbname,$options=false)
> function createDatabase($dbname,$options=false)
< $options = $this->_Options($options);
> $options = $this->_options($options);
< $s = 'CREATE DATABASE ' . $this->NameQuote($dbname);
> $s = 'CREATE DATABASE ' . $this->nameQuote($dbname);
$sql[] = $s; return $sql; } /* Generates the SQL to create index. Returns an array of sql strings. */
< function CreateIndexSQL($idxname, $tabname, $flds, $idxoptions = false)
> function createIndexSQL($idxname, $tabname, $flds, $idxoptions = false)
{ if (!is_array($flds)) { $flds = explode(',',$flds); } foreach($flds as $key => $fld) { # some indexes can use partial fields, eg. index first 32 chars of "name" with NAME(32)
< $flds[$key] = $this->NameQuote($fld,$allowBrackets=true);
> $flds[$key] = $this->nameQuote($fld,$allowBrackets=true);
}
< return $this->_IndexSQL($this->NameQuote($idxname), $this->TableName($tabname), $flds, $this->_Options($idxoptions));
> return $this->_indexSQL($this->nameQuote($idxname), $this->tableName($tabname), $flds, $this->_options($idxoptions));
}
< function DropIndexSQL ($idxname, $tabname = NULL)
> function dropIndexSQL ($idxname, $tabname = NULL)
{
< return array(sprintf($this->dropIndex, $this->NameQuote($idxname), $this->TableName($tabname)));
> return array(sprintf($this->dropIndex, $this->nameQuote($idxname), $this->tableName($tabname)));
}
< function SetSchema($schema)
> function setSchema($schema)
{ $this->schema = $schema; }
< function AddColumnSQL($tabname, $flds)
> function addColumnSQL($tabname, $flds)
{
< $tabname = $this->TableName ($tabname);
> $tabname = $this->tableName($tabname);
$sql = array();
< list($lines,$pkey,$idxs) = $this->_GenFields($flds);
> list($lines,$pkey,$idxs) = $this->_genFields($flds);
// genfields can return FALSE at times if ($lines == null) $lines = array(); $alter = 'ALTER TABLE ' . $tabname . $this->addCol . ' '; foreach($lines as $v) { $sql[] = $alter . $v; } if (is_array($idxs)) { foreach($idxs as $idx => $idxdef) {
< $sql_idxs = $this->CreateIndexSql($idx, $tabname, $idxdef['cols'], $idxdef['opts']);
> $sql_idxs = $this->createIndexSql($idx, $tabname, $idxdef['cols'], $idxdef['opts']);
$sql = array_merge($sql, $sql_idxs); } } 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 defintion of the new table, < * to allow, recreating the table and copying the content over to the new table
> * As some DBMs can't do that on their 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 defintion of the new table, eg. for postgres, default '' < * @param array/string $tableoptions='' options for the new table see CreateTableSQL, default ''
> * @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 ''
* @return array with SQL strings */
< function AlterColumnSQL($tabname, $flds, $tableflds='',$tableoptions='')
> function alterColumnSQL($tabname, $flds, $tableflds='',$tableoptions='')
{
< $tabname = $this->TableName ($tabname);
> $tabname = $this->tableName($tabname);
$sql = array();
< list($lines,$pkey,$idxs) = $this->_GenFields($flds);
> list($lines,$pkey,$idxs) = $this->_genFields($flds);
// genfields can return FALSE at times if ($lines == null) $lines = array(); $alter = 'ALTER TABLE ' . $tabname . $this->alterCol . ' '; foreach($lines as $v) { $sql[] = $alter . $v; } if (is_array($idxs)) { foreach($idxs as $idx => $idxdef) {
< $sql_idxs = $this->CreateIndexSql($idx, $tabname, $idxdef['cols'], $idxdef['opts']);
> $sql_idxs = $this->createIndexSql($idx, $tabname, $idxdef['cols'], $idxdef['opts']);
$sql = array_merge($sql, $sql_idxs); } } return $sql; } /** * Rename one column *
< * Some DBM's can only do this together with changeing the type of the column (even if that stays the same, eg. mysql)
> * Some DBMs can only do this together with changeing the type of the column (even if that stays the same, eg. mysql)
* @param string $tabname table-name * @param string $oldcolumn column-name to be renamed * @param string $newcolumn new column-name
< * @param string $flds='' complete column-defintion-string like for AddColumnSQL, only used by mysql atm., default=''
> * @param string $flds='' complete column-definition-string like for addColumnSQL, only used by mysql atm., default=''
* @return array with SQL strings */
< function RenameColumnSQL($tabname,$oldcolumn,$newcolumn,$flds='')
> function renameColumnSQL($tabname,$oldcolumn,$newcolumn,$flds='')
{
< $tabname = $this->TableName ($tabname);
> $tabname = $this->tableName($tabname);
if ($flds) {
< list($lines,$pkey,$idxs) = $this->_GenFields($flds);
> list($lines,$pkey,$idxs) = $this->_genFields($flds);
// genfields can return FALSE at times if ($lines == null) $lines = array(); $first = current($lines); list(,$column_def) = preg_split("/[\t ]+/",$first,2); }
< return array(sprintf($this->renameColumn,$tabname,$this->NameQuote($oldcolumn),$this->NameQuote($newcolumn),$column_def));
> return array(sprintf($this->renameColumn,$tabname,$this->nameQuote($oldcolumn),$this->nameQuote($newcolumn),$column_def));
} /** * Drop one column *
< * Some DBM's can't do that on there own, you need to supply the complete defintion of the new table,
> * Some DBM's can't do that on their 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 defintion of the new table, eg. for postgres, default '' < * @param array/string $tableoptions='' options for the new table see CreateTableSQL, default ''
> * @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 ''
* @return array with SQL strings */
< function DropColumnSQL($tabname, $flds, $tableflds='',$tableoptions='')
> function dropColumnSQL($tabname, $flds, $tableflds='',$tableoptions='')
{
< $tabname = $this->TableName ($tabname);
> $tabname = $this->tableName($tabname);
if (!is_array($flds)) $flds = explode(',',$flds); $sql = array(); $alter = 'ALTER TABLE ' . $tabname . $this->dropCol . ' '; foreach($flds as $v) {
< $sql[] = $alter . $this->NameQuote($v);
> $sql[] = $alter . $this->nameQuote($v);
} return $sql; }
< function DropTableSQL($tabname)
> function dropTableSQL($tabname)
{
< return array (sprintf($this->dropTable, $this->TableName($tabname)));
> return array (sprintf($this->dropTable, $this->tableName($tabname)));
}
< function RenameTableSQL($tabname,$newname)
> function renameTableSQL($tabname,$newname)
{
< return array (sprintf($this->renameTable, $this->TableName($tabname),$this->TableName($newname)));
> return array (sprintf($this->renameTable, $this->tableName($tabname),$this->tableName($newname)));
} /** 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);
> list($lines,$pkey,$idxs) = $this->_genFields($flds, true);
// genfields can return FALSE at times if ($lines == null) $lines = array();
< $taboptions = $this->_Options($tableoptions); < $tabname = $this->TableName ($tabname); < $sql = $this->_TableSQL($tabname,$lines,$pkey,$taboptions);
> $taboptions = $this->_options($tableoptions); > $tabname = $this->tableName($tabname); > $sql = $this->_tableSQL($tabname,$lines,$pkey,$taboptions);
// ggiunta - 2006/10/12 - KLUDGE: // if we are on autoincrement, and table options includes REPLACE, the // autoincrement sequence has already been dropped on table creation sql, so // we avoid passing REPLACE to trigger creation code. This prevents // creating sql that double-drops the sequence if ($this->autoIncrement && isset($taboptions['REPLACE'])) unset($taboptions['REPLACE']);
< $tsql = $this->_Triggers($tabname,$taboptions);
> $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_idxs = $this->createIndexSql($idx, $tabname, $idxdef['cols'], $idxdef['opts']);
$sql = array_merge($sql, $sql_idxs); } } return $sql; }
< function _GenFields($flds,$widespacing=false)
> function _genFields($flds,$widespacing=false)
{ if (is_string($flds)) { $padding = ' '; $txt = $flds.$padding; $flds = array();
< $flds0 = Lens_ParseArgs($txt,',');
> $flds0 = lens_ParseArgs($txt,',');
$hasparam = false; foreach($flds0 as $f0) { $f1 = array(); foreach($f0 as $token) { switch (strtoupper($token)) { case 'INDEX': $f1['INDEX'] = ''; // fall through intentionally case 'CONSTRAINT': case 'DEFAULT': $hasparam = $token; break; default: if ($hasparam) $f1[$hasparam] = $token; else $f1[] = $token; $hasparam = false; break; } } // 'index' token without a name means single column index: name it after column if (array_key_exists('INDEX', $f1) && $f1['INDEX'] == '') { $f1['INDEX'] = isset($f0['NAME']) ? $f0['NAME'] : $f0[0]; // check if column name used to create an index name was quoted if (($f1['INDEX'][0] == '"' || $f1['INDEX'][0] == "'" || $f1['INDEX'][0] == "`") && ($f1['INDEX'][0] == substr($f1['INDEX'], -1))) { $f1['INDEX'] = $f1['INDEX'][0].'idx_'.substr($f1['INDEX'], 1, -1).$f1['INDEX'][0]; } else $f1['INDEX'] = 'idx_'.$f1['INDEX']; } // reset it, so we don't get next field 1st token as INDEX... $hasparam = false; $flds[] = $f1; } } $this->autoIncrement = false; $lines = array(); $pkey = array(); $idxs = array(); foreach($flds as $fld) {
< $fld = _array_change_key_case($fld); <
> if (is_array($fld)) > $fld = array_change_key_case($fld,CASE_UPPER);
$fname = false; $fdefault = false; $fautoinc = false; $ftype = false; $fsize = false; $fprec = false; $fprimary = false; $fnoquote = false; $fdefts = false; $fdefdate = false; $fconstraint = false; $fnotnull = false; $funsigned = false; $findex = ''; $funiqueindex = false;
> $fOptions = array();
//----------------- // Parse attributes foreach($fld as $attr => $v) {
< if ($attr == 2 && is_numeric($v)) $attr = 'SIZE'; < else if (is_numeric($attr) && $attr > 1 && !is_numeric($v)) $attr = strtoupper($v);
> if ($attr == 2 && is_numeric($v)) > $attr = 'SIZE'; > elseif ($attr == 2 && strtoupper($ftype) == 'ENUM') > $attr = 'ENUM'; > else if (is_numeric($attr) && $attr > 1 && !is_numeric($v)) > $attr = strtoupper($v);
switch($attr) { case '0': case 'NAME': $fname = $v; break; case '1':
< case 'TYPE': $ty = $v; $ftype = $this->ActualType(strtoupper($v)); break;
> case 'TYPE': > > $ty = $v; > $ftype = $this->actualType(strtoupper($v)); > break;
case 'SIZE':
< $dotat = strpos($v,'.'); if ($dotat === false) $dotat = strpos($v,','); < if ($dotat === false) $fsize = $v;
> $dotat = strpos($v,'.'); > if ($dotat === false) > $dotat = strpos($v,','); > if ($dotat === false) > $fsize = $v;
else {
>
$fsize = substr($v,0,$dotat); $fprec = substr($v,$dotat+1);
>
} break; case 'UNSIGNED': $funsigned = true; break; case 'AUTOINCREMENT': case 'AUTO': $fautoinc = true; $fnotnull = true; break; case 'KEY': // a primary key col can be non unique in itself (if key spans many cols...) case 'PRIMARY': $fprimary = $v; $fnotnull = true; /*$funiqueindex = true;*/ break; case 'DEF': case 'DEFAULT': $fdefault = $v; break; case 'NOTNULL': $fnotnull = $v; break; case 'NOQUOTE': $fnoquote = $v; break; case 'DEFDATE': $fdefdate = $v; break; case 'DEFTIMESTAMP': $fdefts = $v; break; case 'CONSTRAINT': $fconstraint = $v; break; // let INDEX keyword create a 'very standard' index on column case 'INDEX': $findex = $v; break; case 'UNIQUE': $funiqueindex = true; break;
> case 'ENUM': } //switch > $fOptions['ENUM'] = $v; break;
} // foreach $fld //-------------------- // VALIDATE FIELD INFO if (!strlen($fname)) { if ($this->debug) ADOConnection::outp("Undefined NAME"); return false; } $fid = strtoupper(preg_replace('/^`(.+)`$/', '$1', $fname));
< $fname = $this->NameQuote($fname);
> $fname = $this->nameQuote($fname);
if (!strlen($ftype)) { if ($this->debug) ADOConnection::outp("Undefined TYPE for field '$fname'"); return false; } else { $ftype = strtoupper($ftype); }
< $ftype = $this->_GetSize($ftype, $ty, $fsize, $fprec);
> $ftype = $this->_getSize($ftype, $ty, $fsize, $fprec, $fOptions);
< if ($ty == 'X' || $ty == 'X2' || $ty == 'B') $fnotnull = false; // some blob types do not accept nulls
> if (($ty == 'X' || $ty == 'X2' || $ty == 'XL' || $ty == 'B') && !$this->blobAllowsNotNull) > /* > * some blob types do not accept nulls, so we override the > * previously defined value > */ > $fnotnull = false;
< if ($fprimary) $pkey[] = $fname;
> if ($fprimary) > $pkey[] = $fname;
< // some databases do not allow blobs to have defaults < if ($ty == 'X') $fdefault = false;
> if (($ty == 'X' || $ty == 'X2' || $ty == 'XL' || $ty == 'B') && !$this->blobAllowsDefaultValue) > /* > * some databases do not allow blobs to have defaults, so we > * override the previously defined value > */ > $fdefault = false;
// build list of indexes if ($findex != '') { if (array_key_exists($findex, $idxs)) { $idxs[$findex]['cols'][] = ($fname); if (in_array('UNIQUE', $idxs[$findex]['opts']) != $funiqueindex) { if ($this->debug) ADOConnection::outp("Index $findex defined once UNIQUE and once not"); } if ($funiqueindex && !in_array('UNIQUE', $idxs[$findex]['opts'])) $idxs[$findex]['opts'][] = 'UNIQUE'; } else { $idxs[$findex] = array(); $idxs[$findex]['cols'] = array($fname); if ($funiqueindex) $idxs[$findex]['opts'] = array('UNIQUE'); else $idxs[$findex]['opts'] = array(); } } //-------------------- // CONSTRUCT FIELD SQL if ($fdefts) { if (substr($this->connection->databaseType,0,5) == 'mysql') { $ftype = 'TIMESTAMP'; } else { $fdefault = $this->connection->sysTimeStamp; } } else if ($fdefdate) { if (substr($this->connection->databaseType,0,5) == 'mysql') { $ftype = 'TIMESTAMP'; } else { $fdefault = $this->connection->sysDate; } } else if ($fdefault !== false && !$fnoquote) { if ($ty == 'C' or $ty == 'X' or ( substr($fdefault,0,1) != "'" && !is_numeric($fdefault))) { if (($ty == 'D' || $ty == 'T') && strtolower($fdefault) != 'null') { // convert default date into database-aware code if ($ty == 'T') {
< $fdefault = $this->connection->DBTimeStamp($fdefault);
> $fdefault = $this->connection->dbTimeStamp($fdefault);
} else {
< $fdefault = $this->connection->DBDate($fdefault);
> $fdefault = $this->connection->dbDate($fdefault);
} } else if (strlen($fdefault) != 1 && substr($fdefault,0,1) == ' ' && substr($fdefault,strlen($fdefault)-1) == ' ') $fdefault = trim($fdefault); else if (strtolower($fdefault) != 'null') $fdefault = $this->connection->qstr($fdefault); } }
< $suffix = $this->_CreateSuffix($fname,$ftype,$fnotnull,$fdefault,$fautoinc,$fconstraint,$funsigned);
> $suffix = $this->_createSuffix($fname,$ftype,$fnotnull,$fdefault,$fautoinc,$fconstraint,$funsigned);
// add index creation if ($widespacing) $fname = str_pad($fname,24); // check for field names appearing twice if (array_key_exists($fid, $lines)) { ADOConnection::outp("Field '$fname' defined twice"); } $lines[$fid] = $fname.' '.$ftype.$suffix; if ($fautoinc) $this->autoIncrement = true; } // foreach $flds return array($lines,$pkey,$idxs); } /** GENERATE THE SIZE PART OF THE DATATYPE $ftype is the actual type $ty is the type defined originally in the DDL */
< function _GetSize($ftype, $ty, $fsize, $fprec)
> function _getSize($ftype, $ty, $fsize, $fprec, $options=false)
{ if (strlen($fsize) && $ty != 'X' && $ty != 'B' && strpos($ftype,'(') === false) { $ftype .= "(".$fsize; if (strlen($fprec)) $ftype .= ",".$fprec; $ftype .= ')'; }
> return $ftype; > /* } > * Handle additional options > */ > if (is_array($options)) // return string must begin with space > { function _CreateSuffix($fname,&$ftype,$fnotnull,$fdefault,$fautoinc,$fconstraint,$funsigned) > foreach($options as $type=>$value) { > { $suffix = ''; > switch ($type) if (strlen($fdefault)) $suffix .= " DEFAULT $fdefault"; > { if ($fnotnull) $suffix .= ' NOT NULL'; > case 'ENUM': if ($fconstraint) $suffix .= ' '.$fconstraint; > $ftype .= '(' . $value . ')'; return $suffix; > break; } > > default: function _IndexSQL($idxname, $tabname, $flds, $idxoptions) > } { > } $sql = array(); > } >
< function _CreateSuffix($fname,&$ftype,$fnotnull,$fdefault,$fautoinc,$fconstraint,$funsigned)
> function _createSuffix($fname,&$ftype,$fnotnull,$fdefault,$fautoinc,$fconstraint,$funsigned)
< function _IndexSQL($idxname, $tabname, $flds, $idxoptions)
> function _indexSQL($idxname, $tabname, $flds, $idxoptions)
if ( isset($idxoptions['DROP']) ) return $sql; } if ( empty ($flds) ) { return $sql; } $unique = isset($idxoptions['UNIQUE']) ? ' UNIQUE' : ''; $s = 'CREATE' . $unique . ' INDEX ' . $idxname . ' ON ' . $tabname . ' '; if ( isset($idxoptions[$this->upperName]) ) $s .= $idxoptions[$this->upperName]; if ( is_array($flds) ) $flds = implode(', ',$flds); $s .= '(' . $flds . ')'; $sql[] = $s; return $sql; }
< function _DropAutoIncrement($tabname)
> function _dropAutoIncrement($tabname)
{ return false; }
< function _TableSQL($tabname,$lines,$pkey,$tableoptions)
> function _tableSQL($tabname,$lines,$pkey,$tableoptions)
{ $sql = array(); if (isset($tableoptions['REPLACE']) || isset ($tableoptions['DROP'])) { $sql[] = sprintf($this->dropTable,$tabname); if ($this->autoIncrement) {
< $sInc = $this->_DropAutoIncrement($tabname);
> $sInc = $this->_dropAutoIncrement($tabname);
if ($sInc) $sql[] = $sInc; } if ( isset ($tableoptions['DROP']) ) { return $sql; } }
>
$s = "CREATE TABLE $tabname (\n"; $s .= implode(",\n", $lines); if (sizeof($pkey)>0) { $s .= ",\n PRIMARY KEY ("; $s .= implode(", ",$pkey).")"; } if (isset($tableoptions['CONSTRAINTS'])) $s .= "\n".$tableoptions['CONSTRAINTS']; if (isset($tableoptions[$this->upperName.'_CONSTRAINTS'])) $s .= "\n".$tableoptions[$this->upperName.'_CONSTRAINTS']; $s .= "\n)"; if (isset($tableoptions[$this->upperName])) $s .= $tableoptions[$this->upperName]; $sql[] = $s; return $sql; } /** GENERATE TRIGGERS IF NEEDED used when table has auto-incrementing field that is emulated using triggers */
< function _Triggers($tabname,$taboptions)
> function _triggers($tabname,$taboptions)
{ return array(); } /** Sanitize options, so that array elements with no keys are promoted to keys */
< function _Options($opts)
> function _options($opts)
{ if (!is_array($opts)) return array(); $newopts = array(); foreach($opts as $k => $v) { if (is_numeric($k)) $newopts[strtoupper($v)] = $v; else $newopts[strtoupper($k)] = $v; } return $newopts; } function _getSizePrec($size) { $fsize = false; $fprec = false; $dotat = strpos($size,'.'); if ($dotat === false) $dotat = strpos($size,','); if ($dotat === false) $fsize = $size; else { $fsize = substr($size,0,$dotat); $fprec = substr($size,$dotat+1); } return array($fsize, $fprec); } /**
< "Florian Buzin [ easywe ]" <florian.buzin#easywe.de> < < This function changes/adds new fields to your table. You don't < have to know if the col is new or not. It will check on its own.
> * This function changes/adds new fields to your table. > * > * You don't have to know if the col is new or not. It will check on its own. > * > * @param string $tablename > * @param string $flds > * @param string[] $tableoptions > * @param bool $dropOldFlds > * > * @return string[] Array of SQL Commands
*/
< function ChangeTableSQL($tablename, $flds, $tableoptions = false, $dropOldFlds=false)
> function changeTableSQL($tablename, $flds, $tableoptions = false, $dropOldFlds=false)
{ global $ADODB_FETCH_MODE; $save = $ADODB_FETCH_MODE; $ADODB_FETCH_MODE = ADODB_FETCH_ASSOC;
< if ($this->connection->fetchMode !== false) $savem = $this->connection->SetFetchMode(false);
> if ($this->connection->fetchMode !== false) $savem = $this->connection->setFetchMode(false);
// check table exists $save_handler = $this->connection->raiseErrorFn; $this->connection->raiseErrorFn = '';
< $cols = $this->MetaColumns($tablename);
> $cols = $this->metaColumns($tablename);
$this->connection->raiseErrorFn = $save_handler;
< if (isset($savem)) $this->connection->SetFetchMode($savem);
> if (isset($savem)) $this->connection->setFetchMode($savem);
$ADODB_FETCH_MODE = $save; if ( empty($cols)) {
< return $this->CreateTableSQL($tablename, $flds, $tableoptions);
> return $this->createTableSQL($tablename, $flds, $tableoptions);
} if (is_array($flds)) { // Cycle through the update fields, comparing // existing fields to fields to update. // if the Metatype and size is exactly the // same, ignore - by Mark Newham $holdflds = array(); foreach($flds as $k=>$v) { if ( isset($cols[$k]) && is_object($cols[$k]) ) { // If already not allowing nulls, then don't change $obj = $cols[$k]; if (isset($obj->not_null) && $obj->not_null) $v = str_replace('NOT NULL','',$v); if (isset($obj->auto_increment) && $obj->auto_increment && empty($v['AUTOINCREMENT'])) $v = str_replace('AUTOINCREMENT','',$v); $c = $cols[$k]; $ml = $c->max_length;
< $mt = $this->MetaType($c->type,$ml);
> $mt = $this->metaType($c->type,$ml);
if (isset($c->scale)) $sc = $c->scale; else $sc = 99; // always force change if scale not known. if ($sc == -1) $sc = false; list($fsize, $fprec) = $this->_getSizePrec($v['SIZE']); if ($ml == -1) $ml = ''; if ($mt == 'X') $ml = $v['SIZE']; if (($mt != $v['TYPE']) || ($ml != $fsize || $sc != $fprec) || (isset($v['AUTOINCREMENT']) && $v['AUTOINCREMENT'] != $obj->auto_increment)) { $holdflds[$k] = $v; } } else { $holdflds[$k] = $v; } } $flds = $holdflds; }
> $sql = $this->alterColumnSql($tablename, $flds);
< // already exists, alter table instead < list($lines,$pkey,$idxs) = $this->_GenFields($flds); < // genfields can return FALSE at times < if ($lines == null) $lines = array(); < $alter = 'ALTER TABLE ' . $this->TableName($tablename); < $sql = array(); < < foreach ( $lines as $id => $v ) { < if ( isset($cols[$id]) && is_object($cols[$id]) ) { < < $flds = Lens_ParseArgs($v,','); < < // We are trying to change the size of the field, if not allowed, simply ignore the request. < // $flds[1] holds the type, $flds[2] holds the size -postnuke addition < if ($flds && in_array(strtoupper(substr($flds[0][1],0,4)),$this->invalidResizeTypes4) < && (isset($flds[0][2]) && is_numeric($flds[0][2]))) { < if ($this->debug) ADOConnection::outp(sprintf("<h3>%s cannot be changed to %s currently</h3>", $flds[0][0], $flds[0][1])); < #echo "<h3>$this->alterCol cannot be changed to $flds currently</h3>"; < continue; < } < $sql[] = $alter . $this->alterCol . ' ' . $v; < } else { < $sql[] = $alter . $this->addCol . ' ' . $v;
> if ($dropOldFlds) { > foreach ($cols as $id => $v) { > if (!isset($lines[$id])) { > $sql[] = $this->dropColumnSQL($tablename, $flds);
} }
< < if ($dropOldFlds) { < foreach ( $cols as $id => $v ) < if ( !isset($lines[$id]) ) < $sql[] = $alter . $this->dropCol . ' ' . $v->name;
} return $sql; } } // class