Proyectos de Subversion Moodle

Rev

Autoría | Ultima modificación | Ver Log |

<?php
/**
 * 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();

/**
 * 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);
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='_.-')
{
        $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 $blobSize = 100;    /// any varchar/char field this size or greater is treated as a blob
                                                        /// 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;


        /**
         * @var string String to use to quote identifiers and names
         */
        public $quote;

        function getCommentSQL($table,$col)
        {
                return false;
        }

        function setCommentSQL($table,$col,$cmt)
        {
                return false;
        }

        function metaTables()
        {
                if (!$this->connection->isConnected()) return array();
                return $this->connection->metaTables();
        }

        function metaColumns($tab, $upper=true, $schema=false)
        {
                if (!$this->connection->isConnected()) return array();
                return $this->connection->metaColumns($this->tableName($tab), $upper, $schema);
        }

        function metaPrimaryKeys($tab,$owner=false,$intkey=false)
        {
                if (!$this->connection->isConnected()) return array();
                return $this->connection->metaPrimaryKeys($this->tableName($tab), $owner, $intkey);
        }

        function metaIndexes($table, $primary = false, $owner = false)
        {
                if (!$this->connection->isConnected()) return array();
                return $this->connection->metaIndexes($this->tableName($table), $primary, $owner);
        }

        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()) {
                        $t = strtoupper($t);
                        if (isset($typeMap[$t])) return $typeMap[$t];
                        return ADODB_DEFAULT_METATYPE;
                }
                return $this->connection->metaType($t,$len,$fieldobj);
        }

        function nameQuote($name = NULL,$allowBrackets=false)
        {
                if (!is_string($name)) {
                        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)
        {
                if ( $this->schema ) {
                        return $this->nameQuote($this->schema) .'.'. $this->nameQuote($name);
                }
                return $this->nameQuote($name);
        }

        // 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);
                        $conn->debug = $saved;
                        if (!$ok) {
                                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)
        {
                $meta = strtoupper($meta);

                /*
                * 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'];

                return $meta;
        }

        function createDatabase($dbname,$options=false)
        {
                $options = $this->_options($options);
                $sql = array();

                $s = 'CREATE DATABASE ' . $this->nameQuote($dbname);
                if (isset($options[$this->upperName]))
                        $s .= ' '.$options[$this->upperName];

                $sql[] = $s;
                return $sql;
        }

        /*
         Generates the SQL to create index. Returns an array of sql strings.
        */
        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);
                }

                return $this->_indexSQL($this->nameQuote($idxname), $this->tableName($tabname), $flds, $this->_options($idxoptions));
        }

        function dropIndexSQL ($idxname, $tabname = NULL)
        {
                return array(sprintf($this->dropIndex, $this->nameQuote($idxname), $this->tableName($tabname)));
        }

        function setSchema($schema)
        {
                $this->schema = $schema;
        }

        function addColumnSQL($tabname, $flds)
        {
                $tabname = $this->tableName($tabname);
                $sql = array();
                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 = array_merge($sql, $sql_idxs);
                        }
                }
                return $sql;
        }

        /**
         * Change the definition of one column
         *
         * 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 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='')
        {
                $tabname = $this->tableName($tabname);
                $sql = array();
                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 = array_merge($sql, $sql_idxs);
                        }

                }
                return $sql;
        }

        /**
         * Rename one column
         *
         * 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-definition-string like for addColumnSQL, only used by mysql atm., default=''
         * @return array with SQL strings
         */
        function renameColumnSQL($tabname,$oldcolumn,$newcolumn,$flds='')
        {
                $tabname = $this->tableName($tabname);
                if ($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));
        }

        /**
         * Drop one column
         *
         * 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 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='')
        {
                $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);
                }
                return $sql;
        }

        function dropTableSQL($tabname)
        {
                return array (sprintf($this->dropTable, $this->tableName($tabname)));
        }

        function renameTableSQL($tabname,$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())
        {
                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);

                // 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);
                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;
        }



        function _genFields($flds,$widespacing=false)
        {
                if (is_string($flds)) {
                        $padding = '     ';
                        $txt = $flds.$padding;
                        $flds = array();
                        $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) {
                        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';
                                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 'SIZE':
                                        $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':
                                        $fOptions['ENUM'] = $v; break;
                                } //switch
                        } // 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);

                        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, $fOptions);

                        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 (($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);
                                                }
                                                else
                                                {
                                                        $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);

                        // 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, $options=false)
        {
                if (strlen($fsize) && $ty != 'X' && $ty != 'B' && strpos($ftype,'(') === false) {
                        $ftype .= "(".$fsize;
                        if (strlen($fprec)) $ftype .= ",".$fprec;
                        $ftype .= ')';
                }

                /*
                * Handle additional options
                */
                if (is_array($options))
                {
                        foreach($options as $type=>$value)
                        {
                                switch ($type)
                                {
                                        case 'ENUM':
                                        $ftype .= '(' . $value . ')';
                                        break;

                                        default:
                                }
                        }
                }

                return $ftype;
        }


        // return string must begin with space
        function _createSuffix($fname,&$ftype,$fnotnull,$fdefault,$fautoinc,$fconstraint,$funsigned)
        {
                $suffix = '';
                if (strlen($fdefault)) $suffix .= " DEFAULT $fdefault";
                if ($fnotnull) $suffix .= ' NOT NULL';
                if ($fconstraint) $suffix .= ' '.$fconstraint;
                return $suffix;
        }

        function _indexSQL($idxname, $tabname, $flds, $idxoptions)
        {
                $sql = array();

                if ( isset($idxoptions['REPLACE']) || isset($idxoptions['DROP']) ) {
                        $sql[] = sprintf ($this->dropIndex, $idxname);
                        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)
        {
                return false;
        }

        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);
                                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)
        {
                return array();
        }

        /**
                Sanitize options, so that array elements with no keys are promoted to keys
        */
        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);
        }

        /**
         * 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)
        {
        global $ADODB_FETCH_MODE;

                $save = $ADODB_FETCH_MODE;
                $ADODB_FETCH_MODE = ADODB_FETCH_ASSOC;
                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);
                $this->connection->raiseErrorFn = $save_handler;

                if (isset($savem)) $this->connection->setFetchMode($savem);
                $ADODB_FETCH_MODE = $save;

                if ( empty($cols)) {
                        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);

                                        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);

                if ($dropOldFlds) {
                        foreach ($cols as $id => $v) {
                                if (!isset($lines[$id])) {
                                        $sql[] = $this->dropColumnSQL($tablename, $flds);
                                }
                        }
                }
                return $sql;
        }
} // class