- fixed #1485032 and updated MDB2 package+drivers

alecpl

2008-05-02 d1403fd7268ccf96ab6e7d04506ea1b1802c7eb2

- fixed #1485032 and updated MDB2 package+drivers

 CHANGELOG

@@ -1,6 +1,13 @@
CHANGELOG RoundCube Webmail
---------------------------

2008/05/02 (alec)
----------
- Updated MDB2 package to version 2.5.0b1
- Updated MDB2 pgsql, mysql, mysqli, sqlite drivers to version 1.5.0b1
- Updated MDB2 mssql driver to version 1.3.0b1
- Fixed identities saving when using MDB2 pgsql driver (#1485032)

2008/05/01 (alec)
----------
- Fix BCC header reset (#1484997)

 program/lib/MDB2.php

@@ -43,7 +43,7 @@
// | Author: Lukas Smith <smith@pooteeweet.org>                           |

// +----------------------------------------------------------------------+

//

// $Id: MDB2.php,v 1.307 2007/11/10 13:29:05 quipo Exp $

// $Id: MDB2.php,v 1.318 2008/03/08 14:18:38 quipo Exp $

//



/**

@@ -100,6 +100,8 @@
define('MDB2_ERROR_MANAGER_PARSE',      -33);

define('MDB2_ERROR_LOADMODULE',         -34);

define('MDB2_ERROR_INSUFFICIENT_DATA',  -35);

define('MDB2_ERROR_NO_PERMISSION',      -36);



// }}}

// {{{ Verbose constants

/**

@@ -564,7 +566,7 @@
     */

    function apiVersion()

    {

        return '2.5.0a2';

        return '2.5.0b1';

    }



    // }}}

@@ -764,6 +766,7 @@
                MDB2_ERROR_LOADMODULE         => 'error while including on demand module',

                MDB2_ERROR_TRUNCATED          => 'truncated',

                MDB2_ERROR_DEADLOCK           => 'deadlock detected',

                MDB2_ERROR_NO_PERMISSION      => 'no permission',

            );

        }



@@ -888,7 +891,7 @@
                //"username/password@[//]host[:port][/service_name]"

                //e.g. "scott/tiger@//mymachine:1521/oracle"

                $proto_opts = $dsn;

                $dsn = null;

                $dsn = substr($proto_opts, strrpos($proto_opts, '/') + 1);

            } elseif (strpos($dsn, '/') !== false) {

                list($proto_opts, $dsn) = explode('/', $dsn, 2);

            } else {

@@ -1095,6 +1098,7 @@
        'LOBs' => false,

        'replace' => false,

        'sub_selects' => false,

        'triggers' => false,

        'auto_increment' => false,

        'primary_key' => false,

        'result_introspection' => false,

@@ -1142,6 +1146,7 @@
     *  <li>$options['datatype_map'] -> array: map user defined datatypes to other primitive datatypes</li>

     *  <li>$options['datatype_map_callback'] -> array: callback function/method that should be called</li>

     *  <li>$options['bindname_format'] -> string: regular expression pattern for named parameters

     *  <li>$options['max_identifiers_length'] -> integer: max identifier length</li>

     * </ul>

     *

     * @var     array

@@ -1190,6 +1195,7 @@
        'nativetype_map_callback' => array(),

        'lob_allow_url_include' => false,

        'bindname_format' => '(?:\d+)|(?:[a-zA-Z][a-zA-Z0-9_]*)',

        'max_identifiers_length' => 30,

    );



    /**

@@ -2219,6 +2225,23 @@
    }



    // }}}

    // {{{ databaseExists()



    /**

     * check if given database name is exists?

     *

     * @param string $name    name of the database that should be checked

     *

     * @return mixed true/false on success, a MDB2 error on failure

     * @access public

     */

    function databaseExists($name)

    {

        return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

            'method not implemented', __FUNCTION__);

    }



    // }}}

    // {{{ setCharset($charset, $connection = null)



    /**

@@ -2277,7 +2300,9 @@
    {

        $previous_database_name = (isset($this->database_name)) ? $this->database_name : '';

        $this->database_name = $name;

        $this->disconnect(false);

        if (!empty($this->connected_database_name) && ($this->connected_database_name != $this->database_name)) {

            $this->disconnect(false);

        }

        return $previous_database_name;

    }



@@ -2795,7 +2820,7 @@
                    return $this->raiseError(MDB2_ERROR_CANNOT_REPLACE, null, null,

                        'key value '.$name.' may not be NULL', __FUNCTION__);

                }

                $condition[] = $name . '=' . $value;

                $condition[] = $this->quoteIdentifier($name, true) . '=' . $value;

            }

        }

        if (empty($condition)) {

@@ -2815,13 +2840,16 @@
        }



        $condition = ' WHERE '.implode(' AND ', $condition);

        $query = "DELETE FROM $table$condition";

        $query = 'DELETE FROM ' . $this->quoteIdentifier($table, true) . $condition;

        $result =& $this->_doQuery($query, true, $connection);

        if (!PEAR::isError($result)) {

            $affected_rows = $this->_affectedRows($connection, $result);

            $insert = implode(', ', array_keys($values));

            $insert = '';

            foreach ($values as $key => $value) {

                $insert .= ($insert?', ':'') . $this->quoteIdentifier($key, true);

            }

            $values = implode(', ', $values);

            $query = "INSERT INTO $table ($insert) VALUES ($values)";

            $query = 'INSERT INTO '. $this->quoteIdentifier($table, true) . "($insert) VALUES ($values)";

            $result =& $this->_doQuery($query, true, $connection);

            if (!PEAR::isError($result)) {

                $affected_rows += $this->_affectedRows($connection, $result);;

@@ -2998,7 +3026,7 @@
                                return $err;

                            }

                        }

                    } while ($ignore['escape'] && $query[($end_quote - 1)] == $ignore['escape']);

                    } while ($ignore['escape'] && $query[($end_quote - 1)] == $ignore['escape'] && $end_quote-1 != $start_quote);

                    $position = $end_quote + 1;

                    return $position;

                }

@@ -3980,9 +4008,11 @@
        $types = is_array($types) ? array_values($types) : array_fill(0, count($values), null);

        $parameters = array_keys($values);

        foreach ($parameters as $key => $parameter) {

            $this->db->pushErrorHandling(PEAR_ERROR_RETURN);

            $this->db->expectError(MDB2_ERROR_NOT_FOUND);

            $err = $this->bindValue($parameter, $values[$parameter], $types[$key]);

            $this->db->popExpect();

            $this->db->popErrorHandling();

            if (PEAR::isError($err)) {

                if ($err->getCode() == MDB2_ERROR_NOT_FOUND) {

                    //ignore (extra value for missing placeholder)


 program/lib/MDB2/Driver/Datatype/Common.php

@@ -1,1830 +1,1824 @@
<?php

// +----------------------------------------------------------------------+

// | PHP versions 4 and 5                                                 |

// +----------------------------------------------------------------------+

// | Copyright (c) 1998-2007 Manuel Lemos, Tomas V.V.Cox,                 |

// | Stig. S. Bakken, Lukas Smith                                         |

// | All rights reserved.                                                 |

// +----------------------------------------------------------------------+

// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |

// | API as well as database abstraction for PHP applications.            |

// | This LICENSE is in the BSD license style.                            |

// |                                                                      |

// | Redistribution and use in source and binary forms, with or without   |

// | modification, are permitted provided that the following conditions   |

// | are met:                                                             |

// |                                                                      |

// | Redistributions of source code must retain the above copyright       |

// | notice, this list of conditions and the following disclaimer.        |

// |                                                                      |

// | Redistributions in binary form must reproduce the above copyright    |

// | notice, this list of conditions and the following disclaimer in the  |

// | documentation and/or other materials provided with the distribution. |

// |                                                                      |

// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |

// | Lukas Smith nor the names of his contributors may be used to endorse |

// | or promote products derived from this software without specific prior|

// | written permission.                                                  |

// |                                                                      |

// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |

// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |

// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |

// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |

// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |

// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |

// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|

// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |

// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |

// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|

// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |

// | POSSIBILITY OF SUCH DAMAGE.                                          |

// +----------------------------------------------------------------------+

// | Author: Lukas Smith <smith@pooteeweet.org>                           |

// +----------------------------------------------------------------------+

//

// $Id: Common.php,v 1.128 2007/11/09 20:54:58 quipo Exp $



require_once 'MDB2/LOB.php';



/**

 * @package  MDB2

 * @category Database

 * @author   Lukas Smith <smith@pooteeweet.org>

 */



/**

 * MDB2_Driver_Common: Base class that is extended by each MDB2 driver

 *

 * To load this module in the MDB2 object:

 * $mdb->loadModule('Datatype');

 *

 * @package MDB2

 * @category Database

 * @author Lukas Smith <smith@pooteeweet.org>

 */

class MDB2_Driver_Datatype_Common extends MDB2_Module_Common

{

    var $valid_default_values = array(

        'text'      => '',

        'boolean'   => true,

        'integer'   => 0,

        'decimal'   => 0.0,

        'float'     => 0.0,

        'timestamp' => '1970-01-01 00:00:00',

        'time'      => '00:00:00',

        'date'      => '1970-01-01',

        'clob'      => '',

        'blob'      => '',

    );



    /**

     * contains all LOB objects created with this MDB2 instance

     * @var array

     * @access protected

     */

    var $lobs = array();



    // }}}

    // {{{ getValidTypes()



    /**

     * Get the list of valid types

     *

     * This function returns an array of valid types as keys with the values

     * being possible default values for all native datatypes and mapped types

     * for custom datatypes.

     *

     * @return mixed array on success, a MDB2 error on failure

     * @access public

     */

    function getValidTypes()

    {

        $types = $this->valid_default_values;

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }

        if (!empty($db->options['datatype_map'])) {

            foreach ($db->options['datatype_map'] as $type => $mapped_type) {

                if (array_key_exists($mapped_type, $types)) {

                    $types[$type] = $types[$mapped_type];

                } elseif (!empty($db->options['datatype_map_callback'][$type])) {

                    $parameter = array('type' => $type, 'mapped_type' => $mapped_type);

                    $default =  call_user_func_array($db->options['datatype_map_callback'][$type], array(&$db, __FUNCTION__, $parameter));

                    $types[$type] = $default;

                }

            }

        }

        return $types;

    }



    // }}}

    // {{{ checkResultTypes()



    /**

     * Define the list of types to be associated with the columns of a given

     * result set.

     *

     * This function may be called before invoking fetchRow(), fetchOne()

     * fetchCole() and fetchAll() so that the necessary data type

     * conversions are performed on the data to be retrieved by them. If this

     * function is not called, the type of all result set columns is assumed

     * to be text, thus leading to not perform any conversions.

     *

     * @param array $types array variable that lists the

     *       data types to be expected in the result set columns. If this array

     *       contains less types than the number of columns that are returned

     *       in the result set, the remaining columns are assumed to be of the

     *       type text. Currently, the types clob and blob are not fully

     *       supported.

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function checkResultTypes($types)

    {

        $types = is_array($types) ? $types : array($types);

        foreach ($types as $key => $type) {

            if (!isset($this->valid_default_values[$type])) {

                $db =& $this->getDBInstance();

                if (PEAR::isError($db)) {

                    return $db;

                }

                if (empty($db->options['datatype_map'][$type])) {

                    return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

                        $type.' for '.$key.' is not a supported column type', __FUNCTION__);

                }

            }

        }

        return $types;

    }



    // }}}

    // {{{ _baseConvertResult()



    /**

     * General type conversion method

     *

     * @param mixed   $value reference to a value to be converted

     * @param string  $type  specifies which type to convert to

     * @param boolean $rtrim [optional] when TRUE [default], apply rtrim() to text

     * @return object an MDB2 error on failure

     * @access protected

     */

    function _baseConvertResult($value, $type, $rtrim = true)

    {

        switch ($type) {

        case 'text':

            if ($rtrim) {

                $value = rtrim($value);

            }

            return $value;

        case 'integer':

            return intval($value);

        case 'boolean':

            return !empty($value);

        case 'decimal':

            return $value;

        case 'float':

            return doubleval($value);

        case 'date':

            return $value;

        case 'time':

            return $value;

        case 'timestamp':

            return $value;

        case 'clob':

        case 'blob':

            $this->lobs[] = array(

                'buffer' => null,

                'position' => 0,

                'lob_index' => null,

                'endOfLOB' => false,

                'resource' => $value,

                'value' => null,

                'loaded' => false,

            );

            end($this->lobs);

            $lob_index = key($this->lobs);

            $this->lobs[$lob_index]['lob_index'] = $lob_index;

            return fopen('MDB2LOB://'.$lob_index.'@'.$this->db_index, 'r+');

        }



        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        return $db->raiseError(MDB2_ERROR_INVALID, null, null,

            'attempt to convert result value to an unknown type :' . $type, __FUNCTION__);

    }



    // }}}

    // {{{ convertResult()



    /**

     * Convert a value to a RDBMS indipendent MDB2 type

     *

     * @param mixed   $value value to be converted

     * @param string  $type  specifies which type to convert to

     * @param boolean $rtrim [optional] when TRUE [default], apply rtrim() to text

     * @return mixed converted value

     * @access public

     */

    function convertResult($value, $type, $rtrim = true)

    {

        if (is_null($value)) {

            return null;

        }

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }

        if (!empty($db->options['datatype_map'][$type])) {

            $type = $db->options['datatype_map'][$type];

            if (!empty($db->options['datatype_map_callback'][$type])) {

                $parameter = array('type' => $type, 'value' => $value, 'rtrim' => $rtrim);

                return call_user_func_array($db->options['datatype_map_callback'][$type], array(&$db, __FUNCTION__, $parameter));

            }

        }

        return $this->_baseConvertResult($value, $type, $rtrim);

    }



    // }}}

    // {{{ convertResultRow()



    /**

     * Convert a result row

     *

     * @param array   $types

     * @param array   $row   specifies the types to convert to

     * @param boolean $rtrim [optional] when TRUE [default], apply rtrim() to text

     * @return mixed MDB2_OK on success, an MDB2 error on failure

     * @access public

     */

    function convertResultRow($types, $row, $rtrim = true)

    {

        $types = $this->_sortResultFieldTypes(array_keys($row), $types);

        foreach ($row as $key => $value) {

            if (empty($types[$key])) {

                continue;

            }

            $value = $this->convertResult($row[$key], $types[$key], $rtrim);

            if (PEAR::isError($value)) {

                return $value;

            }

            $row[$key] = $value;

        }

        return $row;

    }



    // }}}

    // {{{ _sortResultFieldTypes()



    /**

     * convert a result row

     *

     * @param array $types

     * @param array $row specifies the types to convert to

     * @param bool   $rtrim   if to rtrim text values or not

     * @return mixed MDB2_OK on success,  a MDB2 error on failure

     * @access public

     */

    function _sortResultFieldTypes($columns, $types)

    {

        $n_cols = count($columns);

        $n_types = count($types);

        if ($n_cols > $n_types) {

            for ($i= $n_cols - $n_types; $i >= 0; $i--) {

                $types[] = null;

            }

        }

        $sorted_types = array();

        foreach ($columns as $col) {

            $sorted_types[$col] = null;

        }

        foreach ($types as $name => $type) {

            if (array_key_exists($name, $sorted_types)) {

                $sorted_types[$name] = $type;

                unset($types[$name]);

            }

        }

        // if there are left types in the array, fill the null values of the

        // sorted array with them, in order.

        if (count($types)) {

            reset($types);

            foreach (array_keys($sorted_types) as $k) {

                if (is_null($sorted_types[$k])) {

                    $sorted_types[$k] = current($types);

                    next($types);

                }

            }

        }

        return $sorted_types;

    }



    // }}}

    // {{{ getDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to declare

     * of the given type

     *

     * @param string $type type to which the value should be converted to

     * @param string  $name   name the field to be declared.

     * @param string  $field  definition of the field

     * @return string  DBMS specific SQL code portion that should be used to

     *                 declare the specified field.

     * @access public

     */

    function getDeclaration($type, $name, $field)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        if (!empty($db->options['datatype_map'][$type])) {

            $type = $db->options['datatype_map'][$type];

            if (!empty($db->options['datatype_map_callback'][$type])) {

                $parameter = array('type' => $type, 'name' => $name, 'field' => $field);

                return call_user_func_array($db->options['datatype_map_callback'][$type], array(&$db, __FUNCTION__, $parameter));

            }

            $field['type'] = $type;

        }



        if (!method_exists($this, "_get{$type}Declaration")) {

            return $db->raiseError(MDB2_ERROR_NOT_FOUND, null, null,

                'type not defined: '.$type, __FUNCTION__);

        }

        return $this->{"_get{$type}Declaration"}($name, $field);

    }



    // }}}

    // {{{ getTypeDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to declare an text type

     * field to be used in statements like CREATE TABLE.

     *

     * @param array $field  associative array with the name of the properties

     *      of the field being declared as array indexes. Currently, the types

     *      of supported field properties are as follows:

     *

     *      length

     *          Integer value that determines the maximum length of the text

     *          field. If this argument is missing the field should be

     *          declared to have the longest length allowed by the DBMS.

     *

     *      default

     *          Text value to be used as default for this field.

     *

     *      notnull

     *          Boolean flag that indicates whether this field is constrained

     *          to not be set to null.

     * @return string  DBMS specific SQL code portion that should be used to

     *      declare the specified field.

     * @access public

     */

    function getTypeDeclaration($field)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        switch ($field['type']) {

        case 'text':

            $length = !empty($field['length']) ? $field['length'] : $db->options['default_text_field_length'];

            $fixed = !empty($field['fixed']) ? $field['fixed'] : false;

            return $fixed ? ($length ? 'CHAR('.$length.')' : 'CHAR('.$db->options['default_text_field_length'].')')

                : ($length ? 'VARCHAR('.$length.')' : 'TEXT');

        case 'clob':

            return 'TEXT';

        case 'blob':

            return 'TEXT';

        case 'integer':

            return 'INT';

        case 'boolean':

            return 'INT';

        case 'date':

            return 'CHAR ('.strlen('YYYY-MM-DD').')';

        case 'time':

            return 'CHAR ('.strlen('HH:MM:SS').')';

        case 'timestamp':

            return 'CHAR ('.strlen('YYYY-MM-DD HH:MM:SS').')';

        case 'float':

            return 'TEXT';

        case 'decimal':

            return 'TEXT';

        }

        return '';

    }



    // }}}

    // {{{ _getDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to declare a generic type

     * field to be used in statements like CREATE TABLE.

     *

     * @param string $name   name the field to be declared.

     * @param array  $field  associative array with the name of the properties

     *      of the field being declared as array indexes. Currently, the types

     *      of supported field properties are as follows:

     *

     *      length

     *          Integer value that determines the maximum length of the text

     *          field. If this argument is missing the field should be

     *          declared to have the longest length allowed by the DBMS.

     *

     *      default

     *          Text value to be used as default for this field.

     *

     *      notnull

     *          Boolean flag that indicates whether this field is constrained

     *          to not be set to null.

     *      charset

     *          Text value with the default CHARACTER SET for this field.

     *      collation

     *          Text value with the default COLLATION for this field.

     * @return string  DBMS specific SQL code portion that should be used to

     *      declare the specified field, or a MDB2_Error on failure

     * @access protected

     */

    function _getDeclaration($name, $field)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $name = $db->quoteIdentifier($name, true);

        $declaration_options = $db->datatype->_getDeclarationOptions($field);

        if (PEAR::isError($declaration_options)) {

            return $declaration_options;

        }

        return $name.' '.$this->getTypeDeclaration($field).$declaration_options;

    }



    // }}}

    // {{{ _getDeclarationOptions()



    /**

     * Obtain DBMS specific SQL code portion needed to declare a generic type

     * field to be used in statement like CREATE TABLE, without the field name

     * and type values (ie. just the character set, default value, if the

     * field is permitted to be NULL or not, and the collation options).

     *

     * @param array  $field  associative array with the name of the properties

     *      of the field being declared as array indexes. Currently, the types

     *      of supported field properties are as follows:

     *

     *      default

     *          Text value to be used as default for this field.

     *      notnull

     *          Boolean flag that indicates whether this field is constrained

     *          to not be set to null.

     *      charset

     *          Text value with the default CHARACTER SET for this field.

     *      collation

     *          Text value with the default COLLATION for this field.

     * @return string  DBMS specific SQL code portion that should be used to

     *      declare the specified field's options.

     * @access protected

     */

    function _getDeclarationOptions($field)

    {

        $charset = empty($field['charset']) ? '' :

            ' '.$this->_getCharsetFieldDeclaration($field['charset']);



        $default = '';

        if (array_key_exists('default', $field)) {

            if ($field['default'] === '') {

                $db =& $this->getDBInstance();

                if (PEAR::isError($db)) {

                    return $db;

                }

                if (empty($field['notnull'])) {

                    $field['default'] = null;

                } else {

                    $valid_default_values = $this->getValidTypes();

                    $field['default'] = $valid_default_values[$field['type']];

                }

                if ($field['default'] === ''

                    && ($db->options['portability'] & MDB2_PORTABILITY_EMPTY_TO_NULL)

                ) {

                    $field['default'] = ' ';

                }

            }

            $default = ' DEFAULT '.$this->quote($field['default'], $field['type']);

        } elseif (empty($field['notnull'])) {

            $default = ' DEFAULT NULL';

        }



        $notnull = empty($field['notnull']) ? '' : ' NOT NULL';

        
        $collation = empty($field['collation']) ? '' :

            ' '.$this->_getCollationFieldDeclaration($field['collation']);

        return $charset.$default.$notnull.$collation;

    }



    // }}}

    // {{{ _getCharsetFieldDeclaration()

    
    /**

     * Obtain DBMS specific SQL code portion needed to set the CHARACTER SET

     * of a field declaration to be used in statements like CREATE TABLE.

     *

     * @param string $charset   name of the charset

     * @return string  DBMS specific SQL code portion needed to set the CHARACTER SET

     *                 of a field declaration.

     */

    function _getCharsetFieldDeclaration($charset)

    {

        return '';

    }



    // }}}

    // {{{ _getCollationFieldDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to set the COLLATION

     * of a field declaration to be used in statements like CREATE TABLE.

     *

     * @param string $collation   name of the collation

     * @return string  DBMS specific SQL code portion needed to set the COLLATION

     *                 of a field declaration.

     */

    function _getCollationFieldDeclaration($collation)

    {

        return '';

    }



    // }}}

    // {{{ _getIntegerDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to declare an integer type

     * field to be used in statements like CREATE TABLE.

     *

     * @param string $name name the field to be declared.

     * @param array $field associative array with the name of the properties

     *       of the field being declared as array indexes. Currently, the types

     *       of supported field properties are as follows:

     *

     *       unsigned

     *           Boolean flag that indicates whether the field should be

     *           declared as unsigned integer if possible.

     *

     *       default

     *           Integer value to be used as default for this field.

     *

     *       notnull

     *           Boolean flag that indicates whether this field is constrained

     *           to not be set to null.

     * @return string DBMS specific SQL code portion that should be used to

     *       declare the specified field.

     * @access protected

     */

    function _getIntegerDeclaration($name, $field)

    {

        if (!empty($field['unsigned'])) {

            $db =& $this->getDBInstance();

            if (PEAR::isError($db)) {

                return $db;

            }



            $db->warnings[] = "unsigned integer field \"$name\" is being declared as signed integer";

        }

        return $this->_getDeclaration($name, $field);

    }



    // }}}

    // {{{ _getTextDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to declare an text type

     * field to be used in statements like CREATE TABLE.

     *

     * @param string $name name the field to be declared.

     * @param array $field associative array with the name of the properties

     *       of the field being declared as array indexes. Currently, the types

     *       of supported field properties are as follows:

     *

     *       length

     *           Integer value that determines the maximum length of the text

     *           field. If this argument is missing the field should be

     *           declared to have the longest length allowed by the DBMS.

     *

     *       default

     *           Text value to be used as default for this field.

     *

     *       notnull

     *           Boolean flag that indicates whether this field is constrained

     *           to not be set to null.

     * @return string DBMS specific SQL code portion that should be used to

     *       declare the specified field.

     * @access protected

     */

    function _getTextDeclaration($name, $field)

    {

        return $this->_getDeclaration($name, $field);

    }



    // }}}

    // {{{ _getCLOBDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to declare an character

     * large object type field to be used in statements like CREATE TABLE.

     *

     * @param string $name name the field to be declared.

     * @param array $field associative array with the name of the properties

     *        of the field being declared as array indexes. Currently, the types

     *        of supported field properties are as follows:

     *

     *        length

     *            Integer value that determines the maximum length of the large

     *            object field. If this argument is missing the field should be

     *            declared to have the longest length allowed by the DBMS.

     *

     *        notnull

     *            Boolean flag that indicates whether this field is constrained

     *            to not be set to null.

     * @return string DBMS specific SQL code portion that should be used to

     *        declare the specified field.

     * @access public

     */

    function _getCLOBDeclaration($name, $field)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $notnull = empty($field['notnull']) ? '' : ' NOT NULL';

        $name = $db->quoteIdentifier($name, true);

        return $name.' '.$this->getTypeDeclaration($field).$notnull;

    }



    // }}}

    // {{{ _getBLOBDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to declare an binary large

     * object type field to be used in statements like CREATE TABLE.

     *

     * @param string $name name the field to be declared.

     * @param array $field associative array with the name of the properties

     *        of the field being declared as array indexes. Currently, the types

     *        of supported field properties are as follows:

     *

     *        length

     *            Integer value that determines the maximum length of the large

     *            object field. If this argument is missing the field should be

     *            declared to have the longest length allowed by the DBMS.

     *

     *        notnull

     *            Boolean flag that indicates whether this field is constrained

     *            to not be set to null.

     * @return string DBMS specific SQL code portion that should be used to

     *        declare the specified field.

     * @access protected

     */

    function _getBLOBDeclaration($name, $field)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $notnull = empty($field['notnull']) ? '' : ' NOT NULL';

        $name = $db->quoteIdentifier($name, true);

        return $name.' '.$this->getTypeDeclaration($field).$notnull;

    }



    // }}}

    // {{{ _getBooleanDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to declare a boolean type

     * field to be used in statements like CREATE TABLE.

     *

     * @param string $name name the field to be declared.

     * @param array $field associative array with the name of the properties

     *       of the field being declared as array indexes. Currently, the types

     *       of supported field properties are as follows:

     *

     *       default

     *           Boolean value to be used as default for this field.

     *

     *       notnullL

     *           Boolean flag that indicates whether this field is constrained

     *           to not be set to null.

     * @return string DBMS specific SQL code portion that should be used to

     *       declare the specified field.

     * @access protected

     */

    function _getBooleanDeclaration($name, $field)

    {

        return $this->_getDeclaration($name, $field);

    }



    // }}}

    // {{{ _getDateDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to declare a date type

     * field to be used in statements like CREATE TABLE.

     *

     * @param string $name name the field to be declared.

     * @param array $field associative array with the name of the properties

     *       of the field being declared as array indexes. Currently, the types

     *       of supported field properties are as follows:

     *

     *       default

     *           Date value to be used as default for this field.

     *

     *       notnull

     *           Boolean flag that indicates whether this field is constrained

     *           to not be set to null.

     * @return string DBMS specific SQL code portion that should be used to

     *       declare the specified field.

     * @access protected

     */

    function _getDateDeclaration($name, $field)

    {

        return $this->_getDeclaration($name, $field);

    }



    // }}}

    // {{{ _getTimestampDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to declare a timestamp

     * field to be used in statements like CREATE TABLE.

     *

     * @param string $name name the field to be declared.

     * @param array $field associative array with the name of the properties

     *       of the field being declared as array indexes. Currently, the types

     *       of supported field properties are as follows:

     *

     *       default

     *           Timestamp value to be used as default for this field.

     *

     *       notnull

     *           Boolean flag that indicates whether this field is constrained

     *           to not be set to null.

     * @return string DBMS specific SQL code portion that should be used to

     *       declare the specified field.

     * @access protected

     */

    function _getTimestampDeclaration($name, $field)

    {

        return $this->_getDeclaration($name, $field);

    }



    // }}}

    // {{{ _getTimeDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to declare a time

     * field to be used in statements like CREATE TABLE.

     *

     * @param string $name name the field to be declared.

     * @param array $field associative array with the name of the properties

     *       of the field being declared as array indexes. Currently, the types

     *       of supported field properties are as follows:

     *

     *       default

     *           Time value to be used as default for this field.

     *

     *       notnull

     *           Boolean flag that indicates whether this field is constrained

     *           to not be set to null.

     * @return string DBMS specific SQL code portion that should be used to

     *       declare the specified field.

     * @access protected

     */

    function _getTimeDeclaration($name, $field)

    {

        return $this->_getDeclaration($name, $field);

    }



    // }}}

    // {{{ _getFloatDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to declare a float type

     * field to be used in statements like CREATE TABLE.

     *

     * @param string $name name the field to be declared.

     * @param array $field associative array with the name of the properties

     *       of the field being declared as array indexes. Currently, the types

     *       of supported field properties are as follows:

     *

     *       default

     *           Float value to be used as default for this field.

     *

     *       notnull

     *           Boolean flag that indicates whether this field is constrained

     *           to not be set to null.

     * @return string DBMS specific SQL code portion that should be used to

     *       declare the specified field.

     * @access protected

     */

    function _getFloatDeclaration($name, $field)

    {

        return $this->_getDeclaration($name, $field);

    }



    // }}}

    // {{{ _getDecimalDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to declare a decimal type

     * field to be used in statements like CREATE TABLE.

     *

     * @param string $name name the field to be declared.

     * @param array $field associative array with the name of the properties

     *       of the field being declared as array indexes. Currently, the types

     *       of supported field properties are as follows:

     *

     *       default

     *           Decimal value to be used as default for this field.

     *

     *       notnull

     *           Boolean flag that indicates whether this field is constrained

     *           to not be set to null.

     * @return string DBMS specific SQL code portion that should be used to

     *       declare the specified field.

     * @access protected

     */

    function _getDecimalDeclaration($name, $field)

    {

        return $this->_getDeclaration($name, $field);

    }



    // }}}

    // {{{ compareDefinition()



    /**

     * Obtain an array of changes that may need to applied

     *

     * @param array $current new definition

     * @param array  $previous old definition

     * @return array  containing all changes that will need to be applied

     * @access public

     */

    function compareDefinition($current, $previous)

    {

        $type = !empty($current['type']) ? $current['type'] : null;



        if (!method_exists($this, "_compare{$type}Definition")) {

            $db =& $this->getDBInstance();

            if (PEAR::isError($db)) {

                return $db;

            }

            if (!empty($db->options['datatype_map_callback'][$type])) {

                $parameter = array('current' => $current, 'previous' => $previous);

                $change =  call_user_func_array($db->options['datatype_map_callback'][$type], array(&$db, __FUNCTION__, $parameter));

                return $change;

            }

            return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

                'type "'.$current['type'].'" is not yet supported', __FUNCTION__);

        }



        if (empty($previous['type']) || $previous['type'] != $type) {

            return $current;

        }



        $change = $this->{"_compare{$type}Definition"}($current, $previous);



        if ($previous['type'] != $type) {

            $change['type'] = true;

        }



        $previous_notnull = !empty($previous['notnull']) ? $previous['notnull'] : false;

        $notnull = !empty($current['notnull']) ? $current['notnull'] : false;

        if ($previous_notnull != $notnull) {

            $change['notnull'] = true;

        }



        $previous_default = array_key_exists('default', $previous) ? $previous['default'] :

            ($previous_notnull ? '' : null);

        $default = array_key_exists('default', $current) ? $current['default'] :

            ($notnull ? '' : null);

        if ($previous_default !== $default) {

            $change['default'] = true;

        }



        return $change;

    }



    // }}}

    // {{{ _compareIntegerDefinition()



    /**

     * Obtain an array of changes that may need to applied to an integer field

     *

     * @param array $current new definition

     * @param array  $previous old definition

     * @return array  containing all changes that will need to be applied

     * @access protected

     */

    function _compareIntegerDefinition($current, $previous)

    {

        $change = array();

        $previous_unsigned = !empty($previous['unsigned']) ? $previous['unsigned'] : false;

        $unsigned = !empty($current['unsigned']) ? $current['unsigned'] : false;

        if ($previous_unsigned != $unsigned) {

            $change['unsigned'] = true;

        }

        $previous_autoincrement = !empty($previous['autoincrement']) ? $previous['autoincrement'] : false;

        $autoincrement = !empty($current['autoincrement']) ? $current['autoincrement'] : false;

        if ($previous_autoincrement != $autoincrement) {

            $change['autoincrement'] = true;

        }

        return $change;

    }



    // }}}

    // {{{ _compareTextDefinition()



    /**

     * Obtain an array of changes that may need to applied to an text field

     *

     * @param array $current new definition

     * @param array  $previous old definition

     * @return array  containing all changes that will need to be applied

     * @access protected

     */

    function _compareTextDefinition($current, $previous)

    {

        $change = array();

        $previous_length = !empty($previous['length']) ? $previous['length'] : 0;

        $length = !empty($current['length']) ? $current['length'] : 0;

        if ($previous_length != $length) {

            $change['length'] = true;

        }

        $previous_fixed = !empty($previous['fixed']) ? $previous['fixed'] : 0;

        $fixed = !empty($current['fixed']) ? $current['fixed'] : 0;

        if ($previous_fixed != $fixed) {

            $change['fixed'] = true;

        }

        return $change;

    }



    // }}}

    // {{{ _compareCLOBDefinition()



    /**

     * Obtain an array of changes that may need to applied to an CLOB field

     *

     * @param array $current new definition

     * @param array  $previous old definition

     * @return array  containing all changes that will need to be applied

     * @access protected

     */

    function _compareCLOBDefinition($current, $previous)

    {

        return $this->_compareTextDefinition($current, $previous);

    }



    // }}}

    // {{{ _compareBLOBDefinition()



    /**

     * Obtain an array of changes that may need to applied to an BLOB field

     *

     * @param array $current new definition

     * @param array  $previous old definition

     * @return array  containing all changes that will need to be applied

     * @access protected

     */

    function _compareBLOBDefinition($current, $previous)

    {

        return $this->_compareTextDefinition($current, $previous);

    }



    // }}}

    // {{{ _compareDateDefinition()



    /**

     * Obtain an array of changes that may need to applied to an date field

     *

     * @param array $current new definition

     * @param array  $previous old definition

     * @return array  containing all changes that will need to be applied

     * @access protected

     */

    function _compareDateDefinition($current, $previous)

    {

        return array();

    }



    // }}}

    // {{{ _compareTimeDefinition()



    /**

     * Obtain an array of changes that may need to applied to an time field

     *

     * @param array $current new definition

     * @param array  $previous old definition

     * @return array  containing all changes that will need to be applied

     * @access protected

     */

    function _compareTimeDefinition($current, $previous)

    {

        return array();

    }



    // }}}

    // {{{ _compareTimestampDefinition()



    /**

     * Obtain an array of changes that may need to applied to an timestamp field

     *

     * @param array $current new definition

     * @param array  $previous old definition

     * @return array  containing all changes that will need to be applied

     * @access protected

     */

    function _compareTimestampDefinition($current, $previous)

    {

        return array();

    }



    // }}}

    // {{{ _compareBooleanDefinition()



    /**

     * Obtain an array of changes that may need to applied to an boolean field

     *

     * @param array $current new definition

     * @param array  $previous old definition

     * @return array  containing all changes that will need to be applied

     * @access protected

     */

    function _compareBooleanDefinition($current, $previous)

    {

        return array();

    }



    // }}}

    // {{{ _compareFloatDefinition()



    /**

     * Obtain an array of changes that may need to applied to an float field

     *

     * @param array $current new definition

     * @param array  $previous old definition

     * @return array  containing all changes that will need to be applied

     * @access protected

     */

    function _compareFloatDefinition($current, $previous)

    {

        return array();

    }



    // }}}

    // {{{ _compareDecimalDefinition()



    /**

     * Obtain an array of changes that may need to applied to an decimal field

     *

     * @param array $current new definition

     * @param array  $previous old definition

     * @return array  containing all changes that will need to be applied

     * @access protected

     */

    function _compareDecimalDefinition($current, $previous)

    {

        return array();

    }



    // }}}

    // {{{ quote()



    /**

     * Convert a text value into a DBMS specific format that is suitable to

     * compose query statements.

     *

     * @param string $value text string value that is intended to be converted.

     * @param string $type type to which the value should be converted to

     * @param bool $quote determines if the value should be quoted and escaped

     * @param bool $escape_wildcards if to escape escape wildcards

     * @return string text string that represents the given argument value in

     *       a DBMS specific format.

     * @access public

     */

    function quote($value, $type = null, $quote = true, $escape_wildcards = false)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        if (is_null($value)

            || ($value === '' && $db->options['portability'] & MDB2_PORTABILITY_EMPTY_TO_NULL)

        ) {

            if (!$quote) {

                return null;

            }

            return 'NULL';

        }



        if (is_null($type)) {

            switch (gettype($value)) {

            case 'integer':

                $type = 'integer';

                break;

            case 'double':

                // todo: default to decimal as float is quite unusual

                // $type = 'float';

                $type = 'decimal';

                break;

            case 'boolean':

                $type = 'boolean';

                break;

            case 'array':

                 $value = serialize($value);

            case 'object':

                 $type = 'text';

                break;

            default:

                if (preg_match('/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}$/', $value)) {

                    $type = 'timestamp';

                } elseif (preg_match('/^\d{2}:\d{2}$/', $value)) {

                    $type = 'time';

                } elseif (preg_match('/^\d{4}-\d{2}-\d{2}$/', $value)) {

                    $type = 'date';

                } else {

                    $type = 'text';

                }

                break;

            }

        } elseif (!empty($db->options['datatype_map'][$type])) {

            $type = $db->options['datatype_map'][$type];

            if (!empty($db->options['datatype_map_callback'][$type])) {

                $parameter = array('type' => $type, 'value' => $value, 'quote' => $quote, 'escape_wildcards' => $escape_wildcards);

                return call_user_func_array($db->options['datatype_map_callback'][$type], array(&$db, __FUNCTION__, $parameter));

            }

        }



        if (!method_exists($this, "_quote{$type}")) {

            return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

                'type not defined: '.$type, __FUNCTION__);

        }

        $value = $this->{"_quote{$type}"}($value, $quote, $escape_wildcards);

        if ($quote && $escape_wildcards && $db->string_quoting['escape_pattern']

            && $db->string_quoting['escape'] !== $db->string_quoting['escape_pattern']

        ) {

            $value.= $this->patternEscapeString();

        }

        return $value;

    }



    // }}}

    // {{{ _quoteInteger()



    /**

     * Convert a text value into a DBMS specific format that is suitable to

     * compose query statements.

     *

     * @param string $value text string value that is intended to be converted.

     * @param bool $quote determines if the value should be quoted and escaped

     * @param bool $escape_wildcards if to escape escape wildcards

     * @return string text string that represents the given argument value in

     *       a DBMS specific format.

     * @access protected

     */

    function _quoteInteger($value, $quote, $escape_wildcards)

    {

        return (int)$value;

    }



    // }}}

    // {{{ _quoteText()



    /**

     * Convert a text value into a DBMS specific format that is suitable to

     * compose query statements.

     *

     * @param string $value text string value that is intended to be converted.

     * @param bool $quote determines if the value should be quoted and escaped

     * @param bool $escape_wildcards if to escape escape wildcards

     * @return string text string that already contains any DBMS specific

     *       escaped character sequences.

     * @access protected

     */

    function _quoteText($value, $quote, $escape_wildcards)

    {

        if (!$quote) {

            return $value;

        }



        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $value = $db->escape($value, $escape_wildcards);

        if (PEAR::isError($value)) {

            return $value;

        }

        return "'".$value."'";

    }



    // }}}

    // {{{ _readFile()



    /**

     * Convert a text value into a DBMS specific format that is suitable to

     * compose query statements.

     *

     * @param string $value text string value that is intended to be converted.

     * @return string text string that represents the given argument value in

     *       a DBMS specific format.

     * @access protected

     */

    function _readFile($value)

    {

        $close = false;

        if (preg_match('/^(\w+:\/\/)(.*)$/', $value, $match)) {

            $close = true;

            if ($match[1] == 'file://') {

                $value = $match[2];

            }

            $value = @fopen($value, 'r');

        }



        if (is_resource($value)) {

            $db =& $this->getDBInstance();

            if (PEAR::isError($db)) {

                return $db;

            }



            $fp = $value;

            $value = '';

            while (!@feof($fp)) {

                $value.= @fread($fp, $db->options['lob_buffer_length']);

            }

            if ($close) {

                @fclose($fp);

            }

        }



        return $value;

    }



    // }}}

    // {{{ _quoteLOB()



    /**

     * Convert a text value into a DBMS specific format that is suitable to

     * compose query statements.

     *

     * @param string $value text string value that is intended to be converted.

     * @param bool $quote determines if the value should be quoted and escaped

     * @param bool $escape_wildcards if to escape escape wildcards

     * @return string text string that represents the given argument value in

     *       a DBMS specific format.

     * @access protected

     */

    function _quoteLOB($value, $quote, $escape_wildcards)

    {

        $value = $this->_readFile($value);

        if (PEAR::isError($value)) {

            return $value;

        }

        return $this->_quoteText($value, $quote, $escape_wildcards);

    }



    // }}}

    // {{{ _quoteCLOB()



    /**

     * Convert a text value into a DBMS specific format that is suitable to

     * compose query statements.

     *

     * @param string $value text string value that is intended to be converted.

     * @param bool $quote determines if the value should be quoted and escaped

     * @param bool $escape_wildcards if to escape escape wildcards

     * @return string text string that represents the given argument value in

     *       a DBMS specific format.

     * @access protected

     */

    function _quoteCLOB($value, $quote, $escape_wildcards)

    {

        return $this->_quoteLOB($value, $quote, $escape_wildcards);

    }



    // }}}

    // {{{ _quoteBLOB()



    /**

     * Convert a text value into a DBMS specific format that is suitable to

     * compose query statements.

     *

     * @param string $value text string value that is intended to be converted.

     * @param bool $quote determines if the value should be quoted and escaped

     * @param bool $escape_wildcards if to escape escape wildcards

     * @return string text string that represents the given argument value in

     *       a DBMS specific format.

     * @access protected

     */

    function _quoteBLOB($value, $quote, $escape_wildcards)

    {

        return $this->_quoteLOB($value, $quote, $escape_wildcards);

    }



    // }}}

    // {{{ _quoteBoolean()



    /**

     * Convert a text value into a DBMS specific format that is suitable to

     * compose query statements.

     *

     * @param string $value text string value that is intended to be converted.

     * @param bool $quote determines if the value should be quoted and escaped

     * @param bool $escape_wildcards if to escape escape wildcards

     * @return string text string that represents the given argument value in

     *       a DBMS specific format.

     * @access protected

     */

    function _quoteBoolean($value, $quote, $escape_wildcards)

    {

        return ($value ? 1 : 0);

    }



    // }}}

    // {{{ _quoteDate()



    /**

     * Convert a text value into a DBMS specific format that is suitable to

     * compose query statements.

     *

     * @param string $value text string value that is intended to be converted.

     * @param bool $quote determines if the value should be quoted and escaped

     * @param bool $escape_wildcards if to escape escape wildcards

     * @return string text string that represents the given argument value in

     *       a DBMS specific format.

     * @access protected

     */

    function _quoteDate($value, $quote, $escape_wildcards)

    {

        if ($value === 'CURRENT_DATE') {

            $db =& $this->getDBInstance();

            if (PEAR::isError($db)) {

                return $db;

            }

            if (isset($db->function) && is_a($db->function, 'MDB2_Driver_Function_Common')) {

                return $db->function->now('date');

            }

            return 'CURRENT_DATE';

        }

        return $this->_quoteText($value, $quote, $escape_wildcards);

    }



    // }}}

    // {{{ _quoteTimestamp()



    /**

     * Convert a text value into a DBMS specific format that is suitable to

     * compose query statements.

     *

     * @param string $value text string value that is intended to be converted.

     * @param bool $quote determines if the value should be quoted and escaped

     * @param bool $escape_wildcards if to escape escape wildcards

     * @return string text string that represents the given argument value in

     *       a DBMS specific format.

     * @access protected

     */

    function _quoteTimestamp($value, $quote, $escape_wildcards)

    {

        if ($value === 'CURRENT_TIMESTAMP') {

            $db =& $this->getDBInstance();

            if (PEAR::isError($db)) {

                return $db;

            }

            if (isset($db->function) && is_a($db->function, 'MDB2_Driver_Function_Common')) {

                return $db->function->now('timestamp');

            }

            return 'CURRENT_TIMESTAMP';

        }

        return $this->_quoteText($value, $quote, $escape_wildcards);

    }



    // }}}

    // {{{ _quoteTime()



    /**

     * Convert a text value into a DBMS specific format that is suitable to

     *       compose query statements.

     *

     * @param string $value text string value that is intended to be converted.

     * @param bool $quote determines if the value should be quoted and escaped

     * @param bool $escape_wildcards if to escape escape wildcards

     * @return string text string that represents the given argument value in

     *       a DBMS specific format.

     * @access protected

     */

    function _quoteTime($value, $quote, $escape_wildcards)

    {

        if ($value === 'CURRENT_TIME') {

            $db =& $this->getDBInstance();

            if (PEAR::isError($db)) {

                return $db;

            }

            if (isset($db->function) && is_a($db->function, 'MDB2_Driver_Function_Common')) {

                return $db->function->now('time');

            }

            return 'CURRENT_TIME';

        }

        return $this->_quoteText($value, $quote, $escape_wildcards);

    }



    // }}}

    // {{{ _quoteFloat()



    /**

     * Convert a text value into a DBMS specific format that is suitable to

     * compose query statements.

     *

     * @param string $value text string value that is intended to be converted.

     * @param bool $quote determines if the value should be quoted and escaped

     * @param bool $escape_wildcards if to escape escape wildcards

     * @return string text string that represents the given argument value in

     *       a DBMS specific format.

     * @access protected

     */

    function _quoteFloat($value, $quote, $escape_wildcards)

    {

        if (preg_match('/^(.*)e([-+])(\d+)$/i', $value, $matches)) {

            $decimal = $this->_quoteDecimal($matches[1], $quote, $escape_wildcards);

            $sign = $matches[2];

            $exponent = str_pad($matches[3], 2, '0', STR_PAD_LEFT);

            $value = $decimal.'E'.$sign.$exponent;

        } else {

            $value = $this->_quoteDecimal($value, $quote, $escape_wildcards);

        }

        return $value;

    }



    // }}}

    // {{{ _quoteDecimal()



    /**

     * Convert a text value into a DBMS specific format that is suitable to

     * compose query statements.

     *

     * @param string $value text string value that is intended to be converted.

     * @param bool $quote determines if the value should be quoted and escaped

     * @param bool $escape_wildcards if to escape escape wildcards

     * @return string text string that represents the given argument value in

     *       a DBMS specific format.

     * @access protected

     */

    function _quoteDecimal($value, $quote, $escape_wildcards)

    {

        $value = (string)$value;

        $value = preg_replace('/[^\d\.,\-+eE]/', '', $value);

        if (preg_match('/[^.0-9]/', $value)) {

            if (strpos($value, ',')) {

                // 1000,00

                if (!strpos($value, '.')) {

                    // convert the last "," to a "."

                    $value = strrev(str_replace(',', '.', strrev($value)));

                // 1.000,00

                } elseif (strpos($value, '.') && strpos($value, '.') < strpos($value, ',')) {

                    $value = str_replace('.', '', $value);

                    // convert the last "," to a "."

                    $value = strrev(str_replace(',', '.', strrev($value)));

                // 1,000.00

                } else {

                    $value = str_replace(',', '', $value);

                }

            }

        }

        return $value;

    }



    // }}}

    // {{{ writeLOBToFile()



    /**

     * retrieve LOB from the database

     *

     * @param resource $lob stream handle

     * @param string $file name of the file into which the LOb should be fetched

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access protected

     */

    function writeLOBToFile($lob, $file)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        if (preg_match('/^(\w+:\/\/)(.*)$/', $file, $match)) {

            if ($match[1] == 'file://') {

                $file = $match[2];

            }

        }



        $fp = @fopen($file, 'wb');

        while (!@feof($lob)) {

            $result = @fread($lob, $db->options['lob_buffer_length']);

            $read = strlen($result);

            if (@fwrite($fp, $result, $read) != $read) {

                @fclose($fp);

                return $db->raiseError(MDB2_ERROR, null, null,

                    'could not write to the output file', __FUNCTION__);

            }

        }

        @fclose($fp);

        return MDB2_OK;

    }



    // }}}

    // {{{ _retrieveLOB()



    /**

     * retrieve LOB from the database

     *

     * @param array $lob array

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access protected

     */

    function _retrieveLOB(&$lob)

    {

        if (is_null($lob['value'])) {

            $lob['value'] = $lob['resource'];

        }

        $lob['loaded'] = true;

        return MDB2_OK;

    }



    // }}}

    // {{{ readLOB()



    /**

     * Read data from large object input stream.

     *

     * @param resource $lob stream handle

     * @param string $data reference to a variable that will hold data

     *                          to be read from the large object input stream

     * @param integer $length    value that indicates the largest ammount ofdata

     *                          to be read from the large object input stream.

     * @return mixed the effective number of bytes read from the large object

     *                      input stream on sucess or an MDB2 error object.

     * @access public

     * @see endOfLOB()

     */

    function _readLOB($lob, $length)

    {

        return substr($lob['value'], $lob['position'], $length);

    }



    // }}}

    // {{{ _endOfLOB()



    /**

     * Determine whether it was reached the end of the large object and

     * therefore there is no more data to be read for the its input stream.

     *

     * @param array $lob array

     * @return mixed true or false on success, a MDB2 error on failure

     * @access protected

     */

    function _endOfLOB($lob)

    {

        return $lob['endOfLOB'];

    }



    // }}}

    // {{{ destroyLOB()



    /**

     * Free any resources allocated during the lifetime of the large object

     * handler object.

     *

     * @param resource $lob stream handle

     * @access public

     */

    function destroyLOB($lob)

    {

        $lob_data = stream_get_meta_data($lob);

        $lob_index = $lob_data['wrapper_data']->lob_index;

        fclose($lob);

        if (isset($this->lobs[$lob_index])) {

            $this->_destroyLOB($this->lobs[$lob_index]);

            unset($this->lobs[$lob_index]);

        }

        return MDB2_OK;

    }



    // }}}

    // {{{ _destroyLOB()



    /**

     * Free any resources allocated during the lifetime of the large object

     * handler object.

     *

     * @param array $lob array

     * @access private

     */

    function _destroyLOB(&$lob)

    {

        return MDB2_OK;

    }



    // }}}

    // {{{ implodeArray()



    /**

     * apply a type to all values of an array and return as a comma seperated string

     * useful for generating IN statements

     *

     * @access public

     *

     * @param array $array data array

     * @param string $type determines type of the field

     *

     * @return string comma seperated values

     */

    function implodeArray($array, $type = false)

    {

        if (!is_array($array) || empty($array)) {

            return 'NULL';

        }

        if ($type) {

            foreach ($array as $value) {

                $return[] = $this->quote($value, $type);

            }

        } else {

            $return = $array;

        }

        return implode(', ', $return);

    }



    // }}}

    // {{{ matchPattern()



    /**

     * build a pattern matching string

     *

     * @access public

     *

     * @param array $pattern even keys are strings, odd are patterns (% and _)

     * @param string $operator optional pattern operator (LIKE, ILIKE and maybe others in the future)

     * @param string $field optional field name that is being matched against

     *                  (might be required when emulating ILIKE)

     *

     * @return string SQL pattern

     */

    function matchPattern($pattern, $operator = null, $field = null)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $match = '';

        if (!is_null($operator)) {

            $operator = strtoupper($operator);

            switch ($operator) {

            // case insensitive

            case 'ILIKE':

                if (is_null($field)) {

                    return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

                        'case insensitive LIKE matching requires passing the field name', __FUNCTION__);

                }

                $db->loadModule('Function', null, true);

                $match = $db->function->lower($field).' LIKE ';

                break;

            // case sensitive

            case 'LIKE':

                $match = is_null($field) ? 'LIKE ' : $field.' LIKE ';

                break;

            default:

                return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

                    'not a supported operator type:'. $operator, __FUNCTION__);

            }

        }

        $match.= "'";

        foreach ($pattern as $key => $value) {

            if ($key % 2) {

                $match.= $value;

            } else {

                if ($operator === 'ILIKE') {

                    $value = strtolower($value);

                }

                $escaped = $db->escape($value);

                if (PEAR::isError($escaped)) {

                    return $escaped;

                }

                $match.= $db->escapePattern($escaped);

            }

        }

        $match.= "'";

        $match.= $this->patternEscapeString();

        return $match;

    }



    // }}}

    // {{{ patternEscapeString()



    /**

     * build string to define pattern escape character

     *

     * @access public

     *

     * @return string define pattern escape character

     */

    function patternEscapeString()

    {

        return '';

    }



    // }}}

    // {{{ mapNativeDatatype()



    /**

     * Maps a native array description of a field to a MDB2 datatype and length

     *

     * @param array  $field native field description

     * @return array containing the various possible types, length, sign, fixed

     * @access public

     */

    function mapNativeDatatype($field)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        // If the user has specified an option to map the native field

        // type to a custom MDB2 datatype...

        $db_type = strtok($field['type'], '(), ');

        if (!empty($db->options['nativetype_map_callback'][$db_type])) {

            return call_user_func_array($db->options['nativetype_map_callback'][$db_type], array($db, $field));

        }



        // Otherwise perform the built-in (i.e. normal) MDB2 native type to

        // MDB2 datatype conversion

        return $this->_mapNativeDatatype($field);

    }



    // }}}

    // {{{ _mapNativeDatatype()



    /**

     * Maps a native array description of a field to a MDB2 datatype and length

     *

     * @param array  $field native field description

     * @return array containing the various possible types, length, sign, fixed

     * @access public

     */

    function _mapNativeDatatype($field)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

            'method not implemented', __FUNCTION__);

    }



    // }}}

    // {{{ mapPrepareDatatype()



    /**

     * Maps an mdb2 datatype to mysqli prepare type

     *

     * @param string $type

     * @return string

     * @access public

     */

    function mapPrepareDatatype($type)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        if (!empty($db->options['datatype_map'][$type])) {

            $type = $db->options['datatype_map'][$type];

            if (!empty($db->options['datatype_map_callback'][$type])) {

                $parameter = array('type' => $type);

                return call_user_func_array($db->options['datatype_map_callback'][$type], array(&$db, __FUNCTION__, $parameter));

            }

        }



        return $type;

    }

}

<?php
// +----------------------------------------------------------------------+
// | PHP versions 4 and 5                                                 |
// +----------------------------------------------------------------------+
// | Copyright (c) 1998-2007 Manuel Lemos, Tomas V.V.Cox,                 |
// | Stig. S. Bakken, Lukas Smith                                         |
// | All rights reserved.                                                 |
// +----------------------------------------------------------------------+
// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |
// | API as well as database abstraction for PHP applications.            |
// | This LICENSE is in the BSD license style.                            |
// |                                                                      |
// | Redistribution and use in source and binary forms, with or without   |
// | modification, are permitted provided that the following conditions   |
// | are met:                                                             |
// |                                                                      |
// | Redistributions of source code must retain the above copyright       |
// | notice, this list of conditions and the following disclaimer.        |
// |                                                                      |
// | Redistributions in binary form must reproduce the above copyright    |
// | notice, this list of conditions and the following disclaimer in the  |
// | documentation and/or other materials provided with the distribution. |
// |                                                                      |
// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |
// | Lukas Smith nor the names of his contributors may be used to endorse |
// | or promote products derived from this software without specific prior|
// | written permission.                                                  |
// |                                                                      |
// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |
// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |
// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |
// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |
// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |
// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |
// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|
// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |
// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |
// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|
// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |
// | POSSIBILITY OF SUCH DAMAGE.                                          |
// +----------------------------------------------------------------------+
// | Author: Lukas Smith <smith@pooteeweet.org>                           |
// +----------------------------------------------------------------------+
//
// $Id: Common.php,v 1.137 2008/02/17 18:53:40 afz Exp $

require_once 'MDB2/LOB.php';

/**
 * @package  MDB2
 * @category Database
 * @author   Lukas Smith <smith@pooteeweet.org>
 */

/**
 * MDB2_Driver_Common: Base class that is extended by each MDB2 driver
 *
 * To load this module in the MDB2 object:
 * $mdb->loadModule('Datatype');
 *
 * @package MDB2
 * @category Database
 * @author Lukas Smith <smith@pooteeweet.org>
 */
class MDB2_Driver_Datatype_Common extends MDB2_Module_Common
{
    var $valid_default_values = array(
        'text'      => '',
        'boolean'   => true,
        'integer'   => 0,
        'decimal'   => 0.0,
        'float'     => 0.0,
        'timestamp' => '1970-01-01 00:00:00',
        'time'      => '00:00:00',
        'date'      => '1970-01-01',
        'clob'      => '',
        'blob'      => '',
    );

    /**
     * contains all LOB objects created with this MDB2 instance
     * @var array
     * @access protected
     */
    var $lobs = array();

    // }}}
    // {{{ getValidTypes()

    /**
     * Get the list of valid types
     *
     * This function returns an array of valid types as keys with the values
     * being possible default values for all native datatypes and mapped types
     * for custom datatypes.
     *
     * @return mixed array on success, a MDB2 error on failure
     * @access public
     */
    function getValidTypes()
    {
        $types = $this->valid_default_values;
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }
        if (!empty($db->options['datatype_map'])) {
            foreach ($db->options['datatype_map'] as $type => $mapped_type) {
                if (array_key_exists($mapped_type, $types)) {
                    $types[$type] = $types[$mapped_type];
                } elseif (!empty($db->options['datatype_map_callback'][$type])) {
                    $parameter = array('type' => $type, 'mapped_type' => $mapped_type);
                    $default =  call_user_func_array($db->options['datatype_map_callback'][$type], array(&$db, __FUNCTION__, $parameter));
                    $types[$type] = $default;
                }
            }
        }
        return $types;
    }

    // }}}
    // {{{ checkResultTypes()

    /**
     * Define the list of types to be associated with the columns of a given
     * result set.
     *
     * This function may be called before invoking fetchRow(), fetchOne()
     * fetchCole() and fetchAll() so that the necessary data type
     * conversions are performed on the data to be retrieved by them. If this
     * function is not called, the type of all result set columns is assumed
     * to be text, thus leading to not perform any conversions.
     *
     * @param array $types array variable that lists the
     *       data types to be expected in the result set columns. If this array
     *       contains less types than the number of columns that are returned
     *       in the result set, the remaining columns are assumed to be of the
     *       type text. Currently, the types clob and blob are not fully
     *       supported.
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function checkResultTypes($types)
    {
        $types = is_array($types) ? $types : array($types);
        foreach ($types as $key => $type) {
            if (!isset($this->valid_default_values[$type])) {
                $db =& $this->getDBInstance();
                if (PEAR::isError($db)) {
                    return $db;
                }
                if (empty($db->options['datatype_map'][$type])) {
                    return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
                        $type.' for '.$key.' is not a supported column type', __FUNCTION__);
                }
            }
        }
        return $types;
    }

    // }}}
    // {{{ _baseConvertResult()

    /**
     * General type conversion method
     *
     * @param mixed   $value reference to a value to be converted
     * @param string  $type  specifies which type to convert to
     * @param boolean $rtrim [optional] when TRUE [default], apply rtrim() to text
     * @return object an MDB2 error on failure
     * @access protected
     */
    function _baseConvertResult($value, $type, $rtrim = true)
    {
        switch ($type) {
        case 'text':
            if ($rtrim) {
                $value = rtrim($value);
            }
            return $value;
        case 'integer':
            return intval($value);
        case 'boolean':
            return !empty($value);
        case 'decimal':
            return $value;
        case 'float':
            return doubleval($value);
        case 'date':
            return $value;
        case 'time':
            return $value;
        case 'timestamp':
            return $value;
        case 'clob':
        case 'blob':
            $this->lobs[] = array(
                'buffer' => null,
                'position' => 0,
                'lob_index' => null,
                'endOfLOB' => false,
                'resource' => $value,
                'value' => null,
                'loaded' => false,
            );
            end($this->lobs);
            $lob_index = key($this->lobs);
            $this->lobs[$lob_index]['lob_index'] = $lob_index;
            return fopen('MDB2LOB://'.$lob_index.'@'.$this->db_index, 'r+');
        }

        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        return $db->raiseError(MDB2_ERROR_INVALID, null, null,
            'attempt to convert result value to an unknown type :' . $type, __FUNCTION__);
    }

    // }}}
    // {{{ convertResult()

    /**
     * Convert a value to a RDBMS indipendent MDB2 type
     *
     * @param mixed   $value value to be converted
     * @param string  $type  specifies which type to convert to
     * @param boolean $rtrim [optional] when TRUE [default], apply rtrim() to text
     * @return mixed converted value
     * @access public
     */
    function convertResult($value, $type, $rtrim = true)
    {
        if (is_null($value)) {
            return null;
        }
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }
        if (!empty($db->options['datatype_map'][$type])) {
            $type = $db->options['datatype_map'][$type];
            if (!empty($db->options['datatype_map_callback'][$type])) {
                $parameter = array('type' => $type, 'value' => $value, 'rtrim' => $rtrim);
                return call_user_func_array($db->options['datatype_map_callback'][$type], array(&$db, __FUNCTION__, $parameter));
            }
        }
        return $this->_baseConvertResult($value, $type, $rtrim);
    }

    // }}}
    // {{{ convertResultRow()

    /**
     * Convert a result row
     *
     * @param array   $types
     * @param array   $row   specifies the types to convert to
     * @param boolean $rtrim [optional] when TRUE [default], apply rtrim() to text
     * @return mixed MDB2_OK on success, an MDB2 error on failure
     * @access public
     */
    function convertResultRow($types, $row, $rtrim = true)
    {
        $types = $this->_sortResultFieldTypes(array_keys($row), $types);
        foreach ($row as $key => $value) {
            if (empty($types[$key])) {
                continue;
            }
            $value = $this->convertResult($row[$key], $types[$key], $rtrim);
            if (PEAR::isError($value)) {
                return $value;
            }
            $row[$key] = $value;
        }
        return $row;
    }

    // }}}
    // {{{ _sortResultFieldTypes()

    /**
     * convert a result row
     *
     * @param array $types
     * @param array $row specifies the types to convert to
     * @param bool   $rtrim   if to rtrim text values or not
     * @return mixed MDB2_OK on success,  a MDB2 error on failure
     * @access public
     */
    function _sortResultFieldTypes($columns, $types)
    {
        $n_cols = count($columns);
        $n_types = count($types);
        if ($n_cols > $n_types) {
            for ($i= $n_cols - $n_types; $i >= 0; $i--) {
                $types[] = null;
            }
        }
        $sorted_types = array();
        foreach ($columns as $col) {
            $sorted_types[$col] = null;
        }
        foreach ($types as $name => $type) {
            if (array_key_exists($name, $sorted_types)) {
                $sorted_types[$name] = $type;
                unset($types[$name]);
            }
        }
        // if there are left types in the array, fill the null values of the
        // sorted array with them, in order.
        if (count($types)) {
            reset($types);
            foreach (array_keys($sorted_types) as $k) {
                if (is_null($sorted_types[$k])) {
                    $sorted_types[$k] = current($types);
                    next($types);
                }
            }
        }
        return $sorted_types;
    }

    // }}}
    // {{{ getDeclaration()

    /**
     * Obtain DBMS specific SQL code portion needed to declare
     * of the given type
     *
     * @param string $type type to which the value should be converted to
     * @param string  $name   name the field to be declared.
     * @param string  $field  definition of the field
     * @return string  DBMS specific SQL code portion that should be used to
     *                 declare the specified field.
     * @access public
     */
    function getDeclaration($type, $name, $field)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        if (!empty($db->options['datatype_map'][$type])) {
            $type = $db->options['datatype_map'][$type];
            if (!empty($db->options['datatype_map_callback'][$type])) {
                $parameter = array('type' => $type, 'name' => $name, 'field' => $field);
                return call_user_func_array($db->options['datatype_map_callback'][$type], array(&$db, __FUNCTION__, $parameter));
            }
            $field['type'] = $type;
        }

        if (!method_exists($this, "_get{$type}Declaration")) {
            return $db->raiseError(MDB2_ERROR_NOT_FOUND, null, null,
                'type not defined: '.$type, __FUNCTION__);
        }
        return $this->{"_get{$type}Declaration"}($name, $field);
    }

    // }}}
    // {{{ getTypeDeclaration()

    /**
     * Obtain DBMS specific SQL code portion needed to declare an text type
     * field to be used in statements like CREATE TABLE.
     *
     * @param array $field  associative array with the name of the properties
     *      of the field being declared as array indexes. Currently, the types
     *      of supported field properties are as follows:
     *
     *      length
     *          Integer value that determines the maximum length of the text
     *          field. If this argument is missing the field should be
     *          declared to have the longest length allowed by the DBMS.
     *
     *      default
     *          Text value to be used as default for this field.
     *
     *      notnull
     *          Boolean flag that indicates whether this field is constrained
     *          to not be set to null.
     * @return string  DBMS specific SQL code portion that should be used to
     *      declare the specified field.
     * @access public
     */
    function getTypeDeclaration($field)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        switch ($field['type']) {
        case 'text':
            $length = !empty($field['length']) ? $field['length'] : $db->options['default_text_field_length'];
            $fixed = !empty($field['fixed']) ? $field['fixed'] : false;
            return $fixed ? ($length ? 'CHAR('.$length.')' : 'CHAR('.$db->options['default_text_field_length'].')')
                : ($length ? 'VARCHAR('.$length.')' : 'TEXT');
        case 'clob':
            return 'TEXT';
        case 'blob':
            return 'TEXT';
        case 'integer':
            return 'INT';
        case 'boolean':
            return 'INT';
        case 'date':
            return 'CHAR ('.strlen('YYYY-MM-DD').')';
        case 'time':
            return 'CHAR ('.strlen('HH:MM:SS').')';
        case 'timestamp':
            return 'CHAR ('.strlen('YYYY-MM-DD HH:MM:SS').')';
        case 'float':
            return 'TEXT';
        case 'decimal':
            return 'TEXT';
        }
        return '';
    }

    // }}}
    // {{{ _getDeclaration()

    /**
     * Obtain DBMS specific SQL code portion needed to declare a generic type
     * field to be used in statements like CREATE TABLE.
     *
     * @param string $name   name the field to be declared.
     * @param array  $field  associative array with the name of the properties
     *      of the field being declared as array indexes. Currently, the types
     *      of supported field properties are as follows:
     *
     *      length
     *          Integer value that determines the maximum length of the text
     *          field. If this argument is missing the field should be
     *          declared to have the longest length allowed by the DBMS.
     *
     *      default
     *          Text value to be used as default for this field.
     *
     *      notnull
     *          Boolean flag that indicates whether this field is constrained
     *          to not be set to null.
     *      charset
     *          Text value with the default CHARACTER SET for this field.
     *      collation
     *          Text value with the default COLLATION for this field.
     * @return string  DBMS specific SQL code portion that should be used to
     *      declare the specified field, or a MDB2_Error on failure
     * @access protected
     */
    function _getDeclaration($name, $field)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $name = $db->quoteIdentifier($name, true);
        $declaration_options = $db->datatype->_getDeclarationOptions($field);
        if (PEAR::isError($declaration_options)) {
            return $declaration_options;
        }
        return $name.' '.$this->getTypeDeclaration($field).$declaration_options;
    }

    // }}}
    // {{{ _getDeclarationOptions()

    /**
     * Obtain DBMS specific SQL code portion needed to declare a generic type
     * field to be used in statement like CREATE TABLE, without the field name
     * and type values (ie. just the character set, default value, if the
     * field is permitted to be NULL or not, and the collation options).
     *
     * @param array  $field  associative array with the name of the properties
     *      of the field being declared as array indexes. Currently, the types
     *      of supported field properties are as follows:
     *
     *      default
     *          Text value to be used as default for this field.
     *      notnull
     *          Boolean flag that indicates whether this field is constrained
     *          to not be set to null.
     *      charset
     *          Text value with the default CHARACTER SET for this field.
     *      collation
     *          Text value with the default COLLATION for this field.
     * @return string  DBMS specific SQL code portion that should be used to
     *      declare the specified field's options.
     * @access protected
     */
    function _getDeclarationOptions($field)
    {
        $charset = empty($field['charset']) ? '' :
            ' '.$this->_getCharsetFieldDeclaration($field['charset']);

        $notnull = empty($field['notnull']) ? '' : ' NOT NULL';
        $default = '';
        if (array_key_exists('default', $field)) {
            if ($field['default'] === '') {
                $db =& $this->getDBInstance();
                if (PEAR::isError($db)) {
                    return $db;
                }
                $valid_default_values = $this->getValidTypes();
                $field['default'] = $valid_default_values[$field['type']];
                if ($field['default'] === ''&& ($db->options['portability'] & MDB2_PORTABILITY_EMPTY_TO_NULL)) {
                    $field['default'] = ' ';
                }
            }
            if (!is_null($field['default'])) {
                $default = ' DEFAULT ' . $this->quote($field['default'], $field['type']);
            }
        }

        $collation = empty($field['collation']) ? '' :
            ' '.$this->_getCollationFieldDeclaration($field['collation']);

        return $charset.$default.$notnull.$collation;
    }

    // }}}
    // {{{ _getCharsetFieldDeclaration()
    
    /**
     * Obtain DBMS specific SQL code portion needed to set the CHARACTER SET
     * of a field declaration to be used in statements like CREATE TABLE.
     *
     * @param string $charset   name of the charset
     * @return string  DBMS specific SQL code portion needed to set the CHARACTER SET
     *                 of a field declaration.
     */
    function _getCharsetFieldDeclaration($charset)
    {
        return '';
    }

    // }}}
    // {{{ _getCollationFieldDeclaration()

    /**
     * Obtain DBMS specific SQL code portion needed to set the COLLATION
     * of a field declaration to be used in statements like CREATE TABLE.
     *
     * @param string $collation   name of the collation
     * @return string  DBMS specific SQL code portion needed to set the COLLATION
     *                 of a field declaration.
     */
    function _getCollationFieldDeclaration($collation)
    {
        return '';
    }

    // }}}
    // {{{ _getIntegerDeclaration()

    /**
     * Obtain DBMS specific SQL code portion needed to declare an integer type
     * field to be used in statements like CREATE TABLE.
     *
     * @param string $name name the field to be declared.
     * @param array $field associative array with the name of the properties
     *       of the field being declared as array indexes. Currently, the types
     *       of supported field properties are as follows:
     *
     *       unsigned
     *           Boolean flag that indicates whether the field should be
     *           declared as unsigned integer if possible.
     *
     *       default
     *           Integer value to be used as default for this field.
     *
     *       notnull
     *           Boolean flag that indicates whether this field is constrained
     *           to not be set to null.
     * @return string DBMS specific SQL code portion that should be used to
     *       declare the specified field.
     * @access protected
     */
    function _getIntegerDeclaration($name, $field)
    {
        if (!empty($field['unsigned'])) {
            $db =& $this->getDBInstance();
            if (PEAR::isError($db)) {
                return $db;
            }

            $db->warnings[] = "unsigned integer field \"$name\" is being declared as signed integer";
        }
        return $this->_getDeclaration($name, $field);
    }

    // }}}
    // {{{ _getTextDeclaration()

    /**
     * Obtain DBMS specific SQL code portion needed to declare an text type
     * field to be used in statements like CREATE TABLE.
     *
     * @param string $name name the field to be declared.
     * @param array $field associative array with the name of the properties
     *       of the field being declared as array indexes. Currently, the types
     *       of supported field properties are as follows:
     *
     *       length
     *           Integer value that determines the maximum length of the text
     *           field. If this argument is missing the field should be
     *           declared to have the longest length allowed by the DBMS.
     *
     *       default
     *           Text value to be used as default for this field.
     *
     *       notnull
     *           Boolean flag that indicates whether this field is constrained
     *           to not be set to null.
     * @return string DBMS specific SQL code portion that should be used to
     *       declare the specified field.
     * @access protected
     */
    function _getTextDeclaration($name, $field)
    {
        return $this->_getDeclaration($name, $field);
    }

    // }}}
    // {{{ _getCLOBDeclaration()

    /**
     * Obtain DBMS specific SQL code portion needed to declare an character
     * large object type field to be used in statements like CREATE TABLE.
     *
     * @param string $name name the field to be declared.
     * @param array $field associative array with the name of the properties
     *        of the field being declared as array indexes. Currently, the types
     *        of supported field properties are as follows:
     *
     *        length
     *            Integer value that determines the maximum length of the large
     *            object field. If this argument is missing the field should be
     *            declared to have the longest length allowed by the DBMS.
     *
     *        notnull
     *            Boolean flag that indicates whether this field is constrained
     *            to not be set to null.
     * @return string DBMS specific SQL code portion that should be used to
     *        declare the specified field.
     * @access public
     */
    function _getCLOBDeclaration($name, $field)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $notnull = empty($field['notnull']) ? '' : ' NOT NULL';
        $name = $db->quoteIdentifier($name, true);
        return $name.' '.$this->getTypeDeclaration($field).$notnull;
    }

    // }}}
    // {{{ _getBLOBDeclaration()

    /**
     * Obtain DBMS specific SQL code portion needed to declare an binary large
     * object type field to be used in statements like CREATE TABLE.
     *
     * @param string $name name the field to be declared.
     * @param array $field associative array with the name of the properties
     *        of the field being declared as array indexes. Currently, the types
     *        of supported field properties are as follows:
     *
     *        length
     *            Integer value that determines the maximum length of the large
     *            object field. If this argument is missing the field should be
     *            declared to have the longest length allowed by the DBMS.
     *
     *        notnull
     *            Boolean flag that indicates whether this field is constrained
     *            to not be set to null.
     * @return string DBMS specific SQL code portion that should be used to
     *        declare the specified field.
     * @access protected
     */
    function _getBLOBDeclaration($name, $field)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $notnull = empty($field['notnull']) ? '' : ' NOT NULL';
        $name = $db->quoteIdentifier($name, true);
        return $name.' '.$this->getTypeDeclaration($field).$notnull;
    }

    // }}}
    // {{{ _getBooleanDeclaration()

    /**
     * Obtain DBMS specific SQL code portion needed to declare a boolean type
     * field to be used in statements like CREATE TABLE.
     *
     * @param string $name name the field to be declared.
     * @param array $field associative array with the name of the properties
     *       of the field being declared as array indexes. Currently, the types
     *       of supported field properties are as follows:
     *
     *       default
     *           Boolean value to be used as default for this field.
     *
     *       notnullL
     *           Boolean flag that indicates whether this field is constrained
     *           to not be set to null.
     * @return string DBMS specific SQL code portion that should be used to
     *       declare the specified field.
     * @access protected
     */
    function _getBooleanDeclaration($name, $field)
    {
        return $this->_getDeclaration($name, $field);
    }

    // }}}
    // {{{ _getDateDeclaration()

    /**
     * Obtain DBMS specific SQL code portion needed to declare a date type
     * field to be used in statements like CREATE TABLE.
     *
     * @param string $name name the field to be declared.
     * @param array $field associative array with the name of the properties
     *       of the field being declared as array indexes. Currently, the types
     *       of supported field properties are as follows:
     *
     *       default
     *           Date value to be used as default for this field.
     *
     *       notnull
     *           Boolean flag that indicates whether this field is constrained
     *           to not be set to null.
     * @return string DBMS specific SQL code portion that should be used to
     *       declare the specified field.
     * @access protected
     */
    function _getDateDeclaration($name, $field)
    {
        return $this->_getDeclaration($name, $field);
    }

    // }}}
    // {{{ _getTimestampDeclaration()

    /**
     * Obtain DBMS specific SQL code portion needed to declare a timestamp
     * field to be used in statements like CREATE TABLE.
     *
     * @param string $name name the field to be declared.
     * @param array $field associative array with the name of the properties
     *       of the field being declared as array indexes. Currently, the types
     *       of supported field properties are as follows:
     *
     *       default
     *           Timestamp value to be used as default for this field.
     *
     *       notnull
     *           Boolean flag that indicates whether this field is constrained
     *           to not be set to null.
     * @return string DBMS specific SQL code portion that should be used to
     *       declare the specified field.
     * @access protected
     */
    function _getTimestampDeclaration($name, $field)
    {
        return $this->_getDeclaration($name, $field);
    }

    // }}}
    // {{{ _getTimeDeclaration()

    /**
     * Obtain DBMS specific SQL code portion needed to declare a time
     * field to be used in statements like CREATE TABLE.
     *
     * @param string $name name the field to be declared.
     * @param array $field associative array with the name of the properties
     *       of the field being declared as array indexes. Currently, the types
     *       of supported field properties are as follows:
     *
     *       default
     *           Time value to be used as default for this field.
     *
     *       notnull
     *           Boolean flag that indicates whether this field is constrained
     *           to not be set to null.
     * @return string DBMS specific SQL code portion that should be used to
     *       declare the specified field.
     * @access protected
     */
    function _getTimeDeclaration($name, $field)
    {
        return $this->_getDeclaration($name, $field);
    }

    // }}}
    // {{{ _getFloatDeclaration()

    /**
     * Obtain DBMS specific SQL code portion needed to declare a float type
     * field to be used in statements like CREATE TABLE.
     *
     * @param string $name name the field to be declared.
     * @param array $field associative array with the name of the properties
     *       of the field being declared as array indexes. Currently, the types
     *       of supported field properties are as follows:
     *
     *       default
     *           Float value to be used as default for this field.
     *
     *       notnull
     *           Boolean flag that indicates whether this field is constrained
     *           to not be set to null.
     * @return string DBMS specific SQL code portion that should be used to
     *       declare the specified field.
     * @access protected
     */
    function _getFloatDeclaration($name, $field)
    {
        return $this->_getDeclaration($name, $field);
    }

    // }}}
    // {{{ _getDecimalDeclaration()

    /**
     * Obtain DBMS specific SQL code portion needed to declare a decimal type
     * field to be used in statements like CREATE TABLE.
     *
     * @param string $name name the field to be declared.
     * @param array $field associative array with the name of the properties
     *       of the field being declared as array indexes. Currently, the types
     *       of supported field properties are as follows:
     *
     *       default
     *           Decimal value to be used as default for this field.
     *
     *       notnull
     *           Boolean flag that indicates whether this field is constrained
     *           to not be set to null.
     * @return string DBMS specific SQL code portion that should be used to
     *       declare the specified field.
     * @access protected
     */
    function _getDecimalDeclaration($name, $field)
    {
        return $this->_getDeclaration($name, $field);
    }

    // }}}
    // {{{ compareDefinition()

    /**
     * Obtain an array of changes that may need to applied
     *
     * @param array $current new definition
     * @param array  $previous old definition
     * @return array  containing all changes that will need to be applied
     * @access public
     */
    function compareDefinition($current, $previous)
    {
        $type = !empty($current['type']) ? $current['type'] : null;

        if (!method_exists($this, "_compare{$type}Definition")) {
            $db =& $this->getDBInstance();
            if (PEAR::isError($db)) {
                return $db;
            }
            if (!empty($db->options['datatype_map_callback'][$type])) {
                $parameter = array('current' => $current, 'previous' => $previous);
                $change =  call_user_func_array($db->options['datatype_map_callback'][$type], array(&$db, __FUNCTION__, $parameter));
                return $change;
            }
            return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
                'type "'.$current['type'].'" is not yet supported', __FUNCTION__);
        }

        if (empty($previous['type']) || $previous['type'] != $type) {
            return $current;
        }

        $change = $this->{"_compare{$type}Definition"}($current, $previous);

        if ($previous['type'] != $type) {
            $change['type'] = true;
        }

        $previous_notnull = !empty($previous['notnull']) ? $previous['notnull'] : false;
        $notnull = !empty($current['notnull']) ? $current['notnull'] : false;
        if ($previous_notnull != $notnull) {
            $change['notnull'] = true;
        }

        $previous_default = array_key_exists('default', $previous) ? $previous['default'] :
            ($previous_notnull ? '' : null);
        $default = array_key_exists('default', $current) ? $current['default'] :
            ($notnull ? '' : null);
        if ($previous_default !== $default) {
            $change['default'] = true;
        }

        return $change;
    }

    // }}}
    // {{{ _compareIntegerDefinition()

    /**
     * Obtain an array of changes that may need to applied to an integer field
     *
     * @param array $current new definition
     * @param array  $previous old definition
     * @return array  containing all changes that will need to be applied
     * @access protected
     */
    function _compareIntegerDefinition($current, $previous)
    {
        $change = array();
        $previous_unsigned = !empty($previous['unsigned']) ? $previous['unsigned'] : false;
        $unsigned = !empty($current['unsigned']) ? $current['unsigned'] : false;
        if ($previous_unsigned != $unsigned) {
            $change['unsigned'] = true;
        }
        $previous_autoincrement = !empty($previous['autoincrement']) ? $previous['autoincrement'] : false;
        $autoincrement = !empty($current['autoincrement']) ? $current['autoincrement'] : false;
        if ($previous_autoincrement != $autoincrement) {
            $change['autoincrement'] = true;
        }
        return $change;
    }

    // }}}
    // {{{ _compareTextDefinition()

    /**
     * Obtain an array of changes that may need to applied to an text field
     *
     * @param array $current new definition
     * @param array  $previous old definition
     * @return array  containing all changes that will need to be applied
     * @access protected
     */
    function _compareTextDefinition($current, $previous)
    {
        $change = array();
        $previous_length = !empty($previous['length']) ? $previous['length'] : 0;
        $length = !empty($current['length']) ? $current['length'] : 0;
        if ($previous_length != $length) {
            $change['length'] = true;
        }
        $previous_fixed = !empty($previous['fixed']) ? $previous['fixed'] : 0;
        $fixed = !empty($current['fixed']) ? $current['fixed'] : 0;
        if ($previous_fixed != $fixed) {
            $change['fixed'] = true;
        }
        return $change;
    }

    // }}}
    // {{{ _compareCLOBDefinition()

    /**
     * Obtain an array of changes that may need to applied to an CLOB field
     *
     * @param array $current new definition
     * @param array  $previous old definition
     * @return array  containing all changes that will need to be applied
     * @access protected
     */
    function _compareCLOBDefinition($current, $previous)
    {
        return $this->_compareTextDefinition($current, $previous);
    }

    // }}}
    // {{{ _compareBLOBDefinition()

    /**
     * Obtain an array of changes that may need to applied to an BLOB field
     *
     * @param array $current new definition
     * @param array  $previous old definition
     * @return array  containing all changes that will need to be applied
     * @access protected
     */
    function _compareBLOBDefinition($current, $previous)
    {
        return $this->_compareTextDefinition($current, $previous);
    }

    // }}}
    // {{{ _compareDateDefinition()

    /**
     * Obtain an array of changes that may need to applied to an date field
     *
     * @param array $current new definition
     * @param array  $previous old definition
     * @return array  containing all changes that will need to be applied
     * @access protected
     */
    function _compareDateDefinition($current, $previous)
    {
        return array();
    }

    // }}}
    // {{{ _compareTimeDefinition()

    /**
     * Obtain an array of changes that may need to applied to an time field
     *
     * @param array $current new definition
     * @param array  $previous old definition
     * @return array  containing all changes that will need to be applied
     * @access protected
     */
    function _compareTimeDefinition($current, $previous)
    {
        return array();
    }

    // }}}
    // {{{ _compareTimestampDefinition()

    /**
     * Obtain an array of changes that may need to applied to an timestamp field
     *
     * @param array $current new definition
     * @param array  $previous old definition
     * @return array  containing all changes that will need to be applied
     * @access protected
     */
    function _compareTimestampDefinition($current, $previous)
    {
        return array();
    }

    // }}}
    // {{{ _compareBooleanDefinition()

    /**
     * Obtain an array of changes that may need to applied to an boolean field
     *
     * @param array $current new definition
     * @param array  $previous old definition
     * @return array  containing all changes that will need to be applied
     * @access protected
     */
    function _compareBooleanDefinition($current, $previous)
    {
        return array();
    }

    // }}}
    // {{{ _compareFloatDefinition()

    /**
     * Obtain an array of changes that may need to applied to an float field
     *
     * @param array $current new definition
     * @param array  $previous old definition
     * @return array  containing all changes that will need to be applied
     * @access protected
     */
    function _compareFloatDefinition($current, $previous)
    {
        return array();
    }

    // }}}
    // {{{ _compareDecimalDefinition()

    /**
     * Obtain an array of changes that may need to applied to an decimal field
     *
     * @param array $current new definition
     * @param array  $previous old definition
     * @return array  containing all changes that will need to be applied
     * @access protected
     */
    function _compareDecimalDefinition($current, $previous)
    {
        return array();
    }

    // }}}
    // {{{ quote()

    /**
     * Convert a text value into a DBMS specific format that is suitable to
     * compose query statements.
     *
     * @param string $value text string value that is intended to be converted.
     * @param string $type type to which the value should be converted to
     * @param bool $quote determines if the value should be quoted and escaped
     * @param bool $escape_wildcards if to escape escape wildcards
     * @return string text string that represents the given argument value in
     *       a DBMS specific format.
     * @access public
     */
    function quote($value, $type = null, $quote = true, $escape_wildcards = false)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        if (is_null($value)
            || ($value === '' && $db->options['portability'] & MDB2_PORTABILITY_EMPTY_TO_NULL)
        ) {
            if (!$quote) {
                return null;
            }
            return 'NULL';
        }

        if (is_null($type)) {
            switch (gettype($value)) {
            case 'integer':
                $type = 'integer';
                break;
            case 'double':
                // todo: default to decimal as float is quite unusual
                // $type = 'float';
                $type = 'decimal';
                break;
            case 'boolean':
                $type = 'boolean';
                break;
            case 'array':
                 $value = serialize($value);
            case 'object':
                 $type = 'text';
                break;
            default:
                if (preg_match('/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}$/', $value)) {
                    $type = 'timestamp';
                } elseif (preg_match('/^\d{2}:\d{2}$/', $value)) {
                    $type = 'time';
                } elseif (preg_match('/^\d{4}-\d{2}-\d{2}$/', $value)) {
                    $type = 'date';
                } else {
                    $type = 'text';
                }
                break;
            }
        } elseif (!empty($db->options['datatype_map'][$type])) {
            $type = $db->options['datatype_map'][$type];
            if (!empty($db->options['datatype_map_callback'][$type])) {
                $parameter = array('type' => $type, 'value' => $value, 'quote' => $quote, 'escape_wildcards' => $escape_wildcards);
                return call_user_func_array($db->options['datatype_map_callback'][$type], array(&$db, __FUNCTION__, $parameter));
            }
        }

        if (!method_exists($this, "_quote{$type}")) {
            return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
                'type not defined: '.$type, __FUNCTION__);
        }
        $value = $this->{"_quote{$type}"}($value, $quote, $escape_wildcards);
        if ($quote && $escape_wildcards && $db->string_quoting['escape_pattern']
            && $db->string_quoting['escape'] !== $db->string_quoting['escape_pattern']
        ) {
            $value.= $this->patternEscapeString();
        }
        return $value;
    }

    // }}}
    // {{{ _quoteInteger()

    /**
     * Convert a text value into a DBMS specific format that is suitable to
     * compose query statements.
     *
     * @param string $value text string value that is intended to be converted.
     * @param bool $quote determines if the value should be quoted and escaped
     * @param bool $escape_wildcards if to escape escape wildcards
     * @return string text string that represents the given argument value in
     *       a DBMS specific format.
     * @access protected
     */
    function _quoteInteger($value, $quote, $escape_wildcards)
    {
        return (int)$value;
    }

    // }}}
    // {{{ _quoteText()

    /**
     * Convert a text value into a DBMS specific format that is suitable to
     * compose query statements.
     *
     * @param string $value text string value that is intended to be converted.
     * @param bool $quote determines if the value should be quoted and escaped
     * @param bool $escape_wildcards if to escape escape wildcards
     * @return string text string that already contains any DBMS specific
     *       escaped character sequences.
     * @access protected
     */
    function _quoteText($value, $quote, $escape_wildcards)
    {
        if (!$quote) {
            return $value;
        }

        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $value = $db->escape($value, $escape_wildcards);
        if (PEAR::isError($value)) {
            return $value;
        }
        return "'".$value."'";
    }

    // }}}
    // {{{ _readFile()

    /**
     * Convert a text value into a DBMS specific format that is suitable to
     * compose query statements.
     *
     * @param string $value text string value that is intended to be converted.
     * @return string text string that represents the given argument value in
     *       a DBMS specific format.
     * @access protected
     */
    function _readFile($value)
    {
        $close = false;
        if (preg_match('/^(\w+:\/\/)(.*)$/', $value, $match)) {
            $close = true;
            if ($match[1] == 'file://') {
                $value = $match[2];
            }
            $value = @fopen($value, 'r');
        }

        if (is_resource($value)) {
            $db =& $this->getDBInstance();
            if (PEAR::isError($db)) {
                return $db;
            }

            $fp = $value;
            $value = '';
            while (!@feof($fp)) {
                $value.= @fread($fp, $db->options['lob_buffer_length']);
            }
            if ($close) {
                @fclose($fp);
            }
        }

        return $value;
    }

    // }}}
    // {{{ _quoteLOB()

    /**
     * Convert a text value into a DBMS specific format that is suitable to
     * compose query statements.
     *
     * @param string $value text string value that is intended to be converted.
     * @param bool $quote determines if the value should be quoted and escaped
     * @param bool $escape_wildcards if to escape escape wildcards
     * @return string text string that represents the given argument value in
     *       a DBMS specific format.
     * @access protected
     */
    function _quoteLOB($value, $quote, $escape_wildcards)
    {
        $value = $this->_readFile($value);
        if (PEAR::isError($value)) {
            return $value;
        }
        return $this->_quoteText($value, $quote, $escape_wildcards);
    }

    // }}}
    // {{{ _quoteCLOB()

    /**
     * Convert a text value into a DBMS specific format that is suitable to
     * compose query statements.
     *
     * @param string $value text string value that is intended to be converted.
     * @param bool $quote determines if the value should be quoted and escaped
     * @param bool $escape_wildcards if to escape escape wildcards
     * @return string text string that represents the given argument value in
     *       a DBMS specific format.
     * @access protected
     */
    function _quoteCLOB($value, $quote, $escape_wildcards)
    {
        return $this->_quoteLOB($value, $quote, $escape_wildcards);
    }

    // }}}
    // {{{ _quoteBLOB()

    /**
     * Convert a text value into a DBMS specific format that is suitable to
     * compose query statements.
     *
     * @param string $value text string value that is intended to be converted.
     * @param bool $quote determines if the value should be quoted and escaped
     * @param bool $escape_wildcards if to escape escape wildcards
     * @return string text string that represents the given argument value in
     *       a DBMS specific format.
     * @access protected
     */
    function _quoteBLOB($value, $quote, $escape_wildcards)
    {
        return $this->_quoteLOB($value, $quote, $escape_wildcards);
    }

    // }}}
    // {{{ _quoteBoolean()

    /**
     * Convert a text value into a DBMS specific format that is suitable to
     * compose query statements.
     *
     * @param string $value text string value that is intended to be converted.
     * @param bool $quote determines if the value should be quoted and escaped
     * @param bool $escape_wildcards if to escape escape wildcards
     * @return string text string that represents the given argument value in
     *       a DBMS specific format.
     * @access protected
     */
    function _quoteBoolean($value, $quote, $escape_wildcards)
    {
        return ($value ? 1 : 0);
    }

    // }}}
    // {{{ _quoteDate()

    /**
     * Convert a text value into a DBMS specific format that is suitable to
     * compose query statements.
     *
     * @param string $value text string value that is intended to be converted.
     * @param bool $quote determines if the value should be quoted and escaped
     * @param bool $escape_wildcards if to escape escape wildcards
     * @return string text string that represents the given argument value in
     *       a DBMS specific format.
     * @access protected
     */
    function _quoteDate($value, $quote, $escape_wildcards)
    {
        if ($value === 'CURRENT_DATE') {
            $db =& $this->getDBInstance();
            if (PEAR::isError($db)) {
                return $db;
            }
            if (isset($db->function) && is_a($db->function, 'MDB2_Driver_Function_Common')) {
                return $db->function->now('date');
            }
            return 'CURRENT_DATE';
        }
        return $this->_quoteText($value, $quote, $escape_wildcards);
    }

    // }}}
    // {{{ _quoteTimestamp()

    /**
     * Convert a text value into a DBMS specific format that is suitable to
     * compose query statements.
     *
     * @param string $value text string value that is intended to be converted.
     * @param bool $quote determines if the value should be quoted and escaped
     * @param bool $escape_wildcards if to escape escape wildcards
     * @return string text string that represents the given argument value in
     *       a DBMS specific format.
     * @access protected
     */
    function _quoteTimestamp($value, $quote, $escape_wildcards)
    {
        if ($value === 'CURRENT_TIMESTAMP') {
            $db =& $this->getDBInstance();
            if (PEAR::isError($db)) {
                return $db;
            }
            if (isset($db->function) && is_a($db->function, 'MDB2_Driver_Function_Common')) {
                return $db->function->now('timestamp');
            }
            return 'CURRENT_TIMESTAMP';
        }
        return $this->_quoteText($value, $quote, $escape_wildcards);
    }

    // }}}
    // {{{ _quoteTime()

    /**
     * Convert a text value into a DBMS specific format that is suitable to
     *       compose query statements.
     *
     * @param string $value text string value that is intended to be converted.
     * @param bool $quote determines if the value should be quoted and escaped
     * @param bool $escape_wildcards if to escape escape wildcards
     * @return string text string that represents the given argument value in
     *       a DBMS specific format.
     * @access protected
     */
    function _quoteTime($value, $quote, $escape_wildcards)
    {
        if ($value === 'CURRENT_TIME') {
            $db =& $this->getDBInstance();
            if (PEAR::isError($db)) {
                return $db;
            }
            if (isset($db->function) && is_a($db->function, 'MDB2_Driver_Function_Common')) {
                return $db->function->now('time');
            }
            return 'CURRENT_TIME';
        }
        return $this->_quoteText($value, $quote, $escape_wildcards);
    }

    // }}}
    // {{{ _quoteFloat()

    /**
     * Convert a text value into a DBMS specific format that is suitable to
     * compose query statements.
     *
     * @param string $value text string value that is intended to be converted.
     * @param bool $quote determines if the value should be quoted and escaped
     * @param bool $escape_wildcards if to escape escape wildcards
     * @return string text string that represents the given argument value in
     *       a DBMS specific format.
     * @access protected
     */
    function _quoteFloat($value, $quote, $escape_wildcards)
    {
        if (preg_match('/^(.*)e([-+])(\d+)$/i', $value, $matches)) {
            $decimal = $this->_quoteDecimal($matches[1], $quote, $escape_wildcards);
            $sign = $matches[2];
            $exponent = str_pad($matches[3], 2, '0', STR_PAD_LEFT);
            $value = $decimal.'E'.$sign.$exponent;
        } else {
            $value = $this->_quoteDecimal($value, $quote, $escape_wildcards);
        }
        return $value;
    }

    // }}}
    // {{{ _quoteDecimal()

    /**
     * Convert a text value into a DBMS specific format that is suitable to
     * compose query statements.
     *
     * @param string $value text string value that is intended to be converted.
     * @param bool $quote determines if the value should be quoted and escaped
     * @param bool $escape_wildcards if to escape escape wildcards
     * @return string text string that represents the given argument value in
     *       a DBMS specific format.
     * @access protected
     */
    function _quoteDecimal($value, $quote, $escape_wildcards)
    {
        $value = (string)$value;
        $value = preg_replace('/[^\d\.,\-+eE]/', '', $value);
        if (preg_match('/[^\.\d]/', $value)) {
            if (strpos($value, ',')) {
                // 1000,00
                if (!strpos($value, '.')) {
                    // convert the last "," to a "."
                    $value = strrev(str_replace(',', '.', strrev($value)));
                // 1.000,00
                } elseif (strpos($value, '.') && strpos($value, '.') < strpos($value, ',')) {
                    $value = str_replace('.', '', $value);
                    // convert the last "," to a "."
                    $value = strrev(str_replace(',', '.', strrev($value)));
                // 1,000.00
                } else {
                    $value = str_replace(',', '', $value);
                }
            }
        }
        return $value;
    }

    // }}}
    // {{{ writeLOBToFile()

    /**
     * retrieve LOB from the database
     *
     * @param resource $lob stream handle
     * @param string $file name of the file into which the LOb should be fetched
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access protected
     */
    function writeLOBToFile($lob, $file)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        if (preg_match('/^(\w+:\/\/)(.*)$/', $file, $match)) {
            if ($match[1] == 'file://') {
                $file = $match[2];
            }
        }

        $fp = @fopen($file, 'wb');
        while (!@feof($lob)) {
            $result = @fread($lob, $db->options['lob_buffer_length']);
            $read = strlen($result);
            if (@fwrite($fp, $result, $read) != $read) {
                @fclose($fp);
                return $db->raiseError(MDB2_ERROR, null, null,
                    'could not write to the output file', __FUNCTION__);
            }
        }
        @fclose($fp);
        return MDB2_OK;
    }

    // }}}
    // {{{ _retrieveLOB()

    /**
     * retrieve LOB from the database
     *
     * @param array $lob array
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access protected
     */
    function _retrieveLOB(&$lob)
    {
        if (is_null($lob['value'])) {
            $lob['value'] = $lob['resource'];
        }
        $lob['loaded'] = true;
        return MDB2_OK;
    }

    // }}}
    // {{{ readLOB()

    /**
     * Read data from large object input stream.
     *
     * @param resource $lob stream handle
     * @param string $data reference to a variable that will hold data
     *                          to be read from the large object input stream
     * @param integer $length    value that indicates the largest ammount ofdata
     *                          to be read from the large object input stream.
     * @return mixed the effective number of bytes read from the large object
     *                      input stream on sucess or an MDB2 error object.
     * @access public
     * @see endOfLOB()
     */
    function _readLOB($lob, $length)
    {
        return substr($lob['value'], $lob['position'], $length);
    }

    // }}}
    // {{{ _endOfLOB()

    /**
     * Determine whether it was reached the end of the large object and
     * therefore there is no more data to be read for the its input stream.
     *
     * @param array $lob array
     * @return mixed true or false on success, a MDB2 error on failure
     * @access protected
     */
    function _endOfLOB($lob)
    {
        return $lob['endOfLOB'];
    }

    // }}}
    // {{{ destroyLOB()

    /**
     * Free any resources allocated during the lifetime of the large object
     * handler object.
     *
     * @param resource $lob stream handle
     * @access public
     */
    function destroyLOB($lob)
    {
        $lob_data = stream_get_meta_data($lob);
        $lob_index = $lob_data['wrapper_data']->lob_index;
        fclose($lob);
        if (isset($this->lobs[$lob_index])) {
            $this->_destroyLOB($this->lobs[$lob_index]);
            unset($this->lobs[$lob_index]);
        }
        return MDB2_OK;
    }

    // }}}
    // {{{ _destroyLOB()

    /**
     * Free any resources allocated during the lifetime of the large object
     * handler object.
     *
     * @param array $lob array
     * @access private
     */
    function _destroyLOB(&$lob)
    {
        return MDB2_OK;
    }

    // }}}
    // {{{ implodeArray()

    /**
     * apply a type to all values of an array and return as a comma seperated string
     * useful for generating IN statements
     *
     * @access public
     *
     * @param array $array data array
     * @param string $type determines type of the field
     *
     * @return string comma seperated values
     */
    function implodeArray($array, $type = false)
    {
        if (!is_array($array) || empty($array)) {
            return 'NULL';
        }
        if ($type) {
            foreach ($array as $value) {
                $return[] = $this->quote($value, $type);
            }
        } else {
            $return = $array;
        }
        return implode(', ', $return);
    }

    // }}}
    // {{{ matchPattern()

    /**
     * build a pattern matching string
     *
     * @access public
     *
     * @param array $pattern even keys are strings, odd are patterns (% and _)
     * @param string $operator optional pattern operator (LIKE, ILIKE and maybe others in the future)
     * @param string $field optional field name that is being matched against
     *                  (might be required when emulating ILIKE)
     *
     * @return string SQL pattern
     */
    function matchPattern($pattern, $operator = null, $field = null)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $match = '';
        if (!is_null($operator)) {
            $operator = strtoupper($operator);
            switch ($operator) {
            // case insensitive
            case 'ILIKE':
                if (is_null($field)) {
                    return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
                        'case insensitive LIKE matching requires passing the field name', __FUNCTION__);
                }
                $db->loadModule('Function', null, true);
                $match = $db->function->lower($field).' LIKE ';
                break;
            // case sensitive
            case 'LIKE':
                $match = is_null($field) ? 'LIKE ' : $field.' LIKE ';
                break;
            default:
                return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
                    'not a supported operator type:'. $operator, __FUNCTION__);
            }
        }
        $match.= "'";
        foreach ($pattern as $key => $value) {
            if ($key % 2) {
                $match.= $value;
            } else {
                if ($operator === 'ILIKE') {
                    $value = strtolower($value);
                }
                $escaped = $db->escape($value);
                if (PEAR::isError($escaped)) {
                    return $escaped;
                }
                $match.= $db->escapePattern($escaped);
            }
        }
        $match.= "'";
        $match.= $this->patternEscapeString();
        return $match;
    }

    // }}}
    // {{{ patternEscapeString()

    /**
     * build string to define pattern escape character
     *
     * @access public
     *
     * @return string define pattern escape character
     */
    function patternEscapeString()
    {
        return '';
    }

    // }}}
    // {{{ mapNativeDatatype()

    /**
     * Maps a native array description of a field to a MDB2 datatype and length
     *
     * @param array  $field native field description
     * @return array containing the various possible types, length, sign, fixed
     * @access public
     */
    function mapNativeDatatype($field)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        // If the user has specified an option to map the native field
        // type to a custom MDB2 datatype...
        $db_type = strtok($field['type'], '(), ');
        if (!empty($db->options['nativetype_map_callback'][$db_type])) {
            return call_user_func_array($db->options['nativetype_map_callback'][$db_type], array($db, $field));
        }

        // Otherwise perform the built-in (i.e. normal) MDB2 native type to
        // MDB2 datatype conversion
        return $this->_mapNativeDatatype($field);
    }

    // }}}
    // {{{ _mapNativeDatatype()

    /**
     * Maps a native array description of a field to a MDB2 datatype and length
     *
     * @param array  $field native field description
     * @return array containing the various possible types, length, sign, fixed
     * @access public
     */
    function _mapNativeDatatype($field)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
            'method not implemented', __FUNCTION__);
    }

    // }}}
    // {{{ mapPrepareDatatype()

    /**
     * Maps an mdb2 datatype to mysqli prepare type
     *
     * @param string $type
     * @return string
     * @access public
     */
    function mapPrepareDatatype($type)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        if (!empty($db->options['datatype_map'][$type])) {
            $type = $db->options['datatype_map'][$type];
            if (!empty($db->options['datatype_map_callback'][$type])) {
                $parameter = array('type' => $type);
                return call_user_func_array($db->options['datatype_map_callback'][$type], array(&$db, __FUNCTION__, $parameter));
            }
        }

        return $type;
    }
}
?>

 program/lib/MDB2/Driver/Datatype/mssql.php

@@ -1,498 +1,436 @@
<?php

// vim: set et ts=4 sw=4 fdm=marker:

// +----------------------------------------------------------------------+

// | PHP versions 4 and 5                                                 |

// +----------------------------------------------------------------------+

// | Copyright (c) 1998-2007 Manuel Lemos, Tomas V.V.Cox,                 |

// | Stig. S. Bakken, Lukas Smith                                         |

// | All rights reserved.                                                 |

// +----------------------------------------------------------------------+

// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |

// | API as well as database abstraction for PHP applications.            |

// | This LICENSE is in the BSD license style.                            |

// |                                                                      |

// | Redistribution and use in source and binary forms, with or without   |

// | modification, are permitted provided that the following conditions   |

// | are met:                                                             |

// |                                                                      |

// | Redistributions of source code must retain the above copyright       |

// | notice, this list of conditions and the following disclaimer.        |

// |                                                                      |

// | Redistributions in binary form must reproduce the above copyright    |

// | notice, this list of conditions and the following disclaimer in the  |

// | documentation and/or other materials provided with the distribution. |

// |                                                                      |

// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |

// | Lukas Smith nor the names of his contributors may be used to endorse |

// | or promote products derived from this software without specific prior|

// | written permission.                                                  |

// |                                                                      |

// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |

// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |

// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |

// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |

// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |

// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |

// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|

// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |

// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |

// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|

// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |

// | POSSIBILITY OF SUCH DAMAGE.                                          |

// +----------------------------------------------------------------------+

// | Authors: Lukas Smith <smith@pooteeweet.org>                          |

// |          Daniel Convissor <danielc@php.net>                          |

// +----------------------------------------------------------------------+

//

// $Id: mssql.php,v 1.59 2007/12/03 20:59:50 quipo Exp $

//



require_once 'MDB2/Driver/Datatype/Common.php';



/**

 * MDB2 MS SQL driver

 *

 * @package MDB2

 * @category Database

 * @author  Lukas Smith <smith@pooteeweet.org>

 */

class MDB2_Driver_Datatype_mssql extends MDB2_Driver_Datatype_Common

{

    // {{{ _baseConvertResult()



    /**

     * general type conversion method

     *

     * @param mixed   $value refernce to a value to be converted

     * @param string  $type  specifies which type to convert to

     * @param boolean $rtrim [optional] when TRUE [default], apply rtrim() to text

     * @return object a MDB2 error on failure

     * @access protected

     */

    function _baseConvertResult($value, $type, $rtrim = true)

    {

        if (is_null($value)) {

            return null;

        }

        switch ($type) {

        case 'boolean':

            return $value == '1';

        case 'date':

            if (strlen($value) > 10) {

                $value = substr($value,0,10);

            }

            return $value;

        case 'time':

            if (strlen($value) > 8) {

                $value = substr($value,11,8);

            }

            return $value;

        }

        return parent::_baseConvertResult($value, $type, $rtrim);

    }



    // }}}

    // {{{ _getCollationFieldDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to set the COLLATION

     * of a field declaration to be used in statements like CREATE TABLE.

     *

     * @param string $collation name of the collation

     *

     * @return string DBMS specific SQL code portion needed to set the COLLATION

     *                of a field declaration.

     */

    function _getCollationFieldDeclaration($collation)

    {

        return 'COLLATE '.$collation;

    }



    // }}}

    // {{{ getTypeDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to declare an text type

     * field to be used in statements like CREATE TABLE.

     *

     * @param array $field  associative array with the name of the properties

     *      of the field being declared as array indexes. Currently, the types

     *      of supported field properties are as follows:

     *

     *      length

     *          Integer value that determines the maximum length of the text

     *          field. If this argument is missing the field should be

     *          declared to have the longest length allowed by the DBMS.

     *

     *      default

     *          Text value to be used as default for this field.

     *

     *      notnull

     *          Boolean flag that indicates whether this field is constrained

     *          to not be set to null.

     * @return string  DBMS specific SQL code portion that should be used to

     *      declare the specified field.

     * @access public

     */

    function getTypeDeclaration($field)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        switch ($field['type']) {

        case 'text':

            $length = !empty($field['length'])

                ? $field['length'] : false;

            $fixed = !empty($field['fixed']) ? $field['fixed'] : false;

            return $fixed ? ($length ? 'CHAR('.$length.')' : 'CHAR('.$db->options['default_text_field_length'].')')

                : ($length ? 'VARCHAR('.$length.')' : 'TEXT');

        case 'clob':

            if (!empty($field['length'])) {

                $length = $field['length'];

                if ($length <= 8000) {

                    return 'VARCHAR('.$length.')';

                }

             }

             return 'TEXT';

        case 'blob':

            if (!empty($field['length'])) {

                $length = $field['length'];

                if ($length <= 8000) {

                    return "VARBINARY($length)";

                }

            }

            return 'IMAGE';

        case 'integer':

            return 'INT';

        case 'boolean':

            return 'BIT';

        case 'date':

            return 'CHAR ('.strlen('YYYY-MM-DD').')';

        case 'time':

            return 'CHAR ('.strlen('HH:MM:SS').')';

        case 'timestamp':

            return 'CHAR ('.strlen('YYYY-MM-DD HH:MM:SS').')';

        case 'float':

            return 'FLOAT';

        case 'decimal':

            $length = !empty($field['length']) ? $field['length'] : 18;

            $scale = !empty($field['scale']) ? $field['scale'] : $db->options['decimal_places'];

            return 'DECIMAL('.$length.','.$scale.')';

        }

        return '';

    }



    // }}}

    // {{{ _getDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to declare a generic type

     * field to be used in statements like CREATE TABLE.

     *

     * @param string $name   name the field to be declared.

     * @param array  $field  associative array with the name of the properties

     *      of the field being declared as array indexes. Currently, the types

     *      of supported field properties are as follows:

     *

     *      length

     *          Integer value that determines the maximum length of the text

     *          field. If this argument is missing the field should be

     *          declared to have the longest length allowed by the DBMS.

     *

     *      default

     *          Text value to be used as default for this field.

     *

     *      notnull

     *          Boolean flag that indicates whether this field is constrained

     *          to not be set to null.

     * @return string  DBMS specific SQL code portion that should be used to

     *      declare the specified field.

     * @access protected

     */

    function _getDeclarationOptions($field)

    {

        $charset = empty($field['charset']) ? '' :

            ' '.$this->_getCharsetFieldDeclaration($field['charset']);



        $default = '';

        if (array_key_exists('default', $field)) {

            if ($field['default'] === '') {

                $db =& $this->getDBInstance();

                if (PEAR::isError($db)) {

                    return $db;

                }

                $field['default'] = empty($field['notnull'])

                    ? null : $this->valid_default_values[$field['type']];

                if ($field['default'] === ''

                    && ($db->options['portability'] & MDB2_PORTABILITY_EMPTY_TO_NULL)

                ) {

                    $field['default'] = ' ';

                }

            }

            $default = ' DEFAULT '.$this->quote($field['default'], $field['type']);

        } elseif (empty($field['notnull'])) {

            $default = ' DEFAULT NULL';

        }



        $notnull = empty($field['notnull']) ? ' NULL' : ' NOT NULL';

        if ($default == ' DEFAULT NULL' && $notnull == ' NULL') {

            $notnull = '';

        }



        $collation = empty($field['collation']) ? '' :

            ' '.$this->_getCollationFieldDeclaration($field['collation']);

        return $charset.$default.$notnull.$collation;

    }



    // }}}

    // {{{ _getIntegerDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to declare an integer type

     * field to be used in statements like CREATE TABLE.

     *

     * @param string  $name   name the field to be declared.

     * @param string  $field  associative array with the name of the properties

     *                        of the field being declared as array indexes.

     *                        Currently, the types of supported field

     *                        properties are as follows:

     *

     *                       unsigned

     *                        Boolean flag that indicates whether the field

     *                        should be declared as unsigned integer if

     *                        possible.

     *

     *                       default

     *                        Integer value to be used as default for this

     *                        field.

     *

     *                       notnull

     *                        Boolean flag that indicates whether this field is

     *                        constrained to not be set to null.

     * @return string  DBMS specific SQL code portion that should be used to

     *                 declare the specified field.

     * @access protected

     */

    function _getIntegerDeclaration($name, $field)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $default = $autoinc = '';;

        if (!empty($field['autoincrement'])) {

            $autoinc = ' IDENTITY PRIMARY KEY';

        } elseif (array_key_exists('default', $field)) {

            if ($field['default'] === '') {

                $field['default'] = empty($field['notnull']) ? null : 0;

            }

            $default = ' DEFAULT '.$this->quote($field['default'], 'integer');

        } elseif (empty($field['notnull'])) {

            $default = ' DEFAULT NULL';

        }



        $notnull = empty($field['notnull']) ? ' NULL' : ' NOT NULL';

        if ($default == ' DEFAULT NULL' && $notnull == ' NULL') {

            $notnull = '';

        }

        if (!empty($field['unsigned'])) {

            $db->warnings[] = "unsigned integer field \"$name\" is being declared as signed integer";

        }

        $name = $db->quoteIdentifier($name, true);

        return $name.' '.$this->getTypeDeclaration($field).$default.$notnull.$autoinc;

    }



    // }}}

    // {{{ _getCLOBDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to declare an character

     * large object type field to be used in statements like CREATE TABLE.

     *

     * @param string $name name the field to be declared.

     * @param array $field associative array with the name of the properties

     *        of the field being declared as array indexes. Currently, the types

     *        of supported field properties are as follows:

     *

     *        length

     *            Integer value that determines the maximum length of the large

     *            object field. If this argument is missing the field should be

     *            declared to have the longest length allowed by the DBMS.

     *

     *        notnull

     *            Boolean flag that indicates whether this field is constrained

     *            to not be set to null.

     * @return string DBMS specific SQL code portion that should be used to

     *        declare the specified field.

     * @access public

     */

    function _getCLOBDeclaration($name, $field)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $notnull = empty($field['notnull']) ? ' NULL' : ' NOT NULL';

        $name = $db->quoteIdentifier($name, true);

        return $name.' '.$this->getTypeDeclaration($field).$notnull;

    }



    // }}}

    // {{{ _getBLOBDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to declare an binary large

     * object type field to be used in statements like CREATE TABLE.

     *

     * @param string $name name the field to be declared.

     * @param array $field associative array with the name of the properties

     *        of the field being declared as array indexes. Currently, the types

     *        of supported field properties are as follows:

     *

     *        length

     *            Integer value that determines the maximum length of the large

     *            object field. If this argument is missing the field should be

     *            declared to have the longest length allowed by the DBMS.

     *

     *        notnull

     *            Boolean flag that indicates whether this field is constrained

     *            to not be set to null.

     * @return string DBMS specific SQL code portion that should be used to

     *        declare the specified field.

     * @access protected

     */

    function _getBLOBDeclaration($name, $field)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $notnull = empty($field['notnull']) ? ' NULL' : ' NOT NULL';

        $name = $db->quoteIdentifier($name, true);

        return $name.' '.$this->getTypeDeclaration($field).$notnull;

    }



    // }}}

    // {{{ _quoteBLOB()



    /**

     * Convert a text value into a DBMS specific format that is suitable to

     * compose query statements.

     *

     * @param string $value text string value that is intended to be converted.

     * @param bool $quote determines if the value should be quoted and escaped

     * @param bool $escape_wildcards if to escape escape wildcards

     * @return string  text string that represents the given argument value in

     *                 a DBMS specific format.

     * @access protected

     */

    function _quoteBLOB($value, $quote, $escape_wildcards)

    {

        if (!$quote) {

            return $value;

        }

        $value = bin2hex("0x".$this->_readFile($value));

        return $value;

    }



    // }}}

    // {{{ _mapNativeDatatype()



    /**

     * Maps a native array description of a field to a MDB2 datatype and length

     *

     * @param array  $field native field description

     * @return array containing the various possible types, length, sign, fixed

     * @access public

     */

    function _mapNativeDatatype($field)

    {

        // todo: handle length of various int variations

        $db_type = preg_replace('/\d/', '', strtolower($field['type']));

        $length = $field['length'];

        $type = array();

        // todo: unsigned handling seems to be missing

        $unsigned = $fixed = null;

        switch ($db_type) {

        case 'bit':

            $type[0] = 'boolean';

            break;

        case 'tinyint':

            $type[0] = 'integer';

            $length = 1;

            break;

        case 'smallint':

            $type[0] = 'integer';

            $length = 2;

            break;

        case 'int':

            $type[0] = 'integer';

            $length = 4;

            break;

        case 'bigint':

            $type[0] = 'integer';

            $length = 8;

            break;

        case 'datetime':

            $type[0] = 'timestamp';

            break;

        case 'float':

        case 'real':

        case 'numeric':

            $type[0] = 'float';

            break;

        case 'decimal':

        case 'money':

            $type[0] = 'decimal';

            $length = $field['numeric_precision'].','.$field['numeric_scale'];

            break;

        case 'text':

        case 'ntext':

        case 'varchar':

        case 'nvarchar':

            $fixed = false;

        case 'char':

        case 'nchar':

            $type[0] = 'text';

            if ($length == '1') {

                $type[] = 'boolean';

                if (preg_match('/^(is|has)/', $field['name'])) {

                    $type = array_reverse($type);

                }

            } elseif (strstr($db_type, 'text')) {

                $type[] = 'clob';

                $type = array_reverse($type);

            }

            if ($fixed !== false) {

                $fixed = true;

            }

            break;

        case 'image':

        case 'varbinary':

            $type[] = 'blob';

            $length = null;

            break;

        default:

            $db =& $this->getDBInstance();

            if (PEAR::isError($db)) {

                return $db;

            }

            return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

                'unknown database attribute type: '.$db_type, __FUNCTION__);

        }



        if ((int)$length <= 0) {

            $length = null;

        }



        return array($type, $length, $unsigned, $fixed);

    }

    // }}}

}



<?php
// vim: set et ts=4 sw=4 fdm=marker:
// +----------------------------------------------------------------------+
// | PHP versions 4 and 5                                                 |
// +----------------------------------------------------------------------+
// | Copyright (c) 1998-2007 Manuel Lemos, Tomas V.V.Cox,                 |
// | Stig. S. Bakken, Lukas Smith                                         |
// | All rights reserved.                                                 |
// +----------------------------------------------------------------------+
// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |
// | API as well as database abstraction for PHP applications.            |
// | This LICENSE is in the BSD license style.                            |
// |                                                                      |
// | Redistribution and use in source and binary forms, with or without   |
// | modification, are permitted provided that the following conditions   |
// | are met:                                                             |
// |                                                                      |
// | Redistributions of source code must retain the above copyright       |
// | notice, this list of conditions and the following disclaimer.        |
// |                                                                      |
// | Redistributions in binary form must reproduce the above copyright    |
// | notice, this list of conditions and the following disclaimer in the  |
// | documentation and/or other materials provided with the distribution. |
// |                                                                      |
// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |
// | Lukas Smith nor the names of his contributors may be used to endorse |
// | or promote products derived from this software without specific prior|
// | written permission.                                                  |
// |                                                                      |
// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |
// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |
// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |
// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |
// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |
// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |
// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|
// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |
// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |
// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|
// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |
// | POSSIBILITY OF SUCH DAMAGE.                                          |
// +----------------------------------------------------------------------+
// | Authors: Lukas Smith <smith@pooteeweet.org>                          |
// |          Daniel Convissor <danielc@php.net>                          |
// +----------------------------------------------------------------------+
//
// $Id: mssql.php,v 1.65 2008/02/19 14:54:17 afz Exp $
//

require_once 'MDB2/Driver/Datatype/Common.php';

/**
 * MDB2 MS SQL driver
 *
 * @package MDB2
 * @category Database
 * @author  Lukas Smith <smith@pooteeweet.org>
 */
class MDB2_Driver_Datatype_mssql extends MDB2_Driver_Datatype_Common
{
    // {{{ _baseConvertResult()

    /**
     * general type conversion method
     *
     * @param mixed   $value refernce to a value to be converted
     * @param string  $type  specifies which type to convert to
     * @param boolean $rtrim [optional] when TRUE [default], apply rtrim() to text
     * @return object a MDB2 error on failure
     * @access protected
     */
    function _baseConvertResult($value, $type, $rtrim = true)
    {
        if (is_null($value)) {
            return null;
        }
        switch ($type) {
        case 'boolean':
            return $value == '1';
        case 'date':
            if (strlen($value) > 10) {
                $value = substr($value,0,10);
            }
            return $value;
        case 'time':
            if (strlen($value) > 8) {
                $value = substr($value,11,8);
            }
            return $value;
        }
        return parent::_baseConvertResult($value, $type, $rtrim);
    }

    // }}}
    // {{{ _getCollationFieldDeclaration()

    /**
     * Obtain DBMS specific SQL code portion needed to set the COLLATION
     * of a field declaration to be used in statements like CREATE TABLE.
     *
     * @param string $collation name of the collation
     *
     * @return string DBMS specific SQL code portion needed to set the COLLATION
     *                of a field declaration.
     */
    function _getCollationFieldDeclaration($collation)
    {
        return 'COLLATE '.$collation;
    }

    // }}}
    // {{{ getTypeDeclaration()

    /**
     * Obtain DBMS specific SQL code portion needed to declare an text type
     * field to be used in statements like CREATE TABLE.
     *
     * @param array $field  associative array with the name of the properties
     *      of the field being declared as array indexes. Currently, the types
     *      of supported field properties are as follows:
     *
     *      length
     *          Integer value that determines the maximum length of the text
     *          field. If this argument is missing the field should be
     *          declared to have the longest length allowed by the DBMS.
     *
     *      default
     *          Text value to be used as default for this field.
     *
     *      notnull
     *          Boolean flag that indicates whether this field is constrained
     *          to not be set to null.
     * @return string  DBMS specific SQL code portion that should be used to
     *      declare the specified field.
     * @access public
     */
    function getTypeDeclaration($field)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        switch ($field['type']) {
        case 'text':
            $length = !empty($field['length'])
                ? $field['length'] : false;
            $fixed = !empty($field['fixed']) ? $field['fixed'] : false;
            return $fixed ? ($length ? 'CHAR('.$length.')' : 'CHAR('.$db->options['default_text_field_length'].')')
                : ($length ? 'VARCHAR('.$length.')' : 'TEXT');
        case 'clob':
            if (!empty($field['length'])) {
                $length = $field['length'];
                if ($length <= 8000) {
                    return 'VARCHAR('.$length.')';
                }
             }
             return 'TEXT';
        case 'blob':
            if (!empty($field['length'])) {
                $length = $field['length'];
                if ($length <= 8000) {
                    return "VARBINARY($length)";
                }
            }
            return 'IMAGE';
        case 'integer':
            return 'INT';
        case 'boolean':
            return 'BIT';
        case 'date':
            return 'CHAR ('.strlen('YYYY-MM-DD').')';
        case 'time':
            return 'CHAR ('.strlen('HH:MM:SS').')';
        case 'timestamp':
            return 'CHAR ('.strlen('YYYY-MM-DD HH:MM:SS').')';
        case 'float':
            return 'FLOAT';
        case 'decimal':
            $length = !empty($field['length']) ? $field['length'] : 18;
            $scale = !empty($field['scale']) ? $field['scale'] : $db->options['decimal_places'];
            return 'DECIMAL('.$length.','.$scale.')';
        }
        return '';
    }

    // }}}
    // {{{ _getIntegerDeclaration()

    /**
     * Obtain DBMS specific SQL code portion needed to declare an integer type
     * field to be used in statements like CREATE TABLE.
     *
     * @param string  $name   name the field to be declared.
     * @param string  $field  associative array with the name of the properties
     *                        of the field being declared as array indexes.
     *                        Currently, the types of supported field
     *                        properties are as follows:
     *
     *                       unsigned
     *                        Boolean flag that indicates whether the field
     *                        should be declared as unsigned integer if
     *                        possible.
     *
     *                       default
     *                        Integer value to be used as default for this
     *                        field.
     *
     *                       notnull
     *                        Boolean flag that indicates whether this field is
     *                        constrained to not be set to null.
     * @return string  DBMS specific SQL code portion that should be used to
     *                 declare the specified field.
     * @access protected
     */
    function _getIntegerDeclaration($name, $field)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $notnull = empty($field['notnull']) ? ' NULL' : ' NOT NULL';
        $default = $autoinc = '';
        if (!empty($field['autoincrement'])) {
            $autoinc = ' IDENTITY PRIMARY KEY';
        } elseif (array_key_exists('default', $field)) {
            if ($field['default'] === '') {
                $field['default'] = 0;
            }
            if (is_null($field['default'])) {
                $default = ' DEFAULT (null)';
            } else {
                $default = ' DEFAULT (' . $this->quote($field['default'], 'integer') . ')';
            }
        }

        if (!empty($field['unsigned'])) {
            $db->warnings[] = "unsigned integer field \"$name\" is being declared as signed integer";
        }

        $name = $db->quoteIdentifier($name, true);
        return $name.' '.$this->getTypeDeclaration($field).$notnull.$default.$autoinc;
    }

    // }}}
    // {{{ _getCLOBDeclaration()

    /**
     * Obtain DBMS specific SQL code portion needed to declare an character
     * large object type field to be used in statements like CREATE TABLE.
     *
     * @param string $name name the field to be declared.
     * @param array $field associative array with the name of the properties
     *        of the field being declared as array indexes. Currently, the types
     *        of supported field properties are as follows:
     *
     *        length
     *            Integer value that determines the maximum length of the large
     *            object field. If this argument is missing the field should be
     *            declared to have the longest length allowed by the DBMS.
     *
     *        notnull
     *            Boolean flag that indicates whether this field is constrained
     *            to not be set to null.
     * @return string DBMS specific SQL code portion that should be used to
     *        declare the specified field.
     * @access public
     */
    function _getCLOBDeclaration($name, $field)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $notnull = empty($field['notnull']) ? ' NULL' : ' NOT NULL';
        $name = $db->quoteIdentifier($name, true);
        return $name.' '.$this->getTypeDeclaration($field).$notnull;
    }

    // }}}
    // {{{ _getBLOBDeclaration()

    /**
     * Obtain DBMS specific SQL code portion needed to declare an binary large
     * object type field to be used in statements like CREATE TABLE.
     *
     * @param string $name name the field to be declared.
     * @param array $field associative array with the name of the properties
     *        of the field being declared as array indexes. Currently, the types
     *        of supported field properties are as follows:
     *
     *        length
     *            Integer value that determines the maximum length of the large
     *            object field. If this argument is missing the field should be
     *            declared to have the longest length allowed by the DBMS.
     *
     *        notnull
     *            Boolean flag that indicates whether this field is constrained
     *            to not be set to null.
     * @return string DBMS specific SQL code portion that should be used to
     *        declare the specified field.
     * @access protected
     */
    function _getBLOBDeclaration($name, $field)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $notnull = empty($field['notnull']) ? ' NULL' : ' NOT NULL';
        $name = $db->quoteIdentifier($name, true);
        return $name.' '.$this->getTypeDeclaration($field).$notnull;
    }

    // }}}
    // {{{ _quoteBLOB()

    /**
     * Convert a text value into a DBMS specific format that is suitable to
     * compose query statements.
     *
     * @param string $value text string value that is intended to be converted.
     * @param bool $quote determines if the value should be quoted and escaped
     * @param bool $escape_wildcards if to escape escape wildcards
     * @return string  text string that represents the given argument value in
     *                 a DBMS specific format.
     * @access protected
     */
    function _quoteBLOB($value, $quote, $escape_wildcards)
    {
        if (!$quote) {
            return $value;
        }
        $value = '0x'.bin2hex($this->_readFile($value));
        return $value;
    }

    // }}}
    // {{{ _mapNativeDatatype()

    /**
     * Maps a native array description of a field to a MDB2 datatype and length
     *
     * @param array  $field native field description
     * @return array containing the various possible types, length, sign, fixed
     * @access public
     */
    function _mapNativeDatatype($field)
    {
        // todo: handle length of various int variations
        $db_type = preg_replace('/\d/', '', strtolower($field['type']));
        $length = $field['length'];
        $type = array();
        // todo: unsigned handling seems to be missing
        $unsigned = $fixed = null;
        switch ($db_type) {
        case 'bit':
            $type[0] = 'boolean';
            break;
        case 'tinyint':
            $type[0] = 'integer';
            $length = 1;
            break;
        case 'smallint':
            $type[0] = 'integer';
            $length = 2;
            break;
        case 'int':
            $type[0] = 'integer';
            $length = 4;
            break;
        case 'bigint':
            $type[0] = 'integer';
            $length = 8;
            break;
        case 'datetime':
            $type[0] = 'timestamp';
            break;
        case 'float':
        case 'real':
        case 'numeric':
            $type[0] = 'float';
            break;
        case 'decimal':
        case 'money':
            $type[0] = 'decimal';
            $length = $field['numeric_precision'].','.$field['numeric_scale'];
            break;
        case 'text':
        case 'ntext':
        case 'varchar':
        case 'nvarchar':
            $fixed = false;
        case 'char':
        case 'nchar':
            $type[0] = 'text';
            if ($length == '1') {
                $type[] = 'boolean';
                if (preg_match('/^(is|has)/', $field['name'])) {
                    $type = array_reverse($type);
                }
            } elseif (strstr($db_type, 'text')) {
                $type[] = 'clob';
                $type = array_reverse($type);
            }
            if ($fixed !== false) {
                $fixed = true;
            }
            break;
        case 'image':
        case 'varbinary':
            $type[] = 'blob';
            $length = null;
            break;
        default:
            $db =& $this->getDBInstance();
            if (PEAR::isError($db)) {
                return $db;
            }
            return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
                'unknown database attribute type: '.$db_type, __FUNCTION__);
        }

        if ((int)$length <= 0) {
            $length = null;
        }

        return array($type, $length, $unsigned, $fixed);
    }
    // }}}
}

?>

 program/lib/MDB2/Driver/Datatype/mysql.php

@@ -3,7 +3,7 @@
// +----------------------------------------------------------------------+

// | PHP versions 4 and 5                                                 |

// +----------------------------------------------------------------------+

// | Copyright (c) 1998-2007 Manuel Lemos, Tomas V.V.Cox,                 |

// | Copyright (c) 1998-2008 Manuel Lemos, Tomas V.V.Cox,                 |

// | Stig. S. Bakken, Lukas Smith                                         |

// | All rights reserved.                                                 |

// +----------------------------------------------------------------------+

@@ -43,7 +43,7 @@
// | Author: Lukas Smith <smith@pooteeweet.org>                           |

// +----------------------------------------------------------------------+

//

// $Id: mysql.php,v 1.62 2007/11/09 20:54:58 quipo Exp $

// $Id: mysql.php,v 1.65 2008/02/22 19:23:49 quipo Exp $

//



require_once 'MDB2/Driver/Datatype/Common.php';

@@ -232,6 +232,93 @@
                $field['default'] = empty($field['notnull']) ? null : 0;

            }

            $default = ' DEFAULT '.$this->quote($field['default'], 'integer');

        }



        $notnull = empty($field['notnull']) ? '' : ' NOT NULL';

        $unsigned = empty($field['unsigned']) ? '' : ' UNSIGNED';

        $name = $db->quoteIdentifier($name, true);

        return $name.' '.$this->getTypeDeclaration($field).$unsigned.$default.$notnull.$autoinc;

    }



    // }}}

    // {{{ _getFloatDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to declare an float type

     * field to be used in statements like CREATE TABLE.

     *

     * @param string  $name   name the field to be declared.

     * @param string  $field  associative array with the name of the properties

     *                        of the field being declared as array indexes.

     *                        Currently, the types of supported field

     *                        properties are as follows:

     *

     *                       unsigned

     *                        Boolean flag that indicates whether the field

     *                        should be declared as unsigned float if

     *                        possible.

     *

     *                       default

     *                        float value to be used as default for this

     *                        field.

     *

     *                       notnull

     *                        Boolean flag that indicates whether this field is

     *                        constrained to not be set to null.

     * @return string  DBMS specific SQL code portion that should be used to

     *                 declare the specified field.

     * @access protected

     */

    function _getFloatDeclaration($name, $field)

    {

        // Since AUTO_INCREMENT can be used for integer or floating-point types,

        // reuse the INTEGER declaration

        // @see http://bugs.mysql.com/bug.php?id=31032

        return $this->_getIntegerDeclaration($name, $field);

    }



    // }}}

    // {{{ _getDecimalDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to declare an decimal type

     * field to be used in statements like CREATE TABLE.

     *

     * @param string  $name   name the field to be declared.

     * @param string  $field  associative array with the name of the properties

     *                        of the field being declared as array indexes.

     *                        Currently, the types of supported field

     *                        properties are as follows:

     *

     *                       unsigned

     *                        Boolean flag that indicates whether the field

     *                        should be declared as unsigned integer if

     *                        possible.

     *

     *                       default

     *                        Decimal value to be used as default for this

     *                        field.

     *

     *                       notnull

     *                        Boolean flag that indicates whether this field is

     *                        constrained to not be set to null.

     * @return string  DBMS specific SQL code portion that should be used to

     *                 declare the specified field.

     * @access protected

     */

    function _getDecimalDeclaration($name, $field)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $default = '';

        if (array_key_exists('default', $field)) {

            if ($field['default'] === '') {

                $field['default'] = empty($field['notnull']) ? null : 0;

            }

            $default = ' DEFAULT '.$this->quote($field['default'], 'integer');

        } elseif (empty($field['notnull'])) {

            $default = ' DEFAULT NULL';

        }

@@ -239,7 +326,7 @@
        $notnull = empty($field['notnull']) ? '' : ' NOT NULL';

        $unsigned = empty($field['unsigned']) ? '' : ' UNSIGNED';

        $name = $db->quoteIdentifier($name, true);

        return $name.' '.$this->getTypeDeclaration($field).$unsigned.$default.$notnull.$autoinc;

        return $name.' '.$this->getTypeDeclaration($field).$unsigned.$default.$notnull;

    }



    // }}}


 program/lib/MDB2/Driver/Datatype/mysqli.php

@@ -43,7 +43,7 @@
// | Author: Lukas Smith <smith@pooteeweet.org>                           |

// +----------------------------------------------------------------------+

//

// $Id: mysqli.php,v 1.61 2007/11/09 20:54:58 quipo Exp $

// $Id: mysqli.php,v 1.63 2008/02/22 19:23:49 quipo Exp $

//



require_once 'MDB2/Driver/Datatype/Common.php';

@@ -232,6 +232,93 @@
                $field['default'] = empty($field['notnull']) ? null : 0;

            }

            $default = ' DEFAULT '.$this->quote($field['default'], 'integer');

        }



        $notnull = empty($field['notnull']) ? '' : ' NOT NULL';

        $unsigned = empty($field['unsigned']) ? '' : ' UNSIGNED';

        $name = $db->quoteIdentifier($name, true);

        return $name.' '.$this->getTypeDeclaration($field).$unsigned.$default.$notnull.$autoinc;

    }



    // }}}

    // {{{ _getFloatDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to declare an float type

     * field to be used in statements like CREATE TABLE.

     *

     * @param string  $name   name the field to be declared.

     * @param string  $field  associative array with the name of the properties

     *                        of the field being declared as array indexes.

     *                        Currently, the types of supported field

     *                        properties are as follows:

     *

     *                       unsigned

     *                        Boolean flag that indicates whether the field

     *                        should be declared as unsigned float if

     *                        possible.

     *

     *                       default

     *                        float value to be used as default for this

     *                        field.

     *

     *                       notnull

     *                        Boolean flag that indicates whether this field is

     *                        constrained to not be set to null.

     * @return string  DBMS specific SQL code portion that should be used to

     *                 declare the specified field.

     * @access protected

     */

    function _getFloatDeclaration($name, $field)

    {

        // Since AUTO_INCREMENT can be used for integer or floating-point types,

        // reuse the INTEGER declaration

        // @see http://bugs.mysql.com/bug.php?id=31032

        return $this->_getIntegerDeclaration($name, $field);

    }



    // }}}

    // {{{ _getDecimalDeclaration()



    /**

     * Obtain DBMS specific SQL code portion needed to declare an decimal type

     * field to be used in statements like CREATE TABLE.

     *

     * @param string  $name   name the field to be declared.

     * @param string  $field  associative array with the name of the properties

     *                        of the field being declared as array indexes.

     *                        Currently, the types of supported field

     *                        properties are as follows:

     *

     *                       unsigned

     *                        Boolean flag that indicates whether the field

     *                        should be declared as unsigned integer if

     *                        possible.

     *

     *                       default

     *                        Decimal value to be used as default for this

     *                        field.

     *

     *                       notnull

     *                        Boolean flag that indicates whether this field is

     *                        constrained to not be set to null.

     * @return string  DBMS specific SQL code portion that should be used to

     *                 declare the specified field.

     * @access protected

     */

    function _getDecimalDeclaration($name, $field)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $default = '';

        if (array_key_exists('default', $field)) {

            if ($field['default'] === '') {

                $field['default'] = empty($field['notnull']) ? null : 0;

            }

            $default = ' DEFAULT '.$this->quote($field['default'], 'integer');

        } elseif (empty($field['notnull'])) {

            $default = ' DEFAULT NULL';

        }

@@ -239,7 +326,7 @@
        $notnull = empty($field['notnull']) ? '' : ' NOT NULL';

        $unsigned = empty($field['unsigned']) ? '' : ' UNSIGNED';

        $name = $db->quoteIdentifier($name, true);

        return $name.' '.$this->getTypeDeclaration($field).$unsigned.$default.$notnull.$autoinc;

        return $name.' '.$this->getTypeDeclaration($field).$unsigned.$default.$notnull;

    }



    // }}}

@@ -355,7 +442,6 @@
        case 'tinytext':

        case 'mediumtext':

        case 'longtext':

        case 'text':

        case 'text':

        case 'varchar':

            $fixed = false;


 program/lib/MDB2/Driver/Datatype/pgsql.php

@@ -42,7 +42,7 @@
// | Author: Paul Cooper <pgc@ucecom.com>                                 |

// +----------------------------------------------------------------------+

//

// $Id: pgsql.php,v 1.88 2007/11/09 20:54:58 quipo Exp $

// $Id: pgsql.php,v 1.91 2008/03/09 12:28:08 quipo Exp $



require_once 'MDB2/Driver/Datatype/Common.php';



@@ -217,8 +217,6 @@
                $field['default'] = empty($field['notnull']) ? null : 0;

            }

            $default = ' DEFAULT '.$this->quote($field['default'], 'integer');

        } elseif (empty($field['notnull'])) {

            $default = ' DEFAULT NULL';

        }



        $notnull = empty($field['notnull']) ? '' : ' NOT NULL';

@@ -453,6 +451,7 @@
            break;

        case 'datetime':

        case 'timestamp':

        case 'timestamptz':

            $type[] = 'timestamp';

            $length = null;

            break;

@@ -461,6 +460,7 @@
            $length = null;

            break;

        case 'float':

        case 'float4':

        case 'float8':

        case 'double':

        case 'real':


 program/lib/MDB2/Driver/Datatype/sqlite.php

@@ -43,7 +43,7 @@
// | Author: Lukas Smith <smith@pooteeweet.org>                           |

// +----------------------------------------------------------------------+

//

// $Id: sqlite.php,v 1.65 2007/12/03 20:59:51 quipo Exp $

// $Id: sqlite.php,v 1.67 2008/02/22 19:58:06 quipo Exp $

//



require_once 'MDB2/Driver/Datatype/Common.php';

@@ -212,8 +212,6 @@
                $field['default'] = empty($field['notnull']) ? null : 0;

            }

            $default = ' DEFAULT '.$this->quote($field['default'], 'integer');

        } elseif (empty($field['notnull'])) {

            $default = ' DEFAULT NULL';

        }



        $notnull = empty($field['notnull']) ? '' : ' NOT NULL';

@@ -394,7 +392,6 @@
            if (PEAR::isError($db)) {

                return $db;

            }



            return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

                'unknown database attribute type: '.$db_type, __FUNCTION__);

        }


 program/lib/MDB2/Driver/Function/Common.php

@@ -1,249 +1,293 @@
<?php
// +----------------------------------------------------------------------+
// | PHP versions 4 and 5                                                 |
// +----------------------------------------------------------------------+
// | Copyright (c) 1998-2006 Manuel Lemos, Tomas V.V.Cox,                 |
// | Stig. S. Bakken, Lukas Smith                                         |
// | All rights reserved.                                                 |
// +----------------------------------------------------------------------+
// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |
// | API as well as database abstraction for PHP applications.            |
// | This LICENSE is in the BSD license style.                            |
// |                                                                      |
// | Redistribution and use in source and binary forms, with or without   |
// | modification, are permitted provided that the following conditions   |
// | are met:                                                             |
// |                                                                      |
// | Redistributions of source code must retain the above copyright       |
// | notice, this list of conditions and the following disclaimer.        |
// |                                                                      |
// | Redistributions in binary form must reproduce the above copyright    |
// | notice, this list of conditions and the following disclaimer in the  |
// | documentation and/or other materials provided with the distribution. |
// |                                                                      |
// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |
// | Lukas Smith nor the names of his contributors may be used to endorse |
// | or promote products derived from this software without specific prior|
// | written permission.                                                  |
// |                                                                      |
// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |
// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |
// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |
// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |
// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |
// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |
// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|
// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |
// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |
// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|
// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |
// | POSSIBILITY OF SUCH DAMAGE.                                          |
// +----------------------------------------------------------------------+
// | Author: Lukas Smith <smith@pooteeweet.org>                           |
// +----------------------------------------------------------------------+
//
// $Id: Common.php,v 1.19 2007/09/09 13:47:36 quipo Exp $
//

/**
 * @package  MDB2
 * @category Database
 * @author   Lukas Smith <smith@pooteeweet.org>
 */

/**
 * Base class for the function modules that is extended by each MDB2 driver
 *
 * To load this module in the MDB2 object:
 * $mdb->loadModule('Function');
 *
 * @package MDB2
 * @category Database
 * @author  Lukas Smith <smith@pooteeweet.org>
 */
class MDB2_Driver_Function_Common extends MDB2_Module_Common
{
    // {{{ executeStoredProc()

    /**
     * Execute a stored procedure and return any results
     *
     * @param string $name string that identifies the function to execute
     * @param mixed  $params  array that contains the paramaters to pass the stored proc
     * @param mixed   $types  array that contains the types of the columns in
     *                        the result set
     * @param mixed $result_class string which specifies which result class to use
     * @param mixed $result_wrap_class string which specifies which class to wrap results in
     * @return mixed a result handle or MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function &executeStoredProc($name, $params = null, $types = null, $result_class = true, $result_wrap_class = false)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $error =& $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
            'method not implemented', __FUNCTION__);
        return $error;
    }

    // }}}
    // {{{ functionTable()

    /**
     * return string for internal table used when calling only a function
     *
     * @return string for internal table used when calling only a function
     * @access public
     */
    function functionTable()
    {
        return '';
    }

    // }}}
    // {{{ now()

    /**
     * Return string to call a variable with the current timestamp inside an SQL statement
     * There are three special variables for current date and time:
     * - CURRENT_TIMESTAMP (date and time, TIMESTAMP type)
     * - CURRENT_DATE (date, DATE type)
     * - CURRENT_TIME (time, TIME type)
     *
     * @return string to call a variable with the current timestamp
     * @access public
     */
    function now($type = 'timestamp')
    {
        switch ($type) {
        case 'time':
            return 'CURRENT_TIME';
        case 'date':
            return 'CURRENT_DATE';
        case 'timestamp':
        default:
            return 'CURRENT_TIMESTAMP';
        }
    }

    // }}}
    // {{{ substring()

    /**
     * return string to call a function to get a substring inside an SQL statement
     *
     * @return string to call a function to get a substring
     * @access public
     */
    function substring($value, $position = 1, $length = null)
    {
        if (!is_null($length)) {
            return "SUBSTRING($value FROM $position FOR $length)";
        }
        return "SUBSTRING($value FROM $position)";
    }

    // }}}
    // {{{ concat()

    /**
     * Returns string to concatenate two or more string parameters
     *
     * @param string $value1
     * @param string $value2
     * @param string $values...
     * @return string to concatenate two strings
     * @access public
     */
    function concat($value1, $value2)
    {
        $args = func_get_args();
        return "(".implode(' || ', $args).")";
    }

    // }}}
    // {{{ random()

    /**
     * return string to call a function to get random value inside an SQL statement
     *
     * @return return string to generate float between 0 and 1
     * @access public
     */
    function random()
    {
        return 'RAND()';
    }

    // }}}
    // {{{ lower()

    /**
     * return string to call a function to lower the case of an expression
     *
     * @param string $expression
     * @return return string to lower case of an expression
     * @access public
     */
    function lower($expression)
    {
        return "LOWER($expression)";
    }

    // }}}
    // {{{ upper()

    /**
     * return string to call a function to upper the case of an expression
     *
     * @param string $expression
     * @return return string to upper case of an expression
     * @access public
     */
    function upper($expression)
    {
        return "UPPER($expression)";
    }

    // }}}
    // {{{ length()

    /**
     * return string to call a function to get the length of a string expression
     *
     * @param string $expression
     * @return return string to get the string expression length
     * @access public
     */
    function length($expression)
    {
        return "LENGTH($expression)";
    }

    // }}}
    // {{{ guid()

    /**
     * Returns global unique identifier
     *
     * @return string to get global unique identifier
     * @access public
     */
    function guid()
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $error =& $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
            'method not implemented', __FUNCTION__);
        return $error;
    }

    // }}}
}
<?php

// +----------------------------------------------------------------------+

// | PHP versions 4 and 5                                                 |

// +----------------------------------------------------------------------+

// | Copyright (c) 1998-2006 Manuel Lemos, Tomas V.V.Cox,                 |

// | Stig. S. Bakken, Lukas Smith                                         |

// | All rights reserved.                                                 |

// +----------------------------------------------------------------------+

// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |

// | API as well as database abstraction for PHP applications.            |

// | This LICENSE is in the BSD license style.                            |

// |                                                                      |

// | Redistribution and use in source and binary forms, with or without   |

// | modification, are permitted provided that the following conditions   |

// | are met:                                                             |

// |                                                                      |

// | Redistributions of source code must retain the above copyright       |

// | notice, this list of conditions and the following disclaimer.        |

// |                                                                      |

// | Redistributions in binary form must reproduce the above copyright    |

// | notice, this list of conditions and the following disclaimer in the  |

// | documentation and/or other materials provided with the distribution. |

// |                                                                      |

// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |

// | Lukas Smith nor the names of his contributors may be used to endorse |

// | or promote products derived from this software without specific prior|

// | written permission.                                                  |

// |                                                                      |

// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |

// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |

// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |

// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |

// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |

// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |

// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|

// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |

// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |

// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|

// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |

// | POSSIBILITY OF SUCH DAMAGE.                                          |

// +----------------------------------------------------------------------+

// | Author: Lukas Smith <smith@pooteeweet.org>                           |

// +----------------------------------------------------------------------+

//

// $Id: Common.php,v 1.21 2008/02/17 18:51:39 quipo Exp $

//



/**

 * @package  MDB2

 * @category Database

 * @author   Lukas Smith <smith@pooteeweet.org>

 */



/**

 * Base class for the function modules that is extended by each MDB2 driver

 *

 * To load this module in the MDB2 object:

 * $mdb->loadModule('Function');

 *

 * @package  MDB2

 * @category Database

 * @author   Lukas Smith <smith@pooteeweet.org>

 */

class MDB2_Driver_Function_Common extends MDB2_Module_Common

{

    // {{{ executeStoredProc()



    /**

     * Execute a stored procedure and return any results

     *

     * @param string $name string that identifies the function to execute

     * @param mixed  $params  array that contains the paramaters to pass the stored proc

     * @param mixed   $types  array that contains the types of the columns in

     *                        the result set

     * @param mixed $result_class string which specifies which result class to use

     * @param mixed $result_wrap_class string which specifies which class to wrap results in

     *

     * @return mixed a result handle or MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function &executeStoredProc($name, $params = null, $types = null, $result_class = true, $result_wrap_class = false)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $error =& $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

            'method not implemented', __FUNCTION__);

        return $error;

    }



    // }}}

    // {{{ functionTable()



    /**

     * return string for internal table used when calling only a function

     *

     * @return string for internal table used when calling only a function

     * @access public

     */

    function functionTable()

    {

        return '';

    }



    // }}}

    // {{{ now()



    /**

     * Return string to call a variable with the current timestamp inside an SQL statement

     * There are three special variables for current date and time:

     * - CURRENT_TIMESTAMP (date and time, TIMESTAMP type)

     * - CURRENT_DATE (date, DATE type)

     * - CURRENT_TIME (time, TIME type)

     *

     * @param string $type 'timestamp' | 'time' | 'date'

     *

     * @return string to call a variable with the current timestamp

     * @access public

     */

    function now($type = 'timestamp')

    {

        switch ($type) {

        case 'time':

            return 'CURRENT_TIME';

        case 'date':

            return 'CURRENT_DATE';

        case 'timestamp':

        default:

            return 'CURRENT_TIMESTAMP';

        }

    }



    // }}}

    // {{{ unixtimestamp()



    /**

     * return string to call a function to get the unix timestamp from a iso timestamp

     *

     * @param string $expression

     *

     * @return string to call a variable with the timestamp

     * @access public

     */

    function unixtimestamp($expression)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $error =& $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

            'method not implemented', __FUNCTION__);

        return $error;

    }



    // }}}

    // {{{ substring()



    /**

     * return string to call a function to get a substring inside an SQL statement

     *

     * @return string to call a function to get a substring

     * @access public

     */

    function substring($value, $position = 1, $length = null)

    {

        if (!is_null($length)) {

            return "SUBSTRING($value FROM $position FOR $length)";

        }

        return "SUBSTRING($value FROM $position)";

    }



    // }}}

    // {{{ replace()



    /**

     * return string to call a function to get replace inside an SQL statement.

     *

     * @return string to call a function to get a replace

     * @access public

     */

    function replace($str, $from_str, $to_str)

    {

        return "REPLACE($str, $from_str , $to_str)";

    }



    // }}}

    // {{{ concat()



    /**

     * Returns string to concatenate two or more string parameters

     *

     * @param string $value1

     * @param string $value2

     * @param string $values...

     *

     * @return string to concatenate two strings

     * @access public

     */

    function concat($value1, $value2)

    {

        $args = func_get_args();

        return "(".implode(' || ', $args).")";

    }



    // }}}

    // {{{ random()



    /**

     * return string to call a function to get random value inside an SQL statement

     *

     * @return return string to generate float between 0 and 1

     * @access public

     */

    function random()

    {

        return 'RAND()';

    }



    // }}}

    // {{{ lower()



    /**

     * return string to call a function to lower the case of an expression

     *

     * @param string $expression

     *

     * @return return string to lower case of an expression

     * @access public

     */

    function lower($expression)

    {

        return "LOWER($expression)";

    }



    // }}}

    // {{{ upper()



    /**

     * return string to call a function to upper the case of an expression

     *

     * @param string $expression

     *

     * @return return string to upper case of an expression

     * @access public

     */

    function upper($expression)

    {

        return "UPPER($expression)";

    }



    // }}}

    // {{{ length()



    /**

     * return string to call a function to get the length of a string expression

     *

     * @param string $expression

     *

     * @return return string to get the string expression length

     * @access public

     */

    function length($expression)

    {

        return "LENGTH($expression)";

    }



    // }}}

    // {{{ guid()



    /**

     * Returns global unique identifier

     *

     * @return string to get global unique identifier

     * @access public

     */

    function guid()

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $error =& $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

            'method not implemented', __FUNCTION__);

        return $error;

    }



    // }}}

}

?>

 program/lib/MDB2/Driver/Function/mssql.php

@@ -1,178 +1,193 @@
<?php
// +----------------------------------------------------------------------+
// | PHP versions 4 and 5                                                 |
// +----------------------------------------------------------------------+
// | Copyright (c) 1998-2006 Manuel Lemos, Tomas V.V.Cox,                 |
// | Stig. S. Bakken, Lukas Smith                                         |
// | All rights reserved.                                                 |
// +----------------------------------------------------------------------+
// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |
// | API as well as database abstraction for PHP applications.            |
// | This LICENSE is in the BSD license style.                            |
// |                                                                      |
// | Redistribution and use in source and binary forms, with or without   |
// | modification, are permitted provided that the following conditions   |
// | are met:                                                             |
// |                                                                      |
// | Redistributions of source code must retain the above copyright       |
// | notice, this list of conditions and the following disclaimer.        |
// |                                                                      |
// | Redistributions in binary form must reproduce the above copyright    |
// | notice, this list of conditions and the following disclaimer in the  |
// | documentation and/or other materials provided with the distribution. |
// |                                                                      |
// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |
// | Lukas Smith nor the names of his contributors may be used to endorse |
// | or promote products derived from this software without specific prior|
// | written permission.                                                  |
// |                                                                      |
// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |
// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |
// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |
// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |
// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |
// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |
// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|
// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |
// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |
// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|
// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |
// | POSSIBILITY OF SUCH DAMAGE.                                          |
// +----------------------------------------------------------------------+
// | Author: Frank M. Kromann <frank@kromann.info>                        |
// +----------------------------------------------------------------------+
//
// $Id: mssql.php,v 1.15 2007/08/11 16:02:22 quipo Exp $
//

require_once 'MDB2/Driver/Function/Common.php';

// {{{ class MDB2_Driver_Function_mssql
/**
 * MDB2 MSSQL driver for the function modules
 *
 * @package MDB2
 * @category Database
 * @author Lukas Smith <smith@pooteeweet.org>
 */
class MDB2_Driver_Function_mssql extends MDB2_Driver_Function_Common
{
     // }}}
    // {{{ executeStoredProc()

    /**
     * Execute a stored procedure and return any results
     *
     * @param string $name string that identifies the function to execute
     * @param mixed  $params  array that contains the paramaters to pass the stored proc
     * @param mixed   $types  array that contains the types of the columns in
     *                        the result set
     * @param mixed $result_class string which specifies which result class to use
     * @param mixed $result_wrap_class string which specifies which class to wrap results in
     * @return mixed a result handle or MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function &executeStoredProc($name, $params = null, $types = null, $result_class = true, $result_wrap_class = false)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $query = 'EXECUTE '.$name;
        $query .= $params ? ' '.implode(', ', $params) : '';
        return $db->query($query, $types, $result_class, $result_wrap_class);
    }

    // }}}
    // {{{ now()

    /**
     * Return string to call a variable with the current timestamp inside an SQL statement
     * There are three special variables for current date and time:
     * - CURRENT_TIMESTAMP (date and time, TIMESTAMP type)
     * - CURRENT_DATE (date, DATE type)
     * - CURRENT_TIME (time, TIME type)
     *
     * @return string to call a variable with the current timestamp
     * @access public
     */
    function now($type = 'timestamp')
    {
        switch ($type) {
        case 'time':
        case 'date':
        case 'timestamp':
        default:
            return 'GETDATE()';
        }
    }

    // }}}
    // {{{ substring()

    /**
     * return string to call a function to get a substring inside an SQL statement
     *
     * @return string to call a function to get a substring
     * @access public
     */
    function substring($value, $position = 1, $length = null)
    {
        if (!is_null($length)) {
            return "SUBSTRING($value, $position, $length)";
        }
        return "SUBSTRING($value, $position, LEN($value) - $position + 1)";
    }

    // }}}
    // {{{ concat()

    /**
     * Returns string to concatenate two or more string parameters
     *
     * @param string $value1
     * @param string $value2
     * @param string $values...
     * @return string to concatenate two strings
     * @access public
     **/
    function concat($value1, $value2)
    {
        $args = func_get_args();
        return "(".implode(' + ', $args).")";
    }

    // }}}
    // {{{ length()

    /**
     * return string to call a function to get the length of a string expression
     *
     * @param string $expression
     * @return return string to get the string expression length
     * @access public
     */
    function length($expression)
    {
        return "LEN($expression)";
    }

    // }}}
    // {{{ guid()

    /**
     * Returns global unique identifier
     *
     * @return string to get global unique identifier
     * @access public
     */
    function guid()
    {
        return 'NEWID()';
    }

    // }}}
}
// }}}
<?php

// +----------------------------------------------------------------------+

// | PHP versions 4 and 5                                                 |

// +----------------------------------------------------------------------+

// | Copyright (c) 1998-2008 Manuel Lemos, Tomas V.V.Cox,                 |

// | Stig. S. Bakken, Lukas Smith                                         |

// | All rights reserved.                                                 |

// +----------------------------------------------------------------------+

// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |

// | API as well as database abstraction for PHP applications.            |

// | This LICENSE is in the BSD license style.                            |

// |                                                                      |

// | Redistribution and use in source and binary forms, with or without   |

// | modification, are permitted provided that the following conditions   |

// | are met:                                                             |

// |                                                                      |

// | Redistributions of source code must retain the above copyright       |

// | notice, this list of conditions and the following disclaimer.        |

// |                                                                      |

// | Redistributions in binary form must reproduce the above copyright    |

// | notice, this list of conditions and the following disclaimer in the  |

// | documentation and/or other materials provided with the distribution. |

// |                                                                      |

// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |

// | Lukas Smith nor the names of his contributors may be used to endorse |

// | or promote products derived from this software without specific prior|

// | written permission.                                                  |

// |                                                                      |

// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |

// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |

// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |

// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |

// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |

// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |

// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|

// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |

// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |

// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|

// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |

// | POSSIBILITY OF SUCH DAMAGE.                                          |

// +----------------------------------------------------------------------+

// | Author: Frank M. Kromann <frank@kromann.info>                        |

// +----------------------------------------------------------------------+

//

// $Id: mssql.php,v 1.16 2008/02/17 18:54:08 quipo Exp $

//



require_once 'MDB2/Driver/Function/Common.php';



// {{{ class MDB2_Driver_Function_mssql

/**

 * MDB2 MSSQL driver for the function modules

 *

 * @package MDB2

 * @category Database

 * @author Lukas Smith <smith@pooteeweet.org>

 */

class MDB2_Driver_Function_mssql extends MDB2_Driver_Function_Common

{

    // {{{ executeStoredProc()



    /**

     * Execute a stored procedure and return any results

     *

     * @param string $name string that identifies the function to execute

     * @param mixed  $params  array that contains the paramaters to pass the stored proc

     * @param mixed   $types  array that contains the types of the columns in

     *                        the result set

     * @param mixed $result_class string which specifies which result class to use

     * @param mixed $result_wrap_class string which specifies which class to wrap results in

     * @return mixed a result handle or MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function &executeStoredProc($name, $params = null, $types = null, $result_class = true, $result_wrap_class = false)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $query = 'EXECUTE '.$name;

        $query .= $params ? ' '.implode(', ', $params) : '';

        return $db->query($query, $types, $result_class, $result_wrap_class);

    }



    // }}}

    // {{{ now()



    /**

     * Return string to call a variable with the current timestamp inside an SQL statement

     * There are three special variables for current date and time:

     * - CURRENT_TIMESTAMP (date and time, TIMESTAMP type)

     * - CURRENT_DATE (date, DATE type)

     * - CURRENT_TIME (time, TIME type)

     *

     * @return string to call a variable with the current timestamp

     * @access public

     */

    function now($type = 'timestamp')

    {

        switch ($type) {

        case 'time':

        case 'date':

        case 'timestamp':

        default:

            return 'GETDATE()';

        }

    }



    // }}}

    // {{{ unixtimestamp()



    /**

     * return string to call a function to get the unix timestamp from a iso timestamp

     *

     * @param string $expression

     *

     * @return string to call a variable with the timestamp

     * @access public

     */

    function unixtimestamp($expression)

    {

        return 'DATEDIFF(second, \'19700101\', '. $expression.') + DATEDIFF(second, GETDATE(), GETUTCDATE())';

    }



    // }}}

    // {{{ substring()



    /**

     * return string to call a function to get a substring inside an SQL statement

     *

     * @return string to call a function to get a substring

     * @access public

     */

    function substring($value, $position = 1, $length = null)

    {

        if (!is_null($length)) {

            return "SUBSTRING($value, $position, $length)";

        }

        return "SUBSTRING($value, $position, LEN($value) - $position + 1)";

    }



    // }}}

    // {{{ concat()



    /**

     * Returns string to concatenate two or more string parameters

     *

     * @param string $value1

     * @param string $value2

     * @param string $values...

     * @return string to concatenate two strings

     * @access public

     **/

    function concat($value1, $value2)

    {

        $args = func_get_args();

        return "(".implode(' + ', $args).")";

    }



    // }}}

    // {{{ length()



    /**

     * return string to call a function to get the length of a string expression

     *

     * @param string $expression

     * @return return string to get the string expression length

     * @access public

     */

    function length($expression)

    {

        return "LEN($expression)";

    }



    // }}}

    // {{{ guid()



    /**

     * Returns global unique identifier

     *

     * @return string to get global unique identifier

     * @access public

     */

    function guid()

    {

        return 'NEWID()';

    }



    // }}}

}

// }}}

?>

 program/lib/MDB2/Driver/Function/mysql.php

@@ -1,120 +1,136 @@
<?php
// +----------------------------------------------------------------------+
// | PHP versions 4 and 5                                                 |
// +----------------------------------------------------------------------+
// | Copyright (c) 1998-2006 Manuel Lemos, Tomas V.V.Cox,                 |
// | Stig. S. Bakken, Lukas Smith                                         |
// | All rights reserved.                                                 |
// +----------------------------------------------------------------------+
// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |
// | API as well as database abstraction for PHP applications.            |
// | This LICENSE is in the BSD license style.                            |
// |                                                                      |
// | Redistribution and use in source and binary forms, with or without   |
// | modification, are permitted provided that the following conditions   |
// | are met:                                                             |
// |                                                                      |
// | Redistributions of source code must retain the above copyright       |
// | notice, this list of conditions and the following disclaimer.        |
// |                                                                      |
// | Redistributions in binary form must reproduce the above copyright    |
// | notice, this list of conditions and the following disclaimer in the  |
// | documentation and/or other materials provided with the distribution. |
// |                                                                      |
// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |
// | Lukas Smith nor the names of his contributors may be used to endorse |
// | or promote products derived from this software without specific prior|
// | written permission.                                                  |
// |                                                                      |
// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |
// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |
// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |
// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |
// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |
// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |
// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|
// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |
// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |
// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|
// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |
// | POSSIBILITY OF SUCH DAMAGE.                                          |
// +----------------------------------------------------------------------+
// | Author: Lukas Smith <smith@pooteeweet.org>                           |
// +----------------------------------------------------------------------+
//
// $Id: mysql.php,v 1.11 2007/01/12 11:29:12 quipo Exp $
//

require_once 'MDB2/Driver/Function/Common.php';

/**
 * MDB2 MySQL driver for the function modules
 *
 * @package MDB2
 * @category Database
 * @author  Lukas Smith <smith@pooteeweet.org>
 */
class MDB2_Driver_Function_mysql extends MDB2_Driver_Function_Common
{
     // }}}
    // {{{ executeStoredProc()

    /**
     * Execute a stored procedure and return any results
     *
     * @param string $name string that identifies the function to execute
     * @param mixed  $params  array that contains the paramaters to pass the stored proc
     * @param mixed   $types  array that contains the types of the columns in
     *                        the result set
     * @param mixed $result_class string which specifies which result class to use
     * @param mixed $result_wrap_class string which specifies which class to wrap results in
     * @return mixed a result handle or MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function &executeStoredProc($name, $params = null, $types = null, $result_class = true, $result_wrap_class = false)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $query = 'CALL '.$name;
        $query .= $params ? '('.implode(', ', $params).')' : '()';
        return $db->query($query, $types, $result_class, $result_wrap_class);
    }

    // }}}
    // {{{ concat()

    /**
     * Returns string to concatenate two or more string parameters
     *
     * @param string $value1
     * @param string $value2
     * @param string $values...
     * @return string to concatenate two strings
     * @access public
     **/
    function concat($value1, $value2)
    {
        $args = func_get_args();
        return "CONCAT(".implode(', ', $args).")";
    }

    // }}}
    // {{{ guid()

    /**
     * Returns global unique identifier
     *
     * @return string to get global unique identifier
     * @access public
     */
    function guid()
    {
        return 'UUID()';
    }

    // }}}
}
<?php

// +----------------------------------------------------------------------+

// | PHP versions 4 and 5                                                 |

// +----------------------------------------------------------------------+

// | Copyright (c) 1998-2008 Manuel Lemos, Tomas V.V.Cox,                 |

// | Stig. S. Bakken, Lukas Smith                                         |

// | All rights reserved.                                                 |

// +----------------------------------------------------------------------+

// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |

// | API as well as database abstraction for PHP applications.            |

// | This LICENSE is in the BSD license style.                            |

// |                                                                      |

// | Redistribution and use in source and binary forms, with or without   |

// | modification, are permitted provided that the following conditions   |

// | are met:                                                             |

// |                                                                      |

// | Redistributions of source code must retain the above copyright       |

// | notice, this list of conditions and the following disclaimer.        |

// |                                                                      |

// | Redistributions in binary form must reproduce the above copyright    |

// | notice, this list of conditions and the following disclaimer in the  |

// | documentation and/or other materials provided with the distribution. |

// |                                                                      |

// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |

// | Lukas Smith nor the names of his contributors may be used to endorse |

// | or promote products derived from this software without specific prior|

// | written permission.                                                  |

// |                                                                      |

// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |

// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |

// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |

// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |

// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |

// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |

// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|

// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |

// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |

// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|

// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |

// | POSSIBILITY OF SUCH DAMAGE.                                          |

// +----------------------------------------------------------------------+

// | Author: Lukas Smith <smith@pooteeweet.org>                           |

// +----------------------------------------------------------------------+

//

// $Id: mysql.php,v 1.12 2008/02/17 18:54:08 quipo Exp $

//



require_once 'MDB2/Driver/Function/Common.php';



/**

 * MDB2 MySQL driver for the function modules

 *

 * @package MDB2

 * @category Database

 * @author  Lukas Smith <smith@pooteeweet.org>

 */

class MDB2_Driver_Function_mysql extends MDB2_Driver_Function_Common

{

     // }}}

    // {{{ executeStoredProc()



    /**

     * Execute a stored procedure and return any results

     *

     * @param string $name string that identifies the function to execute

     * @param mixed  $params  array that contains the paramaters to pass the stored proc

     * @param mixed   $types  array that contains the types of the columns in

     *                        the result set

     * @param mixed $result_class string which specifies which result class to use

     * @param mixed $result_wrap_class string which specifies which class to wrap results in

     * @return mixed a result handle or MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function &executeStoredProc($name, $params = null, $types = null, $result_class = true, $result_wrap_class = false)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $query = 'CALL '.$name;

        $query .= $params ? '('.implode(', ', $params).')' : '()';

        return $db->query($query, $types, $result_class, $result_wrap_class);

    }



    // }}}

    // {{{ unixtimestamp()



    /**

     * return string to call a function to get the unix timestamp from a iso timestamp

     *

     * @param string $expression

     *

     * @return string to call a variable with the timestamp

     * @access public

     */

    function unixtimestamp($expression)

    {

        return 'UNIX_TIMESTAMP('. $expression.')';

    }



    // }}}

    // {{{ concat()



    /**

     * Returns string to concatenate two or more string parameters

     *

     * @param string $value1

     * @param string $value2

     * @param string $values...

     * @return string to concatenate two strings

     * @access public

     **/

    function concat($value1, $value2)

    {

        $args = func_get_args();

        return "CONCAT(".implode(', ', $args).")";

    }



    // }}}

    // {{{ guid()



    /**

     * Returns global unique identifier

     *

     * @return string to get global unique identifier

     * @access public

     */

    function guid()

    {

        return 'UUID()';

    }



    // }}}

}

?>

 program/lib/MDB2/Driver/Function/mysqli.php

@@ -1,128 +1,144 @@
<?php
// +----------------------------------------------------------------------+
// | PHP versions 4 and 5                                                 |
// +----------------------------------------------------------------------+
// | Copyright (c) 1998-2006 Manuel Lemos, Tomas V.V.Cox,                 |
// | Stig. S. Bakken, Lukas Smith                                         |
// | All rights reserved.                                                 |
// +----------------------------------------------------------------------+
// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |
// | API as well as database abstraction for PHP applications.            |
// | This LICENSE is in the BSD license style.                            |
// |                                                                      |
// | Redistribution and use in source and binary forms, with or without   |
// | modification, are permitted provided that the following conditions   |
// | are met:                                                             |
// |                                                                      |
// | Redistributions of source code must retain the above copyright       |
// | notice, this list of conditions and the following disclaimer.        |
// |                                                                      |
// | Redistributions in binary form must reproduce the above copyright    |
// | notice, this list of conditions and the following disclaimer in the  |
// | documentation and/or other materials provided with the distribution. |
// |                                                                      |
// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |
// | Lukas Smith nor the names of his contributors may be used to endorse |
// | or promote products derived from this software without specific prior|
// | written permission.                                                  |
// |                                                                      |
// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |
// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |
// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |
// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |
// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |
// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |
// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|
// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |
// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |
// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|
// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |
// | POSSIBILITY OF SUCH DAMAGE.                                          |
// +----------------------------------------------------------------------+
// | Author: Lukas Smith <smith@pooteeweet.org>                           |
// +----------------------------------------------------------------------+
//
// $Id: mysqli.php,v 1.13 2007/01/12 11:29:12 quipo Exp $
//

require_once 'MDB2/Driver/Function/Common.php';

/**
 * MDB2 MySQLi driver for the function modules
 *
 * @package MDB2
 * @category Database
 * @author  Lukas Smith <smith@pooteeweet.org>
 */
class MDB2_Driver_Function_mysqli extends MDB2_Driver_Function_Common
{
     // }}}
    // {{{ executeStoredProc()

    /**
     * Execute a stored procedure and return any results
     *
     * @param string $name string that identifies the function to execute
     * @param mixed  $params  array that contains the paramaters to pass the stored proc
     * @param mixed   $types  array that contains the types of the columns in
     *                        the result set
     * @param mixed $result_class string which specifies which result class to use
     * @param mixed $result_wrap_class string which specifies which class to wrap results in
     * @return mixed a result handle or MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function &executeStoredProc($name, $params = null, $types = null, $result_class = true, $result_wrap_class = false)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $multi_query = $db->getOption('multi_query');
        if (!$multi_query) {
            $db->setOption('multi_query', true);
        }
        $query = 'CALL '.$name;
        $query .= $params ? '('.implode(', ', $params).')' : '()';
        $result =& $db->query($query, $types, $result_class, $result_wrap_class);
        if (!$multi_query) {
            $db->setOption('multi_query', false);
        }
        return $result;
    }

    // }}}
    // {{{ concat()

    /**
     * Returns string to concatenate two or more string parameters
     *
     * @param string $value1
     * @param string $value2
     * @param string $values...
     * @return string to concatenate two strings
     * @access public
     **/
    function concat($value1, $value2)
    {
        $args = func_get_args();
        return "CONCAT(".implode(', ', $args).")";
    }

    // }}}
    // {{{ guid()

    /**
     * Returns global unique identifier
     *
     * @return string to get global unique identifier
     * @access public
     */
    function guid()
    {
        return 'UUID()';
    }

    // }}}
}
<?php

// +----------------------------------------------------------------------+

// | PHP versions 4 and 5                                                 |

// +----------------------------------------------------------------------+

// | Copyright (c) 1998-2008 Manuel Lemos, Tomas V.V.Cox,                 |

// | Stig. S. Bakken, Lukas Smith                                         |

// | All rights reserved.                                                 |

// +----------------------------------------------------------------------+

// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |

// | API as well as database abstraction for PHP applications.            |

// | This LICENSE is in the BSD license style.                            |

// |                                                                      |

// | Redistribution and use in source and binary forms, with or without   |

// | modification, are permitted provided that the following conditions   |

// | are met:                                                             |

// |                                                                      |

// | Redistributions of source code must retain the above copyright       |

// | notice, this list of conditions and the following disclaimer.        |

// |                                                                      |

// | Redistributions in binary form must reproduce the above copyright    |

// | notice, this list of conditions and the following disclaimer in the  |

// | documentation and/or other materials provided with the distribution. |

// |                                                                      |

// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |

// | Lukas Smith nor the names of his contributors may be used to endorse |

// | or promote products derived from this software without specific prior|

// | written permission.                                                  |

// |                                                                      |

// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |

// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |

// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |

// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |

// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |

// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |

// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|

// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |

// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |

// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|

// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |

// | POSSIBILITY OF SUCH DAMAGE.                                          |

// +----------------------------------------------------------------------+

// | Author: Lukas Smith <smith@pooteeweet.org>                           |

// +----------------------------------------------------------------------+

//

// $Id: mysqli.php,v 1.14 2008/02/17 18:54:08 quipo Exp $

//



require_once 'MDB2/Driver/Function/Common.php';



/**

 * MDB2 MySQLi driver for the function modules

 *

 * @package MDB2

 * @category Database

 * @author  Lukas Smith <smith@pooteeweet.org>

 */

class MDB2_Driver_Function_mysqli extends MDB2_Driver_Function_Common

{

     // }}}

    // {{{ executeStoredProc()



    /**

     * Execute a stored procedure and return any results

     *

     * @param string $name string that identifies the function to execute

     * @param mixed  $params  array that contains the paramaters to pass the stored proc

     * @param mixed   $types  array that contains the types of the columns in

     *                        the result set

     * @param mixed $result_class string which specifies which result class to use

     * @param mixed $result_wrap_class string which specifies which class to wrap results in

     * @return mixed a result handle or MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function &executeStoredProc($name, $params = null, $types = null, $result_class = true, $result_wrap_class = false)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $multi_query = $db->getOption('multi_query');

        if (!$multi_query) {

            $db->setOption('multi_query', true);

        }

        $query = 'CALL '.$name;

        $query .= $params ? '('.implode(', ', $params).')' : '()';

        $result =& $db->query($query, $types, $result_class, $result_wrap_class);

        if (!$multi_query) {

            $db->setOption('multi_query', false);

        }

        return $result;

    }



    // }}}

    // {{{ unixtimestamp()



    /**

     * return string to call a function to get the unix timestamp from a iso timestamp

     *

     * @param string $expression

     *

     * @return string to call a variable with the timestamp

     * @access public

     */

    function unixtimestamp($expression)

    {

        return 'UNIX_TIMESTAMP('. $expression.')';

    }



    // }}}

    // {{{ concat()



    /**

     * Returns string to concatenate two or more string parameters

     *

     * @param string $value1

     * @param string $value2

     * @param string $values...

     * @return string to concatenate two strings

     * @access public

     **/

    function concat($value1, $value2)

    {

        $args = func_get_args();

        return "CONCAT(".implode(', ', $args).")";

    }



    // }}}

    // {{{ guid()



    /**

     * Returns global unique identifier

     *

     * @return string to get global unique identifier

     * @access public

     */

    function guid()

    {

        return 'UUID()';

    }



    // }}}

}

?>

 program/lib/MDB2/Driver/Function/pgsql.php

@@ -1,99 +1,115 @@
<?php
// +----------------------------------------------------------------------+
// | PHP versions 4 and 5                                                 |
// +----------------------------------------------------------------------+
// | Copyright (c) 1998-2006 Manuel Lemos, Tomas V.V.Cox,                 |
// | Stig. S. Bakken, Lukas Smith                                         |
// | All rights reserved.                                                 |
// +----------------------------------------------------------------------+
// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |
// | API as well as database abstraction for PHP applications.            |
// | This LICENSE is in the BSD license style.                            |
// |                                                                      |
// | Redistribution and use in source and binary forms, with or without   |
// | modification, are permitted provided that the following conditions   |
// | are met:                                                             |
// |                                                                      |
// | Redistributions of source code must retain the above copyright       |
// | notice, this list of conditions and the following disclaimer.        |
// |                                                                      |
// | Redistributions in binary form must reproduce the above copyright    |
// | notice, this list of conditions and the following disclaimer in the  |
// | documentation and/or other materials provided with the distribution. |
// |                                                                      |
// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |
// | Lukas Smith nor the names of his contributors may be used to endorse |
// | or promote products derived from this software without specific prior|
// | written permission.                                                  |
// |                                                                      |
// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |
// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |
// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |
// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |
// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |
// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |
// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|
// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |
// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |
// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|
// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |
// | POSSIBILITY OF SUCH DAMAGE.                                          |
// +----------------------------------------------------------------------+
// | Author: Paul Cooper <pgc@ucecom.com>                                 |
// +----------------------------------------------------------------------+
//
// $Id: pgsql.php,v 1.9 2006/06/12 21:48:43 lsmith Exp $

require_once 'MDB2/Driver/Function/Common.php';

/**
 * MDB2 MySQL driver for the function modules
 *
 * @package MDB2
 * @category Database
 * @author Lukas Smith <smith@pooteeweet.org>
 */
class MDB2_Driver_Function_pgsql extends MDB2_Driver_Function_Common
{
    // {{{ executeStoredProc()

    /**
     * Execute a stored procedure and return any results
     *
     * @param string $name string that identifies the function to execute
     * @param mixed  $params  array that contains the paramaters to pass the stored proc
     * @param mixed   $types  array that contains the types of the columns in
     *                        the result set
     * @param mixed $result_class string which specifies which result class to use
     * @param mixed $result_wrap_class string which specifies which class to wrap results in
     * @return mixed a result handle or MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function &executeStoredProc($name, $params = null, $types = null, $result_class = true, $result_wrap_class = false)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $query = 'SELECT * FROM '.$name;
        $query .= $params ? '('.implode(', ', $params).')' : '()';
        return $db->query($query, $types, $result_class, $result_wrap_class);
    }
    // }}}
    // {{{ random()

    /**
     * return string to call a function to get random value inside an SQL statement
     *
     * @return return string to generate float between 0 and 1
     * @access public
     */
    function random()
    {
        return 'RANDOM()';
    }

    // }}}
}
?>
<?php

// +----------------------------------------------------------------------+

// | PHP versions 4 and 5                                                 |

// +----------------------------------------------------------------------+

// | Copyright (c) 1998-2008 Manuel Lemos, Tomas V.V.Cox,                 |

// | Stig. S. Bakken, Lukas Smith                                         |

// | All rights reserved.                                                 |

// +----------------------------------------------------------------------+

// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |

// | API as well as database abstraction for PHP applications.            |

// | This LICENSE is in the BSD license style.                            |

// |                                                                      |

// | Redistribution and use in source and binary forms, with or without   |

// | modification, are permitted provided that the following conditions   |

// | are met:                                                             |

// |                                                                      |

// | Redistributions of source code must retain the above copyright       |

// | notice, this list of conditions and the following disclaimer.        |

// |                                                                      |

// | Redistributions in binary form must reproduce the above copyright    |

// | notice, this list of conditions and the following disclaimer in the  |

// | documentation and/or other materials provided with the distribution. |

// |                                                                      |

// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |

// | Lukas Smith nor the names of his contributors may be used to endorse |

// | or promote products derived from this software without specific prior|

// | written permission.                                                  |

// |                                                                      |

// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |

// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |

// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |

// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |

// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |

// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |

// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|

// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |

// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |

// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|

// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |

// | POSSIBILITY OF SUCH DAMAGE.                                          |

// +----------------------------------------------------------------------+

// | Author: Paul Cooper <pgc@ucecom.com>                                 |

// +----------------------------------------------------------------------+

//

// $Id: pgsql.php,v 1.10 2008/02/17 18:54:08 quipo Exp $



require_once 'MDB2/Driver/Function/Common.php';



/**

 * MDB2 MySQL driver for the function modules

 *

 * @package MDB2

 * @category Database

 * @author Lukas Smith <smith@pooteeweet.org>

 */

class MDB2_Driver_Function_pgsql extends MDB2_Driver_Function_Common

{

    // {{{ executeStoredProc()



    /**

     * Execute a stored procedure and return any results

     *

     * @param string $name string that identifies the function to execute

     * @param mixed  $params  array that contains the paramaters to pass the stored proc

     * @param mixed   $types  array that contains the types of the columns in

     *                        the result set

     * @param mixed $result_class string which specifies which result class to use

     * @param mixed $result_wrap_class string which specifies which class to wrap results in

     * @return mixed a result handle or MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function &executeStoredProc($name, $params = null, $types = null, $result_class = true, $result_wrap_class = false)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $query = 'SELECT * FROM '.$name;

        $query .= $params ? '('.implode(', ', $params).')' : '()';

        return $db->query($query, $types, $result_class, $result_wrap_class);

    }

    // }}}

    // {{{ unixtimestamp()



    /**

     * return string to call a function to get the unix timestamp from a iso timestamp

     *

     * @param string $expression

     *

     * @return string to call a variable with the timestamp

     * @access public

     */

    function unixtimestamp($expression)

    {

        return 'EXTRACT(EPOCH FROM DATE_TRUNC(\'seconds\', TIMESTAMP '. $expression.'))';

    }



    // }}}

    // {{{ random()



    /**

     * return string to call a function to get random value inside an SQL statement

     *

     * @return return string to generate float between 0 and 1

     * @access public

     */

    function random()

    {

        return 'RANDOM()';

    }



    // }}}

}

?>

 program/lib/MDB2/Driver/Function/sqlite.php

@@ -1,125 +1,162 @@
<?php
// +----------------------------------------------------------------------+
// | PHP versions 4 and 5                                                 |
// +----------------------------------------------------------------------+
// | Copyright (c) 1998-2006 Manuel Lemos, Tomas V.V.Cox,                 |
// | Stig. S. Bakken, Lukas Smith                                         |
// | All rights reserved.                                                 |
// +----------------------------------------------------------------------+
// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |
// | API as well as database abstraction for PHP applications.            |
// | This LICENSE is in the BSD license style.                            |
// |                                                                      |
// | Redistribution and use in source and binary forms, with or without   |
// | modification, are permitted provided that the following conditions   |
// | are met:                                                             |
// |                                                                      |
// | Redistributions of source code must retain the above copyright       |
// | notice, this list of conditions and the following disclaimer.        |
// |                                                                      |
// | Redistributions in binary form must reproduce the above copyright    |
// | notice, this list of conditions and the following disclaimer in the  |
// | documentation and/or other materials provided with the distribution. |
// |                                                                      |
// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |
// | Lukas Smith nor the names of his contributors may be used to endorse |
// | or promote products derived from this software without specific prior|
// | written permission.                                                  |
// |                                                                      |
// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |
// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |
// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |
// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |
// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |
// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |
// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|
// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |
// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |
// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|
// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |
// | POSSIBILITY OF SUCH DAMAGE.                                          |
// +----------------------------------------------------------------------+
// | Author: Lukas Smith <smith@pooteeweet.org>                           |
// +----------------------------------------------------------------------+
//
// $Id: sqlite.php,v 1.8 2006/06/13 22:55:55 lsmith Exp $
//

require_once 'MDB2/Driver/Function/Common.php';

/**
 * MDB2 SQLite driver for the function modules
 *
 * @package MDB2
 * @category Database
 * @author  Lukas Smith <smith@pooteeweet.org>
 */
class MDB2_Driver_Function_sqlite extends MDB2_Driver_Function_Common
{
    // {{{ constructor

    /**
     * Constructor
     */
    function __construct($db_index)
    {
        parent::__construct($db_index);
        // create all sorts of UDFs
    }

    // {{{ now()

    /**
     * Return string to call a variable with the current timestamp inside an SQL statement
     * There are three special variables for current date and time.
     *
     * @return string to call a variable with the current timestamp
     * @access public
     */
    function now($type = 'timestamp')
    {
        switch ($type) {
        case 'time':
            return 'time(\'now\')';
        case 'date':
            return 'date(\'now\')';
        case 'timestamp':
        default:
            return 'datetime(\'now\')';
        }
    }

    // }}}
    // {{{ substring()

    /**
     * return string to call a function to get a substring inside an SQL statement
     *
     * @return string to call a function to get a substring
     * @access public
     */
    function substring($value, $position = 1, $length = null)
    {
        if (!is_null($length)) {
            return "substr($value,$position,$length)";
        }
        return "substr($value,$position,length($value))";
    }

    // }}}
    // {{{ random()

    /**
     * return string to call a function to get random value inside an SQL statement
     *
     * @return return string to generate float between 0 and 1
     * @access public
     */
    function random()
    {
        return '((RANDOM()+2147483648)/4294967296)';
    }

    // }}}
}
?>
<?php

// +----------------------------------------------------------------------+

// | PHP versions 4 and 5                                                 |

// +----------------------------------------------------------------------+

// | Copyright (c) 1998-2008 Manuel Lemos, Tomas V.V.Cox,                 |

// | Stig. S. Bakken, Lukas Smith                                         |

// | All rights reserved.                                                 |

// +----------------------------------------------------------------------+

// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |

// | API as well as database abstraction for PHP applications.            |

// | This LICENSE is in the BSD license style.                            |

// |                                                                      |

// | Redistribution and use in source and binary forms, with or without   |

// | modification, are permitted provided that the following conditions   |

// | are met:                                                             |

// |                                                                      |

// | Redistributions of source code must retain the above copyright       |

// | notice, this list of conditions and the following disclaimer.        |

// |                                                                      |

// | Redistributions in binary form must reproduce the above copyright    |

// | notice, this list of conditions and the following disclaimer in the  |

// | documentation and/or other materials provided with the distribution. |

// |                                                                      |

// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |

// | Lukas Smith nor the names of his contributors may be used to endorse |

// | or promote products derived from this software without specific prior|

// | written permission.                                                  |

// |                                                                      |

// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |

// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |

// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |

// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |

// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |

// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |

// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|

// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |

// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |

// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|

// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |

// | POSSIBILITY OF SUCH DAMAGE.                                          |

// +----------------------------------------------------------------------+

// | Author: Lukas Smith <smith@pooteeweet.org>                           |

// +----------------------------------------------------------------------+

//

// $Id: sqlite.php,v 1.10 2008/02/17 18:54:08 quipo Exp $

//



require_once 'MDB2/Driver/Function/Common.php';



/**

 * MDB2 SQLite driver for the function modules

 *

 * @package MDB2

 * @category Database

 * @author  Lukas Smith <smith@pooteeweet.org>

 */

class MDB2_Driver_Function_sqlite extends MDB2_Driver_Function_Common

{

    // {{{ constructor



    /**

     * Constructor

     */

    function __construct($db_index)

    {

        parent::__construct($db_index);

        // create all sorts of UDFs

    }



    // {{{ now()



    /**

     * Return string to call a variable with the current timestamp inside an SQL statement

     * There are three special variables for current date and time.

     *

     * @return string to call a variable with the current timestamp

     * @access public

     */

    function now($type = 'timestamp')

    {

        switch ($type) {

        case 'time':

            return 'time(\'now\')';

        case 'date':

            return 'date(\'now\')';

        case 'timestamp':

        default:

            return 'datetime(\'now\')';

        }

    }



    // }}}

    // {{{ unixtimestamp()



    /**

     * return string to call a function to get the unix timestamp from a iso timestamp

     *

     * @param string $expression

     *

     * @return string to call a variable with the timestamp

     * @access public

     */

    function unixtimestamp($expression)

    {

        return 'strftime("%s",'. $expression.', "utc")';

    }



    // }}}

    // {{{ substring()



    /**

     * return string to call a function to get a substring inside an SQL statement

     *

     * @return string to call a function to get a substring

     * @access public

     */

    function substring($value, $position = 1, $length = null)

    {

        if (!is_null($length)) {

            return "substr($value,$position,$length)";

        }

        return "substr($value,$position,length($value))";

    }



    // }}}

    // {{{ random()



    /**

     * return string to call a function to get random value inside an SQL statement

     *

     * @return return string to generate float between 0 and 1

     * @access public

     */

    function random()

    {

        return '((RANDOM()+2147483648)/4294967296)';

    }



    // }}}

    // {{{ replace()



    /**

     * return string to call a function to get a replacement inside an SQL statement.

     *

     * @return string to call a function to get a replace

     * @access public

     */

    function replace($str, $from_str, $to_str)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $error =& $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

            'method not implemented', __FUNCTION__);

        return $error;

    }



    // }}}

}

?>


 program/lib/MDB2/Driver/Manager/Common.php

@@ -2,7 +2,7 @@
// +----------------------------------------------------------------------+

// | PHP versions 4 and 5                                                 |

// +----------------------------------------------------------------------+

// | Copyright (c) 1998-2007 Manuel Lemos, Tomas V.V.Cox,                 |

// | Copyright (c) 1998-2008 Manuel Lemos, Tomas V.V.Cox,                 |

// | Stig. S. Bakken, Lukas Smith                                         |

// | All rights reserved.                                                 |

// +----------------------------------------------------------------------+

@@ -39,16 +39,18 @@
// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |

// | POSSIBILITY OF SUCH DAMAGE.                                          |

// +----------------------------------------------------------------------+

// | Author: Lukas Smith <smith@pooteeweet.org>                           |

// | Authors: Lukas Smith <smith@pooteeweet.org>                          |

// |          Lorenzo Alberton <l.alberton@quipo.it>                      |

// +----------------------------------------------------------------------+

//

// $Id: Common.php,v 1.68 2007/12/03 20:59:15 quipo Exp $

// $Id: Common.php,v 1.71 2008/02/12 23:12:27 quipo Exp $

//



/**

 * @package  MDB2

 * @category Database

 * @author   Lukas Smith <smith@pooteeweet.org>

 * @author   Lorenzo Alberton <l.alberton@quipo.it>

 */



/**

@@ -188,6 +190,29 @@
     * @access public

     */

    function createDatabase($database, $options = array())

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

            'method not implemented', __FUNCTION__);

    }



    // }}}

    // {{{ alterDatabase()



    /**

     * alter an existing database

     *

     * @param string $name    name of the database that should be created

     * @param array  $options array with charset, collation info

     *

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function alterDatabase($database, $options = array())

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

@@ -360,6 +385,56 @@
    }



    // }}}

    // {{{ truncateTable()



    /**

     * Truncate an existing table (if the TRUNCATE TABLE syntax is not supported,

     * it falls back to a DELETE FROM TABLE query)

     *

     * @param string $name name of the table that should be truncated

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function truncateTable($name)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $name = $db->quoteIdentifier($name, true);

        return $db->exec("DELETE FROM $name");

    }



    // }}}

    // {{{ vacuum()



    /**

     * Optimize (vacuum) all the tables in the db (or only the specified table)

     * and optionally run ANALYZE.

     *

     * @param string $table table name (all the tables if empty)

     * @param array  $options an array with driver-specific options:

     *               - timeout [int] (in seconds) [mssql-only]

     *               - analyze [boolean] [pgsql and mysql]

     *               - full [boolean] [pgsql-only]

     *               - freeze [boolean] [pgsql-only]

     *

     * @return mixed MDB2_OK success, a MDB2 error on failure

     * @access public

     */

    function vacuum($table = null, $options = array())

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

            'method not implemented', __FUNCTION__);

    }



    // }}}

    // {{{ alterTable()



    /**


 program/lib/MDB2/Driver/Manager/mssql.php

@@ -1,815 +1,1129 @@
<?php

// +----------------------------------------------------------------------+

// | PHP versions 4 and 5                                                 |

// +----------------------------------------------------------------------+

// | Copyright (c) 1998-2007 Manuel Lemos, Tomas V.V.Cox,                 |

// | Stig. S. Bakken, Lukas Smith                                         |

// | All rights reserved.                                                 |

// +----------------------------------------------------------------------+

// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |

// | API as well as database abstraction for PHP applications.            |

// | This LICENSE is in the BSD license style.                            |

// |                                                                      |

// | Redistribution and use in source and binary forms, with or without   |

// | modification, are permitted provided that the following conditions   |

// | are met:                                                             |

// |                                                                      |

// | Redistributions of source code must retain the above copyright       |

// | notice, this list of conditions and the following disclaimer.        |

// |                                                                      |

// | Redistributions in binary form must reproduce the above copyright    |

// | notice, this list of conditions and the following disclaimer in the  |

// | documentation and/or other materials provided with the distribution. |

// |                                                                      |

// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |

// | Lukas Smith nor the names of his contributors may be used to endorse |

// | or promote products derived from this software without specific prior|

// | written permission.                                                  |

// |                                                                      |

// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |

// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |

// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |

// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |

// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |

// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |

// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|

// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |

// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |

// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|

// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |

// | POSSIBILITY OF SUCH DAMAGE.                                          |

// +----------------------------------------------------------------------+

// | Authors: Frank M. Kromann <frank@kromann.info>                       |

// |          David Coallier <davidc@php.net>                             |

// |          Lorenzo Alberton <l.alberton@quipo.it>                      |

// +----------------------------------------------------------------------+

//

// $Id: mssql.php,v 1.93 2007/12/03 20:59:15 quipo Exp $

//



require_once 'MDB2/Driver/Manager/Common.php';



// {{{ class MDB2_Driver_Manager_mssql



/**

 * MDB2 MSSQL driver for the management modules

 *

 * @package MDB2

 * @category Database

 * @author  Frank M. Kromann <frank@kromann.info>

 * @author  David Coallier <davidc@php.net>

 * @author  Lorenzo Alberton <l.alberton@quipo.it>

 */

class MDB2_Driver_Manager_mssql extends MDB2_Driver_Manager_Common

{

    // {{{ createDatabase()

    /**

     * create a new database

     *

     * @param string $name    name of the database that should be created

     * @param array  $options array with collation info

     *

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function createDatabase($name, $options = array())

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $name = $db->quoteIdentifier($name, true);

        $query = "CREATE DATABASE $name";

        if ($db->options['database_device']) {

            $query.= ' ON '.$db->options['database_device'];

            $query.= $db->options['database_size'] ? '=' .

                     $db->options['database_size'] : '';

        }

        if (!empty($options['collation'])) {

            $query .= ' COLLATE ' . $options['collation'];

        }

        return $db->standaloneQuery($query, null, true);

    }



    // }}}

    // {{{ dropDatabase()



    /**

     * drop an existing database

     *

     * @param string $name name of the database that should be dropped

     *

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function dropDatabase($name)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $name = $db->quoteIdentifier($name, true);

        return $db->standaloneQuery("DROP DATABASE $name", null, true);

    }



    // }}}

    // {{{ _getTemporaryTableQuery()



    /**

     * Override the parent method.

     *

     * @return string The string required to be placed between "CREATE" and "TABLE"

     *                to generate a temporary table, if possible.

     */

    function _getTemporaryTableQuery()

    {

        return '';

    }



    // }}}

    // {{{ _getAdvancedFKOptions()



    /**

     * Return the FOREIGN KEY query section dealing with non-standard options

     * as MATCH, INITIALLY DEFERRED, ON UPDATE, ...

     *

     * @param array $definition

     *

     * @return string

     * @access protected

     */

    function _getAdvancedFKOptions($definition)

    {

        $query = '';

        if (!empty($definition['onupdate'])) {

            $query .= ' ON UPDATE '.$definition['onupdate'];

        }

        if (!empty($definition['ondelete'])) {

            $query .= ' ON DELETE '.$definition['ondelete'];

        }

        return $query;

    }



    // }}}

    // {{{ createTable()



    /**

     * create a new table

     *

     * @param string $name   Name of the database that should be created

     * @param array  $fields Associative array that contains the definition of each field of the new table

     *                       The indexes of the array entries are the names of the fields of the table an

     *                       the array entry values are associative arrays like those that are meant to be

     *                       passed with the field definitions to get[Type]Declaration() functions.

     *

     *                      Example

     *                        array(

     *

     *                            'id' => array(

     *                                'type' => 'integer',

     *                                'unsigned' => 1,

     *                                'notnull' => 1,

     *                                'default' => 0,

     *                            ),

     *                            'name' => array(

     *                                'type' => 'text',

     *                                'length' => 12,

     *                            ),

     *                            'description' => array(

     *                                'type' => 'text',

     *                                'length' => 12,

     *                            )

     *                        );

     * @param array $options An associative array of table options:

     *                          array(

     *                              'comment' => 'Foo',

     *                              'temporary' => true|false,

     *                          );

     *

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function createTable($name, $fields, $options = array())

    {

        if (!empty($options['temporary'])) {

            $name = '#'.$name;

        }

        return parent::createTable($name, $fields, $options);

    }



    // }}}

    // {{{ alterTable()



    /**

     * alter an existing table

     *

     * @param string  $name    name of the table that is intended to be changed.

     * @param array   $changes associative array that contains the details of each type

     *                         of change that is intended to be performed. The types of

     *                         changes that are currently supported are defined as follows:

     *

     *                             name

     *

     *                                New name for the table.

     *

     *                            add

     *

     *                                Associative array with the names of fields to be added as

     *                                 indexes of the array. The value of each entry of the array

     *                                 should be set to another associative array with the properties

     *                                 of the fields to be added. The properties of the fields should

     *                                 be the same as defined by the MDB2 parser.

     *

     *

     *                            remove

     *

     *                                Associative array with the names of fields to be removed as indexes

     *                                 of the array. Currently the values assigned to each entry are ignored.

     *                                 An empty array should be used for future compatibility.

     *

     *                            rename

     *

     *                                Associative array with the names of fields to be renamed as indexes

     *                                 of the array. The value of each entry of the array should be set to

     *                                 another associative array with the entry named name with the new

     *                                 field name and the entry named Declaration that is expected to contain

     *                                 the portion of the field declaration already in DBMS specific SQL code

     *                                 as it is used in the CREATE TABLE statement.

     *

     *                            change

     *

     *                                Associative array with the names of the fields to be changed as indexes

     *                                 of the array. Keep in mind that if it is intended to change either the

     *                                 name of a field and any other properties, the change array entries

     *                                 should have the new names of the fields as array indexes.

     *

     *                                The value of each entry of the array should be set to another associative

     *                                 array with the properties of the fields to that are meant to be changed as

     *                                 array entries. These entries should be assigned to the new values of the

     *                                 respective properties. The properties of the fields should be the same

     *                                 as defined by the MDB2 parser.

     *

     *                            Example

     *                                array(

     *                                    'name' => 'userlist',

     *                                    'add' => array(

     *                                        'quota' => array(

     *                                            'type' => 'integer',

     *                                            'unsigned' => 1

     *                                        )

     *                                    ),

     *                                    'remove' => array(

     *                                        'file_limit' => array(),

     *                                        'time_limit' => array()

     *                                    ),

     *                                    'change' => array(

     *                                        'name' => array(

     *                                            'length' => '20',

     *                                            'definition' => array(

     *                                                'type' => 'text',

     *                                                'length' => 20,

     *                                            ),

     *                                        )

     *                                    ),

     *                                    'rename' => array(

     *                                        'sex' => array(

     *                                            'name' => 'gender',

     *                                            'definition' => array(

     *                                                'type' => 'text',

     *                                                'length' => 1,

     *                                                'default' => 'M',

     *                                            ),

     *                                        )

     *                                    )

     *                                )

     *

     * @param boolean $check   indicates whether the function should just check if the DBMS driver

     *                         can perform the requested table alterations if the value is true or

     *                         actually perform them otherwise.

     *

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function alterTable($name, $changes, $check)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        foreach ($changes as $change_name => $change) {

            switch ($change_name) {

            case 'add':

                break;

            case 'remove':

                break;

            case 'name':

            case 'rename':

            case 'change':

            default:

                return $db->raiseError(MDB2_ERROR_CANNOT_ALTER, null, null,

                    'change type "'.$change_name.'" not yet supported', __FUNCTION__);

            }

        }



        if ($check) {

            return MDB2_OK;

        }



        $query = '';

        if (!empty($changes['add']) && is_array($changes['add'])) {

            foreach ($changes['add'] as $field_name => $field) {

                if ($query) {

                    $query.= ', ';

                } else {

                    $query.= 'ADD COLUMN ';

                }

                $query.= $db->getDeclaration($field['type'], $field_name, $field);

            }

        }



        if (!empty($changes['remove']) && is_array($changes['remove'])) {

            foreach ($changes['remove'] as $field_name => $field) {

                if ($query) {

                    $query.= ', ';

                }

                $field_name = $db->quoteIdentifier($field_name, true);

                $query.= 'DROP COLUMN ' . $field_name;

            }

        }



        if (!$query) {

            return MDB2_OK;

        }



        $name = $db->quoteIdentifier($name, true);

        return $db->exec("ALTER TABLE $name $query");

    }



    // }}}

    // {{{ listTables()



    /**

     * list all tables in the current database

     *

     * @return mixed array of table names on success, a MDB2 error on failure

     * @access public

     */

    function listTables()

    {

        $db =& $this->getDBInstance();



        if (PEAR::isError($db)) {

            return $db;

        }



        $query = 'EXEC sp_tables @table_type = "\'TABLE\'"';

        $table_names = $db->queryCol($query, null, 2);

        if (PEAR::isError($table_names)) {

            return $table_names;

        }

        $result = array();

        foreach ($table_names as $table_name) {

            if (!$this->_fixSequenceName($table_name, true)) {

                $result[] = $table_name;

            }

        }

        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {

            $result = array_map(($db->options['field_case'] == CASE_LOWER ?

                        'strtolower' : 'strtoupper'), $result);

        }

        return $result;

    }



    // }}}

    // {{{ listTableFields()



    /**

     * list all fields in a table in the current database

     *

     * @param string $table name of table that should be used in method

     *

     * @return mixed array of field names on success, a MDB2 error on failure

     * @access public

     */

    function listTableFields($table)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }

        
        $table = $db->quoteIdentifier($table, true);

        $columns = $db->queryCol("SELECT c.name

                                    FROM syscolumns c

                               LEFT JOIN sysobjects o ON c.id = o.id

                                   WHERE o.name = '$table'");

        if (PEAR::isError($columns)) {

            return $columns;

        }

        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {

            $columns = array_map(($db->options['field_case'] == CASE_LOWER ? 'strtolower' : 'strtoupper'), $columns);

        }

        return $columns;

    }



    // }}}

    // {{{ listTableIndexes()



    /**

     * list all indexes in a table

     *

     * @param string $table name of table that should be used in method

     *

     * @return mixed array of index names on success, a MDB2 error on failure

     * @access public

     */

    function listTableIndexes($table)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $key_name = 'INDEX_NAME';

        $pk_name = 'PK_NAME';

        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {

            if ($db->options['field_case'] == CASE_LOWER) {

                $key_name = strtolower($key_name);

                $pk_name  = strtolower($pk_name);

            } else {

                $key_name = strtoupper($key_name);

                $pk_name  = strtoupper($pk_name);

            }

        }

        $table = $db->quote($table, 'text');

        $query = "EXEC sp_statistics @table_name=$table";

        $indexes = $db->queryCol($query, 'text', $key_name);

        if (PEAR::isError($indexes)) {

            return $indexes;

        }

        $query = "EXEC sp_pkeys @table_name=$table";

        $pk_all = $db->queryCol($query, 'text', $pk_name);

        $result = array();

        foreach ($indexes as $index) {

            if (!in_array($index, $pk_all) && ($index = $this->_fixIndexName($index))) {

                $result[$index] = true;

            }

        }



        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {

            $result = array_change_key_case($result, $db->options['field_case']);

        }

        return array_keys($result);

    }



    // }}}

    // {{{ listDatabases()



    /**

     * list all databases

     *

     * @return mixed array of database names on success, a MDB2 error on failure

     * @access public

     */

    function listDatabases()

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $result = $db->queryCol('SELECT name FROM sys.databases');

        if (PEAR::isError($result)) {

            return $result;

        }

        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {

            $result = array_map(($db->options['field_case'] == CASE_LOWER ? 'strtolower' : 'strtoupper'), $result);

        }

        return $result;

    }



    // }}}

    // {{{ listUsers()



    /**

     * list all users

     *

     * @return mixed array of user names on success, a MDB2 error on failure

     * @access public

     */

    function listUsers()

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $result = $db->queryCol('SELECT DISTINCT loginame FROM master..sysprocesses');

        if (PEAR::isError($result) || empty($result)) {

            return $result;

        }

        foreach (array_keys($result) as $k) {

            $result[$k] = trim($result[$k]);

        }

        return $result;

    }



    // }}}

    // {{{ listFunctions()



    /**

     * list all functions in the current database

     *

     * @return mixed array of function names on success, a MDB2 error on failure

     * @access public

     */

    function listFunctions()

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $query = "SELECT name

                    FROM sysobjects

                   WHERE objectproperty(id, N'IsMSShipped') = 0

                    AND (objectproperty(id, N'IsTableFunction') = 1

                     OR objectproperty(id, N'IsScalarFunction') = 1)";

        /*

        SELECT ROUTINE_NAME

          FROM INFORMATION_SCHEMA.ROUTINES

         WHERE ROUTINE_TYPE = 'FUNCTION'

        */

        $result = $db->queryCol($query);

        if (PEAR::isError($result)) {

            return $result;

        }

        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {

            $result = array_map(($db->options['field_case'] == CASE_LOWER ? 'strtolower' : 'strtoupper'), $result);

        }

        return $result;

    }



    // }}}

    // {{{ listTableTriggers()



    /**

     * list all triggers in the database that reference a given table

     *

     * @param string table for which all referenced triggers should be found

     *

     * @return mixed array of trigger names on success,  otherwise, false which

     *               could be a db error if the db is not instantiated or could

     *               be the results of the error that occured during the

     *               querying of the sysobject module.

     * @access public

     */

    function listTableTriggers($table = null)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $table = $db->quote($table, 'text');

        $query = "SELECT o.name

                    FROM sysobjects o

                   WHERE xtype = 'TR'

                     AND OBJECTPROPERTY(o.id, 'IsMSShipped') = 0";

        if (!is_null($table)) {

            $query .= " AND object_name(parent_obj) = $table";

        }



        $result = $db->queryCol($query);

        if (PEAR::isError($result)) {

            return $result;

        }



        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE &&

            $db->options['field_case'] == CASE_LOWER)

        {

            $result = array_map(($db->options['field_case'] == CASE_LOWER ?

                'strtolower' : 'strtoupper'), $result);

        }

        return $result;

    }



    // }}}

    // {{{ listViews()



    /**

     * list all views in the current database

     *

     * @param string database, the current is default

     *

     * @return mixed array of view names on success, a MDB2 error on failure

     * @access public

     */

    function listViews()

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $query = "SELECT name

                    FROM sysobjects

                   WHERE xtype = 'V'";

        /*

        SELECT *

          FROM sysobjects

         WHERE objectproperty(id, N'IsMSShipped') = 0

           AND objectproperty(id, N'IsView') = 1

        */



        $result = $db->queryCol($query);

        if (PEAR::isError($result)) {

            return $result;

        }



        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE &&

            $db->options['field_case'] == CASE_LOWER)

        {

            $result = array_map(($db->options['field_case'] == CASE_LOWER ?

                          'strtolower' : 'strtoupper'), $result);

        }

        return $result;

    }



    // }}}

    // {{{ dropIndex()



    /**

     * drop existing index

     *

     * @param string $table name of table that should be used in method

     * @param string $name  name of the index to be dropped

     *

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function dropIndex($table, $name)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $table = $db->quoteIdentifier($table, true);

        $name = $db->quoteIdentifier($db->getIndexName($name), true);

        return $db->exec("DROP INDEX $table.$name");

    }



    // }}}

    // {{{ listTableConstraints()



    /**

     * list all constraints in a table

     *

     * @param string $table name of table that should be used in method

     *

     * @return mixed array of constraint names on success, a MDB2 error on failure

     * @access public

     */

    function listTableConstraints($table)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }

        $table = $db->quoteIdentifier($table, true);

        
        $query = "SELECT c.constraint_name

                    FROM INFORMATION_SCHEMA.TABLE_CONSTRAINTS c

                   WHERE c.constraint_catalog = DB_NAME()

                     AND c.table_name = '$table'";

        $constraints = $db->queryCol($query);

        if (PEAR::isError($constraints)) {

            return $constraints;

        }



        $result = array();

        foreach ($constraints as $constraint) {

            $constraint = $this->_fixIndexName($constraint);

            if (!empty($constraint)) {

                $result[$constraint] = true;

            }

        }



        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {

            $result = array_change_key_case($result, $db->options['field_case']);

        }

        return array_keys($result);

    }



    // }}}

    // {{{ createSequence()



    /**

     * create sequence

     *

     * @param string $seq_name  name of the sequence to be created

     * @param string $start     start value of the sequence; default is 1

     *

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function createSequence($seq_name, $start = 1)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $sequence_name = $db->quoteIdentifier($db->getSequenceName($seq_name), true);

        $seqcol_name = $db->quoteIdentifier($db->options['seqcol_name'], true);

        $query = "CREATE TABLE $sequence_name ($seqcol_name " .

                 "INT PRIMARY KEY CLUSTERED IDENTITY($start,1) NOT NULL)";



        $res = $db->exec($query);

        if (PEAR::isError($res)) {

            return $res;

        }



        $query = "SET IDENTITY_INSERT $sequence_name ON ".

                 "INSERT INTO $sequence_name ($seqcol_name) VALUES ($start)";

        $res = $db->exec($query);



        if (!PEAR::isError($res)) {

            return MDB2_OK;

        }



        $result = $db->exec("DROP TABLE $sequence_name");

        if (PEAR::isError($result)) {

            return $db->raiseError($result, null, null,

                'could not drop inconsistent sequence table', __FUNCTION__);

        }



        return $db->raiseError($res, null, null,

            'could not create sequence table', __FUNCTION__);

    }



    // }}}

    // {{{ dropSequence()



    /**

     * This function drops an existing sequence

     *

     * @param string $seq_name name of the sequence to be dropped

     *

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function dropSequence($seq_name)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $sequence_name = $db->quoteIdentifier($db->getSequenceName($seq_name), true);

        return $db->exec("DROP TABLE $sequence_name");

    }



    // }}}

    // {{{ listSequences()



    /**

     * list all sequences in the current database

     *

     * @return mixed array of sequence names on success, a MDB2 error on failure

     * @access public

     */

    function listSequences()

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $query = "SELECT name FROM sysobjects WHERE xtype = 'U'";

        $table_names = $db->queryCol($query);

        if (PEAR::isError($table_names)) {

            return $table_names;

        }

        $result = array();

        foreach ($table_names as $table_name) {

            if ($sqn = $this->_fixSequenceName($table_name, true)) {

                $result[] = $sqn;

            }

        }

        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {

            $result = array_map(($db->options['field_case'] == CASE_LOWER ?

                          'strtolower' : 'strtoupper'), $result);

        }

        return $result;

    }



    // }}}

}



// }}}

<?php
// +----------------------------------------------------------------------+
// | PHP versions 4 and 5                                                 |
// +----------------------------------------------------------------------+
// | Copyright (c) 1998-2008 Manuel Lemos, Tomas V.V.Cox,                 |
// | Stig. S. Bakken, Lukas Smith                                         |
// | All rights reserved.                                                 |
// +----------------------------------------------------------------------+
// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |
// | API as well as database abstraction for PHP applications.            |
// | This LICENSE is in the BSD license style.                            |
// |                                                                      |
// | Redistribution and use in source and binary forms, with or without   |
// | modification, are permitted provided that the following conditions   |
// | are met:                                                             |
// |                                                                      |
// | Redistributions of source code must retain the above copyright       |
// | notice, this list of conditions and the following disclaimer.        |
// |                                                                      |
// | Redistributions in binary form must reproduce the above copyright    |
// | notice, this list of conditions and the following disclaimer in the  |
// | documentation and/or other materials provided with the distribution. |
// |                                                                      |
// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |
// | Lukas Smith nor the names of his contributors may be used to endorse |
// | or promote products derived from this software without specific prior|
// | written permission.                                                  |
// |                                                                      |
// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |
// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |
// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |
// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |
// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |
// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |
// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|
// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |
// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |
// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|
// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |
// | POSSIBILITY OF SUCH DAMAGE.                                          |
// +----------------------------------------------------------------------+
// | Authors: Frank M. Kromann <frank@kromann.info>                       |
// |          David Coallier <davidc@php.net>                             |
// |          Lorenzo Alberton <l.alberton@quipo.it>                      |
// +----------------------------------------------------------------------+
//
// $Id: mssql.php,v 1.109 2008/03/05 12:55:57 afz Exp $
//

require_once 'MDB2/Driver/Manager/Common.php';

// {{{ class MDB2_Driver_Manager_mssql

/**
 * MDB2 MSSQL driver for the management modules
 *
 * @package MDB2
 * @category Database
 * @author  Frank M. Kromann <frank@kromann.info>
 * @author  David Coallier <davidc@php.net>
 * @author  Lorenzo Alberton <l.alberton@quipo.it>
 */
class MDB2_Driver_Manager_mssql extends MDB2_Driver_Manager_Common
{
    // {{{ createDatabase()
    /**
     * create a new database
     *
     * @param string $name    name of the database that should be created
     * @param array  $options array with collation info
     *
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function createDatabase($name, $options = array())
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $name = $db->quoteIdentifier($name, true);
        $query = "CREATE DATABASE $name";
        if ($db->options['database_device']) {
            $query.= ' ON '.$db->options['database_device'];
            $query.= $db->options['database_size'] ? '=' .
                     $db->options['database_size'] : '';
        }
        if (!empty($options['collation'])) {
            $query .= ' COLLATE ' . $options['collation'];
        }
        return $db->standaloneQuery($query, null, true);
    }

    // }}}
    // {{{ alterDatabase()

    /**
     * alter an existing database
     *
     * @param string $name    name of the database that is intended to be changed
     * @param array  $options array with name, collation info
     *
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function alterDatabase($name, $options = array())
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $query = '';
        if (!empty($options['name'])) {
            $query .= ' MODIFY NAME = ' .$db->quoteIdentifier($options['name'], true);
        }
        if (!empty($options['collation'])) {
            $query .= ' COLLATE ' . $options['collation'];
        }
        if (!empty($query)) {
            $query = 'ALTER DATABASE '. $db->quoteIdentifier($name, true) . $query;
            return $db->standaloneQuery($query, null, true);
        }
        return MDB2_OK;
    }

    // }}}
    // {{{ dropDatabase()

    /**
     * drop an existing database
     *
     * @param string $name name of the database that should be dropped
     *
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function dropDatabase($name)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $name = $db->quoteIdentifier($name, true);
        return $db->standaloneQuery("DROP DATABASE $name", null, true);
    }

    // }}}
    // {{{ _getTemporaryTableQuery()

    /**
     * Override the parent method.
     *
     * @return string The string required to be placed between "CREATE" and "TABLE"
     *                to generate a temporary table, if possible.
     */
    function _getTemporaryTableQuery()
    {
        return '';
    }

    // }}}
    // {{{ _getAdvancedFKOptions()

    /**
     * Return the FOREIGN KEY query section dealing with non-standard options
     * as MATCH, INITIALLY DEFERRED, ON UPDATE, ...
     *
     * @param array $definition
     *
     * @return string
     * @access protected
     */
    function _getAdvancedFKOptions($definition)
    {
        $query = '';
        if (!empty($definition['onupdate'])) {
            $query .= ' ON UPDATE '.$definition['onupdate'];
        }
        if (!empty($definition['ondelete'])) {
            $query .= ' ON DELETE '.$definition['ondelete'];
        }
        return $query;
    }

    // }}}
    // {{{ createTable()

    /**
     * create a new table
     *
     * @param string $name   Name of the database that should be created
     * @param array  $fields Associative array that contains the definition of each field of the new table
     *                       The indexes of the array entries are the names of the fields of the table an
     *                       the array entry values are associative arrays like those that are meant to be
     *                       passed with the field definitions to get[Type]Declaration() functions.
     *
     *                      Example
     *                        array(
     *
     *                            'id' => array(
     *                                'type' => 'integer',
     *                                'unsigned' => 1,
     *                                'notnull' => 1,
     *                                'default' => 0,
     *                            ),
     *                            'name' => array(
     *                                'type' => 'text',
     *                                'length' => 12,
     *                            ),
     *                            'description' => array(
     *                                'type' => 'text',
     *                                'length' => 12,
     *                            )
     *                        );
     * @param array $options An associative array of table options:
     *                          array(
     *                              'comment' => 'Foo',
     *                              'temporary' => true|false,
     *                          );
     *
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function createTable($name, $fields, $options = array())
    {
        if (!empty($options['temporary'])) {
            $name = '#'.$name;
        }
        return parent::createTable($name, $fields, $options);
    }

    // }}}
    // {{{ truncateTable()

    /**
     * Truncate an existing table (if the TRUNCATE TABLE syntax is not supported,
     * it falls back to a DELETE FROM TABLE query)
     *
     * @param string $name name of the table that should be truncated
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function truncateTable($name)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $name = $db->quoteIdentifier($name, true);
        return $db->exec("TRUNCATE TABLE $name");
    }

    // }}}
    // {{{ vacuum()

    /**
     * Optimize (vacuum) all the tables in the db (or only the specified table)
     * and optionally run ANALYZE.
     *
     * @param string $table table name (all the tables if empty)
     * @param array  $options an array with driver-specific options:
     *               - timeout [int] (in seconds) [mssql-only]
     *               - analyze [boolean] [pgsql and mysql]
     *               - full [boolean] [pgsql-only]
     *               - freeze [boolean] [pgsql-only]
     *
     * NB: you have to run the NSControl Create utility to enable VACUUM
     *
     * @return mixed MDB2_OK success, a MDB2 error on failure
     * @access public
     */
    function vacuum($table = null, $options = array())
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }
        $timeout = isset($options['timeout']) ? (int)$options['timeout'] : 300;

        $query = 'NSControl Create';
        $result = $db->exec($query);
        if (PEAR::isError($result)) {
            return $result;
        }

        return $db->exec('EXEC NSVacuum '.$timeout);
    }

    // }}}
    // {{{ alterTable()

    /**
     * alter an existing table
     *
     * @param string  $name    name of the table that is intended to be changed.
     * @param array   $changes associative array that contains the details of each type
     *                         of change that is intended to be performed. The types of
     *                         changes that are currently supported are defined as follows:
     *
     *                             name
     *
     *                                New name for the table.
     *
     *                            add
     *
     *                                Associative array with the names of fields to be added as
     *                                 indexes of the array. The value of each entry of the array
     *                                 should be set to another associative array with the properties
     *                                 of the fields to be added. The properties of the fields should
     *                                 be the same as defined by the MDB2 parser.
     *
     *
     *                            remove
     *
     *                                Associative array with the names of fields to be removed as indexes
     *                                 of the array. Currently the values assigned to each entry are ignored.
     *                                 An empty array should be used for future compatibility.
     *
     *                            rename
     *
     *                                Associative array with the names of fields to be renamed as indexes
     *                                 of the array. The value of each entry of the array should be set to
     *                                 another associative array with the entry named name with the new
     *                                 field name and the entry named Declaration that is expected to contain
     *                                 the portion of the field declaration already in DBMS specific SQL code
     *                                 as it is used in the CREATE TABLE statement.
     *
     *                            change
     *
     *                                Associative array with the names of the fields to be changed as indexes
     *                                 of the array. Keep in mind that if it is intended to change either the
     *                                 name of a field and any other properties, the change array entries
     *                                 should have the new names of the fields as array indexes.
     *
     *                                The value of each entry of the array should be set to another associative
     *                                 array with the properties of the fields to that are meant to be changed as
     *                                 array entries. These entries should be assigned to the new values of the
     *                                 respective properties. The properties of the fields should be the same
     *                                 as defined by the MDB2 parser.
     *
     *                            Example
     *                                array(
     *                                    'name' => 'userlist',
     *                                    'add' => array(
     *                                        'quota' => array(
     *                                            'type' => 'integer',
     *                                            'unsigned' => 1
     *                                        )
     *                                    ),
     *                                    'remove' => array(
     *                                        'file_limit' => array(),
     *                                        'time_limit' => array()
     *                                    ),
     *                                    'change' => array(
     *                                        'name' => array(
     *                                            'length' => '20',
     *                                            'definition' => array(
     *                                                'type' => 'text',
     *                                                'length' => 20,
     *                                            ),
     *                                        )
     *                                    ),
     *                                    'rename' => array(
     *                                        'sex' => array(
     *                                            'name' => 'gender',
     *                                            'definition' => array(
     *                                                'type' => 'text',
     *                                                'length' => 1,
     *                                                'default' => 'M',
     *                                            ),
     *                                        )
     *                                    )
     *                                )
     *
     * @param boolean $check   indicates whether the function should just check if the DBMS driver
     *                         can perform the requested table alterations if the value is true or
     *                         actually perform them otherwise.
     *
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function alterTable($name, $changes, $check)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }
        $name_quoted = $db->quoteIdentifier($name, true);

        foreach ($changes as $change_name => $change) {
            switch ($change_name) {
            case 'remove':
            case 'rename':
            case 'add':
            case 'change':
            case 'name':
                break;
            default:
                return $db->raiseError(MDB2_ERROR_CANNOT_ALTER, null, null,
                    'change type "'.$change_name.'" not yet supported', __FUNCTION__);
            }
        }

        if ($check) {
            return MDB2_OK;
        }

        $idxname_format = $db->getOption('idxname_format');
        $db->setOption('idxname_format', '%s');

        if (!empty($changes['remove']) && is_array($changes['remove'])) {
            $result = $this->_dropConflictingIndices($name, array_keys($changes['remove']));
            if (PEAR::isError($result)) {
                $db->setOption('idxname_format', $idxname_format);
                return $result;
            }
            $result = $this->_dropConflictingConstraints($name, array_keys($changes['remove']));
            if (PEAR::isError($result)) {
                $db->setOption('idxname_format', $idxname_format);
                return $result;
            }

            $query = '';
            foreach ($changes['remove'] as $field_name => $field) {
                if ($query) {
                    $query.= ', ';
                }
                $field_name = $db->quoteIdentifier($field_name, true);
                $query.= 'COLUMN ' . $field_name;
            }

            $result = $db->exec("ALTER TABLE $name_quoted DROP $query");
            if (PEAR::isError($result)) {
                $db->setOption('idxname_format', $idxname_format);
                return $result;
            }
        }

        if (!empty($changes['rename']) && is_array($changes['rename'])) {
            foreach ($changes['rename'] as $field_name => $field) {
                $field_name = $db->quoteIdentifier($field_name, true);
                $result = $db->exec("sp_rename '$name_quoted.$field_name', '".$field['name']."', 'COLUMN'");
                if (PEAR::isError($result)) {
                    $db->setOption('idxname_format', $idxname_format);
                    return $result;
                }
            }
        }

        if (!empty($changes['add']) && is_array($changes['add'])) {
            $query = '';
            foreach ($changes['add'] as $field_name => $field) {
                if ($query) {
                    $query.= ', ';
                } else {
                    $query.= 'ADD ';
                }
                $query.= $db->getDeclaration($field['type'], $field_name, $field);
            }

            $result = $db->exec("ALTER TABLE $name_quoted $query");
            if (PEAR::isError($result)) {
                $db->setOption('idxname_format', $idxname_format);
                return $result;
            }
        }

        $dropped_indices     = array();
        $dropped_constraints = array();

        if (!empty($changes['change']) && is_array($changes['change'])) {
            $dropped = $this->_dropConflictingIndices($name, array_keys($changes['change']));
            if (PEAR::isError($dropped)) {
                $db->setOption('idxname_format', $idxname_format);
                return $dropped;
            }
            $dropped_indices = array_merge($dropped_indices, $dropped);
            $dropped = $this->_dropConflictingConstraints($name, array_keys($changes['change']));
            if (PEAR::isError($dropped)) {
                $db->setOption('idxname_format', $idxname_format);
                return $dropped;
            }
            $dropped_constraints = array_merge($dropped_constraints, $dropped);

            foreach ($changes['change'] as $field_name => $field) {
                //MSSQL doesn't allow multiple ALTER COLUMNs in one query
                $query = 'ALTER COLUMN ';

                //MSSQL doesn't allow changing the DEFAULT value of a field in altering mode
                if (array_key_exists('default', $field['definition'])) {
                    unset($field['definition']['default']);
                }

                $query .= $db->getDeclaration($field['definition']['type'], $field_name, $field['definition']);
                $result = $db->exec("ALTER TABLE $name_quoted $query");
                if (PEAR::isError($result)) {
                    $db->setOption('idxname_format', $idxname_format);
                    return $result;
                }
            }
        }

        // restore the dropped conflicting indices and constraints
        foreach ($dropped_indices as $index_name => $index) {
            $result = $this->createIndex($name, $index_name, $index);
            if (PEAR::isError($result)) {
                $db->setOption('idxname_format', $idxname_format);
                return $result;
            }
        }
        foreach ($dropped_constraints as $constraint_name => $constraint) {
            $result = $this->createConstraint($name, $constraint_name, $constraint);
            if (PEAR::isError($result)) {
                $db->setOption('idxname_format', $idxname_format);
                return $result;
            }
        }

        $db->setOption('idxname_format', $idxname_format);

        if (!empty($changes['name'])) {
            $new_name = $db->quoteIdentifier($changes['name'], true);
            $result = $db->exec("sp_rename '$name_quoted', '$new_name'");
            if (PEAR::isError($result)) {
                return $result;
            }
        }

        return MDB2_OK;
    }

    // }}}
    // {{{ _dropConflictingIndices()

    /**
     * Drop the indices that prevent a successful ALTER TABLE action
     *
     * @param string $table  table name
     * @param array  $fields array of names of the fields affected by the change
     *
     * @return array dropped indices definitions
     */
    function _dropConflictingIndices($table, $fields)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $dropped = array();
        $index_names = $this->listTableIndexes($table);
        if (PEAR::isError($index_names)) {
            return $index_names;
        }
        $db->loadModule('Reverse');
        $indexes = array();
        foreach ($index_names as $index_name) {
            $idx_def = $db->reverse->getTableIndexDefinition($table, $index_name);
            if (!PEAR::isError($idx_def)) {
                $indexes[$index_name] = $idx_def;
            }
        }
        foreach ($fields as $field_name) {
            foreach ($indexes as $index_name => $index) {
                if (!isset($dropped[$index_name]) && array_key_exists($field_name, $index['fields'])) {
                    $dropped[$index_name] = $index;
                    $result = $this->dropIndex($table, $index_name);
                    if (PEAR::isError($result)) {
                        return $result;
                    }
                }
            }
        }

        return $dropped;
    }

    // }}}
    // {{{ _dropConflictingConstraints()

    /**
     * Drop the constraints that prevent a successful ALTER TABLE action
     *
     * @param string $table  table name
     * @param array  $fields array of names of the fields affected by the change
     *
     * @return array dropped constraints definitions
     */
    function _dropConflictingConstraints($table, $fields)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $dropped = array();
        $constraint_names = $this->listTableConstraints($table);
        if (PEAR::isError($constraint_names)) {
            return $constraint_names;
        }
        $db->loadModule('Reverse');
        $constraints = array();
        foreach ($constraint_names as $constraint_name) {
            $cons_def = $db->reverse->getTableConstraintDefinition($table, $constraint_name);
            if (!PEAR::isError($cons_def)) {
                $constraints[$constraint_name] = $cons_def;
            }
        }
        foreach ($fields as $field_name) {
            foreach ($constraints as $constraint_name => $constraint) {
                if (!isset($dropped[$constraint_name]) && array_key_exists($field_name, $constraint['fields'])) {
                    $dropped[$constraint_name] = $constraint;
                    $result = $this->dropConstraint($table, $constraint_name);
                    if (PEAR::isError($result)) {
                        return $result;
                    }
                }
            }
            // also drop implicit DEFAULT constraints
            $default = $this->_getTableFieldDefaultConstraint($table, $field_name);
            if (!PEAR::isError($default) && !empty($default)) {
                $result = $this->dropConstraint($table, $default);
                if (PEAR::isError($result)) {
                    return $result;
                }
            }
        }

        return $dropped;
    }

    // }}}
    // {{{ _getTableFieldDefaultConstraint()

    /**
     * Get the default constraint for a table field
     *
     * @param string $table name of table that should be used in method
     * @param string $field name of field that should be used in method
     *
     * @return mixed name of default constraint on success, a MDB2 error on failure
     * @access private
     */
    function _getTableFieldDefaultConstraint($table, $field)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $table = $db->quoteIdentifier($table, true);
        $field = $db->quote($field, 'text');
        $query = "SELECT OBJECT_NAME(syscolumns.cdefault)
                    FROM syscolumns
                   WHERE syscolumns.id = object_id('$table')
                     AND syscolumns.name = $field
                     AND syscolumns.cdefault <> 0";
        return $db->queryOne($query);
    }

    // }}}
    // {{{ listTables()

    /**
     * list all tables in the current database
     *
     * @return mixed array of table names on success, a MDB2 error on failure
     * @access public
     */
    function listTables()
    {
        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {
            return $db;
        }

        $query = 'EXEC sp_tables @table_type = "\'TABLE\'"';
        $table_names = $db->queryCol($query, null, 2);
        if (PEAR::isError($table_names)) {
            return $table_names;
        }
        $result = array();
        foreach ($table_names as $table_name) {
            if (!$this->_fixSequenceName($table_name, true)) {
                $result[] = $table_name;
            }
        }
        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {
            $result = array_map(($db->options['field_case'] == CASE_LOWER ?
                        'strtolower' : 'strtoupper'), $result);
        }
        return $result;
    }

    // }}}
    // {{{ listTableFields()

    /**
     * list all fields in a table in the current database
     *
     * @param string $table name of table that should be used in method
     *
     * @return mixed array of field names on success, a MDB2 error on failure
     * @access public
     */
    function listTableFields($table)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $table = $db->quoteIdentifier($table, true);
        $columns = $db->queryCol("SELECT c.name
                                    FROM syscolumns c
                               LEFT JOIN sysobjects o ON c.id = o.id
                                   WHERE o.name = '$table'");
        if (PEAR::isError($columns)) {
            return $columns;
        }
        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {
            $columns = array_map(($db->options['field_case'] == CASE_LOWER ? 'strtolower' : 'strtoupper'), $columns);
        }
        return $columns;
    }

    // }}}
    // {{{ listTableIndexes()

    /**
     * list all indexes in a table
     *
     * @param string $table name of table that should be used in method
     *
     * @return mixed array of index names on success, a MDB2 error on failure
     * @access public
     */
    function listTableIndexes($table)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $key_name = 'INDEX_NAME';
        $pk_name = 'PK_NAME';
        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {
            if ($db->options['field_case'] == CASE_LOWER) {
                $key_name = strtolower($key_name);
                $pk_name  = strtolower($pk_name);
            } else {
                $key_name = strtoupper($key_name);
                $pk_name  = strtoupper($pk_name);
            }
        }
        $table = $db->quote($table, 'text');
        $query = "EXEC sp_statistics @table_name=$table";
        $indexes = $db->queryCol($query, 'text', $key_name);
        if (PEAR::isError($indexes)) {
            return $indexes;
        }
        $query = "EXEC sp_pkeys @table_name=$table";
        $pk_all = $db->queryCol($query, 'text', $pk_name);
        $result = array();
        foreach ($indexes as $index) {
            if (!in_array($index, $pk_all) && ($index = $this->_fixIndexName($index))) {
                $result[$index] = true;
            }
        }

        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {
            $result = array_change_key_case($result, $db->options['field_case']);
        }
        return array_keys($result);
    }

    // }}}
    // {{{ listDatabases()

    /**
     * list all databases
     *
     * @return mixed array of database names on success, a MDB2 error on failure
     * @access public
     */
    function listDatabases()
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $result = $db->queryCol('SELECT name FROM sys.databases');
        if (PEAR::isError($result)) {
            return $result;
        }
        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {
            $result = array_map(($db->options['field_case'] == CASE_LOWER ? 'strtolower' : 'strtoupper'), $result);
        }
        return $result;
    }

    // }}}
    // {{{ listUsers()

    /**
     * list all users
     *
     * @return mixed array of user names on success, a MDB2 error on failure
     * @access public
     */
    function listUsers()
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $result = $db->queryCol('SELECT DISTINCT loginame FROM master..sysprocesses');
        if (PEAR::isError($result) || empty($result)) {
            return $result;
        }
        foreach (array_keys($result) as $k) {
            $result[$k] = trim($result[$k]);
        }
        return $result;
    }

    // }}}
    // {{{ listFunctions()

    /**
     * list all functions in the current database
     *
     * @return mixed array of function names on success, a MDB2 error on failure
     * @access public
     */
    function listFunctions()
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $query = "SELECT name
                    FROM sysobjects
                   WHERE objectproperty(id, N'IsMSShipped') = 0
                    AND (objectproperty(id, N'IsTableFunction') = 1
                     OR objectproperty(id, N'IsScalarFunction') = 1)";
        /*
        SELECT ROUTINE_NAME
          FROM INFORMATION_SCHEMA.ROUTINES
         WHERE ROUTINE_TYPE = 'FUNCTION'
        */
        $result = $db->queryCol($query);
        if (PEAR::isError($result)) {
            return $result;
        }
        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {
            $result = array_map(($db->options['field_case'] == CASE_LOWER ? 'strtolower' : 'strtoupper'), $result);
        }
        return $result;
    }

    // }}}
    // {{{ listTableTriggers()

    /**
     * list all triggers in the database that reference a given table
     *
     * @param string table for which all referenced triggers should be found
     *
     * @return mixed array of trigger names on success,  otherwise, false which
     *               could be a db error if the db is not instantiated or could
     *               be the results of the error that occured during the
     *               querying of the sysobject module.
     * @access public
     */
    function listTableTriggers($table = null)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $table = $db->quote($table, 'text');
        $query = "SELECT o.name
                    FROM sysobjects o
                   WHERE xtype = 'TR'
                     AND OBJECTPROPERTY(o.id, 'IsMSShipped') = 0";
        if (!is_null($table)) {
            $query .= " AND object_name(parent_obj) = $table";
        }

        $result = $db->queryCol($query);
        if (PEAR::isError($result)) {
            return $result;
        }

        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE &&
            $db->options['field_case'] == CASE_LOWER)
        {
            $result = array_map(($db->options['field_case'] == CASE_LOWER ?
                'strtolower' : 'strtoupper'), $result);
        }
        return $result;
    }

    // }}}
    // {{{ listViews()

    /**
     * list all views in the current database
     *
     * @param string database, the current is default
     *
     * @return mixed array of view names on success, a MDB2 error on failure
     * @access public
     */
    function listViews()
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $query = "SELECT name
                    FROM sysobjects
                   WHERE xtype = 'V'";
        /*
        SELECT *
          FROM sysobjects
         WHERE objectproperty(id, N'IsMSShipped') = 0
           AND objectproperty(id, N'IsView') = 1
        */

        $result = $db->queryCol($query);
        if (PEAR::isError($result)) {
            return $result;
        }

        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE &&
            $db->options['field_case'] == CASE_LOWER)
        {
            $result = array_map(($db->options['field_case'] == CASE_LOWER ?
                          'strtolower' : 'strtoupper'), $result);
        }
        return $result;
    }

    // }}}
    // {{{ dropIndex()

    /**
     * drop existing index
     *
     * @param string $table name of table that should be used in method
     * @param string $name  name of the index to be dropped
     *
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function dropIndex($table, $name)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $table = $db->quoteIdentifier($table, true);
        $name = $db->quoteIdentifier($db->getIndexName($name), true);
        return $db->exec("DROP INDEX $table.$name");
    }

    // }}}
    // {{{ listTableConstraints()

    /**
     * list all constraints in a table
     *
     * @param string $table name of table that should be used in method
     *
     * @return mixed array of constraint names on success, a MDB2 error on failure
     * @access public
     */
    function listTableConstraints($table)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }
        $table = $db->quoteIdentifier($table, true);

        $query = "SELECT c.constraint_name
                    FROM INFORMATION_SCHEMA.TABLE_CONSTRAINTS c
                   WHERE c.constraint_catalog = DB_NAME()
                     AND c.table_name = '$table'";
        $constraints = $db->queryCol($query);
        if (PEAR::isError($constraints)) {
            return $constraints;
        }

        $result = array();
        foreach ($constraints as $constraint) {
            $constraint = $this->_fixIndexName($constraint);
            if (!empty($constraint)) {
                $result[$constraint] = true;
            }
        }

        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {
            $result = array_change_key_case($result, $db->options['field_case']);
        }
        return array_keys($result);
    }

    // }}}
    // {{{ createSequence()

    /**
     * create sequence
     *
     * @param string $seq_name name of the sequence to be created
     * @param string $start    start value of the sequence; default is 1
     *
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function createSequence($seq_name, $start = 1)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $sequence_name = $db->quoteIdentifier($db->getSequenceName($seq_name), true);
        $seqcol_name = $db->quoteIdentifier($db->options['seqcol_name'], true);
        $query = "CREATE TABLE $sequence_name ($seqcol_name " .
                 "INT PRIMARY KEY CLUSTERED IDENTITY($start,1) NOT NULL)";

        $res = $db->exec($query);
        if (PEAR::isError($res)) {
            return $res;
        }

        $query = "SET IDENTITY_INSERT $sequence_name ON ".
                 "INSERT INTO $sequence_name ($seqcol_name) VALUES ($start)";
        $res = $db->exec($query);

        if (!PEAR::isError($res)) {
            return MDB2_OK;
        }

        $result = $db->exec("DROP TABLE $sequence_name");
        if (PEAR::isError($result)) {
            return $db->raiseError($result, null, null,
                'could not drop inconsistent sequence table', __FUNCTION__);
        }

        return $db->raiseError($res, null, null,
            'could not create sequence table', __FUNCTION__);
    }

    // }}}
    // {{{ dropSequence()

    /**
     * This function drops an existing sequence
     *
     * @param string $seq_name name of the sequence to be dropped
     *
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function dropSequence($seq_name)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $sequence_name = $db->quoteIdentifier($db->getSequenceName($seq_name), true);
        return $db->exec("DROP TABLE $sequence_name");
    }

    // }}}
    // {{{ listSequences()

    /**
     * list all sequences in the current database
     *
     * @return mixed array of sequence names on success, a MDB2 error on failure
     * @access public
     */
    function listSequences()
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $query = "SELECT name FROM sysobjects WHERE xtype = 'U'";
        $table_names = $db->queryCol($query);
        if (PEAR::isError($table_names)) {
            return $table_names;
        }
        $result = array();
        foreach ($table_names as $table_name) {
            if ($sqn = $this->_fixSequenceName($table_name, true)) {
                $result[] = $sqn;
            }
        }
        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {
            $result = array_map(($db->options['field_case'] == CASE_LOWER ?
                          'strtolower' : 'strtoupper'), $result);
        }
        return $result;
    }

    // }}}
}

// }}}
?>

 program/lib/MDB2/Driver/Manager/mysql.php

@@ -2,7 +2,7 @@
// +----------------------------------------------------------------------+

// | PHP versions 4 and 5                                                 |

// +----------------------------------------------------------------------+

// | Copyright (c) 1998-2007 Manuel Lemos, Tomas V.V.Cox,                 |

// | Copyright (c) 1998-2008 Manuel Lemos, Tomas V.V.Cox,                 |

// | Stig. S. Bakken, Lukas Smith                                         |

// | All rights reserved.                                                 |

// +----------------------------------------------------------------------+

@@ -42,7 +42,7 @@
// | Author: Lukas Smith <smith@pooteeweet.org>                           |

// +----------------------------------------------------------------------+

//

// $Id: mysql.php,v 1.100 2007/12/03 20:59:15 quipo Exp $

// $Id: mysql.php,v 1.108 2008/03/11 19:58:12 quipo Exp $

//



require_once 'MDB2/Driver/Manager/Common.php';

@@ -79,16 +79,41 @@
        $name  = $db->quoteIdentifier($name, true);

        $query = 'CREATE DATABASE ' . $name;

        if (!empty($options['charset'])) {

            $query .= ' DEFAULT CHARACTER SET ' . $options['charset'];

            $query .= ' DEFAULT CHARACTER SET ' . $db->quote($options['charset'], 'text');

        }

        if (!empty($options['collation'])) {

            $query .= ' COLLATE ' . $options['collation'];

            $query .= ' COLLATE ' . $db->quote($options['collation'], 'text');

        }

        $result = $db->exec($query);

        if (PEAR::isError($result)) {

            return $result;

        return $db->standaloneQuery($query, null, true);

    }



    // }}}

    // {{{ alterDatabase()



    /**

     * alter an existing database

     *

     * @param string $name    name of the database that is intended to be changed

     * @param array  $options array with charset, collation info

     *

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function alterDatabase($name, $options = array())

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }

        return MDB2_OK;



        $query = 'ALTER DATABASE '. $db->quoteIdentifier($name, true);

        if (!empty($options['charset'])) {

            $query .= ' DEFAULT CHARACTER SET ' . $db->quote($options['charset'], 'text');

        }

        if (!empty($options['collation'])) {

            $query .= ' COLLATE ' . $db->quote($options['collation'], 'text');

        }

        return $db->standaloneQuery($query, null, true);

    }



    // }}}

@@ -110,11 +135,7 @@


        $name = $db->quoteIdentifier($name, true);

        $query = "DROP DATABASE $name";

        $result = $db->exec($query);

        if (PEAR::isError($result)) {

            return $result;

        }

        return MDB2_OK;

        return $db->standaloneQuery($query, null, true);

    }



    // }}}

@@ -188,9 +209,35 @@
            return $db;

        }



        // if we have an AUTO_INCREMENT column and a PK on more than one field,

        // we have to handle it differently...

        $autoincrement = null;

        if (empty($options['primary'])) {

            $pk_fields = array();

            foreach ($fields as $fieldname => $def) {

                if (!empty($def['primary'])) {

                    $pk_fields[$fieldname] = true;

                }

                if (!empty($def['autoincrement'])) {

                    $autoincrement = $fieldname;

                }

            }

            if (!is_null($autoincrement) && count($pk_fields) > 1) {

                $options['primary'] = $pk_fields;

            } else {

                // the PK constraint is on max one field => OK

                $autoincrement = null;

            }

        }



        $query = $this->_getCreateTableQuery($name, $fields, $options);

        if (PEAR::isError($query)) {

            return $query;

        }



        if (!is_null($autoincrement)) {

            // we have to remove the PK clause added by _getIntegerDeclaration()

            $query = str_replace('AUTO_INCREMENT PRIMARY KEY', 'AUTO_INCREMENT', $query);

        }



        $options_strings = array();

@@ -222,6 +269,112 @@
        $result = $db->exec($query);

        if (PEAR::isError($result)) {

            return $result;

        }

        return MDB2_OK;

    }



    // }}}

    // {{{ dropTable()



    /**

     * drop an existing table

     *

     * @param string $name name of the table that should be dropped

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function dropTable($name)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        //delete the triggers associated to existing FK constraints

        $constraints = $this->listTableConstraints($name);

        if (!PEAR::isError($constraints) && !empty($constraints)) {

            $db->loadModule('Reverse', null, true);

            foreach ($constraints as $constraint) {

                $definition = $db->reverse->getTableConstraintDefinition($name, $constraint);

                if (!PEAR::isError($definition) && !empty($definition['foreign'])) {

                    $result = $this->_dropFKTriggers($name, $constraint, $definition['references']['table']);

                    if (PEAR::isError($result)) {

                        return $result;

                    }

                }

            }

        }



        return parent::dropTable($name);

    }



    // }}}

    // {{{ truncateTable()



    /**

     * Truncate an existing table (if the TRUNCATE TABLE syntax is not supported,

     * it falls back to a DELETE FROM TABLE query)

     *

     * @param string $name name of the table that should be truncated

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function truncateTable($name)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $name = $db->quoteIdentifier($name, true);

        return $db->exec("TRUNCATE TABLE $name");

    }



    // }}}

    // {{{ vacuum()



    /**

     * Optimize (vacuum) all the tables in the db (or only the specified table)

     * and optionally run ANALYZE.

     *

     * @param string $table table name (all the tables if empty)

     * @param array  $options an array with driver-specific options:

     *               - timeout [int] (in seconds) [mssql-only]

     *               - analyze [boolean] [pgsql and mysql]

     *               - full [boolean] [pgsql-only]

     *               - freeze [boolean] [pgsql-only]

     *

     * @return mixed MDB2_OK success, a MDB2 error on failure

     * @access public

     */

    function vacuum($table = null, $options = array())

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        if (empty($table)) {

            $table = $this->listTables();

            if (PEAR::isError($table)) {

                return $table;

            }

        }

        if (is_array($table)) {

            foreach (array_keys($table) as $k) {

                $table[$k] = $db->quoteIdentifier($table[$k], true);

            }

            $table = implode(', ', $table);

        } else {

            $table = $db->quoteIdentifier($table, true);

        }

        
        $result = $db->exec('OPTIMIZE TABLE '.$table);

        if (PEAR::isError($result)) {

            return $result;

        }

        if (!empty($options['analyze'])) {

            return $db->exec('ANALYZE TABLE '.$table);

        }

        return MDB2_OK;

    }

@@ -629,33 +782,34 @@
     * Get the stucture of a field into an array

     *

     * @author Leoncx

     * @param string    $table         name of the table on which the index is to be created

     * @param string    $name         name of the index to be created

     * @param array     $definition        associative array that defines properties of the index to be created.

     *                                 Currently, only one property named FIELDS is supported. This property

     *                                 is also an associative with the names of the index fields as array

     *                                 indexes. Each entry of this array is set to another type of associative

     *                                 array that specifies properties of the index that are specific to

     *                                 each field.

     * @param string $table      name of the table on which the index is to be created

     * @param string $name       name of the index to be created

     * @param array  $definition associative array that defines properties of the index to be created.

     *                           Currently, only one property named FIELDS is supported. This property

     *                           is also an associative with the names of the index fields as array

     *                           indexes. Each entry of this array is set to another type of associative

     *                           array that specifies properties of the index that are specific to

     *                           each field.

     *

     *                                Currently, only the sorting property is supported. It should be used

     *                                 to define the sorting direction of the index. It may be set to either

     *                                 ascending or descending.

     *                           Currently, only the sorting property is supported. It should be used

     *                           to define the sorting direction of the index. It may be set to either

     *                           ascending or descending.

     *

     *                                Not all DBMS support index sorting direction configuration. The DBMS

     *                                 drivers of those that do not support it ignore this property. Use the

     *                                 function supports() to determine whether the DBMS driver can manage indexes.

     *                           Not all DBMS support index sorting direction configuration. The DBMS

     *                           drivers of those that do not support it ignore this property. Use the

     *                           function supports() to determine whether the DBMS driver can manage indexes.

     *

     *                                 Example

     *                                    array(

     *                                        'fields' => array(

     *                                            'user_name' => array(

     *                                                'sorting' => 'ascending'

     *                                                'length' => 10

     *                                            ),

     *                                            'last_login' => array()

     *                                        )

     *                           Example

     *                               array(

     *                                   'fields' => array(

     *                                       'user_name' => array(

     *                                           'sorting' => 'ascending'

     *                                           'length' => 10

     *                                       ),

     *                                       'last_login' => array()

     *                                    )

     *                                )

     *

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

@@ -800,10 +954,10 @@
                'invalid definition, could not create constraint', __FUNCTION__);

        }



        $table = $db->quoteIdentifier($table, true);

        $query = "ALTER TABLE $table ADD $type $name";

        $table_quoted = $db->quoteIdentifier($table, true);

        $query = "ALTER TABLE $table_quoted ADD $type $name";

        if (!empty($definition['foreign'])) {

            $query .= ' FOREIGN KEY ';

            $query .= ' FOREIGN KEY';

        }

        $fields = array();

        foreach (array_keys($definition['fields']) as $field) {

@@ -819,7 +973,14 @@
            $query .= ' ('. implode(', ', $referenced_fields) . ')';

            $query .= $this->_getAdvancedFKOptions($definition);

        }

        return $db->exec($query);

        $res = $db->exec($query);

        if (PEAR::isError($res)) {

            return $res;

        }

        if (!empty($definition['foreign'])) {

            return $this->_createFKTriggers($table, array($name => $definition));

        }

        return MDB2_OK;

    }



    // }}}

@@ -841,14 +1002,208 @@
            return $db;

        }



        $table = $db->quoteIdentifier($table, true);

        if ($primary || strtolower($name) == 'primary') {

            $query = "ALTER TABLE $table DROP PRIMARY KEY";

        } else {

            $name = $db->quoteIdentifier($db->getIndexName($name), true);

            $query = "ALTER TABLE $table DROP INDEX $name";

            $query = 'ALTER TABLE '. $db->quoteIdentifier($table, true) .' DROP PRIMARY KEY';

            return $db->exec($query);

        }



        //is it a FK constraint? If so, also delete the associated triggers

        $db->loadModule('Reverse', null, true);

        $definition = $db->reverse->getTableConstraintDefinition($table, $name);

        if (!PEAR::isError($definition) && !empty($definition['foreign'])) {

            //first drop the FK enforcing triggers

            $result = $this->_dropFKTriggers($table, $name, $definition['references']['table']);

            if (PEAR::isError($result)) {

                return $result;

            }

            //then drop the constraint itself

            $table = $db->quoteIdentifier($table, true);

            $name = $db->quoteIdentifier($db->getIndexName($name), true);

            $query = "ALTER TABLE $table DROP FOREIGN KEY $name";

            return $db->exec($query);

        }



        $table = $db->quoteIdentifier($table, true);

        $name = $db->quoteIdentifier($db->getIndexName($name), true);

        $query = "ALTER TABLE $table DROP INDEX $name";

        return $db->exec($query);

    }



    // }}}

    // {{{ _createFKTriggers()



    /**

     * Create triggers to enforce the FOREIGN KEY constraint on the table

     *

     * NB: since there's no RAISE_APPLICATION_ERROR facility in mysql,

     * we call a non-existent procedure to raise the FK violation message.

     * @see http://forums.mysql.com/read.php?99,55108,71877#msg-71877

     *

     * @param string $table        table name

     * @param array  $foreign_keys FOREIGN KEY definitions

     *

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access private

     */

    function _createFKTriggers($table, $foreign_keys)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }

        // create triggers to enforce FOREIGN KEY constraints

        if ($db->supports('triggers') && !empty($foreign_keys)) {

            $table = $db->quoteIdentifier($table, true);

            foreach ($foreign_keys as $fkname => $fkdef) {

                if (empty($fkdef)) {

                    continue;

                }

                //set actions to 'RESTRICT' if not set

                $fkdef['onupdate'] = empty($fkdef['onupdate']) ? 'RESTRICT' : strtoupper($fkdef['onupdate']);

                $fkdef['ondelete'] = empty($fkdef['ondelete']) ? 'RESTRICT' : strtoupper($fkdef['ondelete']);



                $trigger_names = array(

                    'insert'    => $fkname.'_insert_trg',

                    'update'    => $fkname.'_update_trg',

                    'pk_update' => $fkname.'_pk_update_trg',

                    'pk_delete' => $fkname.'_pk_delete_trg',

                );

                $table_fields = array_keys($fkdef['fields']);

                $referenced_fields = array_keys($fkdef['references']['fields']);



                //create the ON [UPDATE|DELETE] triggers on the primary table

                $restrict_action = ' IF (SELECT ';

                $aliased_fields = array();

                foreach ($table_fields as $field) {

                    $aliased_fields[] = $table .'.'.$field .' AS '.$field;

                }

                $restrict_action .= implode(',', $aliased_fields)

                       .' FROM '.$table

                       .' WHERE ';

                $conditions  = array();

                $new_values  = array();

                $null_values = array();

                for ($i=0; $i<count($table_fields); $i++) {

                    $conditions[]  = $table_fields[$i] .' = OLD.'.$referenced_fields[$i];

                    $new_values[]  = $table_fields[$i] .' = NEW.'.$referenced_fields[$i];

                    $null_values[] = $table_fields[$i] .' = NULL';

                }

                $restrict_action .= implode(' AND ', $conditions).') IS NOT NULL'

                                .' THEN CALL %s_ON_TABLE_'.$table.'_VIOLATES_FOREIGN_KEY_CONSTRAINT();'

                                .' END IF;';



                $cascade_action_update = 'UPDATE '.$table.' SET '.implode(', ', $new_values) .' WHERE '.implode(' AND ', $conditions). ';';

                $cascade_action_delete = 'DELETE FROM '.$table.' WHERE '.implode(' AND ', $conditions). ';';

                $setnull_action        = 'UPDATE '.$table.' SET '.implode(', ', $null_values).' WHERE '.implode(' AND ', $conditions). ';';



                if ('SET DEFAULT' == $fkdef['onupdate'] || 'SET DEFAULT' == $fkdef['ondelete']) {

                    $db->loadModule('Reverse', null, true);

                    $default_values = array();

                    foreach ($table_fields as $table_field) {

                        $field_definition = $db->reverse->getTableFieldDefinition($table, $field);

                        if (PEAR::isError($field_definition)) {

                            return $field_definition;

                        }

                        $default_values[] = $table_field .' = '. $field_definition[0]['default'];

                    }

                    $setdefault_action = 'UPDATE '.$table.' SET '.implode(', ', $default_values).' WHERE '.implode(' AND ', $conditions). ';';

                }



                $query = 'CREATE TRIGGER %s'

                        .' %s ON '.$fkdef['references']['table']

                        .' FOR EACH ROW BEGIN '

                        .' SET FOREIGN_KEY_CHECKS = 0; ';  //only really needed for ON UPDATE CASCADE



                if ('CASCADE' == $fkdef['onupdate']) {

                    $sql_update = sprintf($query, $trigger_names['pk_update'], 'BEFORE UPDATE',  'update') . $cascade_action_update;

                } elseif ('SET NULL' == $fkdef['onupdate']) {

                    $sql_update = sprintf($query, $trigger_names['pk_update'], 'BEFORE UPDATE', 'update') . $setnull_action;

                } elseif ('SET DEFAULT' == $fkdef['onupdate']) {

                    $sql_update = sprintf($query, $trigger_names['pk_update'], 'BEFORE UPDATE', 'update') . $setdefault_action;

                } elseif ('NO ACTION' == $fkdef['onupdate']) {

                    $sql_update = sprintf($query.$restrict_action, $trigger_names['pk_update'], 'AFTER UPDATE', 'update');

                } else {

                    //'RESTRICT'

                    $sql_update = sprintf($query.$restrict_action, $trigger_names['pk_update'], 'BEFORE UPDATE', 'update');

                }

                if ('CASCADE' == $fkdef['ondelete']) {

                    $sql_delete = sprintf($query, $trigger_names['pk_delete'], 'BEFORE DELETE',  'delete') . $cascade_action_delete;

                } elseif ('SET NULL' == $fkdef['ondelete']) {

                    $sql_delete = sprintf($query, $trigger_names['pk_delete'], 'BEFORE DELETE', 'delete') . $setnull_action;

                } elseif ('SET DEFAULT' == $fkdef['ondelete']) {

                    $sql_delete = sprintf($query, $trigger_names['pk_delete'], 'BEFORE DELETE', 'delete') . $setdefault_action;

                } elseif ('NO ACTION' == $fkdef['ondelete']) {

                    $sql_delete = sprintf($query.$restrict_action, $trigger_names['pk_delete'], 'AFTER DELETE', 'delete');

                } else {

                    //'RESTRICT'

                    $sql_delete = sprintf($query.$restrict_action, $trigger_names['pk_delete'], 'BEFORE DELETE', 'delete');

                }

                $sql_update .= ' SET FOREIGN_KEY_CHECKS = 1; END;';

                $sql_delete .= ' SET FOREIGN_KEY_CHECKS = 1; END;';



                $db->pushErrorHandling(PEAR_ERROR_RETURN);

                $db->expectError(MDB2_ERROR_CANNOT_CREATE);

                $result = $db->exec($sql_delete);

                $expected_errmsg = 'This MySQL version doesn\'t support multiple triggers with the same action time and event for one table';

                $db->popExpect();

                $db->popErrorHandling();

                if (PEAR::isError($result)) {

                    if ($result->getCode() != MDB2_ERROR_CANNOT_CREATE) {

                        return $result;

                    }

                    $db->warnings[] = $expected_errmsg;

                }

                $db->pushErrorHandling(PEAR_ERROR_RETURN);

                $db->expectError(MDB2_ERROR_CANNOT_CREATE);

                $result = $db->exec($sql_update);

                $db->popExpect();

                $db->popErrorHandling();

                if (PEAR::isError($result) && $result->getCode() != MDB2_ERROR_CANNOT_CREATE) {

                    if ($result->getCode() != MDB2_ERROR_CANNOT_CREATE) {

                        return $result;

                    }

                    $db->warnings[] = $expected_errmsg;

                }

            }

        }

        return MDB2_OK;

    }



    // }}}

    // {{{ _dropFKTriggers()



    /**

     * Drop the triggers created to enforce the FOREIGN KEY constraint on the table

     *

     * @param string $table            table name

     * @param string $fkname           FOREIGN KEY constraint name

     * @param string $referenced_table referenced table name

     *

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access private

     */

    function _dropFKTriggers($table, $fkname, $referenced_table)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $triggers  = $this->listTableTriggers($table);

        $triggers2 = $this->listTableTriggers($referenced_table);

        if (!PEAR::isError($triggers2) && !PEAR::isError($triggers)) {

            $triggers = array_merge($triggers, $triggers2);

            $pattern = '/^'.$fkname.'(_pk)?_(insert|update|delete)_trg$/i';

            foreach ($triggers as $trigger) {

                if (preg_match($pattern, $trigger)) {

                    $result = $db->exec('DROP TRIGGER '.$trigger);

                    if (PEAR::isError($result)) {

                        return $result;

                    }

                }

            }

        }

        return MDB2_OK;

    }



    // }}}

@@ -904,8 +1259,8 @@
        $query = 'SHOW CREATE TABLE '. $db->escape($table);

        $definition = $db->queryOne($query, 'text', 1);

        if (!PEAR::isError($definition) && !empty($definition)) {

            $pattern = '/\bCONSTRAINT\s+([^\s]+)\s+FOREIGN KEY\b/i';

            if (preg_match_all($pattern, str_replace('`', '', $definition), $matches) > 1) {

            $pattern = '/\bCONSTRAINT\b\s+([^\s]+)\s+\bFOREIGN KEY\b/Uims';

            if (preg_match_all($pattern, str_replace('`', '', $definition), $matches) > 0) {

                foreach ($matches[1] as $constraint) {

                    $result[$constraint] = true;

                }

@@ -974,7 +1329,6 @@
            $query .= ' '.implode(' ', $options_strings);

        }

        $res = $db->exec($query);



        if (PEAR::isError($res)) {

            return $res;

        }


 program/lib/MDB2/Driver/Manager/mysqli.php

@@ -2,7 +2,7 @@
// +----------------------------------------------------------------------+

// | PHP versions 4 and 5                                                 |

// +----------------------------------------------------------------------+

// | Copyright (c) 1998-2007 Manuel Lemos, Tomas V.V.Cox,                 |

// | Copyright (c) 1998-2008 Manuel Lemos, Tomas V.V.Cox,                 |

// | Stig. S. Bakken, Lukas Smith                                         |

// | All rights reserved.                                                 |

// +----------------------------------------------------------------------+

@@ -42,7 +42,7 @@
// | Author: Lukas Smith <smith@pooteeweet.org>                           |

// +----------------------------------------------------------------------+

//

// $Id: mysqli.php,v 1.87 2007/12/03 20:59:15 quipo Exp $

// $Id: mysqli.php,v 1.95 2008/03/11 19:58:12 quipo Exp $

//



require_once 'MDB2/Driver/Manager/Common.php';

@@ -79,16 +79,41 @@
        $name  = $db->quoteIdentifier($name, true);

        $query = 'CREATE DATABASE ' . $name;

        if (!empty($options['charset'])) {

            $query .= ' DEFAULT CHARACTER SET ' . $options['charset'];

            $query .= ' DEFAULT CHARACTER SET ' . $db->quote($options['charset'], 'text');

        }

        if (!empty($options['collation'])) {

            $query .= ' COLLATE ' . $options['collation'];

            $query .= ' COLLATE ' . $db->quote($options['collation'], 'text');

        }

        $result = $db->exec($query);

        if (PEAR::isError($result)) {

            return $result;

        return $db->standaloneQuery($query, null, true);

    }



    // }}}

    // {{{ alterDatabase()



    /**

     * alter an existing database

     *

     * @param string $name    name of the database that is intended to be changed

     * @param array  $options array with charset, collation info

     *

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function alterDatabase($name, $options = array())

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }

        return MDB2_OK;



        $query = 'ALTER DATABASE '. $db->quoteIdentifier($name, true);

        if (!empty($options['charset'])) {

            $query .= ' DEFAULT CHARACTER SET ' . $db->quote($options['charset'], 'text');

        }

        if (!empty($options['collation'])) {

            $query .= ' COLLATE ' . $db->quote($options['collation'], 'text');

        }

        return $db->standaloneQuery($query, null, true);

    }



    // }}}

@@ -110,11 +135,7 @@


        $name = $db->quoteIdentifier($name, true);

        $query = "DROP DATABASE $name";

        $result = $db->exec($query);

        if (PEAR::isError($result)) {

            return $result;

        }

        return MDB2_OK;

        return $db->standaloneQuery($query, null, true);

    }



    // }}}

@@ -188,9 +209,35 @@
            return $db;

        }



        // if we have an AUTO_INCREMENT column and a PK on more than one field,

        // we have to handle it differently...

        $autoincrement = null;

        if (empty($options['primary'])) {

            $pk_fields = array();

            foreach ($fields as $fieldname => $def) {

                if (!empty($def['primary'])) {

                    $pk_fields[$fieldname] = true;

                }

                if (!empty($def['autoincrement'])) {

                    $autoincrement = $fieldname;

                }

            }

            if (!is_null($autoincrement) && count($pk_fields) > 1) {

                $options['primary'] = $pk_fields;

            } else {

                // the PK constraint is on max one field => OK

                $autoincrement = null;

            }

        }



        $query = $this->_getCreateTableQuery($name, $fields, $options);

        if (PEAR::isError($query)) {

            return $query;

        }



        if (!is_null($autoincrement)) {

            // we have to remove the PK clause added by _getIntegerDeclaration()

            $query = str_replace('AUTO_INCREMENT PRIMARY KEY', 'AUTO_INCREMENT', $query);

        }



        $options_strings = array();

@@ -222,6 +269,112 @@
        $result = $db->exec($query);

        if (PEAR::isError($result)) {

            return $result;

        }

        return MDB2_OK;

    }



    // }}}

    // {{{ dropTable()



    /**

     * drop an existing table

     *

     * @param string $name name of the table that should be dropped

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function dropTable($name)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        //delete the triggers associated to existing FK constraints

        $constraints = $this->listTableConstraints($name);

        if (!PEAR::isError($constraints) && !empty($constraints)) {

            $db->loadModule('Reverse', null, true);

            foreach ($constraints as $constraint) {

                $definition = $db->reverse->getTableConstraintDefinition($name, $constraint);

                if (!PEAR::isError($definition) && !empty($definition['foreign'])) {

                    $result = $this->_dropFKTriggers($name, $constraint, $definition['references']['table']);

                    if (PEAR::isError($result)) {

                        return $result;

                    }

                }

            }

        }



        return parent::dropTable($name);

    }



    // }}}

    // {{{ truncateTable()



    /**

     * Truncate an existing table (if the TRUNCATE TABLE syntax is not supported,

     * it falls back to a DELETE FROM TABLE query)

     *

     * @param string $name name of the table that should be truncated

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function truncateTable($name)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $name = $db->quoteIdentifier($name, true);

        return $db->exec("TRUNCATE TABLE $name");

    }



    // }}}

    // {{{ vacuum()



    /**

     * Optimize (vacuum) all the tables in the db (or only the specified table)

     * and optionally run ANALYZE.

     *

     * @param string $table table name (all the tables if empty)

     * @param array  $options an array with driver-specific options:

     *               - timeout [int] (in seconds) [mssql-only]

     *               - analyze [boolean] [pgsql and mysql]

     *               - full [boolean] [pgsql-only]

     *               - freeze [boolean] [pgsql-only]

     *

     * @return mixed MDB2_OK success, a MDB2 error on failure

     * @access public

     */

    function vacuum($table = null, $options = array())

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        if (empty($table)) {

            $table = $this->listTables();

            if (PEAR::isError($table)) {

                return $table;

            }

        }

        if (is_array($table)) {

            foreach (array_keys($table) as $k) {

                $table[$k] = $db->quoteIdentifier($table[$k], true);

            }

            $table = implode(', ', $table);

        } else {

            $table = $db->quoteIdentifier($table, true);

        }



        $result = $db->exec('OPTIMIZE TABLE '.$table);

        if (PEAR::isError($result)) {

            return $result;

        }

        if (!empty($options['analyze'])) {

            return $db->exec('ANALYZE TABLE '.$table);

        }

        return MDB2_OK;

    }

@@ -656,6 +809,7 @@
     *                                            'last_login' => array()

     *                                        )

     *                                    )

     *

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

@@ -800,10 +954,10 @@
                'invalid definition, could not create constraint', __FUNCTION__);

        }



        $table = $db->quoteIdentifier($table, true);

        $query = "ALTER TABLE $table ADD $type $name";

        $table_quoted = $db->quoteIdentifier($table, true);

        $query = "ALTER TABLE $table_quoted ADD $type $name";

        if (!empty($definition['foreign'])) {

            $query .= ' FOREIGN KEY ';

            $query .= ' FOREIGN KEY';

        }

        $fields = array();

        foreach (array_keys($definition['fields']) as $field) {

@@ -819,7 +973,14 @@
            $query .= ' ('. implode(', ', $referenced_fields) . ')';

            $query .= $this->_getAdvancedFKOptions($definition);

        }

        return $db->exec($query);

        $res = $db->exec($query);

        if (PEAR::isError($res)) {

            return $res;

        }

        if (!empty($definition['foreign'])) {

            return $this->_createFKTriggers($table, array($name => $definition));

        }

        return MDB2_OK;

    }



    // }}}

@@ -840,15 +1001,209 @@
        if (PEAR::isError($db)) {

            return $db;

        }

        
        if ($primary || strtolower($name) == 'primary') {

            $query = 'ALTER TABLE '. $db->quoteIdentifier($table, true) .' DROP PRIMARY KEY';

            return $db->exec($query);

        }

        
        //is it a FK constraint? If so, also delete the associated triggers

        $db->loadModule('Reverse', null, true);

        $definition = $db->reverse->getTableConstraintDefinition($table, $name);

        if (!PEAR::isError($definition) && !empty($definition['foreign'])) {

            //first drop the FK enforcing triggers

            $result = $this->_dropFKTriggers($table, $name, $definition['references']['table']);

            if (PEAR::isError($result)) {

                return $result;

            }

            //then drop the constraint itself

            $table = $db->quoteIdentifier($table, true);

            $name = $db->quoteIdentifier($db->getIndexName($name), true);

            $query = "ALTER TABLE $table DROP FOREIGN KEY $name";

            return $db->exec($query);

        }



        $table = $db->quoteIdentifier($table, true);

        if ($primary || strtolower($name) == 'primary') {

            $query = "ALTER TABLE $table DROP PRIMARY KEY";

        } else {

            $name = $db->quoteIdentifier($db->getIndexName($name), true);

            $query = "ALTER TABLE $table DROP INDEX $name";

        }

        $name = $db->quoteIdentifier($db->getIndexName($name), true);

        $query = "ALTER TABLE $table DROP INDEX $name";

        return $db->exec($query);

    }



    // }}}

    // {{{ _createFKTriggers()



    /**

     * Create triggers to enforce the FOREIGN KEY constraint on the table

     *

     * NB: since there's no RAISE_APPLICATION_ERROR facility in mysql,

     * we call a non-existent procedure to raise the FK violation message.

     * @see http://forums.mysql.com/read.php?99,55108,71877#msg-71877

     *

     * @param string $table        table name

     * @param array  $foreign_keys FOREIGN KEY definitions

     *

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access private

     */

    function _createFKTriggers($table, $foreign_keys)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }

        // create triggers to enforce FOREIGN KEY constraints

        if ($db->supports('triggers') && !empty($foreign_keys)) {

            $table = $db->quoteIdentifier($table, true);

            foreach ($foreign_keys as $fkname => $fkdef) {

                if (empty($fkdef)) {

                    continue;

                }

                //set actions to 'RESTRICT' if not set

                $fkdef['onupdate'] = empty($fkdef['onupdate']) ? 'RESTRICT' : strtoupper($fkdef['onupdate']);

                $fkdef['ondelete'] = empty($fkdef['ondelete']) ? 'RESTRICT' : strtoupper($fkdef['ondelete']);



                $trigger_names = array(

                    'insert'    => $fkname.'_insert_trg',

                    'update'    => $fkname.'_update_trg',

                    'pk_update' => $fkname.'_pk_update_trg',

                    'pk_delete' => $fkname.'_pk_delete_trg',

                );

                $table_fields = array_keys($fkdef['fields']);

                $referenced_fields = array_keys($fkdef['references']['fields']);



                //create the ON [UPDATE|DELETE] triggers on the primary table

                $restrict_action = ' IF (SELECT ';

                $aliased_fields = array();

                foreach ($table_fields as $field) {

                    $aliased_fields[] = $table .'.'.$field .' AS '.$field;

                }

                $restrict_action .= implode(',', $aliased_fields)

                       .' FROM '.$table

                       .' WHERE ';

                $conditions  = array();

                $new_values  = array();

                $null_values = array();

                for ($i=0; $i<count($table_fields); $i++) {

                    $conditions[]  = $table_fields[$i] .' = OLD.'.$referenced_fields[$i];

                    $new_values[]  = $table_fields[$i] .' = NEW.'.$referenced_fields[$i];

                    $null_values[] = $table_fields[$i] .' = NULL';

                }

                $restrict_action .= implode(' AND ', $conditions).') IS NOT NULL'

                                .' THEN CALL %s_ON_TABLE_'.$table.'_VIOLATES_FOREIGN_KEY_CONSTRAINT();'

                                .' END IF;';



                $cascade_action_update = 'UPDATE '.$table.' SET '.implode(', ', $new_values) .' WHERE '.implode(' AND ', $conditions). ';';

                $cascade_action_delete = 'DELETE FROM '.$table.' WHERE '.implode(' AND ', $conditions). ';';

                $setnull_action        = 'UPDATE '.$table.' SET '.implode(', ', $null_values).' WHERE '.implode(' AND ', $conditions). ';';



                if ('SET DEFAULT' == $fkdef['onupdate'] || 'SET DEFAULT' == $fkdef['ondelete']) {

                    $db->loadModule('Reverse', null, true);

                    $default_values = array();

                    foreach ($table_fields as $table_field) {

                        $field_definition = $db->reverse->getTableFieldDefinition($table, $field);

                        if (PEAR::isError($field_definition)) {

                            return $field_definition;

                        }

                        $default_values[] = $table_field .' = '. $field_definition[0]['default'];

                    }

                    $setdefault_action = 'UPDATE '.$table.' SET '.implode(', ', $default_values).' WHERE '.implode(' AND ', $conditions). ';';

                }



                $query = 'CREATE TRIGGER %s'

                        .' %s ON '.$fkdef['references']['table']

                        .' FOR EACH ROW BEGIN '

                        .' SET FOREIGN_KEY_CHECKS = 0; ';  //only really needed for ON UPDATE CASCADE



                if ('CASCADE' == $fkdef['onupdate']) {

                    $sql_update = sprintf($query, $trigger_names['pk_update'], 'BEFORE UPDATE',  'update') . $cascade_action_update;

                } elseif ('SET NULL' == $fkdef['onupdate']) {

                    $sql_update = sprintf($query, $trigger_names['pk_update'], 'BEFORE UPDATE', 'update') . $setnull_action;

                } elseif ('SET DEFAULT' == $fkdef['onupdate']) {

                    $sql_update = sprintf($query, $trigger_names['pk_update'], 'BEFORE UPDATE', 'update') . $setdefault_action;

                } elseif ('NO ACTION' == $fkdef['onupdate']) {

                    $sql_update = sprintf($query.$restrict_action, $trigger_names['pk_update'], 'AFTER UPDATE', 'update');

                } else {

                    //'RESTRICT'

                    $sql_update = sprintf($query.$restrict_action, $trigger_names['pk_update'], 'BEFORE UPDATE', 'update');

                }

                if ('CASCADE' == $fkdef['ondelete']) {

                    $sql_delete = sprintf($query, $trigger_names['pk_delete'], 'BEFORE DELETE',  'delete') . $cascade_action_delete;

                } elseif ('SET NULL' == $fkdef['ondelete']) {

                    $sql_delete = sprintf($query, $trigger_names['pk_delete'], 'BEFORE DELETE', 'delete') . $setnull_action;

                } elseif ('SET DEFAULT' == $fkdef['ondelete']) {

                    $sql_delete = sprintf($query, $trigger_names['pk_delete'], 'BEFORE DELETE', 'delete') . $setdefault_action;

                } elseif ('NO ACTION' == $fkdef['ondelete']) {

                    $sql_delete = sprintf($query.$restrict_action, $trigger_names['pk_delete'], 'AFTER DELETE', 'delete');

                } else {

                    //'RESTRICT'

                    $sql_delete = sprintf($query.$restrict_action, $trigger_names['pk_delete'], 'BEFORE DELETE', 'delete');

                }

                $sql_update .= ' SET FOREIGN_KEY_CHECKS = 1; END;';

                $sql_delete .= ' SET FOREIGN_KEY_CHECKS = 1; END;';



                $db->pushErrorHandling(PEAR_ERROR_RETURN);

                $db->expectError(MDB2_ERROR_CANNOT_CREATE); 
                $result = $db->exec($sql_delete);

                $expected_errmsg = 'This MySQL version doesn\'t support multiple triggers with the same action time and event for one table';

                $db->popExpect();

                $db->popErrorHandling();

                if (PEAR::isError($result)) {

                    if ($result->getCode() != MDB2_ERROR_CANNOT_CREATE) {

                        return $result;

                    }

                    $db->warnings[] = $expected_errmsg;

                }

                $db->pushErrorHandling(PEAR_ERROR_RETURN);

                $db->expectError(MDB2_ERROR_CANNOT_CREATE);

                $result = $db->exec($sql_update);

                $db->popExpect();

                $db->popErrorHandling();

                if (PEAR::isError($result) && $result->getCode() != MDB2_ERROR_CANNOT_CREATE) {

                    if ($result->getCode() != MDB2_ERROR_CANNOT_CREATE) {

                        return $result;

                    }

                    $db->warnings[] = $expected_errmsg;

                }

            }

        }

        return MDB2_OK;

    }



    // }}}

    // {{{ _dropFKTriggers()



    /**

     * Drop the triggers created to enforce the FOREIGN KEY constraint on the table

     *

     * @param string $table            table name

     * @param string $fkname           FOREIGN KEY constraint name

     * @param string $referenced_table referenced table name

     *

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access private

     */

    function _dropFKTriggers($table, $fkname, $referenced_table)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $triggers  = $this->listTableTriggers($table);

        $triggers2 = $this->listTableTriggers($referenced_table);

        if (!PEAR::isError($triggers2) && !PEAR::isError($triggers)) {

            $triggers = array_merge($triggers, $triggers2);

            $pattern = '/^'.$fkname.'(_pk)?_(insert|update|delete)_trg$/i';

            foreach ($triggers as $trigger) {

                if (preg_match($pattern, $trigger)) {

                    $result = $db->exec('DROP TRIGGER '.$trigger);

                    if (PEAR::isError($result)) {

                        return $result;

                    }

                }

            }

        }

        return MDB2_OK;

    }



    // }}}

@@ -904,8 +1259,8 @@
        $query = 'SHOW CREATE TABLE '. $db->escape($table);

        $definition = $db->queryOne($query, 'text', 1);

        if (!PEAR::isError($definition) && !empty($definition)) {

            $pattern = '/\bCONSTRAINT\s+([^\s]+)\s+FOREIGN KEY\b/i';

            if (preg_match_all($pattern, str_replace('`', '', $definition), $matches) > 1) {

            $pattern = '/\bCONSTRAINT\b\s+([^\s]+)\s+\bFOREIGN KEY\b/Uims';

            if (preg_match_all($pattern, str_replace('`', '', $definition), $matches) > 0) {

                foreach ($matches[1] as $constraint) {

                    $result[$constraint] = true;

                }

@@ -967,10 +1322,6 @@
        }

        if ($type) {

            $options_strings[] = "ENGINE = $type";

        }



        if (!empty($options_strings)) {

            $query.= ' '.implode(' ', $options_strings);

        }



        $query = "CREATE TABLE $sequence_name ($seqcol_name INT NOT NULL AUTO_INCREMENT, PRIMARY KEY ($seqcol_name))";


 program/lib/MDB2/Driver/Manager/pgsql.php

@@ -1,765 +1,859 @@
<?php

// +----------------------------------------------------------------------+

// | PHP versions 4 and 5                                                 |

// +----------------------------------------------------------------------+

// | Copyright (c) 1998-2007 Manuel Lemos, Tomas V.V.Cox,                 |

// | Stig. S. Bakken, Lukas Smith                                         |

// | All rights reserved.                                                 |

// +----------------------------------------------------------------------+

// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |

// | API as well as database abstraction for PHP applications.            |

// | This LICENSE is in the BSD license style.                            |

// |                                                                      |

// | Redistribution and use in source and binary forms, with or without   |

// | modification, are permitted provided that the following conditions   |

// | are met:                                                             |

// |                                                                      |

// | Redistributions of source code must retain the above copyright       |

// | notice, this list of conditions and the following disclaimer.        |

// |                                                                      |

// | Redistributions in binary form must reproduce the above copyright    |

// | notice, this list of conditions and the following disclaimer in the  |

// | documentation and/or other materials provided with the distribution. |

// |                                                                      |

// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |

// | Lukas Smith nor the names of his contributors may be used to endorse |

// | or promote products derived from this software without specific prior|

// | written permission.                                                  |

// |                                                                      |

// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |

// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |

// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |

// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |

// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |

// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |

// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|

// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |

// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |

// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|

// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |

// | POSSIBILITY OF SUCH DAMAGE.                                          |

// +----------------------------------------------------------------------+

// | Author: Paul Cooper <pgc@ucecom.com>                                 |

// +----------------------------------------------------------------------+

//

// $Id: pgsql.php,v 1.74 2007/12/03 20:59:15 quipo Exp $



require_once 'MDB2/Driver/Manager/Common.php';



/**

 * MDB2 MySQL driver for the management modules

 *

 * @package MDB2

 * @category Database

 * @author  Paul Cooper <pgc@ucecom.com>

 */

class MDB2_Driver_Manager_pgsql extends MDB2_Driver_Manager_Common

{

    // {{{ createDatabase()



    /**

     * create a new database

     *

     * @param string $name    name of the database that should be created

     * @param array  $options array with charset info

     *

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function createDatabase($name, $options = array())

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $name  = $db->quoteIdentifier($name, true);

        $query = 'CREATE DATABASE ' . $name;

        if (!empty($options['charset'])) {

            $query .= ' WITH ENCODING ' . $db->quote($options['charset'], 'text');

        }

        return $db->standaloneQuery($query, null, true);

    }



    // }}}

    // {{{ dropDatabase()



    /**

     * drop an existing database

     *

     * @param string $name name of the database that should be dropped

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function dropDatabase($name)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $name = $db->quoteIdentifier($name, true);

        return $db->standaloneQuery("DROP DATABASE $name", null, true);

    }



    // }}}

    // {{{ _getAdvancedFKOptions()



    /**

     * Return the FOREIGN KEY query section dealing with non-standard options

     * as MATCH, INITIALLY DEFERRED, ON UPDATE, ...

     *

     * @param array $definition

     * @return string

     * @access protected

     */

    function _getAdvancedFKOptions($definition)

    {

        $query = '';

        if (!empty($definition['match'])) {

            $query .= ' MATCH '.$definition['match'];

        }

        if (!empty($definition['onupdate'])) {

            $query .= ' ON UPDATE '.$definition['onupdate'];

        }

        if (!empty($definition['ondelete'])) {

            $query .= ' ON DELETE '.$definition['ondelete'];

        }

        if (!empty($definition['deferrable'])) {

            $query .= ' DEFERRABLE';

        } else {

            $query .= ' NOT DEFERRABLE';

        }

        if (!empty($definition['initiallydeferred'])) {

            $query .= ' INITIALLY DEFERRED';

        } else {

            $query .= ' INITIALLY IMMEDIATE';

        }

        return $query;

    }



    // }}}

    // {{{ alterTable()



    /**

     * alter an existing table

     *

     * @param string $name         name of the table that is intended to be changed.

     * @param array $changes     associative array that contains the details of each type

     *                             of change that is intended to be performed. The types of

     *                             changes that are currently supported are defined as follows:

     *

     *                             name

     *

     *                                New name for the table.

     *

     *                            add

     *

     *                                Associative array with the names of fields to be added as

     *                                 indexes of the array. The value of each entry of the array

     *                                 should be set to another associative array with the properties

     *                                 of the fields to be added. The properties of the fields should

     *                                 be the same as defined by the MDB2 parser.

     *

     *

     *                            remove

     *

     *                                Associative array with the names of fields to be removed as indexes

     *                                 of the array. Currently the values assigned to each entry are ignored.

     *                                 An empty array should be used for future compatibility.

     *

     *                            rename

     *

     *                                Associative array with the names of fields to be renamed as indexes

     *                                 of the array. The value of each entry of the array should be set to

     *                                 another associative array with the entry named name with the new

     *                                 field name and the entry named Declaration that is expected to contain

     *                                 the portion of the field declaration already in DBMS specific SQL code

     *                                 as it is used in the CREATE TABLE statement.

     *

     *                            change

     *

     *                                Associative array with the names of the fields to be changed as indexes

     *                                 of the array. Keep in mind that if it is intended to change either the

     *                                 name of a field and any other properties, the change array entries

     *                                 should have the new names of the fields as array indexes.

     *

     *                                The value of each entry of the array should be set to another associative

     *                                 array with the properties of the fields to that are meant to be changed as

     *                                 array entries. These entries should be assigned to the new values of the

     *                                 respective properties. The properties of the fields should be the same

     *                                 as defined by the MDB2 parser.

     *

     *                            Example

     *                                array(

     *                                    'name' => 'userlist',

     *                                    'add' => array(

     *                                        'quota' => array(

     *                                            'type' => 'integer',

     *                                            'unsigned' => 1

     *                                        )

     *                                    ),

     *                                    'remove' => array(

     *                                        'file_limit' => array(),

     *                                        'time_limit' => array()

     *                                    ),

     *                                    'change' => array(

     *                                        'name' => array(

     *                                            'length' => '20',

     *                                            'definition' => array(

     *                                                'type' => 'text',

     *                                                'length' => 20,

     *                                            ),

     *                                        )

     *                                    ),

     *                                    'rename' => array(

     *                                        'sex' => array(

     *                                            'name' => 'gender',

     *                                            'definition' => array(

     *                                                'type' => 'text',

     *                                                'length' => 1,

     *                                                'default' => 'M',

     *                                            ),

     *                                        )

     *                                    )

     *                                )

     *

     * @param boolean $check     indicates whether the function should just check if the DBMS driver

     *                             can perform the requested table alterations if the value is true or

     *                             actually perform them otherwise.

     * @access public

     *

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     */

    function alterTable($name, $changes, $check)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        foreach ($changes as $change_name => $change) {

            switch ($change_name) {

            case 'add':

            case 'remove':

            case 'change':

            case 'name':

            case 'rename':

                break;

            default:

                return $db->raiseError(MDB2_ERROR_CANNOT_ALTER, null, null,

                    'change type "'.$change_name.'\" not yet supported', __FUNCTION__);

            }

        }



        if ($check) {

            return MDB2_OK;

        }



        if (!empty($changes['add']) && is_array($changes['add'])) {

            foreach ($changes['add'] as $field_name => $field) {

                $query = 'ADD ' . $db->getDeclaration($field['type'], $field_name, $field);

                $result = $db->exec("ALTER TABLE $name $query");

                if (PEAR::isError($result)) {

                    return $result;

                }

            }

        }



        if (!empty($changes['remove']) && is_array($changes['remove'])) {

            foreach ($changes['remove'] as $field_name => $field) {

                $field_name = $db->quoteIdentifier($field_name, true);

                $query = 'DROP ' . $field_name;

                $result = $db->exec("ALTER TABLE $name $query");

                if (PEAR::isError($result)) {

                    return $result;

                }

            }

        }



        if (!empty($changes['change']) && is_array($changes['change'])) {

            foreach ($changes['change'] as $field_name => $field) {

                $field_name = $db->quoteIdentifier($field_name, true);

                if (!empty($field['definition']['type'])) {

                    $server_info = $db->getServerVersion();

                    if (PEAR::isError($server_info)) {

                        return $server_info;

                    }

                    if (is_array($server_info) && $server_info['major'] < 8) {

                        return $db->raiseError(MDB2_ERROR_CANNOT_ALTER, null, null,

                            'changing column type for "'.$change_name.'\" requires PostgreSQL 8.0 or above', __FUNCTION__);

                    }

                    $db->loadModule('Datatype', null, true);

                    $query = "ALTER $field_name TYPE ".$db->datatype->getTypeDeclaration($field['definition']);

                    $result = $db->exec("ALTER TABLE $name $query");

                    if (PEAR::isError($result)) {

                        return $result;

                    }

                }

                if (array_key_exists('default', $field['definition'])) {

                    $query = "ALTER $field_name SET DEFAULT ".$db->quote($field['definition']['default'], $field['definition']['type']);

                    $result = $db->exec("ALTER TABLE $name $query");

                    if (PEAR::isError($result)) {

                        return $result;

                    }

                }

                if (!empty($field['definition']['notnull'])) {

                    $query = "ALTER $field_name ".($field['definition']['notnull'] ? 'SET' : 'DROP').' NOT NULL';

                    $result = $db->exec("ALTER TABLE $name $query");

                    if (PEAR::isError($result)) {

                        return $result;

                    }

                }

            }

        }



        if (!empty($changes['rename']) && is_array($changes['rename'])) {

            foreach ($changes['rename'] as $field_name => $field) {

                $field_name = $db->quoteIdentifier($field_name, true);

                $result = $db->exec("ALTER TABLE $name RENAME COLUMN $field_name TO ".$db->quoteIdentifier($field['name'], true));

                if (PEAR::isError($result)) {

                    return $result;

                }

            }

        }



        $name = $db->quoteIdentifier($name, true);

        if (!empty($changes['name'])) {

            $change_name = $db->quoteIdentifier($changes['name'], true);

            $result = $db->exec("ALTER TABLE $name RENAME TO ".$change_name);

            if (PEAR::isError($result)) {

                return $result;

            }

        }



        return MDB2_OK;

    }



    // }}}

    // {{{ listDatabases()



    /**

     * list all databases

     *

     * @return mixed array of database names on success, a MDB2 error on failure

     * @access public

     */

    function listDatabases()

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $query = 'SELECT datname FROM pg_database';

        $result2 = $db->standaloneQuery($query, array('text'), false);

        if (!MDB2::isResultCommon($result2)) {

            return $result2;

        }



        $result = $result2->fetchCol();

        $result2->free();

        if (PEAR::isError($result)) {

            return $result;

        }

        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {

            $result = array_map(($db->options['field_case'] == CASE_LOWER ? 'strtolower' : 'strtoupper'), $result);

        }

        return $result;

    }



    // }}}

    // {{{ listUsers()



    /**

     * list all users

     *

     * @return mixed array of user names on success, a MDB2 error on failure

     * @access public

     */

    function listUsers()

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $query = 'SELECT usename FROM pg_user';

        $result2 = $db->standaloneQuery($query, array('text'), false);

        if (!MDB2::isResultCommon($result2)) {

            return $result2;

        }



        $result = $result2->fetchCol();

        $result2->free();

        return $result;

    }



    // }}}

    // {{{ listViews()



    /**

     * list all views in the current database

     *

     * @return mixed array of view names on success, a MDB2 error on failure

     * @access public

     */

    function listViews()

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $query = "SELECT viewname

                    FROM pg_views

                   WHERE schemaname NOT IN ('pg_catalog', 'information_schema')

                     AND viewname !~ '^pg_'";

        $result = $db->queryCol($query);

        if (PEAR::isError($result)) {

            return $result;

        }

        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {

            $result = array_map(($db->options['field_case'] == CASE_LOWER ? 'strtolower' : 'strtoupper'), $result);

        }

        return $result;

    }



    // }}}

    // {{{ listTableViews()



    /**

     * list the views in the database that reference a given table

     *

     * @param string table for which all referenced views should be found

     * @return mixed array of view names on success, a MDB2 error on failure

     * @access public

     */

    function listTableViews($table)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $query = 'SELECT viewname FROM pg_views NATURAL JOIN pg_tables';

        $query.= ' WHERE tablename ='.$db->quote($table, 'text');

        $result = $db->queryCol($query);

        if (PEAR::isError($result)) {

            return $result;

        }

        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {

            $result = array_map(($db->options['field_case'] == CASE_LOWER ? 'strtolower' : 'strtoupper'), $result);

        }

        return $result;

    }



    // }}}

    // {{{ listFunctions()



    /**

     * list all functions in the current database

     *

     * @return mixed array of function names on success, a MDB2 error on failure

     * @access public

     */

    function listFunctions()

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $query = "

            SELECT

                proname

            FROM

                pg_proc pr,

                pg_type tp

            WHERE

                tp.oid = pr.prorettype

                AND pr.proisagg = FALSE

                AND tp.typname <> 'trigger'

                AND pr.pronamespace IN

                    (SELECT oid FROM pg_namespace WHERE nspname NOT LIKE 'pg_%' AND nspname != 'information_schema')";

        $result = $db->queryCol($query);

        if (PEAR::isError($result)) {

            return $result;

        }

        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {

            $result = array_map(($db->options['field_case'] == CASE_LOWER ? 'strtolower' : 'strtoupper'), $result);

        }

        return $result;

    }



    // }}}

    // {{{ listTableTriggers()



    /**

     * list all triggers in the database that reference a given table

     *

     * @param string table for which all referenced triggers should be found

     * @return mixed array of trigger names on success, a MDB2 error on failure

     * @access public

     */

    function listTableTriggers($table = null)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $query = 'SELECT trg.tgname AS trigger_name

                    FROM pg_trigger trg,

                         pg_class tbl

                   WHERE trg.tgrelid = tbl.oid';

        if (!is_null($table)) {

            $table = $db->quote(strtoupper($table), 'text');

            $query .= " AND tbl.relname = $table";

        }

        $result = $db->queryCol($query);

        if (PEAR::isError($result)) {

            return $result;

        }

        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {

            $result = array_map(($db->options['field_case'] == CASE_LOWER ? 'strtolower' : 'strtoupper'), $result);

        }

        return $result;

    }



    // }}}

    // {{{ listTables()



    /**

     * list all tables in the current database

     *

     * @return mixed array of table names on success, a MDB2 error on failure

     * @access public

     */

    function listTables()

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        // gratuitously stolen from PEAR DB _getSpecialQuery in pgsql.php

        $query = 'SELECT c.relname AS "Name"'

            . ' FROM pg_class c, pg_user u'

            . ' WHERE c.relowner = u.usesysid'

            . " AND c.relkind = 'r'"

            . ' AND NOT EXISTS'

            . ' (SELECT 1 FROM pg_views'

            . '  WHERE viewname = c.relname)'

            . " AND c.relname !~ '^(pg_|sql_)'"

            . ' UNION'

            . ' SELECT c.relname AS "Name"'

            . ' FROM pg_class c'

            . " WHERE c.relkind = 'r'"

            . ' AND NOT EXISTS'

            . ' (SELECT 1 FROM pg_views'

            . '  WHERE viewname = c.relname)'

            . ' AND NOT EXISTS'

            . ' (SELECT 1 FROM pg_user'

            . '  WHERE usesysid = c.relowner)'

            . " AND c.relname !~ '^pg_'";

        $result = $db->queryCol($query);

        if (PEAR::isError($result)) {

            return $result;

        }

        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {

            $result = array_map(($db->options['field_case'] == CASE_LOWER ? 'strtolower' : 'strtoupper'), $result);

        }

        return $result;

    }



    // }}}

    // {{{ listTableFields()



    /**

     * list all fields in a table in the current database

     *

     * @param string $table name of table that should be used in method

     * @return mixed array of field names on success, a MDB2 error on failure

     * @access public

     */

    function listTableFields($table)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $table = $db->quoteIdentifier($table, true);

        $db->setLimit(1);

        $result2 = $db->query("SELECT * FROM $table");

        if (PEAR::isError($result2)) {

            return $result2;

        }

        $result = $result2->getColumnNames();

        $result2->free();

        if (PEAR::isError($result)) {

            return $result;

        }

        return array_flip($result);

    }



    // }}}

    // {{{ listTableIndexes()



    /**

     * list all indexes in a table

     *

     * @param string $table name of table that should be used in method

     * @return mixed array of index names on success, a MDB2 error on failure

     * @access public

     */

    function listTableIndexes($table)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $table = $db->quote($table, 'text');

        $subquery = "SELECT indexrelid FROM pg_index, pg_class";

        $subquery.= " WHERE pg_class.relname=$table AND pg_class.oid=pg_index.indrelid AND indisunique != 't' AND indisprimary != 't'";

        $query = "SELECT relname FROM pg_class WHERE oid IN ($subquery)";

        $indexes = $db->queryCol($query, 'text');

        if (PEAR::isError($indexes)) {

            return $indexes;

        }



        $result = array();

        foreach ($indexes as $index) {

            $index = $this->_fixIndexName($index);

            if (!empty($index)) {

                $result[$index] = true;

            }

        }



        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {

            $result = array_change_key_case($result, $db->options['field_case']);

        }

        return array_keys($result);

    }



    // }}}

    // {{{ listTableConstraints()



    /**

     * list all constraints in a table

     *

     * @param string $table name of table that should be used in method

     * @return mixed array of constraint names on success, a MDB2 error on failure

     * @access public

     */

    function listTableConstraints($table)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $table = $db->quote($table, 'text');

        $subquery = "SELECT indexrelid FROM pg_index, pg_class";

        $subquery.= " WHERE pg_class.relname=$table AND pg_class.oid=pg_index.indrelid AND (indisunique = 't' OR indisprimary = 't')";

        $query = "SELECT relname FROM pg_class WHERE oid IN ($subquery)";

        $constraints = $db->queryCol($query);

        if (PEAR::isError($constraints)) {

            return $constraints;

        }



        $result = array();

        foreach ($constraints as $constraint) {

            $constraint = $this->_fixIndexName($constraint);

            if (!empty($constraint)) {

                $result[$constraint] = true;

            }

        }



        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE

            && $db->options['field_case'] == CASE_LOWER

        ) {

            $result = array_change_key_case($result, $db->options['field_case']);

        }

        return array_keys($result);

    }



    // }}}

    // {{{ createSequence()



    /**

     * create sequence

     *

     * @param string $seq_name name of the sequence to be created

     * @param string $start start value of the sequence; default is 1

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function createSequence($seq_name, $start = 1)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $sequence_name = $db->quoteIdentifier($db->getSequenceName($seq_name), true);

        return $db->exec("CREATE SEQUENCE $sequence_name INCREMENT 1".

            ($start < 1 ? " MINVALUE $start" : '')." START $start");

    }



    // }}}

    // {{{ dropSequence()



    /**

     * drop existing sequence

     *

     * @param string $seq_name name of the sequence to be dropped

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function dropSequence($seq_name)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $sequence_name = $db->quoteIdentifier($db->getSequenceName($seq_name), true);

        return $db->exec("DROP SEQUENCE $sequence_name");

    }



    // }}}

    // {{{ listSequences()



    /**

     * list all sequences in the current database

     *

     * @return mixed array of sequence names on success, a MDB2 error on failure

     * @access public

     */

    function listSequences()

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $query = "SELECT relname FROM pg_class WHERE relkind = 'S' AND relnamespace IN";

        $query.= "(SELECT oid FROM pg_namespace WHERE nspname NOT LIKE 'pg_%' AND nspname != 'information_schema')";

        $table_names = $db->queryCol($query);

        if (PEAR::isError($table_names)) {

            return $table_names;

        }

        $result = array();

        foreach ($table_names as $table_name) {

            $result[] = $this->_fixSequenceName($table_name);

        }

        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {

            $result = array_map(($db->options['field_case'] == CASE_LOWER ? 'strtolower' : 'strtoupper'), $result);

        }

        return $result;

    }

}

<?php
// +----------------------------------------------------------------------+
// | PHP versions 4 and 5                                                 |
// +----------------------------------------------------------------------+
// | Copyright (c) 1998-2008 Manuel Lemos, Tomas V.V.Cox,                 |
// | Stig. S. Bakken, Lukas Smith                                         |
// | All rights reserved.                                                 |
// +----------------------------------------------------------------------+
// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |
// | API as well as database abstraction for PHP applications.            |
// | This LICENSE is in the BSD license style.                            |
// |                                                                      |
// | Redistribution and use in source and binary forms, with or without   |
// | modification, are permitted provided that the following conditions   |
// | are met:                                                             |
// |                                                                      |
// | Redistributions of source code must retain the above copyright       |
// | notice, this list of conditions and the following disclaimer.        |
// |                                                                      |
// | Redistributions in binary form must reproduce the above copyright    |
// | notice, this list of conditions and the following disclaimer in the  |
// | documentation and/or other materials provided with the distribution. |
// |                                                                      |
// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |
// | Lukas Smith nor the names of his contributors may be used to endorse |
// | or promote products derived from this software without specific prior|
// | written permission.                                                  |
// |                                                                      |
// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |
// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |
// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |
// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |
// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |
// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |
// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|
// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |
// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |
// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|
// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |
// | POSSIBILITY OF SUCH DAMAGE.                                          |
// +----------------------------------------------------------------------+
// | Author: Paul Cooper <pgc@ucecom.com>                                 |
// +----------------------------------------------------------------------+
//
// $Id: pgsql.php,v 1.82 2008/03/05 12:55:57 afz Exp $

require_once 'MDB2/Driver/Manager/Common.php';

/**
 * MDB2 MySQL driver for the management modules
 *
 * @package MDB2
 * @category Database
 * @author  Paul Cooper <pgc@ucecom.com>
 */
class MDB2_Driver_Manager_pgsql extends MDB2_Driver_Manager_Common
{
    // {{{ createDatabase()

    /**
     * create a new database
     *
     * @param string $name    name of the database that should be created
     * @param array  $options array with charset info
     *
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function createDatabase($name, $options = array())
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $name  = $db->quoteIdentifier($name, true);
        $query = 'CREATE DATABASE ' . $name;
        if (!empty($options['charset'])) {
            $query .= ' WITH ENCODING ' . $db->quote($options['charset'], 'text');
        }
        return $db->standaloneQuery($query, null, true);
    }

    // }}}
    // {{{ alterDatabase()

    /**
     * alter an existing database
     *
     * @param string $name    name of the database that is intended to be changed
     * @param array  $options array with name, owner info
     *
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function alterDatabase($name, $options = array())
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $query = 'ALTER DATABASE '. $db->quoteIdentifier($name, true);
        if (!empty($options['name'])) {
            $query .= ' RENAME TO ' . $options['name'];
        }
        if (!empty($options['owner'])) {
            $query .= ' OWNER TO ' . $options['owner'];
        }
        return $db->standaloneQuery($query, null, true);
    }

    // }}}
    // {{{ dropDatabase()

    /**
     * drop an existing database
     *
     * @param string $name name of the database that should be dropped
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function dropDatabase($name)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $name = $db->quoteIdentifier($name, true);
        $query = "DROP DATABASE $name";
        return $db->standaloneQuery($query, null, true);
    }

    // }}}
    // {{{ _getAdvancedFKOptions()

    /**
     * Return the FOREIGN KEY query section dealing with non-standard options
     * as MATCH, INITIALLY DEFERRED, ON UPDATE, ...
     *
     * @param array $definition
     * @return string
     * @access protected
     */
    function _getAdvancedFKOptions($definition)
    {
        $query = '';
        if (!empty($definition['match'])) {
            $query .= ' MATCH '.$definition['match'];
        }
        if (!empty($definition['onupdate'])) {
            $query .= ' ON UPDATE '.$definition['onupdate'];
        }
        if (!empty($definition['ondelete'])) {
            $query .= ' ON DELETE '.$definition['ondelete'];
        }
        if (!empty($definition['deferrable'])) {
            $query .= ' DEFERRABLE';
        } else {
            $query .= ' NOT DEFERRABLE';
        }
        if (!empty($definition['initiallydeferred'])) {
            $query .= ' INITIALLY DEFERRED';
        } else {
            $query .= ' INITIALLY IMMEDIATE';
        }
        return $query;
    }

    // }}}
    // {{{ truncateTable()

    /**
     * Truncate an existing table (if the TRUNCATE TABLE syntax is not supported,
     * it falls back to a DELETE FROM TABLE query)
     *
     * @param string $name name of the table that should be truncated
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function truncateTable($name)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $name = $db->quoteIdentifier($name, true);
        return $db->exec("TRUNCATE TABLE $name");
    }

    // }}}
    // {{{ vacuum()

    /**
     * Optimize (vacuum) all the tables in the db (or only the specified table)
     * and optionally run ANALYZE.
     *
     * @param string $table table name (all the tables if empty)
     * @param array  $options an array with driver-specific options:
     *               - timeout [int] (in seconds) [mssql-only]
     *               - analyze [boolean] [pgsql and mysql]
     *               - full [boolean] [pgsql-only]
     *               - freeze [boolean] [pgsql-only]
     *
     * @return mixed MDB2_OK success, a MDB2 error on failure
     * @access public
     */
    function vacuum($table = null, $options = array())
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }
        $query = 'VACUUM';

        if (!empty($options['full'])) {
            $query .= ' FULL';
        }
        if (!empty($options['freeze'])) {
            $query .= ' FREEZE';
        }
        if (!empty($options['analyze'])) {
            $query .= ' ANALYZE';
        }

        if (!empty($table)) {
            $query .= ' '.$db->quoteIdentifier($table, true);
        }
        return $db->exec($query);
    }

    // }}}
    // {{{ alterTable()

    /**
     * alter an existing table
     *
     * @param string $name         name of the table that is intended to be changed.
     * @param array $changes     associative array that contains the details of each type
     *                             of change that is intended to be performed. The types of
     *                             changes that are currently supported are defined as follows:
     *
     *                             name
     *
     *                                New name for the table.
     *
     *                            add
     *
     *                                Associative array with the names of fields to be added as
     *                                 indexes of the array. The value of each entry of the array
     *                                 should be set to another associative array with the properties
     *                                 of the fields to be added. The properties of the fields should
     *                                 be the same as defined by the MDB2 parser.
     *
     *
     *                            remove
     *
     *                                Associative array with the names of fields to be removed as indexes
     *                                 of the array. Currently the values assigned to each entry are ignored.
     *                                 An empty array should be used for future compatibility.
     *
     *                            rename
     *
     *                                Associative array with the names of fields to be renamed as indexes
     *                                 of the array. The value of each entry of the array should be set to
     *                                 another associative array with the entry named name with the new
     *                                 field name and the entry named Declaration that is expected to contain
     *                                 the portion of the field declaration already in DBMS specific SQL code
     *                                 as it is used in the CREATE TABLE statement.
     *
     *                            change
     *
     *                                Associative array with the names of the fields to be changed as indexes
     *                                 of the array. Keep in mind that if it is intended to change either the
     *                                 name of a field and any other properties, the change array entries
     *                                 should have the new names of the fields as array indexes.
     *
     *                                The value of each entry of the array should be set to another associative
     *                                 array with the properties of the fields to that are meant to be changed as
     *                                 array entries. These entries should be assigned to the new values of the
     *                                 respective properties. The properties of the fields should be the same
     *                                 as defined by the MDB2 parser.
     *
     *                            Example
     *                                array(
     *                                    'name' => 'userlist',
     *                                    'add' => array(
     *                                        'quota' => array(
     *                                            'type' => 'integer',
     *                                            'unsigned' => 1
     *                                        )
     *                                    ),
     *                                    'remove' => array(
     *                                        'file_limit' => array(),
     *                                        'time_limit' => array()
     *                                    ),
     *                                    'change' => array(
     *                                        'name' => array(
     *                                            'length' => '20',
     *                                            'definition' => array(
     *                                                'type' => 'text',
     *                                                'length' => 20,
     *                                            ),
     *                                        )
     *                                    ),
     *                                    'rename' => array(
     *                                        'sex' => array(
     *                                            'name' => 'gender',
     *                                            'definition' => array(
     *                                                'type' => 'text',
     *                                                'length' => 1,
     *                                                'default' => 'M',
     *                                            ),
     *                                        )
     *                                    )
     *                                )
     *
     * @param boolean $check     indicates whether the function should just check if the DBMS driver
     *                             can perform the requested table alterations if the value is true or
     *                             actually perform them otherwise.
     * @access public
     *
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     */
    function alterTable($name, $changes, $check)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        foreach ($changes as $change_name => $change) {
            switch ($change_name) {
            case 'add':
            case 'remove':
            case 'change':
            case 'name':
            case 'rename':
                break;
            default:
                return $db->raiseError(MDB2_ERROR_CANNOT_ALTER, null, null,
                    'change type "'.$change_name.'\" not yet supported', __FUNCTION__);
            }
        }

        if ($check) {
            return MDB2_OK;
        }

        if (!empty($changes['remove']) && is_array($changes['remove'])) {
            foreach ($changes['remove'] as $field_name => $field) {
                $field_name = $db->quoteIdentifier($field_name, true);
                $query = 'DROP ' . $field_name;
                $result = $db->exec("ALTER TABLE $name $query");
                if (PEAR::isError($result)) {
                    return $result;
                }
            }
        }

        if (!empty($changes['rename']) && is_array($changes['rename'])) {
            foreach ($changes['rename'] as $field_name => $field) {
                $field_name = $db->quoteIdentifier($field_name, true);
                $result = $db->exec("ALTER TABLE $name RENAME COLUMN $field_name TO ".$db->quoteIdentifier($field['name'], true));
                if (PEAR::isError($result)) {
                    return $result;
                }
            }
        }

        if (!empty($changes['add']) && is_array($changes['add'])) {
            foreach ($changes['add'] as $field_name => $field) {
                $query = 'ADD ' . $db->getDeclaration($field['type'], $field_name, $field);
                $result = $db->exec("ALTER TABLE $name $query");
                if (PEAR::isError($result)) {
                    return $result;
                }
            }
        }

        if (!empty($changes['change']) && is_array($changes['change'])) {
            foreach ($changes['change'] as $field_name => $field) {
                $field_name = $db->quoteIdentifier($field_name, true);
                if (!empty($field['definition']['type'])) {
                    $server_info = $db->getServerVersion();
                    if (PEAR::isError($server_info)) {
                        return $server_info;
                    }
                    if (is_array($server_info) && $server_info['major'] < 8) {
                        return $db->raiseError(MDB2_ERROR_CANNOT_ALTER, null, null,
                            'changing column type for "'.$change_name.'\" requires PostgreSQL 8.0 or above', __FUNCTION__);
                    }
                    $db->loadModule('Datatype', null, true);
                    $query = "ALTER $field_name TYPE ".$db->datatype->getTypeDeclaration($field['definition']);
                    $result = $db->exec("ALTER TABLE $name $query");
                    if (PEAR::isError($result)) {
                        return $result;
                    }
                }
                if (array_key_exists('default', $field['definition'])) {
                    $query = "ALTER $field_name SET DEFAULT ".$db->quote($field['definition']['default'], $field['definition']['type']);
                    $result = $db->exec("ALTER TABLE $name $query");
                    if (PEAR::isError($result)) {
                        return $result;
                    }
                }
                if (!empty($field['definition']['notnull'])) {
                    $query = "ALTER $field_name ".($field['definition']['notnull'] ? 'SET' : 'DROP').' NOT NULL';
                    $result = $db->exec("ALTER TABLE $name $query");
                    if (PEAR::isError($result)) {
                        return $result;
                    }
                }
            }
        }

        $name = $db->quoteIdentifier($name, true);
        if (!empty($changes['name'])) {
            $change_name = $db->quoteIdentifier($changes['name'], true);
            $result = $db->exec("ALTER TABLE $name RENAME TO ".$change_name);
            if (PEAR::isError($result)) {
                return $result;
            }
        }

        return MDB2_OK;
    }

    // }}}
    // {{{ listDatabases()

    /**
     * list all databases
     *
     * @return mixed array of database names on success, a MDB2 error on failure
     * @access public
     */
    function listDatabases()
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $query = 'SELECT datname FROM pg_database';
        $result2 = $db->standaloneQuery($query, array('text'), false);
        if (!MDB2::isResultCommon($result2)) {
            return $result2;
        }

        $result = $result2->fetchCol();
        $result2->free();
        if (PEAR::isError($result)) {
            return $result;
        }
        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {
            $result = array_map(($db->options['field_case'] == CASE_LOWER ? 'strtolower' : 'strtoupper'), $result);
        }
        return $result;
    }

    // }}}
    // {{{ listUsers()

    /**
     * list all users
     *
     * @return mixed array of user names on success, a MDB2 error on failure
     * @access public
     */
    function listUsers()
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $query = 'SELECT usename FROM pg_user';
        $result2 = $db->standaloneQuery($query, array('text'), false);
        if (!MDB2::isResultCommon($result2)) {
            return $result2;
        }

        $result = $result2->fetchCol();
        $result2->free();
        return $result;
    }

    // }}}
    // {{{ listViews()

    /**
     * list all views in the current database
     *
     * @return mixed array of view names on success, a MDB2 error on failure
     * @access public
     */
    function listViews()
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $query = "SELECT viewname
                    FROM pg_views
                   WHERE schemaname NOT IN ('pg_catalog', 'information_schema')
                     AND viewname !~ '^pg_'";
        $result = $db->queryCol($query);
        if (PEAR::isError($result)) {
            return $result;
        }
        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {
            $result = array_map(($db->options['field_case'] == CASE_LOWER ? 'strtolower' : 'strtoupper'), $result);
        }
        return $result;
    }

    // }}}
    // {{{ listTableViews()

    /**
     * list the views in the database that reference a given table
     *
     * @param string table for which all referenced views should be found
     * @return mixed array of view names on success, a MDB2 error on failure
     * @access public
     */
    function listTableViews($table)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $query = 'SELECT viewname FROM pg_views NATURAL JOIN pg_tables';
        $query.= ' WHERE tablename ='.$db->quote($table, 'text');
        $result = $db->queryCol($query);
        if (PEAR::isError($result)) {
            return $result;
        }
        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {
            $result = array_map(($db->options['field_case'] == CASE_LOWER ? 'strtolower' : 'strtoupper'), $result);
        }
        return $result;
    }

    // }}}
    // {{{ listFunctions()

    /**
     * list all functions in the current database
     *
     * @return mixed array of function names on success, a MDB2 error on failure
     * @access public
     */
    function listFunctions()
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $query = "
            SELECT
                proname
            FROM
                pg_proc pr,
                pg_type tp
            WHERE
                tp.oid = pr.prorettype
                AND pr.proisagg = FALSE
                AND tp.typname <> 'trigger'
                AND pr.pronamespace IN
                    (SELECT oid FROM pg_namespace WHERE nspname NOT LIKE 'pg_%' AND nspname != 'information_schema')";
        $result = $db->queryCol($query);
        if (PEAR::isError($result)) {
            return $result;
        }
        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {
            $result = array_map(($db->options['field_case'] == CASE_LOWER ? 'strtolower' : 'strtoupper'), $result);
        }
        return $result;
    }

    // }}}
    // {{{ listTableTriggers()

    /**
     * list all triggers in the database that reference a given table
     *
     * @param string table for which all referenced triggers should be found
     * @return mixed array of trigger names on success, a MDB2 error on failure
     * @access public
     */
    function listTableTriggers($table = null)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $query = 'SELECT trg.tgname AS trigger_name
                    FROM pg_trigger trg,
                         pg_class tbl
                   WHERE trg.tgrelid = tbl.oid';
        if (!is_null($table)) {
            $table = $db->quote(strtoupper($table), 'text');
            $query .= " AND tbl.relname = $table";
        }
        $result = $db->queryCol($query);
        if (PEAR::isError($result)) {
            return $result;
        }
        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {
            $result = array_map(($db->options['field_case'] == CASE_LOWER ? 'strtolower' : 'strtoupper'), $result);
        }
        return $result;
    }

    // }}}
    // {{{ listTables()

    /**
     * list all tables in the current database
     *
     * @return mixed array of table names on success, a MDB2 error on failure
     * @access public
     */
    function listTables()
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        // gratuitously stolen from PEAR DB _getSpecialQuery in pgsql.php
        $query = 'SELECT c.relname AS "Name"'
            . ' FROM pg_class c, pg_user u'
            . ' WHERE c.relowner = u.usesysid'
            . " AND c.relkind = 'r'"
            . ' AND NOT EXISTS'
            . ' (SELECT 1 FROM pg_views'
            . '  WHERE viewname = c.relname)'
            . " AND c.relname !~ '^(pg_|sql_)'"
            . ' UNION'
            . ' SELECT c.relname AS "Name"'
            . ' FROM pg_class c'
            . " WHERE c.relkind = 'r'"
            . ' AND NOT EXISTS'
            . ' (SELECT 1 FROM pg_views'
            . '  WHERE viewname = c.relname)'
            . ' AND NOT EXISTS'
            . ' (SELECT 1 FROM pg_user'
            . '  WHERE usesysid = c.relowner)'
            . " AND c.relname !~ '^pg_'";
        $result = $db->queryCol($query);
        if (PEAR::isError($result)) {
            return $result;
        }
        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {
            $result = array_map(($db->options['field_case'] == CASE_LOWER ? 'strtolower' : 'strtoupper'), $result);
        }
        return $result;
    }

    // }}}
    // {{{ listTableFields()

    /**
     * list all fields in a table in the current database
     *
     * @param string $table name of table that should be used in method
     * @return mixed array of field names on success, a MDB2 error on failure
     * @access public
     */
    function listTableFields($table)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $table = $db->quoteIdentifier($table, true);
        $db->setLimit(1);
        $result2 = $db->query("SELECT * FROM $table");
        if (PEAR::isError($result2)) {
            return $result2;
        }
        $result = $result2->getColumnNames();
        $result2->free();
        if (PEAR::isError($result)) {
            return $result;
        }
        return array_flip($result);
    }

    // }}}
    // {{{ listTableIndexes()

    /**
     * list all indexes in a table
     *
     * @param string $table name of table that should be used in method
     * @return mixed array of index names on success, a MDB2 error on failure
     * @access public
     */
    function listTableIndexes($table)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $table = $db->quote($table, 'text');
        $subquery = "SELECT indexrelid FROM pg_index, pg_class";
        $subquery.= " WHERE pg_class.relname=$table AND pg_class.oid=pg_index.indrelid AND indisunique != 't' AND indisprimary != 't'";
        $query = "SELECT relname FROM pg_class WHERE oid IN ($subquery)";
        $indexes = $db->queryCol($query, 'text');
        if (PEAR::isError($indexes)) {
            return $indexes;
        }

        $result = array();
        foreach ($indexes as $index) {
            $index = $this->_fixIndexName($index);
            if (!empty($index)) {
                $result[$index] = true;
            }
        }

        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {
            $result = array_change_key_case($result, $db->options['field_case']);
        }
        return array_keys($result);
    }

    // }}}
    // {{{ listTableConstraints()

    /**
     * list all constraints in a table
     *
     * @param string $table name of table that should be used in method
     * @return mixed array of constraint names on success, a MDB2 error on failure
     * @access public
     */
    function listTableConstraints($table)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $table = $db->quote($table, 'text');
        $query = 'SELECT conname
                    FROM pg_constraint, pg_class
                   WHERE pg_constraint.conrelid = pg_class.oid
                     AND relname = ' .$table;
        $constraints = $db->queryCol($query);
        if (PEAR::isError($constraints)) {
            return $constraints;
        }

        $result = array();
        foreach ($constraints as $constraint) {
            $constraint = $this->_fixIndexName($constraint);
            if (!empty($constraint)) {
                $result[$constraint] = true;
            }
        }

        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE
            && $db->options['field_case'] == CASE_LOWER
        ) {
            $result = array_change_key_case($result, $db->options['field_case']);
        }
        return array_keys($result);
    }

    // }}}
    // {{{ createSequence()

    /**
     * create sequence
     *
     * @param string $seq_name name of the sequence to be created
     * @param string $start start value of the sequence; default is 1
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function createSequence($seq_name, $start = 1)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $sequence_name = $db->quoteIdentifier($db->getSequenceName($seq_name), true);
        return $db->exec("CREATE SEQUENCE $sequence_name INCREMENT 1".
            ($start < 1 ? " MINVALUE $start" : '')." START $start");
    }

    // }}}
    // {{{ dropSequence()

    /**
     * drop existing sequence
     *
     * @param string $seq_name name of the sequence to be dropped
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function dropSequence($seq_name)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $sequence_name = $db->quoteIdentifier($db->getSequenceName($seq_name), true);
        return $db->exec("DROP SEQUENCE $sequence_name");
    }

    // }}}
    // {{{ listSequences()

    /**
     * list all sequences in the current database
     *
     * @return mixed array of sequence names on success, a MDB2 error on failure
     * @access public
     */
    function listSequences()
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $query = "SELECT relname FROM pg_class WHERE relkind = 'S' AND relnamespace IN";
        $query.= "(SELECT oid FROM pg_namespace WHERE nspname NOT LIKE 'pg_%' AND nspname != 'information_schema')";
        $table_names = $db->queryCol($query);
        if (PEAR::isError($table_names)) {
            return $table_names;
        }
        $result = array();
        foreach ($table_names as $table_name) {
            $result[] = $this->_fixSequenceName($table_name);
        }
        if ($db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {
            $result = array_map(($db->options['field_case'] == CASE_LOWER ? 'strtolower' : 'strtoupper'), $result);
        }
        return $result;
    }
}
?>

 program/lib/MDB2/Driver/Manager/sqlite.php

@@ -2,7 +2,7 @@
// +----------------------------------------------------------------------+

// | PHP versions 4 and 5                                                 |

// +----------------------------------------------------------------------+

// | Copyright (c) 1998-2007 Manuel Lemos, Tomas V.V.Cox,                 |

// | Copyright (c) 1998-2008 Manuel Lemos, Tomas V.V.Cox,                 |

// | Stig. S. Bakken, Lukas Smith, Lorenzo Alberton                       |

// | All rights reserved.                                                 |

// +----------------------------------------------------------------------+

@@ -43,7 +43,7 @@
// |          Lorenzo Alberton <l.alberton@quipo.it>                      |

// +----------------------------------------------------------------------+

//

// $Id: sqlite.php,v 1.72 2007/12/03 20:59:15 quipo Exp $

// $Id: sqlite.php,v 1.74 2008/03/05 11:08:53 quipo Exp $

//



require_once 'MDB2/Driver/Manager/Common.php';

@@ -401,6 +401,37 @@


        $name = $db->quoteIdentifier($name, true);

        return $db->exec("DROP TABLE $name");

    }



    // }}}

    // {{{ vacuum()



    /**

     * Optimize (vacuum) all the tables in the db (or only the specified table)

     * and optionally run ANALYZE.

     *

     * @param string $table table name (all the tables if empty)

     * @param array  $options an array with driver-specific options:

     *               - timeout [int] (in seconds) [mssql-only]

     *               - analyze [boolean] [pgsql and mysql]

     *               - full [boolean] [pgsql-only]

     *               - freeze [boolean] [pgsql-only]

     *

     * @return mixed MDB2_OK success, a MDB2 error on failure

     * @access public

     */

    function vacuum($table = null, $options = array())

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $query = 'VACUUM';

        if (!empty($table)) {

            $query .= ' '.$db->quoteIdentifier($table, true);

        }

        return $db->exec($query);

    }



    // }}}

@@ -1207,7 +1238,7 @@
        if (PEAR::isError($table_def)) {

            return $table_def;

        }

        if (preg_match("/\bPRIMARY\s+KEY\b\s*\(([^)]+)/i", $table_def, $tmp)) {

        if (preg_match("/\bPRIMARY\s+KEY\b/i", $table_def, $tmp)) {

            $result['primary'] = true;

        }




 program/lib/MDB2/Driver/Reverse/Common.php

@@ -1,511 +1,513 @@
<?php
// +----------------------------------------------------------------------+
// | PHP versions 4 and 5                                                 |
// +----------------------------------------------------------------------+
// | Copyright (c) 1998-2007 Manuel Lemos, Tomas V.V.Cox,                 |
// | Stig. S. Bakken, Lukas Smith                                         |
// | All rights reserved.                                                 |
// +----------------------------------------------------------------------+
// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |
// | API as well as database abstraction for PHP applications.            |
// | This LICENSE is in the BSD license style.                            |
// |                                                                      |
// | Redistribution and use in source and binary forms, with or without   |
// | modification, are permitted provided that the following conditions   |
// | are met:                                                             |
// |                                                                      |
// | Redistributions of source code must retain the above copyright       |
// | notice, this list of conditions and the following disclaimer.        |
// |                                                                      |
// | Redistributions in binary form must reproduce the above copyright    |
// | notice, this list of conditions and the following disclaimer in the  |
// | documentation and/or other materials provided with the distribution. |
// |                                                                      |
// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |
// | Lukas Smith nor the names of his contributors may be used to endorse |
// | or promote products derived from this software without specific prior|
// | written permission.                                                  |
// |                                                                      |
// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |
// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |
// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |
// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |
// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |
// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |
// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|
// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |
// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |
// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|
// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |
// | POSSIBILITY OF SUCH DAMAGE.                                          |
// +----------------------------------------------------------------------+
// | Author: Lukas Smith <smith@pooteeweet.org>                           |
// +----------------------------------------------------------------------+
//
// $Id: Common.php,v 1.41 2007/09/09 13:47:36 quipo Exp $
//

/**
 * @package MDB2
 * @category Database
 */

/**
 * These are constants for the tableInfo-function
 * they are bitwised or'ed. so if there are more constants to be defined
 * in the future, adjust MDB2_TABLEINFO_FULL accordingly
 */

define('MDB2_TABLEINFO_ORDER',      1);
define('MDB2_TABLEINFO_ORDERTABLE', 2);
define('MDB2_TABLEINFO_FULL',       3);

/**
 * Base class for the schema reverse engineering module that is extended by each MDB2 driver
 *
 * To load this module in the MDB2 object:
 * $mdb->loadModule('Reverse');
 *
 * @package MDB2
 * @category Database
 * @author  Lukas Smith <smith@pooteeweet.org>
 */
class MDB2_Driver_Reverse_Common extends MDB2_Module_Common
{
    // {{{ splitTableSchema()

    /**
     * Split the "[owner|schema].table" notation into an array
     * @access private
     */
    function splitTableSchema($table)
    {
        $ret = array();
        if (strpos($table, '.') !== false) {
            return explode('.', $table);
        }
        return array(null, $table);
    }

    // }}}
    // {{{ getTableFieldDefinition()

    /**
     * Get the structure of a field into an array
     *
     * @param string    $table     name of table that should be used in method
     * @param string    $field     name of field that should be used in method
     * @return mixed data array on success, a MDB2 error on failure.
     *          The returned array contains an array for each field definition,
     *          with all or some of these indices, depending on the field data type:
     *          [notnull] [nativetype] [length] [fixed] [default] [type] [mdb2type]
     * @access public
     */
    function getTableFieldDefinition($table, $field)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
            'method not implemented', __FUNCTION__);
    }

    // }}}
    // {{{ getTableIndexDefinition()

    /**
     * Get the structure of an index into an array
     *
     * @param string    $table      name of table that should be used in method
     * @param string    $index      name of index that should be used in method
     * @return mixed data array on success, a MDB2 error on failure
     *          The returned array has this structure:
     *          </pre>
     *          array (
     *              [fields] => array (
     *                  [field1name] => array() // one entry per each field covered
     *                  [field2name] => array() // by the index
     *                  [field3name] => array(
     *                      [sorting] => ascending
     *                  )
     *              )
     *          );
     *          </pre>
     * @access public
     */
    function getTableIndexDefinition($table, $index)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
            'method not implemented', __FUNCTION__);
    }

    // }}}
    // {{{ getTableConstraintDefinition()

    /**
     * Get the structure of an constraints into an array
     *
     * @param string    $table      name of table that should be used in method
     * @param string    $index      name of index that should be used in method
     * @return mixed data array on success, a MDB2 error on failure
     *          The returned array has this structure:
     *          <pre>
     *          array (
     *              [primary] => 0
     *              [unique]  => 0
     *              [foreign] => 1
     *              [check]   => 0
     *              [fields] => array (
     *                  [field1name] => array() // one entry per each field covered
     *                  [field2name] => array() // by the index
     *                  [field3name] => array(
     *                      [sorting]  => ascending
     *                      [position] => 3
     *                  )
     *              )
     *              [references] => array(
     *                  [table] => name
     *                  [fields] => array(
     *                      [field1name] => array(  //one entry per each referenced field
     *                           [position] => 1
     *                      )
     *                  )
     *              )
     *              [deferrable] => 0
     *              [initiallydeferred] => 0
     *              [onupdate] => CASCADE|RESTRICT|SET NULL|SET DEFAULT|NO ACTION
     *              [ondelete] => CASCADE|RESTRICT|SET NULL|SET DEFAULT|NO ACTION
     *              [match] => SIMPLE|PARTIAL|FULL
     *          );
     *          </pre>
     * @access public
     */
    function getTableConstraintDefinition($table, $index)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
            'method not implemented', __FUNCTION__);
    }

    // }}}
    // {{{ getSequenceDefinition()

    /**
     * Get the structure of a sequence into an array
     *
     * @param string    $sequence   name of sequence that should be used in method
     * @return mixed data array on success, a MDB2 error on failure
     *          The returned array has this structure:
     *          <pre>
     *          array (
     *              [start] => n
     *          );
     *          </pre>
     * @access public
     */
    function getSequenceDefinition($sequence)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        $start = $db->currId($sequence);
        if (PEAR::isError($start)) {
            return $start;
        }
        if ($db->supports('current_id')) {
            $start++;
        } else {
            $db->warnings[] = 'database does not support getting current
                sequence value, the sequence value was incremented';
        }
        $definition = array();
        if ($start != 1) {
            $definition = array('start' => $start);
        }
        return $definition;
    }

    // }}}
    // {{{ getTriggerDefinition()

    /**
     * Get the structure of a trigger into an array
     *
     * EXPERIMENTAL
     *
     * WARNING: this function is experimental and may change the returned value 
     * at any time until labelled as non-experimental
     *
     * @param string    $trigger    name of trigger that should be used in method
     * @return mixed data array on success, a MDB2 error on failure
     *          The returned array has this structure:
     *          <pre>
     *          array (
     *              [trigger_name]    => 'trigger name',
     *              [table_name]      => 'table name',
     *              [trigger_body]    => 'trigger body definition',
     *              [trigger_type]    => 'BEFORE' | 'AFTER',
     *              [trigger_event]   => 'INSERT' | 'UPDATE' | 'DELETE'
     *                  //or comma separated list of multiple events, when supported
     *              [trigger_enabled] => true|false
     *              [trigger_comment] => 'trigger comment',
     *          );
     *          </pre>
     *          The oci8 driver also returns a [when_clause] index.
     * @access public
     */
    function getTriggerDefinition($trigger)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
            'method not implemented', __FUNCTION__);
    }

    // }}}
    // {{{ tableInfo()

    /**
     * Returns information about a table or a result set
     *
     * The format of the resulting array depends on which <var>$mode</var>
     * you select.  The sample output below is based on this query:
     * <pre>
     *    SELECT tblFoo.fldID, tblFoo.fldPhone, tblBar.fldId
     *    FROM tblFoo
     *    JOIN tblBar ON tblFoo.fldId = tblBar.fldId
     * </pre>
     *
     * <ul>
     * <li>
     *
     * <kbd>null</kbd> (default)
     *   <pre>
     *   [0] => Array (
     *       [table] => tblFoo
     *       [name] => fldId
     *       [type] => int
     *       [len] => 11
     *       [flags] => primary_key not_null
     *   )
     *   [1] => Array (
     *       [table] => tblFoo
     *       [name] => fldPhone
     *       [type] => string
     *       [len] => 20
     *       [flags] =>
     *   )
     *   [2] => Array (
     *       [table] => tblBar
     *       [name] => fldId
     *       [type] => int
     *       [len] => 11
     *       [flags] => primary_key not_null
     *   )
     *   </pre>
     *
     * </li><li>
     *
     * <kbd>MDB2_TABLEINFO_ORDER</kbd>
     *
     *   <p>In addition to the information found in the default output,
     *   a notation of the number of columns is provided by the
     *   <samp>num_fields</samp> element while the <samp>order</samp>
     *   element provides an array with the column names as the keys and
     *   their location index number (corresponding to the keys in the
     *   the default output) as the values.</p>
     *
     *   <p>If a result set has identical field names, the last one is
     *   used.</p>
     *
     *   <pre>
     *   [num_fields] => 3
     *   [order] => Array (
     *       [fldId] => 2
     *       [fldTrans] => 1
     *   )
     *   </pre>
     *
     * </li><li>
     *
     * <kbd>MDB2_TABLEINFO_ORDERTABLE</kbd>
     *
     *   <p>Similar to <kbd>MDB2_TABLEINFO_ORDER</kbd> but adds more
     *   dimensions to the array in which the table names are keys and
     *   the field names are sub-keys.  This is helpful for queries that
     *   join tables which have identical field names.</p>
     *
     *   <pre>
     *   [num_fields] => 3
     *   [ordertable] => Array (
     *       [tblFoo] => Array (
     *           [fldId] => 0
     *           [fldPhone] => 1
     *       )
     *       [tblBar] => Array (
     *           [fldId] => 2
     *       )
     *   )
     *   </pre>
     *
     * </li>
     * </ul>
     *
     * The <samp>flags</samp> element contains a space separated list
     * of extra information about the field.  This data is inconsistent
     * between DBMS's due to the way each DBMS works.
     *   + <samp>primary_key</samp>
     *   + <samp>unique_key</samp>
     *   + <samp>multiple_key</samp>
     *   + <samp>not_null</samp>
     *
     * Most DBMS's only provide the <samp>table</samp> and <samp>flags</samp>
     * elements if <var>$result</var> is a table name.  The following DBMS's
     * provide full information from queries:
     *   + fbsql
     *   + mysql
     *
     * If the 'portability' option has <samp>MDB2_PORTABILITY_FIX_CASE</samp>
     * turned on, the names of tables and fields will be lower or upper cased.
     *
     * @param object|string  $result  MDB2_result object from a query or a
     *                                string containing the name of a table.
     *                                While this also accepts a query result
     *                                resource identifier, this behavior is
     *                                deprecated.
     * @param int  $mode   either unused or one of the tableInfo modes:
     *                     <kbd>MDB2_TABLEINFO_ORDERTABLE</kbd>,
     *                     <kbd>MDB2_TABLEINFO_ORDER</kbd> or
     *                     <kbd>MDB2_TABLEINFO_FULL</kbd> (which does both).
     *                     These are bitwise, so the first two can be
     *                     combined using <kbd>|</kbd>.
     *
     * @return array  an associative array with the information requested.
     *                 A MDB2_Error object on failure.
     *
     * @see MDB2_Driver_Common::setOption()
     */
    function tableInfo($result, $mode = null)
    {
        $db =& $this->getDBInstance();
        if (PEAR::isError($db)) {
            return $db;
        }

        if (!is_string($result)) {
            return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
                'method not implemented', __FUNCTION__);
        }

        $db->loadModule('Manager', null, true);
        $fields = $db->manager->listTableFields($result);
        if (PEAR::isError($fields)) {
            return $fields;
        }

        $flags = array();

        $idxname_format = $db->getOption('idxname_format');
        $db->setOption('idxname_format', '%s');

        $indexes = $db->manager->listTableIndexes($result);
        if (PEAR::isError($indexes)) {
            $db->setOption('idxname_format', $idxname_format);
            return $indexes;
        }

        foreach ($indexes as $index) {
            $definition = $this->getTableIndexDefinition($result, $index);
            if (PEAR::isError($definition)) {
                $db->setOption('idxname_format', $idxname_format);
                return $definition;
            }
            if (count($definition['fields']) > 1) {
                foreach ($definition['fields'] as $field => $sort) {
                    $flags[$field] = 'multiple_key';
                }
            }
        }

        $constraints = $db->manager->listTableConstraints($result);
        if (PEAR::isError($constraints)) {
            return $constraints;
        }

        foreach ($constraints as $constraint) {
            $definition = $this->getTableConstraintDefinition($result, $constraint);
            if (PEAR::isError($definition)) {
                $db->setOption('idxname_format', $idxname_format);
                return $definition;
            }
            $flag = !empty($definition['primary'])
                ? 'primary_key' : (!empty($definition['unique'])
                    ? 'unique_key' : false);
            if ($flag) {
                foreach ($definition['fields'] as $field => $sort) {
                    if (empty($flags[$field]) || $flags[$field] != 'primary_key') {
                        $flags[$field] = $flag;
                    }
                }
            }
        }

        if ($mode) {
            $res['num_fields'] = count($fields);
        }

        foreach ($fields as $i => $field) {
            $definition = $this->getTableFieldDefinition($result, $field);
            if (PEAR::isError($definition)) {
                $db->setOption('idxname_format', $idxname_format);
                return $definition;
            }
            $res[$i] = $definition[0];
            $res[$i]['name'] = $field;
            $res[$i]['table'] = $result;
            $res[$i]['type'] = preg_replace('/^([a-z]+).*$/i', '\\1', trim($definition[0]['nativetype']));
            // 'primary_key', 'unique_key', 'multiple_key'
            $res[$i]['flags'] = empty($flags[$field]) ? '' : $flags[$field];
            // not_null', 'unsigned', 'auto_increment', 'default_[rawencodedvalue]'
            if (!empty($res[$i]['notnull'])) {
                $res[$i]['flags'].= ' not_null';
            }
            if (!empty($res[$i]['unsigned'])) {
                $res[$i]['flags'].= ' unsigned';
            }
            if (!empty($res[$i]['auto_increment'])) {
                $res[$i]['flags'].= ' autoincrement';
            }
            if (!empty($res[$i]['default'])) {
                $res[$i]['flags'].= ' default_'.rawurlencode($res[$i]['default']);
            }

            if ($mode & MDB2_TABLEINFO_ORDER) {
                $res['order'][$res[$i]['name']] = $i;
            }
            if ($mode & MDB2_TABLEINFO_ORDERTABLE) {
                $res['ordertable'][$res[$i]['table']][$res[$i]['name']] = $i;
            }
        }

        $db->setOption('idxname_format', $idxname_format);
        return $res;
    }
}
<?php

// +----------------------------------------------------------------------+

// | PHP versions 4 and 5                                                 |

// +----------------------------------------------------------------------+

// | Copyright (c) 1998-2007 Manuel Lemos, Tomas V.V.Cox,                 |

// | Stig. S. Bakken, Lukas Smith                                         |

// | All rights reserved.                                                 |

// +----------------------------------------------------------------------+

// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |

// | API as well as database abstraction for PHP applications.            |

// | This LICENSE is in the BSD license style.                            |

// |                                                                      |

// | Redistribution and use in source and binary forms, with or without   |

// | modification, are permitted provided that the following conditions   |

// | are met:                                                             |

// |                                                                      |

// | Redistributions of source code must retain the above copyright       |

// | notice, this list of conditions and the following disclaimer.        |

// |                                                                      |

// | Redistributions in binary form must reproduce the above copyright    |

// | notice, this list of conditions and the following disclaimer in the  |

// | documentation and/or other materials provided with the distribution. |

// |                                                                      |

// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |

// | Lukas Smith nor the names of his contributors may be used to endorse |

// | or promote products derived from this software without specific prior|

// | written permission.                                                  |

// |                                                                      |

// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |

// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |

// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |

// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |

// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |

// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |

// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|

// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |

// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |

// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|

// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |

// | POSSIBILITY OF SUCH DAMAGE.                                          |

// +----------------------------------------------------------------------+

// | Author: Lukas Smith <smith@pooteeweet.org>                           |

// +----------------------------------------------------------------------+

//

// $Id: Common.php,v 1.42 2008/01/12 12:50:58 quipo Exp $

//



/**

 * @package MDB2

 * @category Database

 */



/**

 * These are constants for the tableInfo-function

 * they are bitwised or'ed. so if there are more constants to be defined

 * in the future, adjust MDB2_TABLEINFO_FULL accordingly

 */



define('MDB2_TABLEINFO_ORDER',      1);

define('MDB2_TABLEINFO_ORDERTABLE', 2);

define('MDB2_TABLEINFO_FULL',       3);



/**

 * Base class for the schema reverse engineering module that is extended by each MDB2 driver

 *

 * To load this module in the MDB2 object:

 * $mdb->loadModule('Reverse');

 *

 * @package MDB2

 * @category Database

 * @author  Lukas Smith <smith@pooteeweet.org>

 */

class MDB2_Driver_Reverse_Common extends MDB2_Module_Common

{

    // {{{ splitTableSchema()



    /**

     * Split the "[owner|schema].table" notation into an array

     * @access private

     */

    function splitTableSchema($table)

    {

        $ret = array();

        if (strpos($table, '.') !== false) {

            return explode('.', $table);

        }

        return array(null, $table);

    }



    // }}}

    // {{{ getTableFieldDefinition()



    /**

     * Get the structure of a field into an array

     *

     * @param string    $table     name of table that should be used in method

     * @param string    $field     name of field that should be used in method

     * @return mixed data array on success, a MDB2 error on failure.

     *          The returned array contains an array for each field definition,

     *          with all or some of these indices, depending on the field data type:

     *          [notnull] [nativetype] [length] [fixed] [default] [type] [mdb2type]

     * @access public

     */

    function getTableFieldDefinition($table, $field)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

            'method not implemented', __FUNCTION__);

    }



    // }}}

    // {{{ getTableIndexDefinition()



    /**

     * Get the structure of an index into an array

     *

     * @param string    $table      name of table that should be used in method

     * @param string    $index      name of index that should be used in method

     * @return mixed data array on success, a MDB2 error on failure

     *          The returned array has this structure:

     *          </pre>

     *          array (

     *              [fields] => array (

     *                  [field1name] => array() // one entry per each field covered

     *                  [field2name] => array() // by the index

     *                  [field3name] => array(

     *                      [sorting] => ascending

     *                  )

     *              )

     *          );

     *          </pre>

     * @access public

     */

    function getTableIndexDefinition($table, $index)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

            'method not implemented', __FUNCTION__);

    }



    // }}}

    // {{{ getTableConstraintDefinition()



    /**

     * Get the structure of an constraints into an array

     *

     * @param string    $table      name of table that should be used in method

     * @param string    $index      name of index that should be used in method

     * @return mixed data array on success, a MDB2 error on failure

     *          The returned array has this structure:

     *          <pre>

     *          array (

     *              [primary] => 0

     *              [unique]  => 0

     *              [foreign] => 1

     *              [check]   => 0

     *              [fields] => array (

     *                  [field1name] => array() // one entry per each field covered

     *                  [field2name] => array() // by the index

     *                  [field3name] => array(

     *                      [sorting]  => ascending

     *                      [position] => 3

     *                  )

     *              )

     *              [references] => array(

     *                  [table] => name

     *                  [fields] => array(

     *                      [field1name] => array(  //one entry per each referenced field

     *                           [position] => 1

     *                      )

     *                  )

     *              )

     *              [deferrable] => 0

     *              [initiallydeferred] => 0

     *              [onupdate] => CASCADE|RESTRICT|SET NULL|SET DEFAULT|NO ACTION

     *              [ondelete] => CASCADE|RESTRICT|SET NULL|SET DEFAULT|NO ACTION

     *              [match] => SIMPLE|PARTIAL|FULL

     *          );

     *          </pre>

     * @access public

     */

    function getTableConstraintDefinition($table, $index)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

            'method not implemented', __FUNCTION__);

    }



    // }}}

    // {{{ getSequenceDefinition()



    /**

     * Get the structure of a sequence into an array

     *

     * @param string    $sequence   name of sequence that should be used in method

     * @return mixed data array on success, a MDB2 error on failure

     *          The returned array has this structure:

     *          <pre>

     *          array (

     *              [start] => n

     *          );

     *          </pre>

     * @access public

     */

    function getSequenceDefinition($sequence)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        $start = $db->currId($sequence);

        if (PEAR::isError($start)) {

            return $start;

        }

        if ($db->supports('current_id')) {

            $start++;

        } else {

            $db->warnings[] = 'database does not support getting current

                sequence value, the sequence value was incremented';

        }

        $definition = array();

        if ($start != 1) {

            $definition = array('start' => $start);

        }

        return $definition;

    }



    // }}}

    // {{{ getTriggerDefinition()



    /**

     * Get the structure of a trigger into an array

     *

     * EXPERIMENTAL

     *

     * WARNING: this function is experimental and may change the returned value 
     * at any time until labelled as non-experimental

     *

     * @param string    $trigger    name of trigger that should be used in method

     * @return mixed data array on success, a MDB2 error on failure

     *          The returned array has this structure:

     *          <pre>

     *          array (

     *              [trigger_name]    => 'trigger name',

     *              [table_name]      => 'table name',

     *              [trigger_body]    => 'trigger body definition',

     *              [trigger_type]    => 'BEFORE' | 'AFTER',

     *              [trigger_event]   => 'INSERT' | 'UPDATE' | 'DELETE'

     *                  //or comma separated list of multiple events, when supported

     *              [trigger_enabled] => true|false

     *              [trigger_comment] => 'trigger comment',

     *          );

     *          </pre>

     *          The oci8 driver also returns a [when_clause] index.

     * @access public

     */

    function getTriggerDefinition($trigger)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

            'method not implemented', __FUNCTION__);

    }



    // }}}

    // {{{ tableInfo()



    /**

     * Returns information about a table or a result set

     *

     * The format of the resulting array depends on which <var>$mode</var>

     * you select.  The sample output below is based on this query:

     * <pre>

     *    SELECT tblFoo.fldID, tblFoo.fldPhone, tblBar.fldId

     *    FROM tblFoo

     *    JOIN tblBar ON tblFoo.fldId = tblBar.fldId

     * </pre>

     *

     * <ul>

     * <li>

     *

     * <kbd>null</kbd> (default)

     *   <pre>

     *   [0] => Array (

     *       [table] => tblFoo

     *       [name] => fldId

     *       [type] => int

     *       [len] => 11

     *       [flags] => primary_key not_null

     *   )

     *   [1] => Array (

     *       [table] => tblFoo

     *       [name] => fldPhone

     *       [type] => string

     *       [len] => 20

     *       [flags] =>

     *   )

     *   [2] => Array (

     *       [table] => tblBar

     *       [name] => fldId

     *       [type] => int

     *       [len] => 11

     *       [flags] => primary_key not_null

     *   )

     *   </pre>

     *

     * </li><li>

     *

     * <kbd>MDB2_TABLEINFO_ORDER</kbd>

     *

     *   <p>In addition to the information found in the default output,

     *   a notation of the number of columns is provided by the

     *   <samp>num_fields</samp> element while the <samp>order</samp>

     *   element provides an array with the column names as the keys and

     *   their location index number (corresponding to the keys in the

     *   the default output) as the values.</p>

     *

     *   <p>If a result set has identical field names, the last one is

     *   used.</p>

     *

     *   <pre>

     *   [num_fields] => 3

     *   [order] => Array (

     *       [fldId] => 2

     *       [fldTrans] => 1

     *   )

     *   </pre>

     *

     * </li><li>

     *

     * <kbd>MDB2_TABLEINFO_ORDERTABLE</kbd>

     *

     *   <p>Similar to <kbd>MDB2_TABLEINFO_ORDER</kbd> but adds more

     *   dimensions to the array in which the table names are keys and

     *   the field names are sub-keys.  This is helpful for queries that

     *   join tables which have identical field names.</p>

     *

     *   <pre>

     *   [num_fields] => 3

     *   [ordertable] => Array (

     *       [tblFoo] => Array (

     *           [fldId] => 0

     *           [fldPhone] => 1

     *       )

     *       [tblBar] => Array (

     *           [fldId] => 2

     *       )

     *   )

     *   </pre>

     *

     * </li>

     * </ul>

     *

     * The <samp>flags</samp> element contains a space separated list

     * of extra information about the field.  This data is inconsistent

     * between DBMS's due to the way each DBMS works.

     *   + <samp>primary_key</samp>

     *   + <samp>unique_key</samp>

     *   + <samp>multiple_key</samp>

     *   + <samp>not_null</samp>

     *

     * Most DBMS's only provide the <samp>table</samp> and <samp>flags</samp>

     * elements if <var>$result</var> is a table name.  The following DBMS's

     * provide full information from queries:

     *   + fbsql

     *   + mysql

     *

     * If the 'portability' option has <samp>MDB2_PORTABILITY_FIX_CASE</samp>

     * turned on, the names of tables and fields will be lower or upper cased.

     *

     * @param object|string  $result  MDB2_result object from a query or a

     *                                string containing the name of a table.

     *                                While this also accepts a query result

     *                                resource identifier, this behavior is

     *                                deprecated.

     * @param int  $mode   either unused or one of the tableInfo modes:

     *                     <kbd>MDB2_TABLEINFO_ORDERTABLE</kbd>,

     *                     <kbd>MDB2_TABLEINFO_ORDER</kbd> or

     *                     <kbd>MDB2_TABLEINFO_FULL</kbd> (which does both).

     *                     These are bitwise, so the first two can be

     *                     combined using <kbd>|</kbd>.

     *

     * @return array  an associative array with the information requested.

     *                 A MDB2_Error object on failure.

     *

     * @see MDB2_Driver_Common::setOption()

     */

    function tableInfo($result, $mode = null)

    {

        $db =& $this->getDBInstance();

        if (PEAR::isError($db)) {

            return $db;

        }



        if (!is_string($result)) {

            return $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

                'method not implemented', __FUNCTION__);

        }



        $db->loadModule('Manager', null, true);

        $fields = $db->manager->listTableFields($result);

        if (PEAR::isError($fields)) {

            return $fields;

        }



        $flags = array();



        $idxname_format = $db->getOption('idxname_format');

        $db->setOption('idxname_format', '%s');



        $indexes = $db->manager->listTableIndexes($result);

        if (PEAR::isError($indexes)) {

            $db->setOption('idxname_format', $idxname_format);

            return $indexes;

        }



        foreach ($indexes as $index) {

            $definition = $this->getTableIndexDefinition($result, $index);

            if (PEAR::isError($definition)) {

                $db->setOption('idxname_format', $idxname_format);

                return $definition;

            }

            if (count($definition['fields']) > 1) {

                foreach ($definition['fields'] as $field => $sort) {

                    $flags[$field] = 'multiple_key';

                }

            }

        }



        $constraints = $db->manager->listTableConstraints($result);

        if (PEAR::isError($constraints)) {

            return $constraints;

        }



        foreach ($constraints as $constraint) {

            $definition = $this->getTableConstraintDefinition($result, $constraint);

            if (PEAR::isError($definition)) {

                $db->setOption('idxname_format', $idxname_format);

                return $definition;

            }

            $flag = !empty($definition['primary'])

                ? 'primary_key' : (!empty($definition['unique'])

                    ? 'unique_key' : false);

            if ($flag) {

                foreach ($definition['fields'] as $field => $sort) {

                    if (empty($flags[$field]) || $flags[$field] != 'primary_key') {

                        $flags[$field] = $flag;

                    }

                }

            }

        }



        $res = array();



        if ($mode) {

            $res['num_fields'] = count($fields);

        }



        foreach ($fields as $i => $field) {

            $definition = $this->getTableFieldDefinition($result, $field);

            if (PEAR::isError($definition)) {

                $db->setOption('idxname_format', $idxname_format);

                return $definition;

            }

            $res[$i] = $definition[0];

            $res[$i]['name'] = $field;

            $res[$i]['table'] = $result;

            $res[$i]['type'] = preg_replace('/^([a-z]+).*$/i', '\\1', trim($definition[0]['nativetype']));

            // 'primary_key', 'unique_key', 'multiple_key'

            $res[$i]['flags'] = empty($flags[$field]) ? '' : $flags[$field];

            // not_null', 'unsigned', 'auto_increment', 'default_[rawencodedvalue]'

            if (!empty($res[$i]['notnull'])) {

                $res[$i]['flags'].= ' not_null';

            }

            if (!empty($res[$i]['unsigned'])) {

                $res[$i]['flags'].= ' unsigned';

            }

            if (!empty($res[$i]['auto_increment'])) {

                $res[$i]['flags'].= ' autoincrement';

            }

            if (!empty($res[$i]['default'])) {

                $res[$i]['flags'].= ' default_'.rawurlencode($res[$i]['default']);

            }



            if ($mode & MDB2_TABLEINFO_ORDER) {

                $res['order'][$res[$i]['name']] = $i;

            }

            if ($mode & MDB2_TABLEINFO_ORDERTABLE) {

                $res['ordertable'][$res[$i]['table']][$res[$i]['name']] = $i;

            }

        }



        $db->setOption('idxname_format', $idxname_format);

        return $res;

    }

}

?>

 program/lib/MDB2/Driver/Reverse/mssql.php

@@ -43,7 +43,7 @@
// |          Lorenzo Alberton <l.alberton@quipo.it>                      |

// +----------------------------------------------------------------------+

//

// $Id: mssql.php,v 1.48 2007/11/25 13:38:29 quipo Exp $

// $Id: mssql.php,v 1.49 2008/02/17 15:30:57 quipo Exp $

//



require_once 'MDB2/Driver/Reverse/Common.php';

@@ -454,7 +454,7 @@
        }

        $trg_body = $db->queryCol('EXEC sp_helptext '. $db->quote($trigger, 'text'), 'text');

        if (!PEAR::isError($trg_body)) {

            $def['trigger_body'] = implode('', $trg_body);

            $def['trigger_body'] = implode(' ', $trg_body);

        }

        return $def;

    }


 program/lib/MDB2/Driver/Reverse/pgsql.php

@@ -2,7 +2,7 @@
// +----------------------------------------------------------------------+

// | PHP versions 4 and 5                                                 |

// +----------------------------------------------------------------------+

// | Copyright (c) 1998-2007 Manuel Lemos, Tomas V.V.Cox,                 |

// | Copyright (c) 1998-2008 Manuel Lemos, Tomas V.V.Cox,                 |

// | Stig. S. Bakken, Lukas Smith                                         |

// | All rights reserved.                                                 |

// +----------------------------------------------------------------------+

@@ -43,7 +43,7 @@
// |          Lorenzo Alberton <l.alberton@quipo.it>                      |

// +----------------------------------------------------------------------+

//

// $Id: pgsql.php,v 1.68 2007/11/25 13:38:29 quipo Exp $

// $Id: pgsql.php,v 1.70 2008/03/13 20:38:09 quipo Exp $



require_once 'MDB2/Driver/Reverse/Common.php';



@@ -358,7 +358,7 @@
            $query = 'SELECT a.attname

                        FROM pg_constraint c

                   LEFT JOIN pg_class t  ON c.confrelid  = t.oid

                   LEFT JOIN pg_attribute a ON a.attrelid = t.oid AND a.attnum = ANY(c.conkey)

                   LEFT JOIN pg_attribute a ON a.attrelid = t.oid AND a.attnum = ANY(c.confkey)

                       WHERE c.conname = %s

                         AND t.relname = ' . $db->quote($definition['references']['table'], 'text');

            $constraint_name_mdb2 = $db->getIndexName($constraint_name);

@@ -424,7 +424,10 @@
                            WHEN 24 THEN 'UPDATE, DELETE'

                            WHEN 12 THEN 'INSERT, DELETE'

                         END AS trigger_event,

                         trg.tgenabled AS trigger_enabled,

                         CASE trg.tgenabled

                            WHEN 'O' THEN 't'

                            ELSE trg.tgenabled

                         END AS trigger_enabled,

                         obj_description(trg.oid, 'pg_trigger') AS trigger_comment

                    FROM pg_trigger trg,

                         pg_class tbl,


 program/lib/MDB2/Driver/Reverse/sqlite.php

@@ -43,7 +43,7 @@
// |          Lorenzo Alberton <l.alberton@quipo.it>                      |

// +----------------------------------------------------------------------+

//

// $Id: sqlite.php,v 1.78 2007/12/01 10:46:13 quipo Exp $

// $Id: sqlite.php,v 1.79 2008/03/05 11:08:53 quipo Exp $

//



require_once 'MDB2/Driver/Reverse/Common.php';

@@ -393,6 +393,18 @@
                    }

                    return $definition;

                }

                if (preg_match("/\"([^\"]+)\"[^\,\"]+\bPRIMARY\s+KEY\b[^\,\)]*/i", $sql, $tmp)) {

                    $definition['primary'] = true;

                    $definition['fields'] = array();

                    $column_names = split(',', $tmp[1]);

                    $colpos = 1;

                    foreach ($column_names as $column_name) {

                        $definition['fields'][trim($column_name)] = array(

                            'position' => $colpos++

                        );

                    }

                    return $definition;

                }

            } else {

                // search in table definition for FOREIGN KEYs

                $pattern = "/\bCONSTRAINT\b\s+%s\s+


 program/lib/MDB2/Driver/mssql.php

@@ -3,7 +3,7 @@
// +----------------------------------------------------------------------+

// | PHP versions 4 and 5                                                 |

// +----------------------------------------------------------------------+

// | Copyright (c) 1998-2006 Manuel Lemos, Tomas V.V.Cox,                 |

// | Copyright (c) 1998-2008 Manuel Lemos, Tomas V.V.Cox,                 |

// | Stig. S. Bakken, Lukas Smith, Frank M. Kromann                       |

// | All rights reserved.                                                 |

// +----------------------------------------------------------------------+

@@ -43,7 +43,7 @@
// | Author: Frank M. Kromann <frank@kromann.info>                        |

// +----------------------------------------------------------------------+

//

// $Id: mssql.php,v 1.161 2007/11/18 17:52:00 quipo Exp $

// $Id: mssql.php,v 1.174 2008/03/08 14:18:39 quipo Exp $

//

// {{{ Class MDB2_Driver_mssql

/**

@@ -86,6 +86,7 @@
        $this->supported['LOBs'] = true;

        $this->supported['replace'] = 'emulated';

        $this->supported['sub_selects'] = true;

        $this->supported['triggers'] = true;

        $this->supported['auto_increment'] = true;

        $this->supported['primary_key'] = true;

        $this->supported['result_introspection'] = true;

@@ -93,8 +94,11 @@
        $this->supported['pattern_escaping'] = true;

        $this->supported['new_link'] = true;



        $this->options['DBA_username'] = false;

        $this->options['DBA_password'] = false;

        $this->options['database_device'] = false;

        $this->options['database_size'] = false;

        $this->options['max_identifiers_length'] = 128; // MS Access: 64

    }



    // }}}

@@ -107,11 +111,15 @@
     * @return array

     * @access public

     */

    function errorInfo($error = null)

    function errorInfo($error = null, $connection = null)

    {

        if (is_null($connection)) {

            $connection = $this->connection;

        }



        $native_code = null;

        if ($this->connection) {

            $result = @mssql_query('select @@ERROR as ErrorCode', $this->connection);

        if ($connection) {

            $result = @mssql_query('select @@ERROR as ErrorCode', $connection);

            if ($result) {

                $native_code = @mssql_result($result, 0, 0);

                @mssql_free_result($result);

@@ -136,8 +144,10 @@
                    336   => MDB2_ERROR_SYNTAX,

                    515   => MDB2_ERROR_CONSTRAINT_NOT_NULL,

                    547   => MDB2_ERROR_CONSTRAINT,

                    911   => MDB2_ERROR_NOT_FOUND,

                    1018  => MDB2_ERROR_SYNTAX,

                    1035  => MDB2_ERROR_SYNTAX,

                    1801  => MDB2_ERROR_ALREADY_EXISTS,

                    1913  => MDB2_ERROR_ALREADY_EXISTS,

                    2209  => MDB2_ERROR_SYNTAX,

                    2223  => MDB2_ERROR_SYNTAX,

@@ -296,6 +306,68 @@
    }



    // }}}

    // {{{ _doConnect()



    /**

     * do the grunt work of the connect

     *

     * @return connection on success or MDB2 Error Object on failure

     * @access protected

     */

    function _doConnect($username, $password, $persistent = false)

    {

        if (!PEAR::loadExtension($this->phptype) && !PEAR::loadExtension('sybase_ct')) {

            return $this->raiseError(MDB2_ERROR_NOT_FOUND, null, null,

                'extension '.$this->phptype.' is not compiled into PHP', __FUNCTION__);

        }



        $params = array(

            $this->dsn['hostspec'] ? $this->dsn['hostspec'] : 'localhost',

            $username ? $username : null,

            $password ? $password : null,

        );

        if ($this->dsn['port']) {

            $params[0].= ((substr(PHP_OS, 0, 3) == 'WIN') ? ',' : ':').$this->dsn['port'];

        }

        if (!$persistent) {

            if (isset($this->dsn['new_link'])

                && ($this->dsn['new_link'] == 'true' || $this->dsn['new_link'] === true)

            ) {

                $params[] = true;

            } else {

                $params[] = false;

            }

        }



        $connect_function = $persistent ? 'mssql_pconnect' : 'mssql_connect';



        $connection = @call_user_func_array($connect_function, $params);

        if ($connection <= 0) {

            return $this->raiseError(MDB2_ERROR_CONNECT_FAILED, null, null,

                'unable to establish a connection', __FUNCTION__, __FUNCTION__);

        }



        @mssql_query('SET ANSI_NULL_DFLT_ON ON', $connection);



        if (!empty($this->dsn['charset'])) {

            $result = $this->setCharset($this->dsn['charset'], $connection);

            if (PEAR::isError($result)) {

                return $result;

            }

        }



       if ((bool)ini_get('mssql.datetimeconvert')) {

           @ini_set('mssql.datetimeconvert', '0');

       }



       if (empty($this->dsn['disable_iso_date'])) {

           @mssql_query('SET DATEFORMAT ymd', $connection);

       }



       return $connection;

    }



    // }}}

    // {{{ connect()



    /**

@@ -315,51 +387,14 @@
            $this->disconnect(false);

        }



        if (!PEAR::loadExtension($this->phptype)) {

            return $this->raiseError(MDB2_ERROR_NOT_FOUND, null, null,

                'extension '.$this->phptype.' is not compiled into PHP', __FUNCTION__);

        }



        $params = array(

            $this->dsn['hostspec'] ? $this->dsn['hostspec'] : 'localhost',

            $this->dsn['username'] ? $this->dsn['username'] : null,

            $this->dsn['password'] ? $this->dsn['password'] : null,

        $connection = $this->_doConnect(

            $this->dsn['username'],

            $this->dsn['password'],

            $this->options['persistent']

        );

        if ($this->dsn['port']) {

            $params[0].= ((substr(PHP_OS, 0, 3) == 'WIN') ? ',' : ':').$this->dsn['port'];

        if (PEAR::isError($connection)) {

            return $connection;

        }

        if (!$this->options['persistent']) {

            if (isset($this->dsn['new_link'])

                && ($this->dsn['new_link'] == 'true' || $this->dsn['new_link'] === true)

            ) {

                $params[] = true;

            } else {

                $params[] = false;

            }

        }



        $connect_function = $this->options['persistent'] ? 'mssql_pconnect' : 'mssql_connect';



        $connection = @call_user_func_array($connect_function, $params);

        if ($connection <= 0) {

            return $this->raiseError(MDB2_ERROR_CONNECT_FAILED, null, null,

                'unable to establish a connection', __FUNCTION__, __FUNCTION__);

        }



        if (!empty($this->dsn['charset'])) {

            $result = $this->setCharset($this->dsn['charset'], $connection);

            if (PEAR::isError($result)) {

                return $result;

            }

        }



       if ((bool)ini_get('mssql.datetimeconvert')) {

           @ini_set('mssql.datetimeconvert', '0');

       }



       if (empty($this->dsn['disable_iso_date'])) {

           @mssql_query('SET DATEFORMAT ymd', $connection);

       }



        $this->connection = $connection;

        $this->connected_dsn = $this->dsn;

@@ -379,6 +414,41 @@
        }



        return MDB2_OK;

    }



    // }}}

    // {{{ databaseExists()



    /**

     * check if given database name is exists?

     *

     * @param string $name    name of the database that should be checked

     *

     * @return mixed true/false on success, a MDB2 error on failure

     * @access public

     */

    function databaseExists($name)

    {

        $connection = $this->_doConnect($this->dsn['username'],

                                        $this->dsn['password'],

                                        $this->options['persistent']);

        if (PEAR::isError($connection)) {

            return $connection;

        }



        $result = @mssql_select_db($name, $connection);

        $errorInfo = $this->errorInfo(null, $connection);

        @mssql_close($connection);

        if (!$result) {

            if ($errorInfo[0] != MDB2_ERROR_NOT_FOUND) {

            exit;

                $result = $this->raiseError($errorInfo[0], null, null, $errorInfo[2], __FUNCTION__);

                return $result;

            }

            $result = false;

        }



        return $result;

    }



    // }}}

@@ -414,6 +484,42 @@
            }

        }

        return parent::disconnect($force);

    }



    // }}}

    // {{{ standaloneQuery()



   /**

     * execute a query as DBA

     *

     * @param string $query the SQL query

     * @param mixed   $types  array that contains the types of the columns in

     *                        the result set

     * @param boolean $is_manip  if the query is a manipulation query

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function &standaloneQuery($query, $types = null, $is_manip = false)

    {

        $user = $this->options['DBA_username']? $this->options['DBA_username'] : $this->dsn['username'];

        $pass = $this->options['DBA_password']? $this->options['DBA_password'] : $this->dsn['password'];

        $connection = $this->_doConnect($user, $pass, $this->options['persistent']);

        if (PEAR::isError($connection)) {

            return $connection;

        }



        $offset = $this->offset;

        $limit = $this->limit;

        $this->offset = $this->limit = 0;

        $query = $this->_modifyQuery($query, $is_manip, $limit, $offset);

        
        $result =& $this->_doQuery($query, $is_manip, $connection, $this->database_name);

        if (!PEAR::isError($result)) {

            $result = $this->_affectedRows($connection, $result);

        }



        @mssql_close($connection);

        return $result;

    }



    // }}}

@@ -546,7 +652,7 @@
        // cache server_info

        $this->connected_server_info = $server_info;

        if (!$native && !PEAR::isError($server_info)) {

            if (preg_match('/([0-9]+)\.([0-9]+)\.([0-9]+)/', $server_info, $tmp)) {

            if (preg_match('/(\d+)\.(\d+)\.(\d+)/', $server_info, $tmp)) {

                $server_info = array(

                    'major' => $tmp[1],

                    'minor' => $tmp[2],

@@ -609,6 +715,7 @@
    {

        $sequence_name = $this->quoteIdentifier($this->getSequenceName($seq_name), true);

        $seqcol_name = $this->quoteIdentifier($this->options['seqcol_name'], true);

        $this->pushErrorHandling(PEAR_ERROR_RETURN);

        $this->expectError(MDB2_ERROR_NOSUCHTABLE);

        

        $seq_val = $this->_checkSequence($sequence_name);

@@ -621,6 +728,7 @@
        }

        $result =& $this->_doQuery($query, true);

        $this->popExpect();

        $this->popErrorHandling();

        if (PEAR::isError($result)) {

            if ($ondemand && !$this->_checkSequence($sequence_name)) {

                $this->loadModule('Manager', null, true);

@@ -669,6 +777,7 @@
     *

     * @param string $table name of the table into which a new row was inserted

     * @param string $field name of the field into which a new row was inserted

     *

     * @return mixed MDB2 Error Object or id

     * @access public

     */

@@ -678,9 +787,12 @@
        if (is_array($server_info) && !is_null($server_info['major'])

           && $server_info['major'] >= 8

        ) {

            $query = "SELECT SCOPE_IDENTITY()";

            $query = "SELECT IDENT_CURRENT('$table')";

        } else {

            $query = "SELECT @@IDENTITY";

            if (!is_null($table)) {

                $query .= ' FROM '.$this->quoteIdentifier($table, true);

            }

        }



        return $this->queryOne($query, 'integer');


 program/lib/MDB2/Driver/mysql.php

@@ -1,1535 +1,1685 @@
<?php

// vim: set et ts=4 sw=4 fdm=marker:

// +----------------------------------------------------------------------+

// | PHP versions 4 and 5                                                 |

// +----------------------------------------------------------------------+

// | Copyright (c) 1998-2006 Manuel Lemos, Tomas V.V.Cox,                 |

// | Stig. S. Bakken, Lukas Smith                                         |

// | All rights reserved.                                                 |

// +----------------------------------------------------------------------+

// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |

// | API as well as database abstraction for PHP applications.            |

// | This LICENSE is in the BSD license style.                            |

// |                                                                      |

// | Redistribution and use in source and binary forms, with or without   |

// | modification, are permitted provided that the following conditions   |

// | are met:                                                             |

// |                                                                      |

// | Redistributions of source code must retain the above copyright       |

// | notice, this list of conditions and the following disclaimer.        |

// |                                                                      |

// | Redistributions in binary form must reproduce the above copyright    |

// | notice, this list of conditions and the following disclaimer in the  |

// | documentation and/or other materials provided with the distribution. |

// |                                                                      |

// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |

// | Lukas Smith nor the names of his contributors may be used to endorse |

// | or promote products derived from this software without specific prior|

// | written permission.                                                  |

// |                                                                      |

// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |

// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |

// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |

// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |

// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |

// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |

// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|

// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |

// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |

// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|

// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |

// | POSSIBILITY OF SUCH DAMAGE.                                          |

// +----------------------------------------------------------------------+

// | Author: Lukas Smith <smith@pooteeweet.org>                           |

// +----------------------------------------------------------------------+

//

// $Id: mysql.php,v 1.195 2007/11/10 13:27:03 quipo Exp $

//



/**

 * MDB2 MySQL driver

 *

 * @package MDB2

 * @category Database

 * @author  Lukas Smith <smith@pooteeweet.org>

 */

class MDB2_Driver_mysql extends MDB2_Driver_Common

{

    // {{{ properties



    var $string_quoting = array('start' => "'", 'end' => "'", 'escape' => '\\', 'escape_pattern' => '\\');



    var $identifier_quoting = array('start' => '`', 'end' => '`', 'escape' => '`');



    var $sql_comments = array(

        array('start' => '-- ', 'end' => "\n", 'escape' => false),

        array('start' => '#', 'end' => "\n", 'escape' => false),

        array('start' => '/*', 'end' => '*/', 'escape' => false),

    );



    var $server_capabilities_checked = false;



    var $start_transaction = false;



    var $varchar_max_length = 255;



    // }}}

    // {{{ constructor



    /**

     * Constructor

     */

    function __construct()

    {

        parent::__construct();



        $this->phptype = 'mysql';

        $this->dbsyntax = 'mysql';



        $this->supported['sequences'] = 'emulated';

        $this->supported['indexes'] = true;

        $this->supported['affected_rows'] = true;

        $this->supported['transactions'] = false;

        $this->supported['savepoints'] = false;

        $this->supported['summary_functions'] = true;

        $this->supported['order_by_text'] = true;

        $this->supported['current_id'] = 'emulated';

        $this->supported['limit_queries'] = true;

        $this->supported['LOBs'] = true;

        $this->supported['replace'] = true;

        $this->supported['sub_selects'] = 'emulated';

        $this->supported['auto_increment'] = true;

        $this->supported['primary_key'] = true;

        $this->supported['result_introspection'] = true;

        $this->supported['prepared_statements'] = 'emulated';

        $this->supported['identifier_quoting'] = true;

        $this->supported['pattern_escaping'] = true;

        $this->supported['new_link'] = true;



        $this->options['default_table_type'] = '';

    }



    // }}}

    // {{{ errorInfo()



    /**

     * This method is used to collect information about an error

     *

     * @param integer $error

     * @return array

     * @access public

     */

    function errorInfo($error = null)

    {

        if ($this->connection) {

            $native_code = @mysql_errno($this->connection);

            $native_msg  = @mysql_error($this->connection);

        } else {

            $native_code = @mysql_errno();

            $native_msg  = @mysql_error();

        }

        if (is_null($error)) {

            static $ecode_map;

            if (empty($ecode_map)) {

                $ecode_map = array(

                    1000 => MDB2_ERROR_INVALID, //hashchk

                    1001 => MDB2_ERROR_INVALID, //isamchk

                    1004 => MDB2_ERROR_CANNOT_CREATE,

                    1005 => MDB2_ERROR_CANNOT_CREATE,

                    1006 => MDB2_ERROR_CANNOT_CREATE,

                    1007 => MDB2_ERROR_ALREADY_EXISTS,

                    1008 => MDB2_ERROR_CANNOT_DROP,

                    1009 => MDB2_ERROR_CANNOT_DROP,

                    1010 => MDB2_ERROR_CANNOT_DROP,

                    1011 => MDB2_ERROR_CANNOT_DELETE,

                    1022 => MDB2_ERROR_ALREADY_EXISTS,

                    1029 => MDB2_ERROR_NOT_FOUND,

                    1032 => MDB2_ERROR_NOT_FOUND,

                    1044 => MDB2_ERROR_ACCESS_VIOLATION,

                    1045 => MDB2_ERROR_ACCESS_VIOLATION,

                    1046 => MDB2_ERROR_NODBSELECTED,

                    1048 => MDB2_ERROR_CONSTRAINT,

                    1049 => MDB2_ERROR_NOSUCHDB,

                    1050 => MDB2_ERROR_ALREADY_EXISTS,

                    1051 => MDB2_ERROR_NOSUCHTABLE,

                    1054 => MDB2_ERROR_NOSUCHFIELD,

                    1060 => MDB2_ERROR_ALREADY_EXISTS,

                    1061 => MDB2_ERROR_ALREADY_EXISTS,

                    1062 => MDB2_ERROR_ALREADY_EXISTS,

                    1064 => MDB2_ERROR_SYNTAX,

                    1067 => MDB2_ERROR_INVALID,

                    1072 => MDB2_ERROR_NOT_FOUND,

                    1086 => MDB2_ERROR_ALREADY_EXISTS,

                    1091 => MDB2_ERROR_NOT_FOUND,

                    1100 => MDB2_ERROR_NOT_LOCKED,

                    1109 => MDB2_ERROR_NOT_FOUND,

                    1125 => MDB2_ERROR_ALREADY_EXISTS,

                    1136 => MDB2_ERROR_VALUE_COUNT_ON_ROW,

                    1138 => MDB2_ERROR_INVALID,

                    1142 => MDB2_ERROR_ACCESS_VIOLATION,

                    1143 => MDB2_ERROR_ACCESS_VIOLATION,

                    1146 => MDB2_ERROR_NOSUCHTABLE,

                    1149 => MDB2_ERROR_SYNTAX,

                    1169 => MDB2_ERROR_CONSTRAINT,

                    1176 => MDB2_ERROR_NOT_FOUND,

                    1177 => MDB2_ERROR_NOSUCHTABLE,

                    1213 => MDB2_ERROR_DEADLOCK,

                    1216 => MDB2_ERROR_CONSTRAINT,

                    1217 => MDB2_ERROR_CONSTRAINT,

                    1227 => MDB2_ERROR_ACCESS_VIOLATION,

                    1299 => MDB2_ERROR_INVALID_DATE,

                    1300 => MDB2_ERROR_INVALID,

                    1304 => MDB2_ERROR_ALREADY_EXISTS,

                    1305 => MDB2_ERROR_NOT_FOUND,

                    1306 => MDB2_ERROR_CANNOT_DROP,

                    1307 => MDB2_ERROR_CANNOT_CREATE,

                    1334 => MDB2_ERROR_CANNOT_ALTER,

                    1339 => MDB2_ERROR_NOT_FOUND,

                    1356 => MDB2_ERROR_INVALID,

                    1359 => MDB2_ERROR_ALREADY_EXISTS,

                    1360 => MDB2_ERROR_NOT_FOUND,

                    1363 => MDB2_ERROR_NOT_FOUND,

                    1365 => MDB2_ERROR_DIVZERO,

                    1451 => MDB2_ERROR_CONSTRAINT,

                    1452 => MDB2_ERROR_CONSTRAINT,

                    1542 => MDB2_ERROR_CANNOT_DROP,

                    1546 => MDB2_ERROR_CONSTRAINT,

                    1582 => MDB2_ERROR_CONSTRAINT,

                );

            }

            if ($this->options['portability'] & MDB2_PORTABILITY_ERRORS) {

                $ecode_map[1022] = MDB2_ERROR_CONSTRAINT;

                $ecode_map[1048] = MDB2_ERROR_CONSTRAINT_NOT_NULL;

                $ecode_map[1062] = MDB2_ERROR_CONSTRAINT;

            } else {

                // Doing this in case mode changes during runtime.

                $ecode_map[1022] = MDB2_ERROR_ALREADY_EXISTS;

                $ecode_map[1048] = MDB2_ERROR_CONSTRAINT;

                $ecode_map[1062] = MDB2_ERROR_ALREADY_EXISTS;

            }

            if (isset($ecode_map[$native_code])) {

                $error = $ecode_map[$native_code];

            }

        }

        return array($error, $native_code, $native_msg);

    }



    // }}}

    // {{{ escape()



    /**

     * Quotes a string so it can be safely used in a query. It will quote

     * the text so it can safely be used within a query.

     *

     * @param   string  the input string to quote

     * @param   bool    escape wildcards

     *

     * @return  string  quoted string

     *

     * @access  public

     */

    function escape($text, $escape_wildcards = false)

    {

        if ($escape_wildcards) {

            $text = $this->escapePattern($text);

        }

        $connection = $this->getConnection();

        if (PEAR::isError($connection)) {

            return $connection;

        }

        $text = @mysql_real_escape_string($text, $connection);

        return $text;

    }



    // }}}

    // {{{ beginTransaction()



    /**

     * Start a transaction or set a savepoint.

     *

     * @param   string  name of a savepoint to set

     * @return  mixed   MDB2_OK on success, a MDB2 error on failure

     *

     * @access  public

     */

    function beginTransaction($savepoint = null)

    {

        $this->debug('Starting transaction/savepoint', __FUNCTION__, array('is_manip' => true, 'savepoint' => $savepoint));

        $this->_getServerCapabilities();

        if (!is_null($savepoint)) {

            if (!$this->supports('savepoints')) {

                return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

                    'savepoints are not supported', __FUNCTION__);

            }

            if (!$this->in_transaction) {

                return $this->raiseError(MDB2_ERROR_INVALID, null, null,

                    'savepoint cannot be released when changes are auto committed', __FUNCTION__);

            }

            $query = 'SAVEPOINT '.$savepoint;

            return $this->_doQuery($query, true);

        } elseif ($this->in_transaction) {

            return MDB2_OK;  //nothing to do

        }

        if (!$this->destructor_registered && $this->opened_persistent) {

            $this->destructor_registered = true;

            register_shutdown_function('MDB2_closeOpenTransactions');

        }

        $query = $this->start_transaction ? 'START TRANSACTION' : 'SET AUTOCOMMIT = 1';

        $result =& $this->_doQuery($query, true);

        if (PEAR::isError($result)) {

            return $result;

        }

        $this->in_transaction = true;

        return MDB2_OK;

    }



    // }}}

    // {{{ commit()



    /**

     * Commit the database changes done during a transaction that is in

     * progress or release a savepoint. This function may only be called when

     * auto-committing is disabled, otherwise it will fail. Therefore, a new

     * transaction is implicitly started after committing the pending changes.

     *

     * @param   string  name of a savepoint to release

     * @return  mixed   MDB2_OK on success, a MDB2 error on failure

     *

     * @access  public

     */

    function commit($savepoint = null)

    {

        $this->debug('Committing transaction/savepoint', __FUNCTION__, array('is_manip' => true, 'savepoint' => $savepoint));

        if (!$this->in_transaction) {

            return $this->raiseError(MDB2_ERROR_INVALID, null, null,

                'commit/release savepoint cannot be done changes are auto committed', __FUNCTION__);

        }

        if (!is_null($savepoint)) {

            if (!$this->supports('savepoints')) {

                return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

                    'savepoints are not supported', __FUNCTION__);

            }

            $server_info = $this->getServerVersion();

            if (version_compare($server_info['major'].'.'.$server_info['minor'].'.'.$server_info['patch'], '5.0.3', '<')) {

                return MDB2_OK;

            }

            $query = 'RELEASE SAVEPOINT '.$savepoint;

            return $this->_doQuery($query, true);

        }



        if (!$this->supports('transactions')) {

            return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

                'transactions are not supported', __FUNCTION__);

        }



        $result =& $this->_doQuery('COMMIT', true);

        if (PEAR::isError($result)) {

            return $result;

        }

        if (!$this->start_transaction) {

            $query = 'SET AUTOCOMMIT = 0';

            $result =& $this->_doQuery($query, true);

            if (PEAR::isError($result)) {

                return $result;

            }

        }

        $this->in_transaction = false;

        return MDB2_OK;

    }



    // }}}

    // {{{ rollback()



    /**

     * Cancel any database changes done during a transaction or since a specific

     * savepoint that is in progress. This function may only be called when

     * auto-committing is disabled, otherwise it will fail. Therefore, a new

     * transaction is implicitly started after canceling the pending changes.

     *

     * @param   string  name of a savepoint to rollback to

     * @return  mixed   MDB2_OK on success, a MDB2 error on failure

     *

     * @access  public

     */

    function rollback($savepoint = null)

    {

        $this->debug('Rolling back transaction/savepoint', __FUNCTION__, array('is_manip' => true, 'savepoint' => $savepoint));

        if (!$this->in_transaction) {

            return $this->raiseError(MDB2_ERROR_INVALID, null, null,

                'rollback cannot be done changes are auto committed', __FUNCTION__);

        }

        if (!is_null($savepoint)) {

            if (!$this->supports('savepoints')) {

                return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

                    'savepoints are not supported', __FUNCTION__);

            }

            $query = 'ROLLBACK TO SAVEPOINT '.$savepoint;

            return $this->_doQuery($query, true);

        }



        $query = 'ROLLBACK';

        $result =& $this->_doQuery($query, true);

        if (PEAR::isError($result)) {

            return $result;

        }

        if (!$this->start_transaction) {

            $query = 'SET AUTOCOMMIT = 0';

            $result =& $this->_doQuery($query, true);

            if (PEAR::isError($result)) {

                return $result;

            }

        }

        $this->in_transaction = false;

        return MDB2_OK;

    }



    // }}}

    // {{{ function setTransactionIsolation()



    /**

     * Set the transacton isolation level.

     *

     * @param   string  standard isolation level

     *                  READ UNCOMMITTED (allows dirty reads)

     *                  READ COMMITTED (prevents dirty reads)

     *                  REPEATABLE READ (prevents nonrepeatable reads)

     *                  SERIALIZABLE (prevents phantom reads)

     * @return  mixed   MDB2_OK on success, a MDB2 error on failure

     *

     * @access  public

     * @since   2.1.1

     */

    function setTransactionIsolation($isolation)

    {

        $this->debug('Setting transaction isolation level', __FUNCTION__, array('is_manip' => true));

        if (!$this->supports('transactions')) {

            return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

                'transactions are not supported', __FUNCTION__);

        }

        switch ($isolation) {

        case 'READ UNCOMMITTED':

        case 'READ COMMITTED':

        case 'REPEATABLE READ':

        case 'SERIALIZABLE':

            break;

        default:

            return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

                'isolation level is not supported: '.$isolation, __FUNCTION__);

        }



        $query = "SET SESSION TRANSACTION ISOLATION LEVEL $isolation";

        return $this->_doQuery($query, true);

    }



    // }}}

    // {{{ connect()



    /**

     * Connect to the database

     *

     * @return true on success, MDB2 Error Object on failure

     */

    function connect()

    {

        if (is_resource($this->connection)) {

            //if (count(array_diff($this->connected_dsn, $this->dsn)) == 0

            if (MDB2::areEquals($this->connected_dsn, $this->dsn)

                && $this->opened_persistent == $this->options['persistent']

                && $this->connected_database_name == $this->database_name

            ) {

                return MDB2_OK;

            }

            $this->disconnect(false);

        }



        if (!PEAR::loadExtension($this->phptype)) {

            return $this->raiseError(MDB2_ERROR_NOT_FOUND, null, null,

                'extension '.$this->phptype.' is not compiled into PHP', __FUNCTION__);

        }



        $params = array();

        if ($this->dsn['protocol'] && $this->dsn['protocol'] == 'unix') {

            $params[0] = ':' . $this->dsn['socket'];

        } else {

            $params[0] = $this->dsn['hostspec'] ? $this->dsn['hostspec']

                         : 'localhost';

            if ($this->dsn['port']) {

                $params[0].= ':' . $this->dsn['port'];

            }

        }

        $params[] = $this->dsn['username'] ? $this->dsn['username'] : null;

        $params[] = $this->dsn['password'] ? $this->dsn['password'] : null;

        if (!$this->options['persistent']) {

            if (isset($this->dsn['new_link'])

                && ($this->dsn['new_link'] == 'true' || $this->dsn['new_link'] === true)

            ) {

                $params[] = true;

            } else {

                $params[] = false;

            }

        }

        if (version_compare(phpversion(), '4.3.0', '>=')) {

            $params[] = isset($this->dsn['client_flags'])

                ? $this->dsn['client_flags'] : null;

        }

        $connect_function = $this->options['persistent'] ? 'mysql_pconnect' : 'mysql_connect';



        $connection = @call_user_func_array($connect_function, $params);

        if (!$connection) {

            if (($err = @mysql_error()) != '') {

                return $this->raiseError(MDB2_ERROR_CONNECT_FAILED, null, null,

                    $err, __FUNCTION__);

            } else {

                return $this->raiseError(MDB2_ERROR_CONNECT_FAILED, null, null,

                    'unable to establish a connection', __FUNCTION__);

            }

        }



        if (!empty($this->dsn['charset'])) {

            $result = $this->setCharset($this->dsn['charset'], $connection);

            if (PEAR::isError($result)) {

                return $result;

            }

        }



        $this->connection = $connection;

        $this->connected_dsn = $this->dsn;

        $this->connected_database_name = '';

        $this->opened_persistent = $this->options['persistent'];

        $this->dbsyntax = $this->dsn['dbsyntax'] ? $this->dsn['dbsyntax'] : $this->phptype;



        if ($this->database_name) {

            if ($this->database_name != $this->connected_database_name) {

                if (!@mysql_select_db($this->database_name, $connection)) {

                    $err = $this->raiseError(null, null, null,

                        'Could not select the database: '.$this->database_name, __FUNCTION__);

                    return $err;

                }

                $this->connected_database_name = $this->database_name;

            }

        }



        $this->supported['transactions'] = $this->options['use_transactions'];

        if ($this->options['default_table_type']) {

            switch (strtoupper($this->options['default_table_type'])) {

            case 'BLACKHOLE':

            case 'MEMORY':

            case 'ARCHIVE':

            case 'CSV':

            case 'HEAP':

            case 'ISAM':

            case 'MERGE':

            case 'MRG_ISAM':

            case 'ISAM':

            case 'MRG_MYISAM':

            case 'MYISAM':

                $this->supported['transactions'] = false;

                $this->warnings[] = $this->options['default_table_type'] .

                    ' is not a supported default table type';

                break;

            }

        }

        
        $this->_getServerCapabilities();



        return MDB2_OK;

    }



    // }}}

    // {{{ setCharset()



    /**

     * Set the charset on the current connection

     *

     * @param string    charset

     * @param resource  connection handle

     *

     * @return true on success, MDB2 Error Object on failure

     */

    function setCharset($charset, $connection = null)

    {

        if (is_null($connection)) {

            $connection = $this->getConnection();

            if (PEAR::isError($connection)) {

                return $connection;

            }

        }

        $query = "SET NAMES '".mysql_real_escape_string($charset, $connection)."'";

        return $this->_doQuery($query, true, $connection);

    }



    // }}}

    // {{{ disconnect()



    /**

     * Log out and disconnect from the database.

     *

     * @param  boolean $force if the disconnect should be forced even if the

     *                        connection is opened persistently

     * @return mixed true on success, false if not connected and error

     *                object on error

     * @access public

     */

    function disconnect($force = true)

    {

        if (is_resource($this->connection)) {

            if ($this->in_transaction) {

                $dsn = $this->dsn;

                $database_name = $this->database_name;

                $persistent = $this->options['persistent'];

                $this->dsn = $this->connected_dsn;

                $this->database_name = $this->connected_database_name;

                $this->options['persistent'] = $this->opened_persistent;

                $this->rollback();

                $this->dsn = $dsn;

                $this->database_name = $database_name;

                $this->options['persistent'] = $persistent;

            }



            if (!$this->opened_persistent || $force) {

                @mysql_close($this->connection);

            }

        }

        return parent::disconnect($force);

    }



    // }}}

    // {{{ _doQuery()



    /**

     * Execute a query

     * @param string $query  query

     * @param boolean $is_manip  if the query is a manipulation query

     * @param resource $connection

     * @param string $database_name

     * @return result or error object

     * @access protected

     */

    function &_doQuery($query, $is_manip = false, $connection = null, $database_name = null)

    {

        $this->last_query = $query;

        $result = $this->debug($query, 'query', array('is_manip' => $is_manip, 'when' => 'pre'));

        if ($result) {

            if (PEAR::isError($result)) {

                return $result;

            }

            $query = $result;

        }

        if ($this->options['disable_query']) {

            $result = $is_manip ? 0 : null;

            return $result;

        }



        if (is_null($connection)) {

            $connection = $this->getConnection();

            if (PEAR::isError($connection)) {

                return $connection;

            }

        }

        if (is_null($database_name)) {

            $database_name = $this->database_name;

        }



        if ($database_name) {

            if ($database_name != $this->connected_database_name) {

                if (!@mysql_select_db($database_name, $connection)) {

                    $err = $this->raiseError(null, null, null,

                        'Could not select the database: '.$database_name, __FUNCTION__);

                    return $err;

                }

                $this->connected_database_name = $database_name;

            }

        }



        $function = $this->options['result_buffering']

            ? 'mysql_query' : 'mysql_unbuffered_query';

        $result = @$function($query, $connection);

        if (!$result) {

            $err =& $this->raiseError(null, null, null,

                'Could not execute statement', __FUNCTION__);

            return $err;

        }



        $this->debug($query, 'query', array('is_manip' => $is_manip, 'when' => 'post', 'result' => $result));

        return $result;

    }



    // }}}

    // {{{ _affectedRows()



    /**

     * Returns the number of rows affected

     *

     * @param resource $result

     * @param resource $connection

     * @return mixed MDB2 Error Object or the number of rows affected

     * @access private

     */

    function _affectedRows($connection, $result = null)

    {

        if (is_null($connection)) {

            $connection = $this->getConnection();

            if (PEAR::isError($connection)) {

                return $connection;

            }

        }

        return @mysql_affected_rows($connection);

    }



    // }}}

    // {{{ _modifyQuery()



    /**

     * Changes a query string for various DBMS specific reasons

     *

     * @param string $query  query to modify

     * @param boolean $is_manip  if it is a DML query

     * @param integer $limit  limit the number of rows

     * @param integer $offset  start reading from given offset

     * @return string modified query

     * @access protected

     */

    function _modifyQuery($query, $is_manip, $limit, $offset)

    {

        if ($this->options['portability'] & MDB2_PORTABILITY_DELETE_COUNT) {

            // "DELETE FROM table" gives 0 affected rows in MySQL.

            // This little hack lets you know how many rows were deleted.

            if (preg_match('/^\s*DELETE\s+FROM\s+(\S+)\s*$/i', $query)) {

                $query = preg_replace('/^\s*DELETE\s+FROM\s+(\S+)\s*$/',

                                      'DELETE FROM \1 WHERE 1=1', $query);

            }

        }

        if ($limit > 0

            && !preg_match('/LIMIT\s*\d(?:\s*(?:,|OFFSET)\s*\d+)?(?:[^\)]*)?$/i', $query)

        ) {

            $query = rtrim($query);

            if (substr($query, -1) == ';') {

                $query = substr($query, 0, -1);

            }



            // LIMIT doesn't always come last in the query

            // @see http://dev.mysql.com/doc/refman/5.0/en/select.html

            $after = '';

            if (preg_match('/(\s+INTO\s+(?:OUT|DUMP)FILE\s.*)$/ims', $query, $matches)) {

                $after = $matches[0];

                $query = preg_replace('/(\s+INTO\s+(?:OUT|DUMP)FILE\s.*)$/ims', '', $query);

            } elseif (preg_match('/(\s+FOR\s+UPDATE\s*)$/i', $query, $matches)) {

               $after = $matches[0];

               $query = preg_replace('/(\s+FOR\s+UPDATE\s*)$/im', '', $query);

            } elseif (preg_match('/(\s+LOCK\s+IN\s+SHARE\s+MODE\s*)$/im', $query, $matches)) {

               $after = $matches[0];

               $query = preg_replace('/(\s+LOCK\s+IN\s+SHARE\s+MODE\s*)$/im', '', $query);

            }



            if ($is_manip) {

                return $query . " LIMIT $limit" . $after;

            } else {

                return $query . " LIMIT $offset, $limit" . $after;

            }

        }

        return $query;

    }



    // }}}

    // {{{ getServerVersion()



    /**

     * return version information about the server

     *

     * @param bool   $native  determines if the raw version string should be returned

     * @return mixed array/string with version information or MDB2 error object

     * @access public

     */

    function getServerVersion($native = false)

    {

        $connection = $this->getConnection();

        if (PEAR::isError($connection)) {

            return $connection;

        }

        if ($this->connected_server_info) {

            $server_info = $this->connected_server_info;

        } else {

            $server_info = @mysql_get_server_info($connection);

        }

        if (!$server_info) {

            return $this->raiseError(null, null, null,

                'Could not get server information', __FUNCTION__);

        }

        // cache server_info

        $this->connected_server_info = $server_info;

        if (!$native) {

            $tmp = explode('.', $server_info, 3);

            if (isset($tmp[2]) && strpos($tmp[2], '-')) {

                $tmp2 = explode('-', @$tmp[2], 2);

            } else {

                $tmp2[0] = isset($tmp[2]) ? $tmp[2] : null;

                $tmp2[1] = null;

            }

            $server_info = array(

                'major' => isset($tmp[0]) ? $tmp[0] : null,

                'minor' => isset($tmp[1]) ? $tmp[1] : null,

                'patch' => $tmp2[0],

                'extra' => $tmp2[1],

                'native' => $server_info,

            );

        }

        return $server_info;

    }



    // }}}

    // {{{ _getServerCapabilities()



    /**

     * Fetch some information about the server capabilities

     * (transactions, subselects, prepared statements, etc).

     *

     * @access private

     */

    function _getServerCapabilities()

    {

        if (!$this->server_capabilities_checked) {

            $this->server_capabilities_checked = true;



            //set defaults

            $this->supported['sub_selects'] = 'emulated';

            $this->supported['prepared_statements'] = 'emulated';

            $this->start_transaction = false;

            $this->varchar_max_length = 255;

            
            $server_info = $this->getServerVersion();

            if (is_array($server_info)) {

                if (!version_compare($server_info['major'].'.'.$server_info['minor'].'.'.$server_info['patch'], '4.1.0', '<')) {

                    $this->supported['sub_selects'] = true;

                    $this->supported['prepared_statements'] = true;

                }



                if (!version_compare($server_info['major'].'.'.$server_info['minor'].'.'.$server_info['patch'], '4.0.14', '<')

                    || !version_compare($server_info['major'].'.'.$server_info['minor'].'.'.$server_info['patch'], '4.1.1', '<')

                ) {

                    $this->supported['savepoints'] = true;

                }



                if (!version_compare($server_info['major'].'.'.$server_info['minor'].'.'.$server_info['patch'], '4.0.11', '<')) {

                    $this->start_transaction = true;

                }



                if (!version_compare($server_info['major'].'.'.$server_info['minor'].'.'.$server_info['patch'], '5.0.3', '<')) {

                    $this->varchar_max_length = 65532;

                }

            }

        }

    }



    // }}}

    // {{{ function _skipUserDefinedVariable($query, $position)



    /**

     * Utility method, used by prepare() to avoid misinterpreting MySQL user 
     * defined variables (SELECT @x:=5) for placeholders.

     * Check if the placeholder is a false positive, i.e. if it is an user defined

     * variable instead. If so, skip it and advance the position, otherwise

     * return the current position, which is valid

     *

     * @param string $query

     * @param integer $position current string cursor position

     * @return integer $new_position

     * @access protected

     */

    function _skipUserDefinedVariable($query, $position)

    {

        $found = strpos(strrev(substr($query, 0, $position)), '@');

        if ($found === false) {

            return $position;

        }

        $pos = strlen($query) - strlen(substr($query, $position)) - $found - 1;

        $substring = substr($query, $pos, $position - $pos + 2);

        if (preg_match('/^@\w+\s*:=$/', $substring)) {

            return $position + 1; //found an user defined variable: skip it

        }

        return $position;

    }



    // }}}

    // {{{ prepare()



    /**

     * Prepares a query for multiple execution with execute().

     * With some database backends, this is emulated.

     * prepare() requires a generic query as string like

     * 'INSERT INTO numbers VALUES(?,?)' or

     * 'INSERT INTO numbers VALUES(:foo,:bar)'.

     * The ? and :name and are placeholders which can be set using

     * bindParam() and the query can be sent off using the execute() method.

     * The allowed format for :name can be set with the 'bindname_format' option.

     *

     * @param string $query the query to prepare

     * @param mixed   $types  array that contains the types of the placeholders

     * @param mixed   $result_types  array that contains the types of the columns in

     *                        the result set or MDB2_PREPARE_RESULT, if set to

     *                        MDB2_PREPARE_MANIP the query is handled as a manipulation query

     * @param mixed   $lobs   key (field) value (parameter) pair for all lob placeholders

     * @return mixed resource handle for the prepared query on success, a MDB2

     *        error on failure

     * @access public

     * @see bindParam, execute

     */

    function &prepare($query, $types = null, $result_types = null, $lobs = array())

    {

        if ($this->options['emulate_prepared']

            || $this->supported['prepared_statements'] !== true

        ) {

            $obj =& parent::prepare($query, $types, $result_types, $lobs);

            return $obj;

        }

        $is_manip = ($result_types === MDB2_PREPARE_MANIP);

        $offset = $this->offset;

        $limit = $this->limit;

        $this->offset = $this->limit = 0;

        $query = $this->_modifyQuery($query, $is_manip, $limit, $offset);

        $result = $this->debug($query, __FUNCTION__, array('is_manip' => $is_manip, 'when' => 'pre'));

        if ($result) {

            if (PEAR::isError($result)) {

                return $result;

            }

            $query = $result;

        }

        $placeholder_type_guess = $placeholder_type = null;

        $question = '?';

        $colon = ':';

        $positions = array();

        $position = 0;

        while ($position < strlen($query)) {

            $q_position = strpos($query, $question, $position);

            $c_position = strpos($query, $colon, $position);

            if ($q_position && $c_position) {

                $p_position = min($q_position, $c_position);

            } elseif ($q_position) {

                $p_position = $q_position;

            } elseif ($c_position) {

                $p_position = $c_position;

            } else {

                break;

            }

            if (is_null($placeholder_type)) {

                $placeholder_type_guess = $query[$p_position];

            }

            
            $new_pos = $this->_skipDelimitedStrings($query, $position, $p_position);

            if (PEAR::isError($new_pos)) {

                return $new_pos;

            }

            if ($new_pos != $position) {

                $position = $new_pos;

                continue; //evaluate again starting from the new position

            }

            
            //make sure this is not part of an user defined variable

            $new_pos = $this->_skipUserDefinedVariable($query, $position);

            if ($new_pos != $position) {

                $position = $new_pos;

                continue; //evaluate again starting from the new position

            }



            if ($query[$position] == $placeholder_type_guess) {

                if (is_null($placeholder_type)) {

                    $placeholder_type = $query[$p_position];

                    $question = $colon = $placeholder_type;

                }

                if ($placeholder_type == ':') {

                    $regexp = '/^.{'.($position+1).'}('.$this->options['bindname_format'].').*$/s';

                    $parameter = preg_replace($regexp, '\\1', $query);

                    if ($parameter === '') {

                        $err =& $this->raiseError(MDB2_ERROR_SYNTAX, null, null,

                            'named parameter name must match "bindname_format" option', __FUNCTION__);

                        return $err;

                    }

                    $positions[$p_position] = $parameter;

                    $query = substr_replace($query, '?', $position, strlen($parameter)+1);

                } else {

                    $positions[$p_position] = count($positions);

                }

                $position = $p_position + 1;

            } else {

                $position = $p_position;

            }

        }

        $connection = $this->getConnection();

        if (PEAR::isError($connection)) {

            return $connection;

        }

        static $prep_statement_counter = 1;

        $statement_name = sprintf($this->options['statement_format'], $this->phptype, sha1(microtime() + mt_rand())) . $prep_statement_counter++;

        $query = "PREPARE $statement_name FROM ".$this->quote($query, 'text');

        $statement =& $this->_doQuery($query, true, $connection);

        if (PEAR::isError($statement)) {

            return $statement;

        }



        $class_name = 'MDB2_Statement_'.$this->phptype;

        $obj = new $class_name($this, $statement_name, $positions, $query, $types, $result_types, $is_manip, $limit, $offset);

        $this->debug($query, __FUNCTION__, array('is_manip' => $is_manip, 'when' => 'post', 'result' => $obj));

        return $obj;

    }



    // }}}

    // {{{ replace()



    /**

     * Execute a SQL REPLACE query. A REPLACE query is identical to a INSERT

     * query, except that if there is already a row in the table with the same

     * key field values, the REPLACE query just updates its values instead of

     * inserting a new row.

     *

     * The REPLACE type of query does not make part of the SQL standards. Since

     * practically only MySQL implements it natively, this type of query is

     * emulated through this method for other DBMS using standard types of

     * queries inside a transaction to assure the atomicity of the operation.

     *

     * @access public

     *

     * @param string $table name of the table on which the REPLACE query will

     *  be executed.

     * @param array $fields associative array that describes the fields and the

     *  values that will be inserted or updated in the specified table. The

     *  indexes of the array are the names of all the fields of the table. The

     *  values of the array are also associative arrays that describe the

     *  values and other properties of the table fields.

     *

     *  Here follows a list of field properties that need to be specified:

     *

     *    value:

     *          Value to be assigned to the specified field. This value may be

     *          of specified in database independent type format as this

     *          function can perform the necessary datatype conversions.

     *

     *    Default:

     *          this property is required unless the Null property

     *          is set to 1.

     *

     *    type

     *          Name of the type of the field. Currently, all types Metabase

     *          are supported except for clob and blob.

     *

     *    Default: no type conversion

     *

     *    null

     *          Boolean property that indicates that the value for this field

     *          should be set to null.

     *

     *          The default value for fields missing in INSERT queries may be

     *          specified the definition of a table. Often, the default value

     *          is already null, but since the REPLACE may be emulated using

     *          an UPDATE query, make sure that all fields of the table are

     *          listed in this function argument array.

     *

     *    Default: 0

     *

     *    key

     *          Boolean property that indicates that this field should be

     *          handled as a primary key or at least as part of the compound

     *          unique index of the table that will determine the row that will

     *          updated if it exists or inserted a new row otherwise.

     *

     *          This function will fail if no key field is specified or if the

     *          value of a key field is set to null because fields that are

     *          part of unique index they may not be null.

     *

     *    Default: 0

     *

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     */

    function replace($table, $fields)

    {

        $count = count($fields);

        $query = $values = '';

        $keys = $colnum = 0;

        for (reset($fields); $colnum < $count; next($fields), $colnum++) {

            $name = key($fields);

            if ($colnum > 0) {

                $query .= ',';

                $values.= ',';

            }

            $query.= $name;

            if (isset($fields[$name]['null']) && $fields[$name]['null']) {

                $value = 'NULL';

            } else {

                $type = isset($fields[$name]['type']) ? $fields[$name]['type'] : null;

                $value = $this->quote($fields[$name]['value'], $type);

                if (PEAR::isError($value)) {

                    return $value;

                }

            }

            $values.= $value;

            if (isset($fields[$name]['key']) && $fields[$name]['key']) {

                if ($value === 'NULL') {

                    return $this->raiseError(MDB2_ERROR_CANNOT_REPLACE, null, null,

                        'key value '.$name.' may not be NULL', __FUNCTION__);

                }

                $keys++;

            }

        }

        if ($keys == 0) {

            return $this->raiseError(MDB2_ERROR_CANNOT_REPLACE, null, null,

                'not specified which fields are keys', __FUNCTION__);

        }



        $connection = $this->getConnection();

        if (PEAR::isError($connection)) {

            return $connection;

        }



        $query = "REPLACE INTO $table ($query) VALUES ($values)";

        $result =& $this->_doQuery($query, true, $connection);

        if (PEAR::isError($result)) {

            return $result;

        }

        return $this->_affectedRows($connection, $result);

    }



    // }}}

    // {{{ nextID()



    /**

     * Returns the next free id of a sequence

     *

     * @param string $seq_name name of the sequence

     * @param boolean $ondemand when true the sequence is

     *                          automatic created, if it

     *                          not exists

     *

     * @return mixed MDB2 Error Object or id

     * @access public

     */

    function nextID($seq_name, $ondemand = true)

    {

        $sequence_name = $this->quoteIdentifier($this->getSequenceName($seq_name), true);

        $seqcol_name = $this->quoteIdentifier($this->options['seqcol_name'], true);

        $query = "INSERT INTO $sequence_name ($seqcol_name) VALUES (NULL)";

        $this->expectError(MDB2_ERROR_NOSUCHTABLE);

        $result =& $this->_doQuery($query, true);

        $this->popExpect();

        if (PEAR::isError($result)) {

            if ($ondemand && $result->getCode() == MDB2_ERROR_NOSUCHTABLE) {

                $this->loadModule('Manager', null, true);

                $result = $this->manager->createSequence($seq_name);

                if (PEAR::isError($result)) {

                    return $this->raiseError($result, null, null,

                        'on demand sequence '.$seq_name.' could not be created', __FUNCTION__);

                } else {

                    return $this->nextID($seq_name, false);

                }

            }

            return $result;

        }

        $value = $this->lastInsertID();

        if (is_numeric($value)) {

            $query = "DELETE FROM $sequence_name WHERE $seqcol_name < $value";

            $result =& $this->_doQuery($query, true);

            if (PEAR::isError($result)) {

                $this->warnings[] = 'nextID: could not delete previous sequence table values from '.$seq_name;

            }

        }

        return $value;

    }



    // }}}

    // {{{ lastInsertID()



    /**

     * Returns the autoincrement ID if supported or $id or fetches the current

     * ID in a sequence called: $table.(empty($field) ? '' : '_'.$field)

     *

     * @param string $table name of the table into which a new row was inserted

     * @param string $field name of the field into which a new row was inserted

     * @return mixed MDB2 Error Object or id

     * @access public

     */

    function lastInsertID($table = null, $field = null)

    {

        // not using mysql_insert_id() due to http://pear.php.net/bugs/bug.php?id=8051

        return $this->queryOne('SELECT LAST_INSERT_ID()', 'integer');

    }



    // }}}

    // {{{ currID()



    /**

     * Returns the current id of a sequence

     *

     * @param string $seq_name name of the sequence

     * @return mixed MDB2 Error Object or id

     * @access public

     */

    function currID($seq_name)

    {

        $sequence_name = $this->quoteIdentifier($this->getSequenceName($seq_name), true);

        $seqcol_name = $this->quoteIdentifier($this->options['seqcol_name'], true);

        $query = "SELECT MAX($seqcol_name) FROM $sequence_name";

        return $this->queryOne($query, 'integer');

    }

}



/**

 * MDB2 MySQL result driver

 *

 * @package MDB2

 * @category Database

 * @author  Lukas Smith <smith@pooteeweet.org>

 */

class MDB2_Result_mysql extends MDB2_Result_Common

{

    // }}}

    // {{{ fetchRow()



    /**

     * Fetch a row and insert the data into an existing array.

     *

     * @param int       $fetchmode  how the array data should be indexed

     * @param int    $rownum    number of the row where the data can be found

     * @return int data array on success, a MDB2 error on failure

     * @access public

     */

    function &fetchRow($fetchmode = MDB2_FETCHMODE_DEFAULT, $rownum = null)

    {

        if (!is_null($rownum)) {

            $seek = $this->seek($rownum);

            if (PEAR::isError($seek)) {

                return $seek;

            }

        }

        if ($fetchmode == MDB2_FETCHMODE_DEFAULT) {

            $fetchmode = $this->db->fetchmode;

        }

        if ($fetchmode & MDB2_FETCHMODE_ASSOC) {

            $row = @mysql_fetch_assoc($this->result);

            if (is_array($row)

                && $this->db->options['portability'] & MDB2_PORTABILITY_FIX_CASE

            ) {

                $row = array_change_key_case($row, $this->db->options['field_case']);

            }

        } else {

           $row = @mysql_fetch_row($this->result);

        }



        if (!$row) {

            if ($this->result === false) {

                $err =& $this->db->raiseError(MDB2_ERROR_NEED_MORE_DATA, null, null,

                    'resultset has already been freed', __FUNCTION__);

                return $err;

            }

            $null = null;

            return $null;

        }

        $mode = $this->db->options['portability'] & MDB2_PORTABILITY_EMPTY_TO_NULL;

        $rtrim = false;

        if ($this->db->options['portability'] & MDB2_PORTABILITY_RTRIM) {

            if (empty($this->types)) {

                $mode += MDB2_PORTABILITY_RTRIM;

            } else {

                $rtrim = true;

            }

        }

        if ($mode) {

            $this->db->_fixResultArrayValues($row, $mode);

        }

        if (!empty($this->types)) {

            $row = $this->db->datatype->convertResultRow($this->types, $row, $rtrim);

        }

        if (!empty($this->values)) {

            $this->_assignBindColumns($row);

        }

        if ($fetchmode === MDB2_FETCHMODE_OBJECT) {

            $object_class = $this->db->options['fetch_class'];

            if ($object_class == 'stdClass') {

                $row = (object) $row;

            } else {

                $row = &new $object_class($row);

            }

        }

        ++$this->rownum;

        return $row;

    }



    // }}}

    // {{{ _getColumnNames()



    /**

     * Retrieve the names of columns returned by the DBMS in a query result.

     *

     * @return  mixed   Array variable that holds the names of columns as keys

     *                  or an MDB2 error on failure.

     *                  Some DBMS may not return any columns when the result set

     *                  does not contain any rows.

     * @access private

     */

    function _getColumnNames()

    {

        $columns = array();

        $numcols = $this->numCols();

        if (PEAR::isError($numcols)) {

            return $numcols;

        }

        for ($column = 0; $column < $numcols; $column++) {

            $column_name = @mysql_field_name($this->result, $column);

            $columns[$column_name] = $column;

        }

        if ($this->db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {

            $columns = array_change_key_case($columns, $this->db->options['field_case']);

        }

        return $columns;

    }



    // }}}

    // {{{ numCols()



    /**

     * Count the number of columns returned by the DBMS in a query result.

     *

     * @return mixed integer value with the number of columns, a MDB2 error

     *                       on failure

     * @access public

     */

    function numCols()

    {

        $cols = @mysql_num_fields($this->result);

        if (is_null($cols)) {

            if ($this->result === false) {

                return $this->db->raiseError(MDB2_ERROR_NEED_MORE_DATA, null, null,

                    'resultset has already been freed', __FUNCTION__);

            } elseif (is_null($this->result)) {

                return count($this->types);

            }

            return $this->db->raiseError(null, null, null,

                'Could not get column count', __FUNCTION__);

        }

        return $cols;

    }



    // }}}

    // {{{ free()



    /**

     * Free the internal resources associated with result.

     *

     * @return boolean true on success, false if result is invalid

     * @access public

     */

    function free()

    {

        if (is_resource($this->result) && $this->db->connection) {

            $free = @mysql_free_result($this->result);

            if ($free === false) {

                return $this->db->raiseError(null, null, null,

                    'Could not free result', __FUNCTION__);

            }

        }

        $this->result = false;

        return MDB2_OK;

    }

}



/**

 * MDB2 MySQL buffered result driver

 *

 * @package MDB2

 * @category Database

 * @author  Lukas Smith <smith@pooteeweet.org>

 */

class MDB2_BufferedResult_mysql extends MDB2_Result_mysql

{

    // }}}

    // {{{ seek()



    /**

     * Seek to a specific row in a result set

     *

     * @param int    $rownum    number of the row where the data can be found

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function seek($rownum = 0)

    {

        if ($this->rownum != ($rownum - 1) && !@mysql_data_seek($this->result, $rownum)) {

            if ($this->result === false) {

                return $this->db->raiseError(MDB2_ERROR_NEED_MORE_DATA, null, null,

                    'resultset has already been freed', __FUNCTION__);

            } elseif (is_null($this->result)) {

                return MDB2_OK;

            }

            return $this->db->raiseError(MDB2_ERROR_INVALID, null, null,

                'tried to seek to an invalid row number ('.$rownum.')', __FUNCTION__);

        }

        $this->rownum = $rownum - 1;

        return MDB2_OK;

    }



    // }}}

    // {{{ valid()



    /**

     * Check if the end of the result set has been reached

     *

     * @return mixed true or false on sucess, a MDB2 error on failure

     * @access public

     */

    function valid()

    {

        $numrows = $this->numRows();

        if (PEAR::isError($numrows)) {

            return $numrows;

        }

        return $this->rownum < ($numrows - 1);

    }



    // }}}

    // {{{ numRows()



    /**

     * Returns the number of rows in a result object

     *

     * @return mixed MDB2 Error Object or the number of rows

     * @access public

     */

    function numRows()

    {

        $rows = @mysql_num_rows($this->result);

        if (false === $rows) {

            if (false === $this->result) {

                return $this->db->raiseError(MDB2_ERROR_NEED_MORE_DATA, null, null,

                    'resultset has already been freed', __FUNCTION__);

            } elseif (is_null($this->result)) {

                return 0;

            }

            return $this->db->raiseError(null, null, null,

                'Could not get row count', __FUNCTION__);

        }

        return $rows;

    }

}



/**

 * MDB2 MySQL statement driver

 *

 * @package MDB2

 * @category Database

 * @author  Lukas Smith <smith@pooteeweet.org>

 */

class MDB2_Statement_mysql extends MDB2_Statement_Common

{

    // {{{ _execute()



    /**

     * Execute a prepared query statement helper method.

     *

     * @param mixed $result_class string which specifies which result class to use

     * @param mixed $result_wrap_class string which specifies which class to wrap results in

     * @return mixed a result handle or MDB2_OK on success, a MDB2 error on failure

     * @access private

     */

    function &_execute($result_class = true, $result_wrap_class = false)

    {

        if (is_null($this->statement)) {

            $result =& parent::_execute($result_class, $result_wrap_class);

            return $result;

        }

        $this->db->last_query = $this->query;

        $this->db->debug($this->query, 'execute', array('is_manip' => $this->is_manip, 'when' => 'pre', 'parameters' => $this->values));

        if ($this->db->getOption('disable_query')) {

            $result = $this->is_manip ? 0 : null;

            return $result;

        }



        $connection = $this->db->getConnection();

        if (PEAR::isError($connection)) {

            return $connection;

        }



        $query = 'EXECUTE '.$this->statement;

        if (!empty($this->positions)) {

            $parameters = array();

            foreach ($this->positions as $parameter) {

                if (!array_key_exists($parameter, $this->values)) {

                    return $this->db->raiseError(MDB2_ERROR_NOT_FOUND, null, null,

                        'Unable to bind to missing placeholder: '.$parameter, __FUNCTION__);

                }

                $value = $this->values[$parameter];

                $type = array_key_exists($parameter, $this->types) ? $this->types[$parameter] : null;

                if (is_resource($value) || $type == 'clob' || $type == 'blob' && $this->db->options['lob_allow_url_include']) {

                    if (!is_resource($value) && preg_match('/^(\w+:\/\/)(.*)$/', $value, $match)) {

                        if ($match[1] == 'file://') {

                            $value = $match[2];

                        }

                        $value = @fopen($value, 'r');

                        $close = true;

                    }

                    if (is_resource($value)) {

                        $data = '';

                        while (!@feof($value)) {

                            $data.= @fread($value, $this->db->options['lob_buffer_length']);

                        }

                        if ($close) {

                            @fclose($value);

                        }

                        $value = $data;

                    }

                }

                $quoted = $this->db->quote($value, $type);

                if (PEAR::isError($quoted)) {

                    return $quoted;

                }

                $param_query = 'SET @'.$parameter.' = '.$quoted;

                $result = $this->db->_doQuery($param_query, true, $connection);

                if (PEAR::isError($result)) {

                    return $result;

                }

            }

            $query.= ' USING @'.implode(', @', array_values($this->positions));

        }



        $result = $this->db->_doQuery($query, $this->is_manip, $connection);

        if (PEAR::isError($result)) {

            return $result;

        }



        if ($this->is_manip) {

            $affected_rows = $this->db->_affectedRows($connection, $result);

            return $affected_rows;

        }



        $result =& $this->db->_wrapResult($result, $this->result_types,

            $result_class, $result_wrap_class, $this->limit, $this->offset);

        $this->db->debug($this->query, 'execute', array('is_manip' => $this->is_manip, 'when' => 'post', 'result' => $result));

        return $result;

    }



    // }}}

    // {{{ free()



    /**

     * Release resources allocated for the specified prepared query.

     *

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function free()

    {

        if (is_null($this->positions)) {

            return $this->db->raiseError(MDB2_ERROR, null, null,

                'Prepared statement has already been freed', __FUNCTION__);

        }

        $result = MDB2_OK;



        if (!is_null($this->statement)) {

            $connection = $this->db->getConnection();

            if (PEAR::isError($connection)) {

                return $connection;

            }

            $query = 'DEALLOCATE PREPARE '.$this->statement;

            $result = $this->db->_doQuery($query, true, $connection);

        }



        parent::free();

        return $result;

    }

}

<?php
// vim: set et ts=4 sw=4 fdm=marker:
// +----------------------------------------------------------------------+
// | PHP versions 4 and 5                                                 |
// +----------------------------------------------------------------------+
// | Copyright (c) 1998-2008 Manuel Lemos, Tomas V.V.Cox,                 |
// | Stig. S. Bakken, Lukas Smith                                         |
// | All rights reserved.                                                 |
// +----------------------------------------------------------------------+
// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |
// | API as well as database abstraction for PHP applications.            |
// | This LICENSE is in the BSD license style.                            |
// |                                                                      |
// | Redistribution and use in source and binary forms, with or without   |
// | modification, are permitted provided that the following conditions   |
// | are met:                                                             |
// |                                                                      |
// | Redistributions of source code must retain the above copyright       |
// | notice, this list of conditions and the following disclaimer.        |
// |                                                                      |
// | Redistributions in binary form must reproduce the above copyright    |
// | notice, this list of conditions and the following disclaimer in the  |
// | documentation and/or other materials provided with the distribution. |
// |                                                                      |
// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |
// | Lukas Smith nor the names of his contributors may be used to endorse |
// | or promote products derived from this software without specific prior|
// | written permission.                                                  |
// |                                                                      |
// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |
// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |
// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |
// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |
// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |
// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |
// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|
// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |
// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |
// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|
// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |
// | POSSIBILITY OF SUCH DAMAGE.                                          |
// +----------------------------------------------------------------------+
// | Author: Lukas Smith <smith@pooteeweet.org>                           |
// +----------------------------------------------------------------------+
//
// $Id: mysql.php,v 1.208 2008/03/13 03:31:55 afz Exp $
//

/**
 * MDB2 MySQL driver
 *
 * @package MDB2
 * @category Database
 * @author  Lukas Smith <smith@pooteeweet.org>
 */
class MDB2_Driver_mysql extends MDB2_Driver_Common
{
    // {{{ properties

    var $string_quoting = array('start' => "'", 'end' => "'", 'escape' => '\\', 'escape_pattern' => '\\');

    var $identifier_quoting = array('start' => '`', 'end' => '`', 'escape' => '`');

    var $sql_comments = array(
        array('start' => '-- ', 'end' => "\n", 'escape' => false),
        array('start' => '#', 'end' => "\n", 'escape' => false),
        array('start' => '/*', 'end' => '*/', 'escape' => false),
    );

    var $server_capabilities_checked = false;

    var $start_transaction = false;

    var $varchar_max_length = 255;

    // }}}
    // {{{ constructor

    /**
     * Constructor
     */
    function __construct()
    {
        parent::__construct();

        $this->phptype = 'mysql';
        $this->dbsyntax = 'mysql';

        $this->supported['sequences'] = 'emulated';
        $this->supported['indexes'] = true;
        $this->supported['affected_rows'] = true;
        $this->supported['transactions'] = false;
        $this->supported['savepoints'] = false;
        $this->supported['summary_functions'] = true;
        $this->supported['order_by_text'] = true;
        $this->supported['current_id'] = 'emulated';
        $this->supported['limit_queries'] = true;
        $this->supported['LOBs'] = true;
        $this->supported['replace'] = true;
        $this->supported['sub_selects'] = 'emulated';
        $this->supported['triggers'] = false;
        $this->supported['auto_increment'] = true;
        $this->supported['primary_key'] = true;
        $this->supported['result_introspection'] = true;
        $this->supported['prepared_statements'] = 'emulated';
        $this->supported['identifier_quoting'] = true;
        $this->supported['pattern_escaping'] = true;
        $this->supported['new_link'] = true;

        $this->options['DBA_username'] = false;
        $this->options['DBA_password'] = false;
        $this->options['default_table_type'] = '';
        $this->options['max_identifiers_length'] = 64;

        $this->_reCheckSupportedOptions();
    }

    // }}}
    // {{{ _reCheckSupportedOptions()
    
    /**
     * If the user changes certain options, other capabilities may depend
     * on the new settings, so we need to check them (again).
     *
     * @access private
     */
    function _reCheckSupportedOptions()
    {
        $this->supported['transactions'] = $this->options['use_transactions'];
        $this->supported['savepoints']   = $this->options['use_transactions'];
        if ($this->options['default_table_type']) {
            switch (strtoupper($this->options['default_table_type'])) {
            case 'BLACKHOLE':
            case 'MEMORY':
            case 'ARCHIVE':
            case 'CSV':
            case 'HEAP':
            case 'ISAM':
            case 'MERGE':
            case 'MRG_ISAM':
            case 'ISAM':
            case 'MRG_MYISAM':
            case 'MYISAM':
                $this->supported['savepoints']   = false;
                $this->supported['transactions'] = false;
                $this->warnings[] = $this->options['default_table_type'] .
                    ' is not a supported default table type';
                break;
            }
        }
    }

    // }}}
    // {{{ function setOption($option, $value)

    /**
     * set the option for the db class
     *
     * @param   string  option name
     * @param   mixed   value for the option
     *
     * @return  mixed   MDB2_OK or MDB2 Error Object
     *
     * @access  public
     */
    function setOption($option, $value)
    {
        $res = parent::setOption($option, $value);
        $this->_reCheckSupportedOptions();
    }

    // }}}
    // {{{ errorInfo()

    /**
     * This method is used to collect information about an error
     *
     * @param integer $error
     * @return array
     * @access public
     */
    function errorInfo($error = null)
    {
        if ($this->connection) {
            $native_code = @mysql_errno($this->connection);
            $native_msg  = @mysql_error($this->connection);
        } else {
            $native_code = @mysql_errno();
            $native_msg  = @mysql_error();
        }
        if (is_null($error)) {
            static $ecode_map;
            if (empty($ecode_map)) {
                $ecode_map = array(
                    1000 => MDB2_ERROR_INVALID, //hashchk
                    1001 => MDB2_ERROR_INVALID, //isamchk
                    1004 => MDB2_ERROR_CANNOT_CREATE,
                    1005 => MDB2_ERROR_CANNOT_CREATE,
                    1006 => MDB2_ERROR_CANNOT_CREATE,
                    1007 => MDB2_ERROR_ALREADY_EXISTS,
                    1008 => MDB2_ERROR_CANNOT_DROP,
                    1009 => MDB2_ERROR_CANNOT_DROP,
                    1010 => MDB2_ERROR_CANNOT_DROP,
                    1011 => MDB2_ERROR_CANNOT_DELETE,
                    1022 => MDB2_ERROR_ALREADY_EXISTS,
                    1029 => MDB2_ERROR_NOT_FOUND,
                    1032 => MDB2_ERROR_NOT_FOUND,
                    1044 => MDB2_ERROR_ACCESS_VIOLATION,
                    1045 => MDB2_ERROR_ACCESS_VIOLATION,
                    1046 => MDB2_ERROR_NODBSELECTED,
                    1048 => MDB2_ERROR_CONSTRAINT,
                    1049 => MDB2_ERROR_NOSUCHDB,
                    1050 => MDB2_ERROR_ALREADY_EXISTS,
                    1051 => MDB2_ERROR_NOSUCHTABLE,
                    1054 => MDB2_ERROR_NOSUCHFIELD,
                    1060 => MDB2_ERROR_ALREADY_EXISTS,
                    1061 => MDB2_ERROR_ALREADY_EXISTS,
                    1062 => MDB2_ERROR_ALREADY_EXISTS,
                    1064 => MDB2_ERROR_SYNTAX,
                    1067 => MDB2_ERROR_INVALID,
                    1072 => MDB2_ERROR_NOT_FOUND,
                    1086 => MDB2_ERROR_ALREADY_EXISTS,
                    1091 => MDB2_ERROR_NOT_FOUND,
                    1100 => MDB2_ERROR_NOT_LOCKED,
                    1109 => MDB2_ERROR_NOT_FOUND,
                    1125 => MDB2_ERROR_ALREADY_EXISTS,
                    1136 => MDB2_ERROR_VALUE_COUNT_ON_ROW,
                    1138 => MDB2_ERROR_INVALID,
                    1142 => MDB2_ERROR_ACCESS_VIOLATION,
                    1143 => MDB2_ERROR_ACCESS_VIOLATION,
                    1146 => MDB2_ERROR_NOSUCHTABLE,
                    1149 => MDB2_ERROR_SYNTAX,
                    1169 => MDB2_ERROR_CONSTRAINT,
                    1176 => MDB2_ERROR_NOT_FOUND,
                    1177 => MDB2_ERROR_NOSUCHTABLE,
                    1213 => MDB2_ERROR_DEADLOCK,
                    1216 => MDB2_ERROR_CONSTRAINT,
                    1217 => MDB2_ERROR_CONSTRAINT,
                    1227 => MDB2_ERROR_ACCESS_VIOLATION,
                    1235 => MDB2_ERROR_CANNOT_CREATE,
                    1299 => MDB2_ERROR_INVALID_DATE,
                    1300 => MDB2_ERROR_INVALID,
                    1304 => MDB2_ERROR_ALREADY_EXISTS,
                    1305 => MDB2_ERROR_NOT_FOUND,
                    1306 => MDB2_ERROR_CANNOT_DROP,
                    1307 => MDB2_ERROR_CANNOT_CREATE,
                    1334 => MDB2_ERROR_CANNOT_ALTER,
                    1339 => MDB2_ERROR_NOT_FOUND,
                    1356 => MDB2_ERROR_INVALID,
                    1359 => MDB2_ERROR_ALREADY_EXISTS,
                    1360 => MDB2_ERROR_NOT_FOUND,
                    1363 => MDB2_ERROR_NOT_FOUND,
                    1365 => MDB2_ERROR_DIVZERO,
                    1451 => MDB2_ERROR_CONSTRAINT,
                    1452 => MDB2_ERROR_CONSTRAINT,
                    1542 => MDB2_ERROR_CANNOT_DROP,
                    1546 => MDB2_ERROR_CONSTRAINT,
                    1582 => MDB2_ERROR_CONSTRAINT,
                    2003 => MDB2_ERROR_CONNECT_FAILED,
                    2019 => MDB2_ERROR_INVALID,
                );
            }
            if ($this->options['portability'] & MDB2_PORTABILITY_ERRORS) {
                $ecode_map[1022] = MDB2_ERROR_CONSTRAINT;
                $ecode_map[1048] = MDB2_ERROR_CONSTRAINT_NOT_NULL;
                $ecode_map[1062] = MDB2_ERROR_CONSTRAINT;
            } else {
                // Doing this in case mode changes during runtime.
                $ecode_map[1022] = MDB2_ERROR_ALREADY_EXISTS;
                $ecode_map[1048] = MDB2_ERROR_CONSTRAINT;
                $ecode_map[1062] = MDB2_ERROR_ALREADY_EXISTS;
            }
            if (isset($ecode_map[$native_code])) {
                $error = $ecode_map[$native_code];
            }
        }
        return array($error, $native_code, $native_msg);
    }

    // }}}
    // {{{ escape()

    /**
     * Quotes a string so it can be safely used in a query. It will quote
     * the text so it can safely be used within a query.
     *
     * @param   string  the input string to quote
     * @param   bool    escape wildcards
     *
     * @return  string  quoted string
     *
     * @access  public
     */
    function escape($text, $escape_wildcards = false)
    {
        if ($escape_wildcards) {
            $text = $this->escapePattern($text);
        }
        $connection = $this->getConnection();
        if (PEAR::isError($connection)) {
            return $connection;
        }
        $text = @mysql_real_escape_string($text, $connection);
        return $text;
    }

    // }}}
    // {{{ beginTransaction()

    /**
     * Start a transaction or set a savepoint.
     *
     * @param   string  name of a savepoint to set
     * @return  mixed   MDB2_OK on success, a MDB2 error on failure
     *
     * @access  public
     */
    function beginTransaction($savepoint = null)
    {
        $this->debug('Starting transaction/savepoint', __FUNCTION__, array('is_manip' => true, 'savepoint' => $savepoint));
        $this->_getServerCapabilities();
        if (!is_null($savepoint)) {
            if (!$this->supports('savepoints')) {
                return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
                    'savepoints are not supported', __FUNCTION__);
            }
            if (!$this->in_transaction) {
                return $this->raiseError(MDB2_ERROR_INVALID, null, null,
                    'savepoint cannot be released when changes are auto committed', __FUNCTION__);
            }
            $query = 'SAVEPOINT '.$savepoint;
            return $this->_doQuery($query, true);
        } elseif ($this->in_transaction) {
            return MDB2_OK;  //nothing to do
        }
        if (!$this->destructor_registered && $this->opened_persistent) {
            $this->destructor_registered = true;
            register_shutdown_function('MDB2_closeOpenTransactions');
        }
        $query = $this->start_transaction ? 'START TRANSACTION' : 'SET AUTOCOMMIT = 1';
        $result =& $this->_doQuery($query, true);
        if (PEAR::isError($result)) {
            return $result;
        }
        $this->in_transaction = true;
        return MDB2_OK;
    }

    // }}}
    // {{{ commit()

    /**
     * Commit the database changes done during a transaction that is in
     * progress or release a savepoint. This function may only be called when
     * auto-committing is disabled, otherwise it will fail. Therefore, a new
     * transaction is implicitly started after committing the pending changes.
     *
     * @param   string  name of a savepoint to release
     * @return  mixed   MDB2_OK on success, a MDB2 error on failure
     *
     * @access  public
     */
    function commit($savepoint = null)
    {
        $this->debug('Committing transaction/savepoint', __FUNCTION__, array('is_manip' => true, 'savepoint' => $savepoint));
        if (!$this->in_transaction) {
            return $this->raiseError(MDB2_ERROR_INVALID, null, null,
                'commit/release savepoint cannot be done changes are auto committed', __FUNCTION__);
        }
        if (!is_null($savepoint)) {
            if (!$this->supports('savepoints')) {
                return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
                    'savepoints are not supported', __FUNCTION__);
            }
            $server_info = $this->getServerVersion();
            if (version_compare($server_info['major'].'.'.$server_info['minor'].'.'.$server_info['patch'], '5.0.3', '<')) {
                return MDB2_OK;
            }
            $query = 'RELEASE SAVEPOINT '.$savepoint;
            return $this->_doQuery($query, true);
        }

        if (!$this->supports('transactions')) {
            return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
                'transactions are not supported', __FUNCTION__);
        }

        $result =& $this->_doQuery('COMMIT', true);
        if (PEAR::isError($result)) {
            return $result;
        }
        if (!$this->start_transaction) {
            $query = 'SET AUTOCOMMIT = 0';
            $result =& $this->_doQuery($query, true);
            if (PEAR::isError($result)) {
                return $result;
            }
        }
        $this->in_transaction = false;
        return MDB2_OK;
    }

    // }}}
    // {{{ rollback()

    /**
     * Cancel any database changes done during a transaction or since a specific
     * savepoint that is in progress. This function may only be called when
     * auto-committing is disabled, otherwise it will fail. Therefore, a new
     * transaction is implicitly started after canceling the pending changes.
     *
     * @param   string  name of a savepoint to rollback to
     * @return  mixed   MDB2_OK on success, a MDB2 error on failure
     *
     * @access  public
     */
    function rollback($savepoint = null)
    {
        $this->debug('Rolling back transaction/savepoint', __FUNCTION__, array('is_manip' => true, 'savepoint' => $savepoint));
        if (!$this->in_transaction) {
            return $this->raiseError(MDB2_ERROR_INVALID, null, null,
                'rollback cannot be done changes are auto committed', __FUNCTION__);
        }
        if (!is_null($savepoint)) {
            if (!$this->supports('savepoints')) {
                return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
                    'savepoints are not supported', __FUNCTION__);
            }
            $query = 'ROLLBACK TO SAVEPOINT '.$savepoint;
            return $this->_doQuery($query, true);
        }

        $query = 'ROLLBACK';
        $result =& $this->_doQuery($query, true);
        if (PEAR::isError($result)) {
            return $result;
        }
        if (!$this->start_transaction) {
            $query = 'SET AUTOCOMMIT = 0';
            $result =& $this->_doQuery($query, true);
            if (PEAR::isError($result)) {
                return $result;
            }
        }
        $this->in_transaction = false;
        return MDB2_OK;
    }

    // }}}
    // {{{ function setTransactionIsolation()

    /**
     * Set the transacton isolation level.
     *
     * @param   string  standard isolation level
     *                  READ UNCOMMITTED (allows dirty reads)
     *                  READ COMMITTED (prevents dirty reads)
     *                  REPEATABLE READ (prevents nonrepeatable reads)
     *                  SERIALIZABLE (prevents phantom reads)
     * @return  mixed   MDB2_OK on success, a MDB2 error on failure
     *
     * @access  public
     * @since   2.1.1
     */
    function setTransactionIsolation($isolation)
    {
        $this->debug('Setting transaction isolation level', __FUNCTION__, array('is_manip' => true));
        if (!$this->supports('transactions')) {
            return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
                'transactions are not supported', __FUNCTION__);
        }
        switch ($isolation) {
        case 'READ UNCOMMITTED':
        case 'READ COMMITTED':
        case 'REPEATABLE READ':
        case 'SERIALIZABLE':
            break;
        default:
            return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
                'isolation level is not supported: '.$isolation, __FUNCTION__);
        }

        $query = "SET SESSION TRANSACTION ISOLATION LEVEL $isolation";
        return $this->_doQuery($query, true);
    }

    // }}}
    // {{{ _doConnect()

    /**
     * do the grunt work of the connect
     *
     * @return connection on success or MDB2 Error Object on failure
     * @access protected
     */
    function _doConnect($username, $password, $persistent = false)
    {
        if (!PEAR::loadExtension($this->phptype)) {
            return $this->raiseError(MDB2_ERROR_NOT_FOUND, null, null,
                'extension '.$this->phptype.' is not compiled into PHP', __FUNCTION__);
        }

        $params = array();
        if ($this->dsn['protocol'] && $this->dsn['protocol'] == 'unix') {
            $params[0] = ':' . $this->dsn['socket'];
        } else {
            $params[0] = $this->dsn['hostspec'] ? $this->dsn['hostspec']
                         : 'localhost';
            if ($this->dsn['port']) {
                $params[0].= ':' . $this->dsn['port'];
            }
        }
        $params[] = $username ? $username : null;
        $params[] = $password ? $password : null;
        if (!$persistent) {
            if (isset($this->dsn['new_link'])
                && ($this->dsn['new_link'] == 'true' || $this->dsn['new_link'] === true)
            ) {
                $params[] = true;
            } else {
                $params[] = false;
            }
        }
        if (version_compare(phpversion(), '4.3.0', '>=')) {
            $params[] = isset($this->dsn['client_flags'])
                ? $this->dsn['client_flags'] : null;
        }
        $connect_function = $persistent ? 'mysql_pconnect' : 'mysql_connect';

        $connection = @call_user_func_array($connect_function, $params);
        if (!$connection) {
            if (($err = @mysql_error()) != '') {
                return $this->raiseError(MDB2_ERROR_CONNECT_FAILED, null, null,
                    $err, __FUNCTION__);
            } else {
                return $this->raiseError(MDB2_ERROR_CONNECT_FAILED, null, null,
                    'unable to establish a connection', __FUNCTION__);
            }
        }

        if (!empty($this->dsn['charset'])) {
            $result = $this->setCharset($this->dsn['charset'], $connection);
            if (PEAR::isError($result)) {
                $this->disconnect(false);
                return $result;
            }
        }

        return $connection;
    }

    // }}}
    // {{{ connect()

    /**
     * Connect to the database
     *
     * @return MDB2_OK on success, MDB2 Error Object on failure
     * @access public
     */
    function connect()
    {
        if (is_resource($this->connection)) {
            //if (count(array_diff($this->connected_dsn, $this->dsn)) == 0
            if (MDB2::areEquals($this->connected_dsn, $this->dsn)
                && $this->opened_persistent == $this->options['persistent']
            ) {
                return MDB2_OK;
            }
            $this->disconnect(false);
        }

        $connection = $this->_doConnect(
            $this->dsn['username'],
            $this->dsn['password'],
            $this->options['persistent']
        );
        if (PEAR::isError($connection)) {
            return $connection;
        }

        $this->connection = $connection;
        $this->connected_dsn = $this->dsn;
        $this->connected_database_name = '';
        $this->opened_persistent = $this->options['persistent'];
        $this->dbsyntax = $this->dsn['dbsyntax'] ? $this->dsn['dbsyntax'] : $this->phptype;

        if ($this->database_name) {
            if ($this->database_name != $this->connected_database_name) {
                if (!@mysql_select_db($this->database_name, $connection)) {
                    $err = $this->raiseError(null, null, null,
                        'Could not select the database: '.$this->database_name, __FUNCTION__);
                    return $err;
                }
                $this->connected_database_name = $this->database_name;
            }
        }

        $this->_getServerCapabilities();

        return MDB2_OK;
    }

    // }}}
    // {{{ setCharset()

    /**
     * Set the charset on the current connection
     *
     * @param string    charset (or array(charset, collation))
     * @param resource  connection handle
     *
     * @return true on success, MDB2 Error Object on failure
     */
    function setCharset($charset, $connection = null)
    {
        if (is_null($connection)) {
            $connection = $this->getConnection();
            if (PEAR::isError($connection)) {
                return $connection;
            }
        }
        $collation = null;
        if (is_array($charset) && 2 == count($charset)) {
            $collation = array_pop($charset);
            $charset   = array_pop($charset);
        }
        $query = "SET NAMES '".mysql_real_escape_string($charset, $connection)."'";
        if (!is_null($collation)) {
            $query .= " COLLATE '".mysqli_real_escape_string($connection, $collation)."'";
        }
        return $this->_doQuery($query, true, $connection);
    }

    // }}}
    // {{{ databaseExists()

    /**
     * check if given database name is exists?
     *
     * @param string $name    name of the database that should be checked
     *
     * @return mixed true/false on success, a MDB2 error on failure
     * @access public
     */
    function databaseExists($name)
    {
        $connection = $this->_doConnect($this->dsn['username'],
                                        $this->dsn['password'],
                                        $this->options['persistent']);
        if (PEAR::isError($connection)) {
            return $connection;
        }

        $result = @mysql_select_db($name, $connection);
        @mysql_close($connection);

        return $result;
    }

    // }}}
    // {{{ disconnect()

    /**
     * Log out and disconnect from the database.
     *
     * @param  boolean $force if the disconnect should be forced even if the
     *                        connection is opened persistently
     * @return mixed true on success, false if not connected and error
     *                object on error
     * @access public
     */
    function disconnect($force = true)
    {
        if (is_resource($this->connection)) {
            if ($this->in_transaction) {
                $dsn = $this->dsn;
                $database_name = $this->database_name;
                $persistent = $this->options['persistent'];
                $this->dsn = $this->connected_dsn;
                $this->database_name = $this->connected_database_name;
                $this->options['persistent'] = $this->opened_persistent;
                $this->rollback();
                $this->dsn = $dsn;
                $this->database_name = $database_name;
                $this->options['persistent'] = $persistent;
            }

            if (!$this->opened_persistent || $force) {
                @mysql_close($this->connection);
            }
        }
        return parent::disconnect($force);
    }

    // }}}
    // {{{ standaloneQuery()

   /**
     * execute a query as DBA
     *
     * @param string $query the SQL query
     * @param mixed   $types  array that contains the types of the columns in
     *                        the result set
     * @param boolean $is_manip  if the query is a manipulation query
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function &standaloneQuery($query, $types = null, $is_manip = false)
    {
        $user = $this->options['DBA_username']? $this->options['DBA_username'] : $this->dsn['username'];
        $pass = $this->options['DBA_password']? $this->options['DBA_password'] : $this->dsn['password'];
        $connection = $this->_doConnect($user, $pass, $this->options['persistent']);
        if (PEAR::isError($connection)) {
            return $connection;
        }

        $offset = $this->offset;
        $limit = $this->limit;
        $this->offset = $this->limit = 0;
        $query = $this->_modifyQuery($query, $is_manip, $limit, $offset);
        
        $result =& $this->_doQuery($query, $is_manip, $connection, $this->database_name);
        if (!PEAR::isError($result)) {
            $result = $this->_affectedRows($connection, $result);
        }

        @mysql_close($connection);
        return $result;
    }

    // }}}
    // {{{ _doQuery()

    /**
     * Execute a query
     * @param string $query  query
     * @param boolean $is_manip  if the query is a manipulation query
     * @param resource $connection
     * @param string $database_name
     * @return result or error object
     * @access protected
     */
    function &_doQuery($query, $is_manip = false, $connection = null, $database_name = null)
    {
        $this->last_query = $query;
        $result = $this->debug($query, 'query', array('is_manip' => $is_manip, 'when' => 'pre'));
        if ($result) {
            if (PEAR::isError($result)) {
                return $result;
            }
            $query = $result;
        }
        if ($this->options['disable_query']) {
            $result = $is_manip ? 0 : null;
            return $result;
        }

        if (is_null($connection)) {
            $connection = $this->getConnection();
            if (PEAR::isError($connection)) {
                return $connection;
            }
        }
        if (is_null($database_name)) {
            $database_name = $this->database_name;
        }

        if ($database_name) {
            if ($database_name != $this->connected_database_name) {
                if (!@mysql_select_db($database_name, $connection)) {
                    $err = $this->raiseError(null, null, null,
                        'Could not select the database: '.$database_name, __FUNCTION__);
                    return $err;
                }
                $this->connected_database_name = $database_name;
            }
        }

        $function = $this->options['result_buffering']
            ? 'mysql_query' : 'mysql_unbuffered_query';
        $result = @$function($query, $connection);
        if (!$result) {
            $err =& $this->raiseError(null, null, null,
                'Could not execute statement', __FUNCTION__);
            return $err;
        }

        $this->debug($query, 'query', array('is_manip' => $is_manip, 'when' => 'post', 'result' => $result));
        return $result;
    }

    // }}}
    // {{{ _affectedRows()

    /**
     * Returns the number of rows affected
     *
     * @param resource $result
     * @param resource $connection
     * @return mixed MDB2 Error Object or the number of rows affected
     * @access private
     */
    function _affectedRows($connection, $result = null)
    {
        if (is_null($connection)) {
            $connection = $this->getConnection();
            if (PEAR::isError($connection)) {
                return $connection;
            }
        }
        return @mysql_affected_rows($connection);
    }

    // }}}
    // {{{ _modifyQuery()

    /**
     * Changes a query string for various DBMS specific reasons
     *
     * @param string $query  query to modify
     * @param boolean $is_manip  if it is a DML query
     * @param integer $limit  limit the number of rows
     * @param integer $offset  start reading from given offset
     * @return string modified query
     * @access protected
     */
    function _modifyQuery($query, $is_manip, $limit, $offset)
    {
        if ($this->options['portability'] & MDB2_PORTABILITY_DELETE_COUNT) {
            // "DELETE FROM table" gives 0 affected rows in MySQL.
            // This little hack lets you know how many rows were deleted.
            if (preg_match('/^\s*DELETE\s+FROM\s+(\S+)\s*$/i', $query)) {
                $query = preg_replace('/^\s*DELETE\s+FROM\s+(\S+)\s*$/',
                                      'DELETE FROM \1 WHERE 1=1', $query);
            }
        }
        if ($limit > 0
            && !preg_match('/LIMIT\s*\d(?:\s*(?:,|OFFSET)\s*\d+)?(?:[^\)]*)?$/i', $query)
        ) {
            $query = rtrim($query);
            if (substr($query, -1) == ';') {
                $query = substr($query, 0, -1);
            }

            // LIMIT doesn't always come last in the query
            // @see http://dev.mysql.com/doc/refman/5.0/en/select.html
            $after = '';
            if (preg_match('/(\s+INTO\s+(?:OUT|DUMP)FILE\s.*)$/ims', $query, $matches)) {
                $after = $matches[0];
                $query = preg_replace('/(\s+INTO\s+(?:OUT|DUMP)FILE\s.*)$/ims', '', $query);
            } elseif (preg_match('/(\s+FOR\s+UPDATE\s*)$/i', $query, $matches)) {
               $after = $matches[0];
               $query = preg_replace('/(\s+FOR\s+UPDATE\s*)$/im', '', $query);
            } elseif (preg_match('/(\s+LOCK\s+IN\s+SHARE\s+MODE\s*)$/im', $query, $matches)) {
               $after = $matches[0];
               $query = preg_replace('/(\s+LOCK\s+IN\s+SHARE\s+MODE\s*)$/im', '', $query);
            }

            if ($is_manip) {
                return $query . " LIMIT $limit" . $after;
            } else {
                return $query . " LIMIT $offset, $limit" . $after;
            }
        }
        return $query;
    }

    // }}}
    // {{{ getServerVersion()

    /**
     * return version information about the server
     *
     * @param bool   $native  determines if the raw version string should be returned
     * @return mixed array/string with version information or MDB2 error object
     * @access public
     */
    function getServerVersion($native = false)
    {
        $connection = $this->getConnection();
        if (PEAR::isError($connection)) {
            return $connection;
        }
        if ($this->connected_server_info) {
            $server_info = $this->connected_server_info;
        } else {
            $server_info = @mysql_get_server_info($connection);
        }
        if (!$server_info) {
            return $this->raiseError(null, null, null,
                'Could not get server information', __FUNCTION__);
        }
        // cache server_info
        $this->connected_server_info = $server_info;
        if (!$native) {
            $tmp = explode('.', $server_info, 3);
            if (isset($tmp[2]) && strpos($tmp[2], '-')) {
                $tmp2 = explode('-', @$tmp[2], 2);
            } else {
                $tmp2[0] = isset($tmp[2]) ? $tmp[2] : null;
                $tmp2[1] = null;
            }
            $server_info = array(
                'major' => isset($tmp[0]) ? $tmp[0] : null,
                'minor' => isset($tmp[1]) ? $tmp[1] : null,
                'patch' => $tmp2[0],
                'extra' => $tmp2[1],
                'native' => $server_info,
            );
        }
        return $server_info;
    }

    // }}}
    // {{{ _getServerCapabilities()

    /**
     * Fetch some information about the server capabilities
     * (transactions, subselects, prepared statements, etc).
     *
     * @access private
     */
    function _getServerCapabilities()
    {
        if (!$this->server_capabilities_checked) {
            $this->server_capabilities_checked = true;

            //set defaults
            $this->supported['sub_selects'] = 'emulated';
            $this->supported['prepared_statements'] = 'emulated';
            $this->supported['triggers'] = false;
            $this->start_transaction = false;
            $this->varchar_max_length = 255;
            
            $server_info = $this->getServerVersion();
            if (is_array($server_info)) {
                $server_version = $server_info['major'].'.'.$server_info['minor'].'.'.$server_info['patch'];

                if (!version_compare($server_version, '4.1.0', '<')) {
                    $this->supported['sub_selects'] = true;
                    $this->supported['prepared_statements'] = true;
                }

                // SAVEPOINTs were introduced in MySQL 4.0.14 and 4.1.1 (InnoDB)
                if (version_compare($server_version, '4.1.0', '>=')) {
                    if (version_compare($server_version, '4.1.1', '<')) {
                        $this->supported['savepoints'] = false;
                    }
                } elseif (version_compare($server_version, '4.0.14', '<')) {
                    $this->supported['savepoints'] = false;
                }

                if (!version_compare($server_version, '4.0.11', '<')) {
                    $this->start_transaction = true;
                }

                if (!version_compare($server_version, '5.0.3', '<')) {
                    $this->varchar_max_length = 65532;
                }

                if (!version_compare($server_version, '5.0.2', '<')) {
                    $this->supported['triggers'] = true;
                }
            }
        }
    }

    // }}}
    // {{{ function _skipUserDefinedVariable($query, $position)

    /**
     * Utility method, used by prepare() to avoid misinterpreting MySQL user 
     * defined variables (SELECT @x:=5) for placeholders.
     * Check if the placeholder is a false positive, i.e. if it is an user defined
     * variable instead. If so, skip it and advance the position, otherwise
     * return the current position, which is valid
     *
     * @param string $query
     * @param integer $position current string cursor position
     * @return integer $new_position
     * @access protected
     */
    function _skipUserDefinedVariable($query, $position)
    {
        $found = strpos(strrev(substr($query, 0, $position)), '@');
        if ($found === false) {
            return $position;
        }
        $pos = strlen($query) - strlen(substr($query, $position)) - $found - 1;
        $substring = substr($query, $pos, $position - $pos + 2);
        if (preg_match('/^@\w+\s*:=$/', $substring)) {
            return $position + 1; //found an user defined variable: skip it
        }
        return $position;
    }

    // }}}
    // {{{ prepare()

    /**
     * Prepares a query for multiple execution with execute().
     * With some database backends, this is emulated.
     * prepare() requires a generic query as string like
     * 'INSERT INTO numbers VALUES(?,?)' or
     * 'INSERT INTO numbers VALUES(:foo,:bar)'.
     * The ? and :name and are placeholders which can be set using
     * bindParam() and the query can be sent off using the execute() method.
     * The allowed format for :name can be set with the 'bindname_format' option.
     *
     * @param string $query the query to prepare
     * @param mixed   $types  array that contains the types of the placeholders
     * @param mixed   $result_types  array that contains the types of the columns in
     *                        the result set or MDB2_PREPARE_RESULT, if set to
     *                        MDB2_PREPARE_MANIP the query is handled as a manipulation query
     * @param mixed   $lobs   key (field) value (parameter) pair for all lob placeholders
     * @return mixed resource handle for the prepared query on success, a MDB2
     *        error on failure
     * @access public
     * @see bindParam, execute
     */
    function &prepare($query, $types = null, $result_types = null, $lobs = array())
    {
        if ($this->options['emulate_prepared']
            || $this->supported['prepared_statements'] !== true
        ) {
            $obj =& parent::prepare($query, $types, $result_types, $lobs);
            return $obj;
        }
        $is_manip = ($result_types === MDB2_PREPARE_MANIP);
        $offset = $this->offset;
        $limit = $this->limit;
        $this->offset = $this->limit = 0;
        $query = $this->_modifyQuery($query, $is_manip, $limit, $offset);
        $result = $this->debug($query, __FUNCTION__, array('is_manip' => $is_manip, 'when' => 'pre'));
        if ($result) {
            if (PEAR::isError($result)) {
                return $result;
            }
            $query = $result;
        }
        $placeholder_type_guess = $placeholder_type = null;
        $question = '?';
        $colon = ':';
        $positions = array();
        $position = 0;
        while ($position < strlen($query)) {
            $q_position = strpos($query, $question, $position);
            $c_position = strpos($query, $colon, $position);
            if ($q_position && $c_position) {
                $p_position = min($q_position, $c_position);
            } elseif ($q_position) {
                $p_position = $q_position;
            } elseif ($c_position) {
                $p_position = $c_position;
            } else {
                break;
            }
            if (is_null($placeholder_type)) {
                $placeholder_type_guess = $query[$p_position];
            }
            
            $new_pos = $this->_skipDelimitedStrings($query, $position, $p_position);
            if (PEAR::isError($new_pos)) {
                return $new_pos;
            }
            if ($new_pos != $position) {
                $position = $new_pos;
                continue; //evaluate again starting from the new position
            }
            
            //make sure this is not part of an user defined variable
            $new_pos = $this->_skipUserDefinedVariable($query, $position);
            if ($new_pos != $position) {
                $position = $new_pos;
                continue; //evaluate again starting from the new position
            }

            if ($query[$position] == $placeholder_type_guess) {
                if (is_null($placeholder_type)) {
                    $placeholder_type = $query[$p_position];
                    $question = $colon = $placeholder_type;
                }
                if ($placeholder_type == ':') {
                    $regexp = '/^.{'.($position+1).'}('.$this->options['bindname_format'].').*$/s';
                    $parameter = preg_replace($regexp, '\\1', $query);
                    if ($parameter === '') {
                        $err =& $this->raiseError(MDB2_ERROR_SYNTAX, null, null,
                            'named parameter name must match "bindname_format" option', __FUNCTION__);
                        return $err;
                    }
                    $positions[$p_position] = $parameter;
                    $query = substr_replace($query, '?', $position, strlen($parameter)+1);
                } else {
                    $positions[$p_position] = count($positions);
                }
                $position = $p_position + 1;
            } else {
                $position = $p_position;
            }
        }
        $connection = $this->getConnection();
        if (PEAR::isError($connection)) {
            return $connection;
        }
        static $prep_statement_counter = 1;
        $statement_name = sprintf($this->options['statement_format'], $this->phptype, $prep_statement_counter++ . sha1(microtime() + mt_rand()));
        $statement_name = substr(strtolower($statement_name), 0, $this->options['max_identifiers_length']);
        $query = "PREPARE $statement_name FROM ".$this->quote($query, 'text');
        $statement =& $this->_doQuery($query, true, $connection);
        if (PEAR::isError($statement)) {
            return $statement;
        }

        $class_name = 'MDB2_Statement_'.$this->phptype;
        $obj = new $class_name($this, $statement_name, $positions, $query, $types, $result_types, $is_manip, $limit, $offset);
        $this->debug($query, __FUNCTION__, array('is_manip' => $is_manip, 'when' => 'post', 'result' => $obj));
        return $obj;
    }

    // }}}
    // {{{ replace()

    /**
     * Execute a SQL REPLACE query. A REPLACE query is identical to a INSERT
     * query, except that if there is already a row in the table with the same
     * key field values, the REPLACE query just updates its values instead of
     * inserting a new row.
     *
     * The REPLACE type of query does not make part of the SQL standards. Since
     * practically only MySQL implements it natively, this type of query is
     * emulated through this method for other DBMS using standard types of
     * queries inside a transaction to assure the atomicity of the operation.
     *
     * @access public
     *
     * @param string $table name of the table on which the REPLACE query will
     *  be executed.
     * @param array $fields associative array that describes the fields and the
     *  values that will be inserted or updated in the specified table. The
     *  indexes of the array are the names of all the fields of the table. The
     *  values of the array are also associative arrays that describe the
     *  values and other properties of the table fields.
     *
     *  Here follows a list of field properties that need to be specified:
     *
     *    value:
     *          Value to be assigned to the specified field. This value may be
     *          of specified in database independent type format as this
     *          function can perform the necessary datatype conversions.
     *
     *    Default:
     *          this property is required unless the Null property
     *          is set to 1.
     *
     *    type
     *          Name of the type of the field. Currently, all types Metabase
     *          are supported except for clob and blob.
     *
     *    Default: no type conversion
     *
     *    null
     *          Boolean property that indicates that the value for this field
     *          should be set to null.
     *
     *          The default value for fields missing in INSERT queries may be
     *          specified the definition of a table. Often, the default value
     *          is already null, but since the REPLACE may be emulated using
     *          an UPDATE query, make sure that all fields of the table are
     *          listed in this function argument array.
     *
     *    Default: 0
     *
     *    key
     *          Boolean property that indicates that this field should be
     *          handled as a primary key or at least as part of the compound
     *          unique index of the table that will determine the row that will
     *          updated if it exists or inserted a new row otherwise.
     *
     *          This function will fail if no key field is specified or if the
     *          value of a key field is set to null because fields that are
     *          part of unique index they may not be null.
     *
     *    Default: 0
     *
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     */
    function replace($table, $fields)
    {
        $count = count($fields);
        $query = $values = '';
        $keys = $colnum = 0;
        for (reset($fields); $colnum < $count; next($fields), $colnum++) {
            $name = key($fields);
            if ($colnum > 0) {
                $query .= ',';
                $values.= ',';
            }
            $query.= $this->quoteIdentifier($name, true);
            if (isset($fields[$name]['null']) && $fields[$name]['null']) {
                $value = 'NULL';
            } else {
                $type = isset($fields[$name]['type']) ? $fields[$name]['type'] : null;
                $value = $this->quote($fields[$name]['value'], $type);
                if (PEAR::isError($value)) {
                    return $value;
                }
            }
            $values.= $value;
            if (isset($fields[$name]['key']) && $fields[$name]['key']) {
                if ($value === 'NULL') {
                    return $this->raiseError(MDB2_ERROR_CANNOT_REPLACE, null, null,
                        'key value '.$name.' may not be NULL', __FUNCTION__);
                }
                $keys++;
            }
        }
        if ($keys == 0) {
            return $this->raiseError(MDB2_ERROR_CANNOT_REPLACE, null, null,
                'not specified which fields are keys', __FUNCTION__);
        }

        $connection = $this->getConnection();
        if (PEAR::isError($connection)) {
            return $connection;
        }

        $table = $this->quoteIdentifier($table, true);
        $query = "REPLACE INTO $table ($query) VALUES ($values)";
        $result =& $this->_doQuery($query, true, $connection);
        if (PEAR::isError($result)) {
            return $result;
        }
        return $this->_affectedRows($connection, $result);
    }

    // }}}
    // {{{ nextID()

    /**
     * Returns the next free id of a sequence
     *
     * @param string $seq_name name of the sequence
     * @param boolean $ondemand when true the sequence is
     *                          automatic created, if it
     *                          not exists
     *
     * @return mixed MDB2 Error Object or id
     * @access public
     */
    function nextID($seq_name, $ondemand = true)
    {
        $sequence_name = $this->quoteIdentifier($this->getSequenceName($seq_name), true);
        $seqcol_name = $this->quoteIdentifier($this->options['seqcol_name'], true);
        $query = "INSERT INTO $sequence_name ($seqcol_name) VALUES (NULL)";
        $this->pushErrorHandling(PEAR_ERROR_RETURN);
        $this->expectError(MDB2_ERROR_NOSUCHTABLE);
        $result =& $this->_doQuery($query, true);
        $this->popExpect();
        $this->popErrorHandling();
        if (PEAR::isError($result)) {
            if ($ondemand && $result->getCode() == MDB2_ERROR_NOSUCHTABLE) {
                $this->loadModule('Manager', null, true);
                $result = $this->manager->createSequence($seq_name);
                if (PEAR::isError($result)) {
                    return $this->raiseError($result, null, null,
                        'on demand sequence '.$seq_name.' could not be created', __FUNCTION__);
                } else {
                    return $this->nextID($seq_name, false);
                }
            }
            return $result;
        }
        $value = $this->lastInsertID();
        if (is_numeric($value)) {
            $query = "DELETE FROM $sequence_name WHERE $seqcol_name < $value";
            $result =& $this->_doQuery($query, true);
            if (PEAR::isError($result)) {
                $this->warnings[] = 'nextID: could not delete previous sequence table values from '.$seq_name;
            }
        }
        return $value;
    }

    // }}}
    // {{{ lastInsertID()

    /**
     * Returns the autoincrement ID if supported or $id or fetches the current
     * ID in a sequence called: $table.(empty($field) ? '' : '_'.$field)
     *
     * @param string $table name of the table into which a new row was inserted
     * @param string $field name of the field into which a new row was inserted
     * @return mixed MDB2 Error Object or id
     * @access public
     */
    function lastInsertID($table = null, $field = null)
    {
        // not using mysql_insert_id() due to http://pear.php.net/bugs/bug.php?id=8051
        return $this->queryOne('SELECT LAST_INSERT_ID()', 'integer');
    }

    // }}}
    // {{{ currID()

    /**
     * Returns the current id of a sequence
     *
     * @param string $seq_name name of the sequence
     * @return mixed MDB2 Error Object or id
     * @access public
     */
    function currID($seq_name)
    {
        $sequence_name = $this->quoteIdentifier($this->getSequenceName($seq_name), true);
        $seqcol_name = $this->quoteIdentifier($this->options['seqcol_name'], true);
        $query = "SELECT MAX($seqcol_name) FROM $sequence_name";
        return $this->queryOne($query, 'integer');
    }
}

/**
 * MDB2 MySQL result driver
 *
 * @package MDB2
 * @category Database
 * @author  Lukas Smith <smith@pooteeweet.org>
 */
class MDB2_Result_mysql extends MDB2_Result_Common
{
    // }}}
    // {{{ fetchRow()

    /**
     * Fetch a row and insert the data into an existing array.
     *
     * @param int       $fetchmode  how the array data should be indexed
     * @param int    $rownum    number of the row where the data can be found
     * @return int data array on success, a MDB2 error on failure
     * @access public
     */
    function &fetchRow($fetchmode = MDB2_FETCHMODE_DEFAULT, $rownum = null)
    {
        if (!is_null($rownum)) {
            $seek = $this->seek($rownum);
            if (PEAR::isError($seek)) {
                return $seek;
            }
        }
        if ($fetchmode == MDB2_FETCHMODE_DEFAULT) {
            $fetchmode = $this->db->fetchmode;
        }
        if ($fetchmode & MDB2_FETCHMODE_ASSOC) {
            $row = @mysql_fetch_assoc($this->result);
            if (is_array($row)
                && $this->db->options['portability'] & MDB2_PORTABILITY_FIX_CASE
            ) {
                $row = array_change_key_case($row, $this->db->options['field_case']);
            }
        } else {
           $row = @mysql_fetch_row($this->result);
        }

        if (!$row) {
            if ($this->result === false) {
                $err =& $this->db->raiseError(MDB2_ERROR_NEED_MORE_DATA, null, null,
                    'resultset has already been freed', __FUNCTION__);
                return $err;
            }
            $null = null;
            return $null;
        }
        $mode = $this->db->options['portability'] & MDB2_PORTABILITY_EMPTY_TO_NULL;
        $rtrim = false;
        if ($this->db->options['portability'] & MDB2_PORTABILITY_RTRIM) {
            if (empty($this->types)) {
                $mode += MDB2_PORTABILITY_RTRIM;
            } else {
                $rtrim = true;
            }
        }
        if ($mode) {
            $this->db->_fixResultArrayValues($row, $mode);
        }
        if (!empty($this->types)) {
            $row = $this->db->datatype->convertResultRow($this->types, $row, $rtrim);
        }
        if (!empty($this->values)) {
            $this->_assignBindColumns($row);
        }
        if ($fetchmode === MDB2_FETCHMODE_OBJECT) {
            $object_class = $this->db->options['fetch_class'];
            if ($object_class == 'stdClass') {
                $row = (object) $row;
            } else {
                $row = &new $object_class($row);
            }
        }
        ++$this->rownum;
        return $row;
    }

    // }}}
    // {{{ _getColumnNames()

    /**
     * Retrieve the names of columns returned by the DBMS in a query result.
     *
     * @return  mixed   Array variable that holds the names of columns as keys
     *                  or an MDB2 error on failure.
     *                  Some DBMS may not return any columns when the result set
     *                  does not contain any rows.
     * @access private
     */
    function _getColumnNames()
    {
        $columns = array();
        $numcols = $this->numCols();
        if (PEAR::isError($numcols)) {
            return $numcols;
        }
        for ($column = 0; $column < $numcols; $column++) {
            $column_name = @mysql_field_name($this->result, $column);
            $columns[$column_name] = $column;
        }
        if ($this->db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {
            $columns = array_change_key_case($columns, $this->db->options['field_case']);
        }
        return $columns;
    }

    // }}}
    // {{{ numCols()

    /**
     * Count the number of columns returned by the DBMS in a query result.
     *
     * @return mixed integer value with the number of columns, a MDB2 error
     *                       on failure
     * @access public
     */
    function numCols()
    {
        $cols = @mysql_num_fields($this->result);
        if (is_null($cols)) {
            if ($this->result === false) {
                return $this->db->raiseError(MDB2_ERROR_NEED_MORE_DATA, null, null,
                    'resultset has already been freed', __FUNCTION__);
            } elseif (is_null($this->result)) {
                return count($this->types);
            }
            return $this->db->raiseError(null, null, null,
                'Could not get column count', __FUNCTION__);
        }
        return $cols;
    }

    // }}}
    // {{{ free()

    /**
     * Free the internal resources associated with result.
     *
     * @return boolean true on success, false if result is invalid
     * @access public
     */
    function free()
    {
        if (is_resource($this->result) && $this->db->connection) {
            $free = @mysql_free_result($this->result);
            if ($free === false) {
                return $this->db->raiseError(null, null, null,
                    'Could not free result', __FUNCTION__);
            }
        }
        $this->result = false;
        return MDB2_OK;
    }
}

/**
 * MDB2 MySQL buffered result driver
 *
 * @package MDB2
 * @category Database
 * @author  Lukas Smith <smith@pooteeweet.org>
 */
class MDB2_BufferedResult_mysql extends MDB2_Result_mysql
{
    // }}}
    // {{{ seek()

    /**
     * Seek to a specific row in a result set
     *
     * @param int    $rownum    number of the row where the data can be found
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function seek($rownum = 0)
    {
        if ($this->rownum != ($rownum - 1) && !@mysql_data_seek($this->result, $rownum)) {
            if ($this->result === false) {
                return $this->db->raiseError(MDB2_ERROR_NEED_MORE_DATA, null, null,
                    'resultset has already been freed', __FUNCTION__);
            } elseif (is_null($this->result)) {
                return MDB2_OK;
            }
            return $this->db->raiseError(MDB2_ERROR_INVALID, null, null,
                'tried to seek to an invalid row number ('.$rownum.')', __FUNCTION__);
        }
        $this->rownum = $rownum - 1;
        return MDB2_OK;
    }

    // }}}
    // {{{ valid()

    /**
     * Check if the end of the result set has been reached
     *
     * @return mixed true or false on sucess, a MDB2 error on failure
     * @access public
     */
    function valid()
    {
        $numrows = $this->numRows();
        if (PEAR::isError($numrows)) {
            return $numrows;
        }
        return $this->rownum < ($numrows - 1);
    }

    // }}}
    // {{{ numRows()

    /**
     * Returns the number of rows in a result object
     *
     * @return mixed MDB2 Error Object or the number of rows
     * @access public
     */
    function numRows()
    {
        $rows = @mysql_num_rows($this->result);
        if (false === $rows) {
            if (false === $this->result) {
                return $this->db->raiseError(MDB2_ERROR_NEED_MORE_DATA, null, null,
                    'resultset has already been freed', __FUNCTION__);
            } elseif (is_null($this->result)) {
                return 0;
            }
            return $this->db->raiseError(null, null, null,
                'Could not get row count', __FUNCTION__);
        }
        return $rows;
    }
}

/**
 * MDB2 MySQL statement driver
 *
 * @package MDB2
 * @category Database
 * @author  Lukas Smith <smith@pooteeweet.org>
 */
class MDB2_Statement_mysql extends MDB2_Statement_Common
{
    // {{{ _execute()

    /**
     * Execute a prepared query statement helper method.
     *
     * @param mixed $result_class string which specifies which result class to use
     * @param mixed $result_wrap_class string which specifies which class to wrap results in
     * @return mixed a result handle or MDB2_OK on success, a MDB2 error on failure
     * @access private
     */
    function &_execute($result_class = true, $result_wrap_class = false)
    {
        if (is_null($this->statement)) {
            $result =& parent::_execute($result_class, $result_wrap_class);
            return $result;
        }
        $this->db->last_query = $this->query;
        $this->db->debug($this->query, 'execute', array('is_manip' => $this->is_manip, 'when' => 'pre', 'parameters' => $this->values));
        if ($this->db->getOption('disable_query')) {
            $result = $this->is_manip ? 0 : null;
            return $result;
        }

        $connection = $this->db->getConnection();
        if (PEAR::isError($connection)) {
            return $connection;
        }

        $query = 'EXECUTE '.$this->statement;
        if (!empty($this->positions)) {
            $parameters = array();
            foreach ($this->positions as $parameter) {
                if (!array_key_exists($parameter, $this->values)) {
                    return $this->db->raiseError(MDB2_ERROR_NOT_FOUND, null, null,
                        'Unable to bind to missing placeholder: '.$parameter, __FUNCTION__);
                }
                $value = $this->values[$parameter];
                $type = array_key_exists($parameter, $this->types) ? $this->types[$parameter] : null;
                if (is_resource($value) || $type == 'clob' || $type == 'blob' && $this->db->options['lob_allow_url_include']) {
                    if (!is_resource($value) && preg_match('/^(\w+:\/\/)(.*)$/', $value, $match)) {
                        if ($match[1] == 'file://') {
                            $value = $match[2];
                        }
                        $value = @fopen($value, 'r');
                        $close = true;
                    }
                    if (is_resource($value)) {
                        $data = '';
                        while (!@feof($value)) {
                            $data.= @fread($value, $this->db->options['lob_buffer_length']);
                        }
                        if ($close) {
                            @fclose($value);
                        }
                        $value = $data;
                    }
                }
                $quoted = $this->db->quote($value, $type);
                if (PEAR::isError($quoted)) {
                    return $quoted;
                }
                $param_query = 'SET @'.$parameter.' = '.$quoted;
                $result = $this->db->_doQuery($param_query, true, $connection);
                if (PEAR::isError($result)) {
                    return $result;
                }
            }
            $query.= ' USING @'.implode(', @', array_values($this->positions));
        }

        $result = $this->db->_doQuery($query, $this->is_manip, $connection);
        if (PEAR::isError($result)) {
            return $result;
        }

        if ($this->is_manip) {
            $affected_rows = $this->db->_affectedRows($connection, $result);
            return $affected_rows;
        }

        $result =& $this->db->_wrapResult($result, $this->result_types,
            $result_class, $result_wrap_class, $this->limit, $this->offset);
        $this->db->debug($this->query, 'execute', array('is_manip' => $this->is_manip, 'when' => 'post', 'result' => $result));
        return $result;
    }

    // }}}
    // {{{ free()

    /**
     * Release resources allocated for the specified prepared query.
     *
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function free()
    {
        if (is_null($this->positions)) {
            return $this->db->raiseError(MDB2_ERROR, null, null,
                'Prepared statement has already been freed', __FUNCTION__);
        }
        $result = MDB2_OK;

        if (!is_null($this->statement)) {
            $connection = $this->db->getConnection();
            if (PEAR::isError($connection)) {
                return $connection;
            }
            $query = 'DEALLOCATE PREPARE '.$this->statement;
            $result = $this->db->_doQuery($query, true, $connection);
        }

        parent::free();
        return $result;
    }
}
?>

 program/lib/MDB2/Driver/mysqli.php

@@ -1,1697 +1,1841 @@
<?php

// vim: set et ts=4 sw=4 fdm=marker:

// +----------------------------------------------------------------------+

// | PHP versions 4 and 5                                                 |

// +----------------------------------------------------------------------+

// | Copyright (c) 1998-2006 Manuel Lemos, Tomas V.V.Cox,                 |

// | Stig. S. Bakken, Lukas Smith                                         |

// | All rights reserved.                                                 |

// +----------------------------------------------------------------------+

// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |

// | API as well as database abstraction for PHP applications.            |

// | This LICENSE is in the BSD license style.                            |

// |                                                                      |

// | Redistribution and use in source and binary forms, with or without   |

// | modification, are permitted provided that the following conditions   |

// | are met:                                                             |

// |                                                                      |

// | Redistributions of source code must retain the above copyright       |

// | notice, this list of conditions and the following disclaimer.        |

// |                                                                      |

// | Redistributions in binary form must reproduce the above copyright    |

// | notice, this list of conditions and the following disclaimer in the  |

// | documentation and/or other materials provided with the distribution. |

// |                                                                      |

// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |

// | Lukas Smith nor the names of his contributors may be used to endorse |

// | or promote products derived from this software without specific prior|

// | written permission.                                                  |

// |                                                                      |

// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |

// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |

// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |

// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |

// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |

// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |

// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|

// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |

// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |

// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|

// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |

// | POSSIBILITY OF SUCH DAMAGE.                                          |

// +----------------------------------------------------------------------+

// | Author: Lukas Smith <smith@pooteeweet.org>                           |

// +----------------------------------------------------------------------+

//

// $Id: mysqli.php,v 1.176 2007/11/10 13:27:03 quipo Exp $

//



/**

 * MDB2 MySQLi driver

 *

 * @package MDB2

 * @category Database

 * @author  Lukas Smith <smith@pooteeweet.org>

 */

class MDB2_Driver_mysqli extends MDB2_Driver_Common

{

    // {{{ properties



    var $string_quoting = array('start' => "'", 'end' => "'", 'escape' => '\\', 'escape_pattern' => '\\');



    var $identifier_quoting = array('start' => '`', 'end' => '`', 'escape' => '`');



    var $sql_comments = array(

        array('start' => '-- ', 'end' => "\n", 'escape' => false),

        array('start' => '#', 'end' => "\n", 'escape' => false),

        array('start' => '/*', 'end' => '*/', 'escape' => false),

    );



    var $server_capabilities_checked = false;



    var $start_transaction = false;



    var $varchar_max_length = 255;



    // }}}

    // {{{ constructor



    /**

     * Constructor

     */

    function __construct()

    {

        parent::__construct();



        $this->phptype = 'mysqli';

        $this->dbsyntax = 'mysql';



        $this->supported['sequences'] = 'emulated';

        $this->supported['indexes'] = true;

        $this->supported['affected_rows'] = true;

        $this->supported['transactions'] = false;

        $this->supported['savepoints'] = false;

        $this->supported['summary_functions'] = true;

        $this->supported['order_by_text'] = true;

        $this->supported['current_id'] = 'emulated';

        $this->supported['limit_queries'] = true;

        $this->supported['LOBs'] = true;

        $this->supported['replace'] = true;

        $this->supported['sub_selects'] = 'emulated';

        $this->supported['auto_increment'] = true;

        $this->supported['primary_key'] = true;

        $this->supported['result_introspection'] = true;

        $this->supported['prepared_statements'] = 'emulated';

        $this->supported['identifier_quoting'] = true;

        $this->supported['pattern_escaping'] = true;

        $this->supported['new_link'] = true;



        $this->options['default_table_type'] = '';

        $this->options['multi_query'] = false;

    }



    // }}}

    // {{{ errorInfo()



    /**

     * This method is used to collect information about an error

     *

     * @param integer $error

     * @return array

     * @access public

     */

    function errorInfo($error = null)

    {

        if ($this->connection) {

            $native_code = @mysqli_errno($this->connection);

            $native_msg  = @mysqli_error($this->connection);

        } else {

            $native_code = @mysqli_connect_errno();

            $native_msg  = @mysqli_connect_error();

        }

        if (is_null($error)) {

            static $ecode_map;

            if (empty($ecode_map)) {

                $ecode_map = array(

                    1000 => MDB2_ERROR_INVALID, //hashchk

                    1001 => MDB2_ERROR_INVALID, //isamchk

                    1004 => MDB2_ERROR_CANNOT_CREATE,

                    1005 => MDB2_ERROR_CANNOT_CREATE,

                    1006 => MDB2_ERROR_CANNOT_CREATE,

                    1007 => MDB2_ERROR_ALREADY_EXISTS,

                    1008 => MDB2_ERROR_CANNOT_DROP,

                    1009 => MDB2_ERROR_CANNOT_DROP,

                    1010 => MDB2_ERROR_CANNOT_DROP,

                    1011 => MDB2_ERROR_CANNOT_DELETE,

                    1022 => MDB2_ERROR_ALREADY_EXISTS,

                    1029 => MDB2_ERROR_NOT_FOUND,

                    1032 => MDB2_ERROR_NOT_FOUND,

                    1044 => MDB2_ERROR_ACCESS_VIOLATION,

                    1045 => MDB2_ERROR_ACCESS_VIOLATION,

                    1046 => MDB2_ERROR_NODBSELECTED,

                    1048 => MDB2_ERROR_CONSTRAINT,

                    1049 => MDB2_ERROR_NOSUCHDB,

                    1050 => MDB2_ERROR_ALREADY_EXISTS,

                    1051 => MDB2_ERROR_NOSUCHTABLE,

                    1054 => MDB2_ERROR_NOSUCHFIELD,

                    1060 => MDB2_ERROR_ALREADY_EXISTS,

                    1061 => MDB2_ERROR_ALREADY_EXISTS,

                    1062 => MDB2_ERROR_ALREADY_EXISTS,

                    1064 => MDB2_ERROR_SYNTAX,

                    1067 => MDB2_ERROR_INVALID,

                    1072 => MDB2_ERROR_NOT_FOUND,

                    1086 => MDB2_ERROR_ALREADY_EXISTS,

                    1091 => MDB2_ERROR_NOT_FOUND,

                    1100 => MDB2_ERROR_NOT_LOCKED,

                    1109 => MDB2_ERROR_NOT_FOUND,

                    1125 => MDB2_ERROR_ALREADY_EXISTS,

                    1136 => MDB2_ERROR_VALUE_COUNT_ON_ROW,

                    1138 => MDB2_ERROR_INVALID,

                    1142 => MDB2_ERROR_ACCESS_VIOLATION,

                    1143 => MDB2_ERROR_ACCESS_VIOLATION,

                    1146 => MDB2_ERROR_NOSUCHTABLE,

                    1149 => MDB2_ERROR_SYNTAX,

                    1169 => MDB2_ERROR_CONSTRAINT,

                    1176 => MDB2_ERROR_NOT_FOUND,

                    1177 => MDB2_ERROR_NOSUCHTABLE,

                    1213 => MDB2_ERROR_DEADLOCK,

                    1216 => MDB2_ERROR_CONSTRAINT,

                    1217 => MDB2_ERROR_CONSTRAINT,

                    1227 => MDB2_ERROR_ACCESS_VIOLATION,

                    1299 => MDB2_ERROR_INVALID_DATE,

                    1300 => MDB2_ERROR_INVALID,

                    1304 => MDB2_ERROR_ALREADY_EXISTS,

                    1305 => MDB2_ERROR_NOT_FOUND,

                    1306 => MDB2_ERROR_CANNOT_DROP,

                    1307 => MDB2_ERROR_CANNOT_CREATE,

                    1334 => MDB2_ERROR_CANNOT_ALTER,

                    1339 => MDB2_ERROR_NOT_FOUND,

                    1356 => MDB2_ERROR_INVALID,

                    1359 => MDB2_ERROR_ALREADY_EXISTS,

                    1360 => MDB2_ERROR_NOT_FOUND,

                    1363 => MDB2_ERROR_NOT_FOUND,

                    1365 => MDB2_ERROR_DIVZERO,

                    1451 => MDB2_ERROR_CONSTRAINT,

                    1452 => MDB2_ERROR_CONSTRAINT,

                    1542 => MDB2_ERROR_CANNOT_DROP,

                    1546 => MDB2_ERROR_CONSTRAINT,

                    1582 => MDB2_ERROR_CONSTRAINT,

                    2019 => MDB2_ERROR_INVALID,

                );

            }

            if ($this->options['portability'] & MDB2_PORTABILITY_ERRORS) {

                $ecode_map[1022] = MDB2_ERROR_CONSTRAINT;

                $ecode_map[1048] = MDB2_ERROR_CONSTRAINT_NOT_NULL;

                $ecode_map[1062] = MDB2_ERROR_CONSTRAINT;

            } else {

                // Doing this in case mode changes during runtime.

                $ecode_map[1022] = MDB2_ERROR_ALREADY_EXISTS;

                $ecode_map[1048] = MDB2_ERROR_CONSTRAINT;

                $ecode_map[1062] = MDB2_ERROR_ALREADY_EXISTS;

            }

            if (isset($ecode_map[$native_code])) {

                $error = $ecode_map[$native_code];

            }

        }

        return array($error, $native_code, $native_msg);

    }



    // }}}

    // {{{ escape()



    /**

     * Quotes a string so it can be safely used in a query. It will quote

     * the text so it can safely be used within a query.

     *

     * @param   string  the input string to quote

     * @param   bool    escape wildcards

     *

     * @return  string  quoted string

     *

     * @access  public

     */

    function escape($text, $escape_wildcards = false)

    {

        if ($escape_wildcards) {

            $text = $this->escapePattern($text);

        }

        $connection = $this->getConnection();

        if (PEAR::isError($connection)) {

            return $connection;

        }

        $text = @mysqli_real_escape_string($connection, $text);

        return $text;

    }



    // }}}

    // {{{ beginTransaction()



    /**

     * Start a transaction or set a savepoint.

     *

     * @param   string  name of a savepoint to set

     * @return  mixed   MDB2_OK on success, a MDB2 error on failure

     *

     * @access  public

     */

    function beginTransaction($savepoint = null)

    {

        $this->debug('Starting transaction/savepoint', __FUNCTION__, array('is_manip' => true, 'savepoint' => $savepoint));

        $this->_getServerCapabilities();

        if (!is_null($savepoint)) {

            if (!$this->supports('savepoints')) {

                return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

                    'savepoints are not supported', __FUNCTION__);

            }

            if (!$this->in_transaction) {

                return $this->raiseError(MDB2_ERROR_INVALID, null, null,

                    'savepoint cannot be released when changes are auto committed', __FUNCTION__);

            }

            $query = 'SAVEPOINT '.$savepoint;

            return $this->_doQuery($query, true);

        } elseif ($this->in_transaction) {

            return MDB2_OK;  //nothing to do

        }

        $query = $this->start_transaction ? 'START TRANSACTION' : 'SET AUTOCOMMIT = 1';

        $result =& $this->_doQuery($query, true);

        if (PEAR::isError($result)) {

            return $result;

        }

        $this->in_transaction = true;

        return MDB2_OK;

    }



    // }}}

    // {{{ commit()



    /**

     * Commit the database changes done during a transaction that is in

     * progress or release a savepoint. This function may only be called when

     * auto-committing is disabled, otherwise it will fail. Therefore, a new

     * transaction is implicitly started after committing the pending changes.

     *

     * @param   string  name of a savepoint to release

     * @return  mixed   MDB2_OK on success, a MDB2 error on failure

     *

     * @access  public

     */

    function commit($savepoint = null)

    {

        $this->debug('Committing transaction/savepoint', __FUNCTION__, array('is_manip' => true, 'savepoint' => $savepoint));

        if (!$this->in_transaction) {

            return $this->raiseError(MDB2_ERROR_INVALID, null, null,

                'commit/release savepoint cannot be done changes are auto committed', __FUNCTION__);

        }

        if (!is_null($savepoint)) {

            if (!$this->supports('savepoints')) {

                return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

                    'savepoints are not supported', __FUNCTION__);

            }

            $server_info = $this->getServerVersion();

            if (version_compare($server_info['major'].'.'.$server_info['minor'].'.'.$server_info['patch'], '5.0.3', '<')) {

                return MDB2_OK;

            }

            $query = 'RELEASE SAVEPOINT '.$savepoint;

            return $this->_doQuery($query, true);

        }



        if (!$this->supports('transactions')) {

            return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

                'transactions are not supported', __FUNCTION__);

        }



        $result =& $this->_doQuery('COMMIT', true);

        if (PEAR::isError($result)) {

            return $result;

        }

        if (!$this->start_transaction) {

            $query = 'SET AUTOCOMMIT = 0';

            $result =& $this->_doQuery($query, true);

            if (PEAR::isError($result)) {

                return $result;

            }

        }

        $this->in_transaction = false;

        return MDB2_OK;

    }



    // }}}

    // {{{ rollback()



    /**

     * Cancel any database changes done during a transaction or since a specific

     * savepoint that is in progress. This function may only be called when

     * auto-committing is disabled, otherwise it will fail. Therefore, a new

     * transaction is implicitly started after canceling the pending changes.

     *

     * @param   string  name of a savepoint to rollback to

     * @return  mixed   MDB2_OK on success, a MDB2 error on failure

     *

     * @access  public

     */

    function rollback($savepoint = null)

    {

        $this->debug('Rolling back transaction/savepoint', __FUNCTION__, array('is_manip' => true, 'savepoint' => $savepoint));

        if (!$this->in_transaction) {

            return $this->raiseError(MDB2_ERROR_INVALID, null, null,

                'rollback cannot be done changes are auto committed', __FUNCTION__);

        }

        if (!is_null($savepoint)) {

            if (!$this->supports('savepoints')) {

                return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

                    'savepoints are not supported', __FUNCTION__);

            }

            $query = 'ROLLBACK TO SAVEPOINT '.$savepoint;

            return $this->_doQuery($query, true);

        }



        $query = 'ROLLBACK';

        $result =& $this->_doQuery($query, true);

        if (PEAR::isError($result)) {

            return $result;

        }

        if (!$this->start_transaction) {

            $query = 'SET AUTOCOMMIT = 0';

            $result =& $this->_doQuery($query, true);

            if (PEAR::isError($result)) {

                return $result;

            }

        }

        $this->in_transaction = false;

        return MDB2_OK;

    }



    // }}}

    // {{{ function setTransactionIsolation()



    /**

     * Set the transacton isolation level.

     *

     * @param   string  standard isolation level

     *                  READ UNCOMMITTED (allows dirty reads)

     *                  READ COMMITTED (prevents dirty reads)

     *                  REPEATABLE READ (prevents nonrepeatable reads)

     *                  SERIALIZABLE (prevents phantom reads)

     * @return  mixed   MDB2_OK on success, a MDB2 error on failure

     *

     * @access  public

     * @since   2.1.1

     */

    function setTransactionIsolation($isolation)

    {

        $this->debug('Setting transaction isolation level', __FUNCTION__, array('is_manip' => true));

        if (!$this->supports('transactions')) {

            return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

                'transactions are not supported', __FUNCTION__);

        }

        switch ($isolation) {

        case 'READ UNCOMMITTED':

        case 'READ COMMITTED':

        case 'REPEATABLE READ':

        case 'SERIALIZABLE':

            break;

        default:

            return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,

                'isolation level is not supported: '.$isolation, __FUNCTION__);

        }



        $query = "SET SESSION TRANSACTION ISOLATION LEVEL $isolation";

        return $this->_doQuery($query, true);

    }



    // }}}

    // {{{ connect()



    /**

     * Connect to the database

     *

     * @return true on success, MDB2 Error Object on failure

     */

    function connect()

    {

        if (is_object($this->connection)) {

            //if (count(array_diff($this->connected_dsn, $this->dsn)) == 0) {

            if (MDB2::areEquals($this->connected_dsn, $this->dsn)) {

                return MDB2_OK;

            }

            $this->connection = 0;

        }



        if (!PEAR::loadExtension($this->phptype)) {

            return $this->raiseError(MDB2_ERROR_NOT_FOUND, null, null,

                'extension '.$this->phptype.' is not compiled into PHP', __FUNCTION__);

        }



        $connection = @mysqli_init();

        if (!empty($this->dsn['charset']) && defined('MYSQLI_SET_CHARSET_NAME')) {

            @mysqli_options($connection, MYSQLI_SET_CHARSET_NAME, $this->dsn['charset']);

        }





        if ($this->options['ssl']) {

            @mysqli_ssl_set(

                $connection,

                empty($this->dsn['key'])    ? null : $this->dsn['key'],

                empty($this->dsn['cert'])   ? null : $this->dsn['cert'],

                empty($this->dsn['ca'])     ? null : $this->dsn['ca'],

                empty($this->dsn['capath']) ? null : $this->dsn['capath'],

                empty($this->dsn['cipher']) ? null : $this->dsn['cipher']

            );

        }



        if (!@mysqli_real_connect(

            $connection,

            $this->dsn['hostspec'],

            $this->dsn['username'],

            $this->dsn['password'],

            $this->database_name,

            $this->dsn['port'],

            $this->dsn['socket']

        )) {



            if (($err = @mysqli_connect_error()) != '') {

                return $this->raiseError(null,

                    null, null, $err, __FUNCTION__);

            } else {

                return $this->raiseError(MDB2_ERROR_CONNECT_FAILED, null, null,

                    'unable to establish a connection', __FUNCTION__);

            }

        }



        if (!empty($this->dsn['charset']) && !defined('MYSQLI_SET_CHARSET_NAME')) {

            $result = $this->setCharset($this->dsn['charset'], $connection);

            if (PEAR::isError($result)) {

                return $result;

            }

        }



        $this->connection = $connection;

        $this->connected_dsn = $this->dsn;

        $this->connected_database_name = $this->database_name;

        $this->dbsyntax = $this->dsn['dbsyntax'] ? $this->dsn['dbsyntax'] : $this->phptype;



        $this->supported['transactions'] = $this->options['use_transactions'];

        if ($this->options['default_table_type']) {

            switch (strtoupper($this->options['default_table_type'])) {

            case 'BLACKHOLE':

            case 'MEMORY':

            case 'ARCHIVE':

            case 'CSV':

            case 'HEAP':

            case 'ISAM':

            case 'MERGE':

            case 'MRG_ISAM':

            case 'ISAM':

            case 'MRG_MYISAM':

            case 'MYISAM':

                $this->supported['transactions'] = false;

                $this->warnings[] = $this->options['default_table_type'] .

                    ' is not a supported default table type';

                break;

            }

        }

        
        $this->_getServerCapabilities();



        return MDB2_OK;

    }



    // }}}

    // {{{ setCharset()



    /**

     * Set the charset on the current connection

     *

     * @param string    charset

     * @param resource  connection handle

     *

     * @return true on success, MDB2 Error Object on failure

     */

    function setCharset($charset, $connection = null)

    {

        if (is_null($connection)) {

            $connection = $this->getConnection();

            if (PEAR::isError($connection)) {

                return $connection;

            }

        }

        $client_info = mysqli_get_client_version();

        if (OS_WINDOWS && ((40111 > $client_info) ||

            ((50000 <= $client_info) && (50006 > $client_info)))

        ) {

            $query = "SET NAMES '".mysqli_real_escape_string($connection, $charset)."'";

            return $this->_doQuery($query, true, $connection);

        }

        if (!$result = mysqli_set_charset($connection, $charset)) {

            $err =& $this->raiseError(null, null, null,

                'Could not set client character set', __FUNCTION__);

            return $err;

        }

        return $result;

    }



    // }}}

    // {{{ disconnect()



    /**

     * Log out and disconnect from the database.

     *

     * @param  boolean $force if the disconnect should be forced even if the

     *                        connection is opened persistently

     * @return mixed true on success, false if not connected and error

     *                object on error

     * @access public

     */

    function disconnect($force = true)

    {

        if (is_object($this->connection)) {

            if ($this->in_transaction) {

                $dsn = $this->dsn;

                $database_name = $this->database_name;

                $persistent = $this->options['persistent'];

                $this->dsn = $this->connected_dsn;

                $this->database_name = $this->connected_database_name;

                $this->options['persistent'] = $this->opened_persistent;

                $this->rollback();

                $this->dsn = $dsn;

                $this->database_name = $database_name;

                $this->options['persistent'] = $persistent;

            }



            if ($force) {

                @mysqli_close($this->connection);

            }

        }

        return parent::disconnect($force);

    }



    // }}}

    // {{{ _doQuery()



    /**

     * Execute a query

     * @param string $query  query

     * @param boolean $is_manip  if the query is a manipulation query

     * @param resource $connection

     * @param string $database_name

     * @return result or error object

     * @access protected

     */

    function &_doQuery($query, $is_manip = false, $connection = null, $database_name = null)

    {

        $this->last_query = $query;

        $result = $this->debug($query, 'query', array('is_manip' => $is_manip, 'when' => 'pre'));

        if ($result) {

            if (PEAR::isError($result)) {

                return $result;

            }

            $query = $result;

        }

        if ($this->options['disable_query']) {

            $result = $is_manip ? 0 : null;

            return $result;

        }



        if (is_null($connection)) {

            $connection = $this->getConnection();

            if (PEAR::isError($connection)) {

                return $connection;

            }

        }

        if (is_null($database_name)) {

            $database_name = $this->database_name;

        }



        if ($database_name) {

            if ($database_name != $this->connected_database_name) {

                if (!@mysqli_select_db($connection, $database_name)) {

                    $err = $this->raiseError(null, null, null,

                        'Could not select the database: '.$database_name, __FUNCTION__);

                    return $err;

                }

                $this->connected_database_name = $database_name;

            }

        }



        if ($this->options['multi_query']) {

            $result = mysqli_multi_query($connection, $query);

        } else {

            $resultmode = $this->options['result_buffering'] ? MYSQLI_USE_RESULT : MYSQLI_USE_RESULT;

            $result = mysqli_query($connection, $query);

        }



        if (!$result) {

            $err =& $this->raiseError(null, null, null,

                'Could not execute statement', __FUNCTION__);

            return $err;

        }



        if ($this->options['multi_query']) {

            if ($this->options['result_buffering']) {

                if (!($result = @mysqli_store_result($connection))) {

                    $err =& $this->raiseError(null, null, null,

                        'Could not get the first result from a multi query', __FUNCTION__);

                    return $err;

                }

            } elseif (!($result = @mysqli_use_result($connection))) {

                $err =& $this->raiseError(null, null, null,

                        'Could not get the first result from a multi query', __FUNCTION__);

                return $err;

            }

        }



        $this->debug($query, 'query', array('is_manip' => $is_manip, 'when' => 'post', 'result' => $result));

        return $result;

    }



    // }}}

    // {{{ _affectedRows()



    /**

     * Returns the number of rows affected

     *

     * @param resource $result

     * @param resource $connection

     * @return mixed MDB2 Error Object or the number of rows affected

     * @access private

     */

    function _affectedRows($connection, $result = null)

    {

        if (is_null($connection)) {

            $connection = $this->getConnection();

            if (PEAR::isError($connection)) {

                return $connection;

            }

        }

        return @mysqli_affected_rows($connection);

    }



    // }}}

    // {{{ _modifyQuery()



    /**

     * Changes a query string for various DBMS specific reasons

     *

     * @param string $query  query to modify

     * @param boolean $is_manip  if it is a DML query

     * @param integer $limit  limit the number of rows

     * @param integer $offset  start reading from given offset

     * @return string modified query

     * @access protected

     */

    function _modifyQuery($query, $is_manip, $limit, $offset)

    {

        if ($this->options['portability'] & MDB2_PORTABILITY_DELETE_COUNT) {

            // "DELETE FROM table" gives 0 affected rows in MySQL.

            // This little hack lets you know how many rows were deleted.

            if (preg_match('/^\s*DELETE\s+FROM\s+(\S+)\s*$/i', $query)) {

                $query = preg_replace('/^\s*DELETE\s+FROM\s+(\S+)\s*$/',

                                      'DELETE FROM \1 WHERE 1=1', $query);

            }

        }

        if ($limit > 0

            && !preg_match('/LIMIT\s*\d(?:\s*(?:,|OFFSET)\s*\d+)?(?:[^\)]*)?$/i', $query)

        ) {

            $query = rtrim($query);

            if (substr($query, -1) == ';') {

                $query = substr($query, 0, -1);

            }



            // LIMIT doesn't always come last in the query

            // @see http://dev.mysql.com/doc/refman/5.0/en/select.html

            $after = '';

            if (preg_match('/(\s+INTO\s+(?:OUT|DUMP)FILE\s.*)$/ims', $query, $matches)) {

                $after = $matches[0];

                $query = preg_replace('/(\s+INTO\s+(?:OUT|DUMP)FILE\s.*)$/ims', '', $query);

            } elseif (preg_match('/(\s+FOR\s+UPDATE\s*)$/i', $query, $matches)) {

               $after = $matches[0];

               $query = preg_replace('/(\s+FOR\s+UPDATE\s*)$/im', '', $query);

            } elseif (preg_match('/(\s+LOCK\s+IN\s+SHARE\s+MODE\s*)$/im', $query, $matches)) {

               $after = $matches[0];

               $query = preg_replace('/(\s+LOCK\s+IN\s+SHARE\s+MODE\s*)$/im', '', $query);

            }



            if ($is_manip) {

                return $query . " LIMIT $limit" . $after;

            } else {

                return $query . " LIMIT $offset, $limit" . $after;

            }

        }

        return $query;

    }



    // }}}

    // {{{ getServerVersion()



    /**

     * return version information about the server

     *

     * @param bool   $native  determines if the raw version string should be returned

     * @return mixed array/string with version information or MDB2 error object

     * @access public

     */

    function getServerVersion($native = false)

    {

        $connection = $this->getConnection();

        if (PEAR::isError($connection)) {

            return $connection;

        }

        if ($this->connected_server_info) {

            $server_info = $this->connected_server_info;

        } else {

            $server_info = @mysqli_get_server_info($connection);

        }

        if (!$server_info) {

            return $this->raiseError(null, null, null,

                'Could not get server information', __FUNCTION__);

        }

        // cache server_info

        $this->connected_server_info = $server_info;

        if (!$native) {

            $tmp = explode('.', $server_info, 3);

            if (isset($tmp[2]) && strpos($tmp[2], '-')) {

                $tmp2 = explode('-', @$tmp[2], 2);

            } else {

                $tmp2[0] = isset($tmp[2]) ? $tmp[2] : null;

                $tmp2[1] = null;

            }

            $server_info = array(

                'major' => isset($tmp[0]) ? $tmp[0] : null,

                'minor' => isset($tmp[1]) ? $tmp[1] : null,

                'patch' => $tmp2[0],

                'extra' => $tmp2[1],

                'native' => $server_info,

            );

        }

        return $server_info;

    }



    // }}}

    // {{{ _getServerCapabilities()



    /**

     * Fetch some information about the server capabilities

     * (transactions, subselects, prepared statements, etc).

     *

     * @access private

     */

    function _getServerCapabilities()

    {

        if (!$this->server_capabilities_checked) {

            $this->server_capabilities_checked = true;



            //set defaults

            $this->supported['sub_selects'] = 'emulated';

            $this->supported['prepared_statements'] = 'emulated';

            $this->start_transaction = false;

            $this->varchar_max_length = 255;



            $server_info = $this->getServerVersion();

            if (is_array($server_info)) {

                if (!version_compare($server_info['major'].'.'.$server_info['minor'].'.'.$server_info['patch'], '4.1.0', '<')) {

                    $this->supported['sub_selects'] = true;

                    $this->supported['prepared_statements'] = true;

                }



                if (!version_compare($server_info['major'].'.'.$server_info['minor'].'.'.$server_info['patch'], '4.0.14', '<')

                    || !version_compare($server_info['major'].'.'.$server_info['minor'].'.'.$server_info['patch'], '4.1.1', '<')

                ) {

                    $this->supported['savepoints'] = true;

                }



                if (!version_compare($server_info['major'].'.'.$server_info['minor'].'.'.$server_info['patch'], '4.0.11', '<')) {

                    $this->start_transaction = true;

                }



                if (!version_compare($server_info['major'].'.'.$server_info['minor'].'.'.$server_info['patch'], '5.0.3', '<')) {

                    $this->varchar_max_length = 65532;

                }

            }

        }

    }



    // }}}

    // {{{ function _skipUserDefinedVariable($query, $position)



    /**

     * Utility method, used by prepare() to avoid misinterpreting MySQL user

     * defined variables (SELECT @x:=5) for placeholders.

     * Check if the placeholder is a false positive, i.e. if it is an user defined

     * variable instead. If so, skip it and advance the position, otherwise

     * return the current position, which is valid

     *

     * @param string $query

     * @param integer $position current string cursor position

     * @return integer $new_position

     * @access protected

     */

    function _skipUserDefinedVariable($query, $position)

    {

        $found = strpos(strrev(substr($query, 0, $position)), '@');

        if ($found === false) {

            return $position;

        }

        $pos = strlen($query) - strlen(substr($query, $position)) - $found - 1;

        $substring = substr($query, $pos, $position - $pos + 2);

        if (preg_match('/^@\w+\s*:=$/', $substring)) {

            return $position + 1; //found an user defined variable: skip it

        }

        return $position;

    }



    // }}}

    // {{{ prepare()



    /**

     * Prepares a query for multiple execution with execute().

     * With some database backends, this is emulated.

     * prepare() requires a generic query as string like

     * 'INSERT INTO numbers VALUES(?,?)' or

     * 'INSERT INTO numbers VALUES(:foo,:bar)'.

     * The ? and :name and are placeholders which can be set using

     * bindParam() and the query can be sent off using the execute() method.

     * The allowed format for :name can be set with the 'bindname_format' option.

     *

     * @param string $query the query to prepare

     * @param mixed   $types  array that contains the types of the placeholders

     * @param mixed   $result_types  array that contains the types of the columns in

     *                        the result set or MDB2_PREPARE_RESULT, if set to

     *                        MDB2_PREPARE_MANIP the query is handled as a manipulation query

     * @param mixed   $lobs   key (field) value (parameter) pair for all lob placeholders

     * @return mixed resource handle for the prepared query on success, a MDB2

     *        error on failure

     * @access public

     * @see bindParam, execute

     */

    function &prepare($query, $types = null, $result_types = null, $lobs = array())

    {

        if ($this->options['emulate_prepared']

            || $this->supported['prepared_statements'] !== true

        ) {

            $obj =& parent::prepare($query, $types, $result_types, $lobs);

            return $obj;

        }

        $is_manip = ($result_types === MDB2_PREPARE_MANIP);

        $offset = $this->offset;

        $limit = $this->limit;

        $this->offset = $this->limit = 0;

        $query = $this->_modifyQuery($query, $is_manip, $limit, $offset);

        $result = $this->debug($query, __FUNCTION__, array('is_manip' => $is_manip, 'when' => 'pre'));

        if ($result) {

            if (PEAR::isError($result)) {

                return $result;

            }

            $query = $result;

        }

        $placeholder_type_guess = $placeholder_type = null;

        $question = '?';

        $colon = ':';

        $positions = array();

        $position = 0;

        while ($position < strlen($query)) {

            $q_position = strpos($query, $question, $position);

            $c_position = strpos($query, $colon, $position);

            if ($q_position && $c_position) {

                $p_position = min($q_position, $c_position);

            } elseif ($q_position) {

                $p_position = $q_position;

            } elseif ($c_position) {

                $p_position = $c_position;

            } else {

                break;

            }

            if (is_null($placeholder_type)) {

                $placeholder_type_guess = $query[$p_position];

            }

            
            $new_pos = $this->_skipDelimitedStrings($query, $position, $p_position);

            if (PEAR::isError($new_pos)) {

                return $new_pos;

            }

            if ($new_pos != $position) {

                $position = $new_pos;

                continue; //evaluate again starting from the new position

            }

            
            //make sure this is not part of an user defined variable

            $new_pos = $this->_skipUserDefinedVariable($query, $position);

            if ($new_pos != $position) {

                $position = $new_pos;

                continue; //evaluate again starting from the new position

            }



            if ($query[$position] == $placeholder_type_guess) {

                if (is_null($placeholder_type)) {

                    $placeholder_type = $query[$p_position];

                    $question = $colon = $placeholder_type;

                }

                if ($placeholder_type == ':') {

                    $regexp = '/^.{'.($position+1).'}('.$this->options['bindname_format'].').*$/s';

                    $parameter = preg_replace($regexp, '\\1', $query);

                    if ($parameter === '') {

                        $err =& $this->raiseError(MDB2_ERROR_SYNTAX, null, null,

                            'named parameter name must match "bindname_format" option', __FUNCTION__);

                        return $err;

                    }

                    $positions[$p_position] = $parameter;

                    $query = substr_replace($query, '?', $position, strlen($parameter)+1);

                } else {

                    $positions[$p_position] = count($positions);

                }

                $position = $p_position + 1;

            } else {

                $position = $p_position;

            }

        }

        $connection = $this->getConnection();

        if (PEAR::isError($connection)) {

            return $connection;

        }



        if (!$is_manip) {

            static $prep_statement_counter = 1;

            $statement_name = sprintf($this->options['statement_format'], $this->phptype, sha1(microtime() + mt_rand())) . $prep_statement_counter++;

            $query = "PREPARE $statement_name FROM ".$this->quote($query, 'text');



            $statement =& $this->_doQuery($query, true, $connection);

            if (PEAR::isError($statement)) {

                return $statement;

            }

            $statement = $statement_name;

        } else {

            $statement = @mysqli_prepare($connection, $query);

            if (!$statement) {

                $err =& $this->raiseError(null, null, null,

                    'Unable to create prepared statement handle', __FUNCTION__);

                return $err;

            }

        }



        $class_name = 'MDB2_Statement_'.$this->phptype;

        $obj = new $class_name($this, $statement, $positions, $query, $types, $result_types, $is_manip, $limit, $offset);

        $this->debug($query, __FUNCTION__, array('is_manip' => $is_manip, 'when' => 'post', 'result' => $obj));

        return $obj;

    }



    // }}}

    // {{{ replace()



    /**

     * Execute a SQL REPLACE query. A REPLACE query is identical to a INSERT

     * query, except that if there is already a row in the table with the same

     * key field values, the REPLACE query just updates its values instead of

     * inserting a new row.

     *

     * The REPLACE type of query does not make part of the SQL standards. Since

     * practically only MySQL implements it natively, this type of query is

     * emulated through this method for other DBMS using standard types of

     * queries inside a transaction to assure the atomicity of the operation.

     *

     * @access public

     *

     * @param string $table name of the table on which the REPLACE query will

     *  be executed.

     * @param array $fields associative array that describes the fields and the

     *  values that will be inserted or updated in the specified table. The

     *  indexes of the array are the names of all the fields of the table. The

     *  values of the array are also associative arrays that describe the

     *  values and other properties of the table fields.

     *

     *  Here follows a list of field properties that need to be specified:

     *

     *    value:

     *          Value to be assigned to the specified field. This value may be

     *          of specified in database independent type format as this

     *          function can perform the necessary datatype conversions.

     *

     *    Default:

     *          this property is required unless the Null property

     *          is set to 1.

     *

     *    type

     *          Name of the type of the field. Currently, all types Metabase

     *          are supported except for clob and blob.

     *

     *    Default: no type conversion

     *

     *    null

     *          Boolean property that indicates that the value for this field

     *          should be set to null.

     *

     *          The default value for fields missing in INSERT queries may be

     *          specified the definition of a table. Often, the default value

     *          is already null, but since the REPLACE may be emulated using

     *          an UPDATE query, make sure that all fields of the table are

     *          listed in this function argument array.

     *

     *    Default: 0

     *

     *    key

     *          Boolean property that indicates that this field should be

     *          handled as a primary key or at least as part of the compound

     *          unique index of the table that will determine the row that will

     *          updated if it exists or inserted a new row otherwise.

     *

     *          This function will fail if no key field is specified or if the

     *          value of a key field is set to null because fields that are

     *          part of unique index they may not be null.

     *

     *    Default: 0

     *

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     */

    function replace($table, $fields)

    {

        $count = count($fields);

        $query = $values = '';

        $keys = $colnum = 0;

        for (reset($fields); $colnum < $count; next($fields), $colnum++) {

            $name = key($fields);

            if ($colnum > 0) {

                $query .= ',';

                $values.= ',';

            }

            $query.= $name;

            if (isset($fields[$name]['null']) && $fields[$name]['null']) {

                $value = 'NULL';

            } else {

                $type = isset($fields[$name]['type']) ? $fields[$name]['type'] : null;

                $value = $this->quote($fields[$name]['value'], $type);

                if (PEAR::isError($value)) {

                    return $value;

                }

            }

            $values.= $value;

            if (isset($fields[$name]['key']) && $fields[$name]['key']) {

                if ($value === 'NULL') {

                    return $this->raiseError(MDB2_ERROR_CANNOT_REPLACE, null, null,

                        'key value '.$name.' may not be NULL', __FUNCTION__);

                }

                $keys++;

            }

        }

        if ($keys == 0) {

            return $this->raiseError(MDB2_ERROR_CANNOT_REPLACE, null, null,

                'not specified which fields are keys', __FUNCTION__);

        }



        $connection = $this->getConnection();

        if (PEAR::isError($connection)) {

            return $connection;

        }



        $query = "REPLACE INTO $table ($query) VALUES ($values)";

        $result =& $this->_doQuery($query, true, $connection);

        if (PEAR::isError($result)) {

            return $result;

        }

        return $this->_affectedRows($connection, $result);

    }



    // }}}

    // {{{ nextID()



    /**

     * Returns the next free id of a sequence

     *

     * @param string $seq_name name of the sequence

     * @param boolean $ondemand when true the sequence is

     *                          automatic created, if it

     *                          not exists

     *

     * @return mixed MDB2 Error Object or id

     * @access public

     */

    function nextID($seq_name, $ondemand = true)

    {

        $sequence_name = $this->quoteIdentifier($this->getSequenceName($seq_name), true);

        $seqcol_name = $this->quoteIdentifier($this->options['seqcol_name'], true);

        $query = "INSERT INTO $sequence_name ($seqcol_name) VALUES (NULL)";

        $this->expectError(MDB2_ERROR_NOSUCHTABLE);

        $result =& $this->_doQuery($query, true);

        $this->popExpect();

        if (PEAR::isError($result)) {

            if ($ondemand && $result->getCode() == MDB2_ERROR_NOSUCHTABLE) {

                $this->loadModule('Manager', null, true);

                $result = $this->manager->createSequence($seq_name);

                if (PEAR::isError($result)) {

                    return $this->raiseError($result, null, null,

                        'on demand sequence '.$seq_name.' could not be created', __FUNCTION__);

                } else {

                    return $this->nextID($seq_name, false);

                }

            }

            return $result;

        }

        $value = $this->lastInsertID();

        if (is_numeric($value)) {

            $query = "DELETE FROM $sequence_name WHERE $seqcol_name < $value";

            $result =& $this->_doQuery($query, true);

            if (PEAR::isError($result)) {

                $this->warnings[] = 'nextID: could not delete previous sequence table values from '.$seq_name;

            }

        }

        return $value;

    }



    // }}}

    // {{{ lastInsertID()



    /**

     * Returns the autoincrement ID if supported or $id or fetches the current

     * ID in a sequence called: $table.(empty($field) ? '' : '_'.$field)

     *

     * @param string $table name of the table into which a new row was inserted

     * @param string $field name of the field into which a new row was inserted

     * @return mixed MDB2 Error Object or id

     * @access public

     */

    function lastInsertID($table = null, $field = null)

    {

        // not using mysql_insert_id() due to http://pear.php.net/bugs/bug.php?id=8051

        return $this->queryOne('SELECT LAST_INSERT_ID()', 'integer');

    }



    // }}}

    // {{{ currID()



    /**

     * Returns the current id of a sequence

     *

     * @param string $seq_name name of the sequence

     * @return mixed MDB2 Error Object or id

     * @access public

     */

    function currID($seq_name)

    {

        $sequence_name = $this->quoteIdentifier($this->getSequenceName($seq_name), true);

        $seqcol_name = $this->quoteIdentifier($this->options['seqcol_name'], true);

        $query = "SELECT MAX($seqcol_name) FROM $sequence_name";

        return $this->queryOne($query, 'integer');

    }

}



/**

 * MDB2 MySQLi result driver

 *

 * @package MDB2

 * @category Database

 * @author  Lukas Smith <smith@pooteeweet.org>

 */

class MDB2_Result_mysqli extends MDB2_Result_Common

{

    // }}}

    // {{{ fetchRow()



    /**

     * Fetch a row and insert the data into an existing array.

     *

     * @param int       $fetchmode  how the array data should be indexed

     * @param int    $rownum    number of the row where the data can be found

     * @return int data array on success, a MDB2 error on failure

     * @access public

     */

    function &fetchRow($fetchmode = MDB2_FETCHMODE_DEFAULT, $rownum = null)

    {

        if (!is_null($rownum)) {

            $seek = $this->seek($rownum);

            if (PEAR::isError($seek)) {

                return $seek;

            }

        }

        if ($fetchmode == MDB2_FETCHMODE_DEFAULT) {

            $fetchmode = $this->db->fetchmode;

        }

        if ($fetchmode & MDB2_FETCHMODE_ASSOC) {

            $row = @mysqli_fetch_assoc($this->result);

            if (is_array($row)

                && $this->db->options['portability'] & MDB2_PORTABILITY_FIX_CASE

            ) {

                $row = array_change_key_case($row, $this->db->options['field_case']);

            }

        } else {

           $row = @mysqli_fetch_row($this->result);

        }



        if (!$row) {

            if ($this->result === false) {

                $err =& $this->db->raiseError(MDB2_ERROR_NEED_MORE_DATA, null, null,

                    'resultset has already been freed', __FUNCTION__);

                return $err;

            }

            $null = null;

            return $null;

        }

        $mode = $this->db->options['portability'] & MDB2_PORTABILITY_EMPTY_TO_NULL;

        $rtrim = false;

        if ($this->db->options['portability'] & MDB2_PORTABILITY_RTRIM) {

            if (empty($this->types)) {

                $mode += MDB2_PORTABILITY_RTRIM;

            } else {

                $rtrim = true;

            }

        }

        if ($mode) {

            $this->db->_fixResultArrayValues($row, $mode);

        }

        if (!empty($this->types)) {

            $row = $this->db->datatype->convertResultRow($this->types, $row, $rtrim);

        }

        if (!empty($this->values)) {

            $this->_assignBindColumns($row);

        }

        if ($fetchmode === MDB2_FETCHMODE_OBJECT) {

            $object_class = $this->db->options['fetch_class'];

            if ($object_class == 'stdClass') {

                $row = (object) $row;

            } else {

                $row = &new $object_class($row);

            }

        }

        ++$this->rownum;

        return $row;

    }



    // }}}

    // {{{ _getColumnNames()



    /**

     * Retrieve the names of columns returned by the DBMS in a query result.

     *

     * @return  mixed   Array variable that holds the names of columns as keys

     *                  or an MDB2 error on failure.

     *                  Some DBMS may not return any columns when the result set

     *                  does not contain any rows.

     * @access private

     */

    function _getColumnNames()

    {

        $columns = array();

        $numcols = $this->numCols();

        if (PEAR::isError($numcols)) {

            return $numcols;

        }

        for ($column = 0; $column < $numcols; $column++) {

            $column_info = @mysqli_fetch_field_direct($this->result, $column);

            $columns[$column_info->name] = $column;

        }

        if ($this->db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {

            $columns = array_change_key_case($columns, $this->db->options['field_case']);

        }

        return $columns;

    }



    // }}}

    // {{{ numCols()



    /**

     * Count the number of columns returned by the DBMS in a query result.

     *

     * @return mixed integer value with the number of columns, a MDB2 error

     *                       on failure

     * @access public

     */

    function numCols()

    {

        $cols = @mysqli_num_fields($this->result);

        if (is_null($cols)) {

            if ($this->result === false) {

                return $this->db->raiseError(MDB2_ERROR_NEED_MORE_DATA, null, null,

                    'resultset has already been freed', __FUNCTION__);

            } elseif (is_null($this->result)) {

                return count($this->types);

            }

            return $this->db->raiseError(null, null, null,

                'Could not get column count', __FUNCTION__);

        }

        return $cols;

    }



    // }}}

    // {{{ nextResult()



    /**

     * Move the internal result pointer to the next available result

     *

     * @return true on success, false if there is no more result set or an error object on failure

     * @access public

     */

    function nextResult()

    {

        $connection = $this->db->getConnection();

        if (PEAR::isError($connection)) {

            return $connection;

        }



        if (!@mysqli_more_results($connection)) {

            return false;

        }

        if (!@mysqli_next_result($connection)) {

            return false;

        }

        if (!($this->result = @mysqli_use_result($connection))) {

            return false;

        }

        return MDB2_OK;

    }



    // }}}

    // {{{ free()



    /**

     * Free the internal resources associated with result.

     *

     * @return boolean true on success, false if result is invalid

     * @access public

     */

    function free()

    {

        if (is_object($this->result) && $this->db->connection) {

            $free = @mysqli_free_result($this->result);

            if ($free === false) {

                return $this->db->raiseError(null, null, null,

                    'Could not free result', __FUNCTION__);

            }

        }

        $this->result = false;

        return MDB2_OK;

    }

}



/**

 * MDB2 MySQLi buffered result driver

 *

 * @package MDB2

 * @category Database

 * @author  Lukas Smith <smith@pooteeweet.org>

 */

class MDB2_BufferedResult_mysqli extends MDB2_Result_mysqli

{

    // }}}

    // {{{ seek()



    /**

     * Seek to a specific row in a result set

     *

     * @param int    $rownum    number of the row where the data can be found

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function seek($rownum = 0)

    {

        if ($this->rownum != ($rownum - 1) && !@mysqli_data_seek($this->result, $rownum)) {

            if ($this->result === false) {

                return $this->db->raiseError(MDB2_ERROR_NEED_MORE_DATA, null, null,

                    'resultset has already been freed', __FUNCTION__);

            } elseif (is_null($this->result)) {

                return MDB2_OK;

            }

            return $this->db->raiseError(MDB2_ERROR_INVALID, null, null,

                'tried to seek to an invalid row number ('.$rownum.')', __FUNCTION__);

        }

        $this->rownum = $rownum - 1;

        return MDB2_OK;

    }



    // }}}

    // {{{ valid()



    /**

     * Check if the end of the result set has been reached

     *

     * @return mixed true or false on sucess, a MDB2 error on failure

     * @access public

     */

    function valid()

    {

        $numrows = $this->numRows();

        if (PEAR::isError($numrows)) {

            return $numrows;

        }

        return $this->rownum < ($numrows - 1);

    }



    // }}}

    // {{{ numRows()



    /**

     * Returns the number of rows in a result object

     *

     * @return mixed MDB2 Error Object or the number of rows

     * @access public

     */

    function numRows()

    {

        $rows = @mysqli_num_rows($this->result);

        if (is_null($rows)) {

            if ($this->result === false) {

                return $this->db->raiseError(MDB2_ERROR_NEED_MORE_DATA, null, null,

                    'resultset has already been freed', __FUNCTION__);

            } elseif (is_null($this->result)) {

                return 0;

            }

            return $this->db->raiseError(null, null, null,

                'Could not get row count', __FUNCTION__);

        }

        return $rows;

    }



    // }}}

    // {{{ nextResult()



    /**

     * Move the internal result pointer to the next available result

     *

     * @param a valid result resource

     * @return true on success, false if there is no more result set or an error object on failure

     * @access public

     */

    function nextResult()

    {

        $connection = $this->db->getConnection();

        if (PEAR::isError($connection)) {

            return $connection;

        }



        if (!@mysqli_more_results($connection)) {

            return false;

        }

        if (!@mysqli_next_result($connection)) {

            return false;

        }

        if (!($this->result = @mysqli_store_result($connection))) {

            return false;

        }

        return MDB2_OK;

    }

}



/**

 * MDB2 MySQLi statement driver

 *

 * @package MDB2

 * @category Database

 * @author  Lukas Smith <smith@pooteeweet.org>

 */

class MDB2_Statement_mysqli extends MDB2_Statement_Common

{

    // {{{ _execute()



    /**

     * Execute a prepared query statement helper method.

     *

     * @param mixed $result_class string which specifies which result class to use

     * @param mixed $result_wrap_class string which specifies which class to wrap results in

     * @return mixed a result handle or MDB2_OK on success, a MDB2 error on failure

     * @access private

     */

    function &_execute($result_class = true, $result_wrap_class = false)

    {

        if (is_null($this->statement)) {

            $result =& parent::_execute($result_class, $result_wrap_class);

            return $result;

        }

        $this->db->last_query = $this->query;

        $this->db->debug($this->query, 'execute', array('is_manip' => $this->is_manip, 'when' => 'pre', 'parameters' => $this->values));

        if ($this->db->getOption('disable_query')) {

            $result = $this->is_manip ? 0 : null;

            return $result;

        }



        $connection = $this->db->getConnection();

        if (PEAR::isError($connection)) {

            return $connection;

        }



        if (!is_object($this->statement)) {

            $query = 'EXECUTE '.$this->statement;

        }

        if (!empty($this->positions)) {

            $parameters = array(0 => $this->statement, 1 => '');

            $lobs = array();

            $i = 0;

            foreach ($this->positions as $parameter) {

                if (!array_key_exists($parameter, $this->values)) {

                    return $this->db->raiseError(MDB2_ERROR_NOT_FOUND, null, null,

                        'Unable to bind to missing placeholder: '.$parameter, __FUNCTION__);

                }

                $value = $this->values[$parameter];

                $type = array_key_exists($parameter, $this->types) ? $this->types[$parameter] : null;

                if (!is_object($this->statement)) {

                    if (is_resource($value) || $type == 'clob' || $type == 'blob' && $this->db->options['lob_allow_url_include']) {

                        if (!is_resource($value) && preg_match('/^(\w+:\/\/)(.*)$/', $value, $match)) {

                            if ($match[1] == 'file://') {

                                $value = $match[2];

                            }

                            $value = @fopen($value, 'r');

                            $close = true;

                        }

                        if (is_resource($value)) {

                            $data = '';

                            while (!@feof($value)) {

                                $data.= @fread($value, $this->db->options['lob_buffer_length']);

                            }

                            if ($close) {

                                @fclose($value);

                            }

                            $value = $data;

                        }

                    }

                    $quoted = $this->db->quote($value, $type);

                    if (PEAR::isError($quoted)) {

                        return $quoted;

                    }

                    $param_query = 'SET @'.$parameter.' = '.$quoted;

                    $result = $this->db->_doQuery($param_query, true, $connection);

                    if (PEAR::isError($result)) {

                        return $result;

                    }

                } else {

                    if (is_resource($value) || $type == 'clob' || $type == 'blob') {

                        $parameters[] = null;

                        $parameters[1].= 'b';

                        $lobs[$i] = $parameter;

                    } else {

                        $quoted = $this->db->quote($value, $type, false);

                        if (PEAR::isError($quoted)) {

                            return $quoted;

                        }

                        $parameters[] = $quoted;

                        $parameters[1].= $this->db->datatype->mapPrepareDatatype($type);

                    }

                    ++$i;

                }

            }



            if (!is_object($this->statement)) {

                $query.= ' USING @'.implode(', @', array_values($this->positions));

            } else {

                $result = @call_user_func_array('mysqli_stmt_bind_param', $parameters);

                if ($result === false) {

                    $err =& $this->db->raiseError(null, null, null,

                        'Unable to bind parameters', __FUNCTION__);

                    return $err;

                }



                foreach ($lobs as $i => $parameter) {

                    $value = $this->values[$parameter];

                    $close = false;

                    if (!is_resource($value)) {

                        $close = true;

                        if (preg_match('/^(\w+:\/\/)(.*)$/', $value, $match)) {

                            if ($match[1] == 'file://') {

                                $value = $match[2];

                            }

                            $value = @fopen($value, 'r');

                        } else {

                            $fp = @tmpfile();

                            @fwrite($fp, $value);

                            @rewind($fp);

                            $value = $fp;

                        }

                    }

                    while (!@feof($value)) {

                        $data = @fread($value, $this->db->options['lob_buffer_length']);

                        @mysqli_stmt_send_long_data($this->statement, $i, $data);

                    }

                    if ($close) {

                        @fclose($value);

                    }

                }

            }

        }



        if (!is_object($this->statement)) {

            $result = $this->db->_doQuery($query, $this->is_manip, $connection);

            if (PEAR::isError($result)) {

                return $result;

            }



            if ($this->is_manip) {

                $affected_rows = $this->db->_affectedRows($connection, $result);

                return $affected_rows;

            }



            $result =& $this->db->_wrapResult($result, $this->result_types,

                $result_class, $result_wrap_class, $this->limit, $this->offset);

        } else {

            if (!@mysqli_stmt_execute($this->statement)) {

                $err =& $this->db->raiseError(null, null, null,

                    'Unable to execute statement', __FUNCTION__);

                return $err;

            }



            if ($this->is_manip) {

                $affected_rows = @mysqli_stmt_affected_rows($this->statement);

                return $affected_rows;

            }



            if ($this->db->options['result_buffering']) {

                @mysqli_stmt_store_result($this->statement);

            }



            $result =& $this->db->_wrapResult($this->statement, $this->result_types,

                $result_class, $result_wrap_class, $this->limit, $this->offset);

        }



        $this->db->debug($this->query, 'execute', array('is_manip' => $this->is_manip, 'when' => 'post', 'result' => $result));

        return $result;

    }



    // }}}

    // {{{ free()



    /**

     * Release resources allocated for the specified prepared query.

     *

     * @return mixed MDB2_OK on success, a MDB2 error on failure

     * @access public

     */

    function free()

    {

        if (is_null($this->positions)) {

            return $this->db->raiseError(MDB2_ERROR, null, null,

                'Prepared statement has already been freed', __FUNCTION__);

        }

        $result = MDB2_OK;



        if (is_object($this->statement)) {

            if (!@mysqli_stmt_close($this->statement)) {

                $result = $this->db->raiseError(null, null, null,

                    'Could not free statement', __FUNCTION__);

            }

        } elseif (!is_null($this->statement)) {

            $connection = $this->db->getConnection();

            if (PEAR::isError($connection)) {

                return $connection;

            }



            $query = 'DEALLOCATE PREPARE '.$this->statement;

            $result = $this->db->_doQuery($query, true, $connection);

        }



        parent::free();

        return $result;

   }

}

<?php
// vim: set et ts=4 sw=4 fdm=marker:
// +----------------------------------------------------------------------+
// | PHP versions 4 and 5                                                 |
// +----------------------------------------------------------------------+
// | Copyright (c) 1998-2006 Manuel Lemos, Tomas V.V.Cox,                 |
// | Stig. S. Bakken, Lukas Smith                                         |
// | All rights reserved.                                                 |
// +----------------------------------------------------------------------+
// | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB  |
// | API as well as database abstraction for PHP applications.            |
// | This LICENSE is in the BSD license style.                            |
// |                                                                      |
// | Redistribution and use in source and binary forms, with or without   |
// | modification, are permitted provided that the following conditions   |
// | are met:                                                             |
// |                                                                      |
// | Redistributions of source code must retain the above copyright       |
// | notice, this list of conditions and the following disclaimer.        |
// |                                                                      |
// | Redistributions in binary form must reproduce the above copyright    |
// | notice, this list of conditions and the following disclaimer in the  |
// | documentation and/or other materials provided with the distribution. |
// |                                                                      |
// | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken,    |
// | Lukas Smith nor the names of his contributors may be used to endorse |
// | or promote products derived from this software without specific prior|
// | written permission.                                                  |
// |                                                                      |
// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS  |
// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT    |
// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS    |
// | FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE      |
// | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,          |
// | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |
// | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|
// |  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED  |
// | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT          |
// | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|
// | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE          |
// | POSSIBILITY OF SUCH DAMAGE.                                          |
// +----------------------------------------------------------------------+
// | Author: Lukas Smith <smith@pooteeweet.org>                           |
// +----------------------------------------------------------------------+
//
// $Id: mysqli.php,v 1.188 2008/03/13 03:31:55 afz Exp $
//

/**
 * MDB2 MySQLi driver
 *
 * @package MDB2
 * @category Database
 * @author  Lukas Smith <smith@pooteeweet.org>
 */
class MDB2_Driver_mysqli extends MDB2_Driver_Common
{
    // {{{ properties

    var $string_quoting = array('start' => "'", 'end' => "'", 'escape' => '\\', 'escape_pattern' => '\\');

    var $identifier_quoting = array('start' => '`', 'end' => '`', 'escape' => '`');

    var $sql_comments = array(
        array('start' => '-- ', 'end' => "\n", 'escape' => false),
        array('start' => '#', 'end' => "\n", 'escape' => false),
        array('start' => '/*', 'end' => '*/', 'escape' => false),
    );

    var $server_capabilities_checked = false;

    var $start_transaction = false;

    var $varchar_max_length = 255;

    // }}}
    // {{{ constructor

    /**
     * Constructor
     */
    function __construct()
    {
        parent::__construct();

        $this->phptype = 'mysqli';
        $this->dbsyntax = 'mysql';

        $this->supported['sequences'] = 'emulated';
        $this->supported['indexes'] = true;
        $this->supported['affected_rows'] = true;
        $this->supported['transactions'] = false;
        $this->supported['savepoints'] = false;
        $this->supported['summary_functions'] = true;
        $this->supported['order_by_text'] = true;
        $this->supported['current_id'] = 'emulated';
        $this->supported['limit_queries'] = true;
        $this->supported['LOBs'] = true;
        $this->supported['replace'] = true;
        $this->supported['sub_selects'] = 'emulated';
        $this->supported['triggers'] = false;
        $this->supported['auto_increment'] = true;
        $this->supported['primary_key'] = true;
        $this->supported['result_introspection'] = true;
        $this->supported['prepared_statements'] = 'emulated';
        $this->supported['identifier_quoting'] = true;
        $this->supported['pattern_escaping'] = true;
        $this->supported['new_link'] = true;

        $this->options['DBA_username'] = false;
        $this->options['DBA_password'] = false;
        $this->options['default_table_type'] = '';
        $this->options['multi_query'] = false;
        $this->options['max_identifiers_length'] = 64;

        $this->_reCheckSupportedOptions();
    }

    // }}}
    // {{{ _reCheckSupportedOptions()

    /**
     * If the user changes certain options, other capabilities may depend
     * on the new settings, so we need to check them (again).
     *
     * @access private
     */
    function _reCheckSupportedOptions()
    {
        $this->supported['transactions'] = $this->options['use_transactions'];
        $this->supported['savepoints']   = $this->options['use_transactions'];
        if ($this->options['default_table_type']) {
            switch (strtoupper($this->options['default_table_type'])) {
            case 'BLACKHOLE':
            case 'MEMORY':
            case 'ARCHIVE':
            case 'CSV':
            case 'HEAP':
            case 'ISAM':
            case 'MERGE':
            case 'MRG_ISAM':
            case 'ISAM':
            case 'MRG_MYISAM':
            case 'MYISAM':
                $this->supported['savepoints']   = false;
                $this->supported['transactions'] = false;
                $this->warnings[] = $this->options['default_table_type'] .
                    ' is not a supported default table type';
                break;
            }
        }
    }

    // }}}
    // {{{ function setOption($option, $value)

    /**
     * set the option for the db class
     *
     * @param   string  option name
     * @param   mixed   value for the option
     *
     * @return  mixed   MDB2_OK or MDB2 Error Object
     *
     * @access  public
     */
    function setOption($option, $value)
    {
        $res = parent::setOption($option, $value);
        $this->_reCheckSupportedOptions();
    }

    // }}}
    // {{{ errorInfo()

    /**
     * This method is used to collect information about an error
     *
     * @param integer $error
     * @return array
     * @access public
     */
    function errorInfo($error = null)
    {
        if ($this->connection) {
            $native_code = @mysqli_errno($this->connection);
            $native_msg  = @mysqli_error($this->connection);
        } else {
            $native_code = @mysqli_connect_errno();
            $native_msg  = @mysqli_connect_error();
        }
        if (is_null($error)) {
            static $ecode_map;
            if (empty($ecode_map)) {
                $ecode_map = array(
                    1000 => MDB2_ERROR_INVALID, //hashchk
                    1001 => MDB2_ERROR_INVALID, //isamchk
                    1004 => MDB2_ERROR_CANNOT_CREATE,
                    1005 => MDB2_ERROR_CANNOT_CREATE,
                    1006 => MDB2_ERROR_CANNOT_CREATE,
                    1007 => MDB2_ERROR_ALREADY_EXISTS,
                    1008 => MDB2_ERROR_CANNOT_DROP,
                    1009 => MDB2_ERROR_CANNOT_DROP,
                    1010 => MDB2_ERROR_CANNOT_DROP,
                    1011 => MDB2_ERROR_CANNOT_DELETE,
                    1022 => MDB2_ERROR_ALREADY_EXISTS,
                    1029 => MDB2_ERROR_NOT_FOUND,
                    1032 => MDB2_ERROR_NOT_FOUND,
                    1044 => MDB2_ERROR_ACCESS_VIOLATION,
                    1045 => MDB2_ERROR_ACCESS_VIOLATION,
                    1046 => MDB2_ERROR_NODBSELECTED,
                    1048 => MDB2_ERROR_CONSTRAINT,
                    1049 => MDB2_ERROR_NOSUCHDB,
                    1050 => MDB2_ERROR_ALREADY_EXISTS,
                    1051 => MDB2_ERROR_NOSUCHTABLE,
                    1054 => MDB2_ERROR_NOSUCHFIELD,
                    1060 => MDB2_ERROR_ALREADY_EXISTS,
                    1061 => MDB2_ERROR_ALREADY_EXISTS,
                    1062 => MDB2_ERROR_ALREADY_EXISTS,
                    1064 => MDB2_ERROR_SYNTAX,
                    1067 => MDB2_ERROR_INVALID,
                    1072 => MDB2_ERROR_NOT_FOUND,
                    1086 => MDB2_ERROR_ALREADY_EXISTS,
                    1091 => MDB2_ERROR_NOT_FOUND,
                    1100 => MDB2_ERROR_NOT_LOCKED,
                    1109 => MDB2_ERROR_NOT_FOUND,
                    1125 => MDB2_ERROR_ALREADY_EXISTS,
                    1136 => MDB2_ERROR_VALUE_COUNT_ON_ROW,
                    1138 => MDB2_ERROR_INVALID,
                    1142 => MDB2_ERROR_ACCESS_VIOLATION,
                    1143 => MDB2_ERROR_ACCESS_VIOLATION,
                    1146 => MDB2_ERROR_NOSUCHTABLE,
                    1149 => MDB2_ERROR_SYNTAX,
                    1169 => MDB2_ERROR_CONSTRAINT,
                    1176 => MDB2_ERROR_NOT_FOUND,
                    1177 => MDB2_ERROR_NOSUCHTABLE,
                    1213 => MDB2_ERROR_DEADLOCK,
                    1216 => MDB2_ERROR_CONSTRAINT,
                    1217 => MDB2_ERROR_CONSTRAINT,
                    1227 => MDB2_ERROR_ACCESS_VIOLATION,
                    1235 => MDB2_ERROR_CANNOT_CREATE,
                    1299 => MDB2_ERROR_INVALID_DATE,
                    1300 => MDB2_ERROR_INVALID,
                    1304 => MDB2_ERROR_ALREADY_EXISTS,
                    1305 => MDB2_ERROR_NOT_FOUND,
                    1306 => MDB2_ERROR_CANNOT_DROP,
                    1307 => MDB2_ERROR_CANNOT_CREATE,
                    1334 => MDB2_ERROR_CANNOT_ALTER,
                    1339 => MDB2_ERROR_NOT_FOUND,
                    1356 => MDB2_ERROR_INVALID,
                    1359 => MDB2_ERROR_ALREADY_EXISTS,
                    1360 => MDB2_ERROR_NOT_FOUND,
                    1363 => MDB2_ERROR_NOT_FOUND,
                    1365 => MDB2_ERROR_DIVZERO,
                    1451 => MDB2_ERROR_CONSTRAINT,
                    1452 => MDB2_ERROR_CONSTRAINT,
                    1542 => MDB2_ERROR_CANNOT_DROP,
                    1546 => MDB2_ERROR_CONSTRAINT,
                    1582 => MDB2_ERROR_CONSTRAINT,
                    2003 => MDB2_ERROR_CONNECT_FAILED,
                    2019 => MDB2_ERROR_INVALID,
                );
            }
            if ($this->options['portability'] & MDB2_PORTABILITY_ERRORS) {
                $ecode_map[1022] = MDB2_ERROR_CONSTRAINT;
                $ecode_map[1048] = MDB2_ERROR_CONSTRAINT_NOT_NULL;
                $ecode_map[1062] = MDB2_ERROR_CONSTRAINT;
            } else {
                // Doing this in case mode changes during runtime.
                $ecode_map[1022] = MDB2_ERROR_ALREADY_EXISTS;
                $ecode_map[1048] = MDB2_ERROR_CONSTRAINT;
                $ecode_map[1062] = MDB2_ERROR_ALREADY_EXISTS;
            }
            if (isset($ecode_map[$native_code])) {
                $error = $ecode_map[$native_code];
            }
        }
        return array($error, $native_code, $native_msg);
    }

    // }}}
    // {{{ escape()

    /**
     * Quotes a string so it can be safely used in a query. It will quote
     * the text so it can safely be used within a query.
     *
     * @param   string  the input string to quote
     * @param   bool    escape wildcards
     *
     * @return  string  quoted string
     *
     * @access  public
     */
    function escape($text, $escape_wildcards = false)
    {
        if ($escape_wildcards) {
            $text = $this->escapePattern($text);
        }
        $connection = $this->getConnection();
        if (PEAR::isError($connection)) {
            return $connection;
        }
        $text = @mysqli_real_escape_string($connection, $text);
        return $text;
    }

    // }}}
    // {{{ beginTransaction()

    /**
     * Start a transaction or set a savepoint.
     *
     * @param   string  name of a savepoint to set
     * @return  mixed   MDB2_OK on success, a MDB2 error on failure
     *
     * @access  public
     */
    function beginTransaction($savepoint = null)
    {
        $this->debug('Starting transaction/savepoint', __FUNCTION__, array('is_manip' => true, 'savepoint' => $savepoint));
        $this->_getServerCapabilities();
        if (!is_null($savepoint)) {
            if (!$this->supports('savepoints')) {
                return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
                    'savepoints are not supported', __FUNCTION__);
            }
            if (!$this->in_transaction) {
                return $this->raiseError(MDB2_ERROR_INVALID, null, null,
                    'savepoint cannot be released when changes are auto committed', __FUNCTION__);
            }
            $query = 'SAVEPOINT '.$savepoint;
            return $this->_doQuery($query, true);
        } elseif ($this->in_transaction) {
            return MDB2_OK;  //nothing to do
        }
        $query = $this->start_transaction ? 'START TRANSACTION' : 'SET AUTOCOMMIT = 1';
        $result =& $this->_doQuery($query, true);
        if (PEAR::isError($result)) {
            return $result;
        }
        $this->in_transaction = true;
        return MDB2_OK;
    }

    // }}}
    // {{{ commit()

    /**
     * Commit the database changes done during a transaction that is in
     * progress or release a savepoint. This function may only be called when
     * auto-committing is disabled, otherwise it will fail. Therefore, a new
     * transaction is implicitly started after committing the pending changes.
     *
     * @param   string  name of a savepoint to release
     * @return  mixed   MDB2_OK on success, a MDB2 error on failure
     *
     * @access  public
     */
    function commit($savepoint = null)
    {
        $this->debug('Committing transaction/savepoint', __FUNCTION__, array('is_manip' => true, 'savepoint' => $savepoint));
        if (!$this->in_transaction) {
            return $this->raiseError(MDB2_ERROR_INVALID, null, null,
                'commit/release savepoint cannot be done changes are auto committed', __FUNCTION__);
        }
        if (!is_null($savepoint)) {
            if (!$this->supports('savepoints')) {
                return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
                    'savepoints are not supported', __FUNCTION__);
            }
            $server_info = $this->getServerVersion();
            if (version_compare($server_info['major'].'.'.$server_info['minor'].'.'.$server_info['patch'], '5.0.3', '<')) {
                return MDB2_OK;
            }
            $query = 'RELEASE SAVEPOINT '.$savepoint;
            return $this->_doQuery($query, true);
        }

        if (!$this->supports('transactions')) {
            return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
                'transactions are not supported', __FUNCTION__);
        }

        $result =& $this->_doQuery('COMMIT', true);
        if (PEAR::isError($result)) {
            return $result;
        }
        if (!$this->start_transaction) {
            $query = 'SET AUTOCOMMIT = 0';
            $result =& $this->_doQuery($query, true);
            if (PEAR::isError($result)) {
                return $result;
            }
        }
        $this->in_transaction = false;
        return MDB2_OK;
    }

    // }}}
    // {{{ rollback()

    /**
     * Cancel any database changes done during a transaction or since a specific
     * savepoint that is in progress. This function may only be called when
     * auto-committing is disabled, otherwise it will fail. Therefore, a new
     * transaction is implicitly started after canceling the pending changes.
     *
     * @param   string  name of a savepoint to rollback to
     * @return  mixed   MDB2_OK on success, a MDB2 error on failure
     *
     * @access  public
     */
    function rollback($savepoint = null)
    {
        $this->debug('Rolling back transaction/savepoint', __FUNCTION__, array('is_manip' => true, 'savepoint' => $savepoint));
        if (!$this->in_transaction) {
            return $this->raiseError(MDB2_ERROR_INVALID, null, null,
                'rollback cannot be done changes are auto committed', __FUNCTION__);
        }
        if (!is_null($savepoint)) {
            if (!$this->supports('savepoints')) {
                return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
                    'savepoints are not supported', __FUNCTION__);
            }
            $query = 'ROLLBACK TO SAVEPOINT '.$savepoint;
            return $this->_doQuery($query, true);
        }

        $query = 'ROLLBACK';
        $result =& $this->_doQuery($query, true);
        if (PEAR::isError($result)) {
            return $result;
        }
        if (!$this->start_transaction) {
            $query = 'SET AUTOCOMMIT = 0';
            $result =& $this->_doQuery($query, true);
            if (PEAR::isError($result)) {
                return $result;
            }
        }
        $this->in_transaction = false;
        return MDB2_OK;
    }

    // }}}
    // {{{ function setTransactionIsolation()

    /**
     * Set the transacton isolation level.
     *
     * @param   string  standard isolation level
     *                  READ UNCOMMITTED (allows dirty reads)
     *                  READ COMMITTED (prevents dirty reads)
     *                  REPEATABLE READ (prevents nonrepeatable reads)
     *                  SERIALIZABLE (prevents phantom reads)
     * @return  mixed   MDB2_OK on success, a MDB2 error on failure
     *
     * @access  public
     * @since   2.1.1
     */
    function setTransactionIsolation($isolation)
    {
        $this->debug('Setting transaction isolation level', __FUNCTION__, array('is_manip' => true));
        if (!$this->supports('transactions')) {
            return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
                'transactions are not supported', __FUNCTION__);
        }
        switch ($isolation) {
        case 'READ UNCOMMITTED':
        case 'READ COMMITTED':
        case 'REPEATABLE READ':
        case 'SERIALIZABLE':
            break;
        default:
            return $this->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
                'isolation level is not supported: '.$isolation, __FUNCTION__);
        }

        $query = "SET SESSION TRANSACTION ISOLATION LEVEL $isolation";
        return $this->_doQuery($query, true);
    }

    // }}}
    // {{{ _doConnect()

    /**
     * do the grunt work of the connect
     *
     * @return connection on success or MDB2 Error Object on failure
     * @access protected
     */
    function _doConnect($username, $password, $persistent = false)
    {
        if (!PEAR::loadExtension($this->phptype)) {
            return $this->raiseError(MDB2_ERROR_NOT_FOUND, null, null,
                'extension '.$this->phptype.' is not compiled into PHP', __FUNCTION__);
        }

        $connection = @mysqli_init();
        if (!empty($this->dsn['charset']) && defined('MYSQLI_SET_CHARSET_NAME')) {
            @mysqli_options($connection, MYSQLI_SET_CHARSET_NAME, $this->dsn['charset']);
        }

        if ($this->options['ssl']) {
            @mysqli_ssl_set(
                $connection,
                empty($this->dsn['key'])    ? null : $this->dsn['key'],
                empty($this->dsn['cert'])   ? null : $this->dsn['cert'],
                empty($this->dsn['ca'])     ? null : $this->dsn['ca'],
                empty($this->dsn['capath']) ? null : $this->dsn['capath'],
                empty($this->dsn['cipher']) ? null : $this->dsn['cipher']
            );
        }

        if (!@mysqli_real_connect(
            $connection,
            $this->dsn['hostspec'],
            $username,
            $password,
            $this->database_name,
            $this->dsn['port'],
            $this->dsn['socket']
        )) {
            if (($err = @mysqli_connect_error()) != '') {
                return $this->raiseError(null,
                    null, null, $err, __FUNCTION__);
            } else {
                return $this->raiseError(MDB2_ERROR_CONNECT_FAILED, null, null,
                    'unable to establish a connection', __FUNCTION__);
            }
        }

        if (!empty($this->dsn['charset']) && !defined('MYSQLI_SET_CHARSET_NAME')) {
            $result = $this->setCharset($this->dsn['charset'], $connection);
            if (PEAR::isError($result)) {
                return $result;
            }
        }

        return $connection;
    }

    // }}}
    // {{{ connect()

    /**
     * Connect to the database
     *
     * @return true on success, MDB2 Error Object on failure
     */
    function connect()
    {
        if (is_object($this->connection)) {
            //if (count(array_diff($this->connected_dsn, $this->dsn)) == 0) {
            if (MDB2::areEquals($this->connected_dsn, $this->dsn)) {
                return MDB2_OK;
            }
            $this->connection = 0;
        }

        $connection = $this->_doConnect(
            $this->dsn['username'],
            $this->dsn['password']
        );
        if (PEAR::isError($connection)) {
            return $connection;
        }

        $this->connection = $connection;
        $this->connected_dsn = $this->dsn;
        $this->connected_database_name = $this->database_name;
        $this->dbsyntax = $this->dsn['dbsyntax'] ? $this->dsn['dbsyntax'] : $this->phptype;

        $this->_getServerCapabilities();

        return MDB2_OK;
    }

    // }}}
    // {{{ setCharset()

    /**
     * Set the charset on the current connection
     *
     * @param string    charset (or array(charset, collation))
     * @param resource  connection handle
     *
     * @return true on success, MDB2 Error Object on failure
     */
    function setCharset($charset, $connection = null)
    {
        if (is_null($connection)) {
            $connection = $this->getConnection();
            if (PEAR::isError($connection)) {
                return $connection;
            }
        }
        $collation = null;
        if (is_array($charset) && 2 == count($charset)) {
            $collation = array_pop($charset);
            $charset   = array_pop($charset);
        }
        $client_info = mysqli_get_client_version();
        if (OS_WINDOWS && ((40111 > $client_info) ||
            ((50000 <= $client_info) && (50006 > $client_info)))
        ) {
            $query = "SET NAMES '".mysqli_real_escape_string($connection, $charset)."'";
            if (!is_null($collation)) {
                $query .= " COLLATE '".mysqli_real_escape_string($connection, $collation)."'";
            }
            return $this->_doQuery($query, true, $connection);
        }
        if (!$result = mysqli_set_charset($connection, $charset)) {
            $err =& $this->raiseError(null, null, null,
                'Could not set client character set', __FUNCTION__);
            return $err;
        }
        return $result;
    }

    // }}}
    // {{{ databaseExists()

    /**
     * check if given database name is exists?
     *
     * @param string $name    name of the database that should be checked
     *
     * @return mixed true/false on success, a MDB2 error on failure
     * @access public
     */
    function databaseExists($name)
    {
        $connection = $this->_doConnect($this->dsn['username'],
                                        $this->dsn['password']);
        if (PEAR::isError($connection)) {
            return $connection;
        }

        $result = @mysqli_select_db($connection, $name);
        @mysqli_close($connection);

        return $result;
    }

    // }}}
    // {{{ disconnect()

    /**
     * Log out and disconnect from the database.
     *
     * @param  boolean $force if the disconnect should be forced even if the
     *                        connection is opened persistently
     * @return mixed true on success, false if not connected and error
     *                object on error
     * @access public
     */
    function disconnect($force = true)
    {
        if (is_object($this->connection)) {
            if ($this->in_transaction) {
                $dsn = $this->dsn;
                $database_name = $this->database_name;
                $persistent = $this->options['persistent'];
                $this->dsn = $this->connected_dsn;
                $this->database_name = $this->connected_database_name;
                $this->options['persistent'] = $this->opened_persistent;
                $this->rollback();
                $this->dsn = $dsn;
                $this->database_name = $database_name;
                $this->options['persistent'] = $persistent;
            }

            if ($force) {
                @mysqli_close($this->connection);
            }
        }
        return parent::disconnect($force);
    }

    // }}}
    // {{{ standaloneQuery()

   /**
     * execute a query as DBA
     *
     * @param string $query the SQL query
     * @param mixed   $types  array that contains the types of the columns in
     *                        the result set
     * @param boolean $is_manip  if the query is a manipulation query
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function &standaloneQuery($query, $types = null, $is_manip = false)
    {
        $user = $this->options['DBA_username']? $this->options['DBA_username'] : $this->dsn['username'];
        $pass = $this->options['DBA_password']? $this->options['DBA_password'] : $this->dsn['password'];
        $connection = $this->_doConnect($user, $pass);
        if (PEAR::isError($connection)) {
            return $connection;
        }

        $offset = $this->offset;
        $limit = $this->limit;
        $this->offset = $this->limit = 0;
        $query = $this->_modifyQuery($query, $is_manip, $limit, $offset);
        
        $result =& $this->_doQuery($query, $is_manip, $connection, $this->database_name);
        if (!PEAR::isError($result)) {
            $result = $this->_affectedRows($connection, $result);
        }

        @mysqli_close($connection);
        return $result;
    }

    // }}}
    // {{{ _doQuery()

    /**
     * Execute a query
     * @param string $query  query
     * @param boolean $is_manip  if the query is a manipulation query
     * @param resource $connection
     * @param string $database_name
     * @return result or error object
     * @access protected
     */
    function &_doQuery($query, $is_manip = false, $connection = null, $database_name = null)
    {
        $this->last_query = $query;
        $result = $this->debug($query, 'query', array('is_manip' => $is_manip, 'when' => 'pre'));
        if ($result) {
            if (PEAR::isError($result)) {
                return $result;
            }
            $query = $result;
        }
        if ($this->options['disable_query']) {
            $result = $is_manip ? 0 : null;
            return $result;
        }

        if (is_null($connection)) {
            $connection = $this->getConnection();
            if (PEAR::isError($connection)) {
                return $connection;
            }
        }
        if (is_null($database_name)) {
            $database_name = $this->database_name;
        }

        if ($database_name) {
            if ($database_name != $this->connected_database_name) {
                if (!@mysqli_select_db($connection, $database_name)) {
                    $err = $this->raiseError(null, null, null,
                        'Could not select the database: '.$database_name, __FUNCTION__);
                    return $err;
                }
                $this->connected_database_name = $database_name;
            }
        }

        if ($this->options['multi_query']) {
            $result = mysqli_multi_query($connection, $query);
        } else {
            $resultmode = $this->options['result_buffering'] ? MYSQLI_USE_RESULT : MYSQLI_USE_RESULT;
            $result = mysqli_query($connection, $query);
        }

        if (!$result) {
            $err =& $this->raiseError(null, null, null,
                'Could not execute statement', __FUNCTION__);
            return $err;
        }

        if ($this->options['multi_query']) {
            if ($this->options['result_buffering']) {
                if (!($result = @mysqli_store_result($connection))) {
                    $err =& $this->raiseError(null, null, null,
                        'Could not get the first result from a multi query', __FUNCTION__);
                    return $err;
                }
            } elseif (!($result = @mysqli_use_result($connection))) {
                $err =& $this->raiseError(null, null, null,
                        'Could not get the first result from a multi query', __FUNCTION__);
                return $err;
            }
        }

        $this->debug($query, 'query', array('is_manip' => $is_manip, 'when' => 'post', 'result' => $result));
        return $result;
    }

    // }}}
    // {{{ _affectedRows()

    /**
     * Returns the number of rows affected
     *
     * @param resource $result
     * @param resource $connection
     * @return mixed MDB2 Error Object or the number of rows affected
     * @access private
     */
    function _affectedRows($connection, $result = null)
    {
        if (is_null($connection)) {
            $connection = $this->getConnection();
            if (PEAR::isError($connection)) {
                return $connection;
            }
        }
        return @mysqli_affected_rows($connection);
    }

    // }}}
    // {{{ _modifyQuery()

    /**
     * Changes a query string for various DBMS specific reasons
     *
     * @param string $query  query to modify
     * @param boolean $is_manip  if it is a DML query
     * @param integer $limit  limit the number of rows
     * @param integer $offset  start reading from given offset
     * @return string modified query
     * @access protected
     */
    function _modifyQuery($query, $is_manip, $limit, $offset)
    {
        if ($this->options['portability'] & MDB2_PORTABILITY_DELETE_COUNT) {
            // "DELETE FROM table" gives 0 affected rows in MySQL.
            // This little hack lets you know how many rows were deleted.
            if (preg_match('/^\s*DELETE\s+FROM\s+(\S+)\s*$/i', $query)) {
                $query = preg_replace('/^\s*DELETE\s+FROM\s+(\S+)\s*$/',
                                      'DELETE FROM \1 WHERE 1=1', $query);
            }
        }
        if ($limit > 0
            && !preg_match('/LIMIT\s*\d(?:\s*(?:,|OFFSET)\s*\d+)?(?:[^\)]*)?$/i', $query)
        ) {
            $query = rtrim($query);
            if (substr($query, -1) == ';') {
                $query = substr($query, 0, -1);
            }

            // LIMIT doesn't always come last in the query
            // @see http://dev.mysql.com/doc/refman/5.0/en/select.html
            $after = '';
            if (preg_match('/(\s+INTO\s+(?:OUT|DUMP)FILE\s.*)$/ims', $query, $matches)) {
                $after = $matches[0];
                $query = preg_replace('/(\s+INTO\s+(?:OUT|DUMP)FILE\s.*)$/ims', '', $query);
            } elseif (preg_match('/(\s+FOR\s+UPDATE\s*)$/i', $query, $matches)) {
               $after = $matches[0];
               $query = preg_replace('/(\s+FOR\s+UPDATE\s*)$/im', '', $query);
            } elseif (preg_match('/(\s+LOCK\s+IN\s+SHARE\s+MODE\s*)$/im', $query, $matches)) {
               $after = $matches[0];
               $query = preg_replace('/(\s+LOCK\s+IN\s+SHARE\s+MODE\s*)$/im', '', $query);
            }

            if ($is_manip) {
                return $query . " LIMIT $limit" . $after;
            } else {
                return $query . " LIMIT $offset, $limit" . $after;
            }
        }
        return $query;
    }

    // }}}
    // {{{ getServerVersion()

    /**
     * return version information about the server
     *
     * @param bool   $native  determines if the raw version string should be returned
     * @return mixed array/string with version information or MDB2 error object
     * @access public
     */
    function getServerVersion($native = false)
    {
        $connection = $this->getConnection();
        if (PEAR::isError($connection)) {
            return $connection;
        }
        if ($this->connected_server_info) {
            $server_info = $this->connected_server_info;
        } else {
            $server_info = @mysqli_get_server_info($connection);
        }
        if (!$server_info) {
            return $this->raiseError(null, null, null,
                'Could not get server information', __FUNCTION__);
        }
        // cache server_info
        $this->connected_server_info = $server_info;
        if (!$native) {
            $tmp = explode('.', $server_info, 3);
            if (isset($tmp[2]) && strpos($tmp[2], '-')) {
                $tmp2 = explode('-', @$tmp[2], 2);
            } else {
                $tmp2[0] = isset($tmp[2]) ? $tmp[2] : null;
                $tmp2[1] = null;
            }
            $server_info = array(
                'major' => isset($tmp[0]) ? $tmp[0] : null,
                'minor' => isset($tmp[1]) ? $tmp[1] : null,
                'patch' => $tmp2[0],
                'extra' => $tmp2[1],
                'native' => $server_info,
            );
        }
        return $server_info;
    }

    // }}}
    // {{{ _getServerCapabilities()

    /**
     * Fetch some information about the server capabilities
     * (transactions, subselects, prepared statements, etc).
     *
     * @access private
     */
    function _getServerCapabilities()
    {
        if (!$this->server_capabilities_checked) {
            $this->server_capabilities_checked = true;

            //set defaults
            $this->supported['sub_selects'] = 'emulated';
            $this->supported['prepared_statements'] = 'emulated';
            $this->supported['triggers'] = false;
            $this->start_transaction = false;
            $this->varchar_max_length = 255;

            $server_info = $this->getServerVersion();
            if (is_array($server_info)) {
                $server_version = $server_info['major'].'.'.$server_info['minor'].'.'.$server_info['patch'];
            
                if (!version_compare($server_version, '4.1.0', '<')) {
                    $this->supported['sub_selects'] = true;
                    $this->supported['prepared_statements'] = true;
                }

                // SAVEPOINTS were introduced in MySQL 4.0.14 and 4.1.1 (InnoDB)
                if (version_compare($server_version, '4.1.0', '>=')) {
                    if (version_compare($server_version, '4.1.1', '<')) {
                        $this->supported['savepoints'] = false;
                    }
                } elseif (version_compare($server_version, '4.0.14', '<')) {
                    $this->supported['savepoints'] = false;
                }

                if (!version_compare($server_version, '4.0.11', '<')) {
                    $this->start_transaction = true;
                }

                if (!version_compare($server_version, '5.0.3', '<')) {
                    $this->varchar_max_length = 65532;
                }

                if (!version_compare($server_version, '5.0.2', '<')) {
                    $this->supported['triggers'] = true;
                }
            }
        }
    }

    // }}}
    // {{{ function _skipUserDefinedVariable($query, $position)

    /**
     * Utility method, used by prepare() to avoid misinterpreting MySQL user
     * defined variables (SELECT @x:=5) for placeholders.
     * Check if the placeholder is a false positive, i.e. if it is an user defined
     * variable instead. If so, skip it and advance the position, otherwise
     * return the current position, which is valid
     *
     * @param string $query
     * @param integer $position current string cursor position
     * @return integer $new_position
     * @access protected
     */
    function _skipUserDefinedVariable($query, $position)
    {
        $found = strpos(strrev(substr($query, 0, $position)), '@');
        if ($found === false) {
            return $position;
        }
        $pos = strlen($query) - strlen(substr($query, $position)) - $found - 1;
        $substring = substr($query, $pos, $position - $pos + 2);
        if (preg_match('/^@\w+\s*:=$/', $substring)) {
            return $position + 1; //found an user defined variable: skip it
        }
        return $position;
    }

    // }}}
    // {{{ prepare()

    /**
     * Prepares a query for multiple execution with execute().
     * With some database backends, this is emulated.
     * prepare() requires a generic query as string like
     * 'INSERT INTO numbers VALUES(?,?)' or
     * 'INSERT INTO numbers VALUES(:foo,:bar)'.
     * The ? and :name and are placeholders which can be set using
     * bindParam() and the query can be sent off using the execute() method.
     * The allowed format for :name can be set with the 'bindname_format' option.
     *
     * @param string $query the query to prepare
     * @param mixed   $types  array that contains the types of the placeholders
     * @param mixed   $result_types  array that contains the types of the columns in
     *                        the result set or MDB2_PREPARE_RESULT, if set to
     *                        MDB2_PREPARE_MANIP the query is handled as a manipulation query
     * @param mixed   $lobs   key (field) value (parameter) pair for all lob placeholders
     * @return mixed resource handle for the prepared query on success, a MDB2
     *        error on failure
     * @access public
     * @see bindParam, execute
     */
    function &prepare($query, $types = null, $result_types = null, $lobs = array())
    {
        if ($this->options['emulate_prepared']
            || $this->supported['prepared_statements'] !== true
        ) {
            $obj =& parent::prepare($query, $types, $result_types, $lobs);
            return $obj;
        }
        $is_manip = ($result_types === MDB2_PREPARE_MANIP);
        $offset = $this->offset;
        $limit = $this->limit;
        $this->offset = $this->limit = 0;
        $query = $this->_modifyQuery($query, $is_manip, $limit, $offset);
        $result = $this->debug($query, __FUNCTION__, array('is_manip' => $is_manip, 'when' => 'pre'));
        if ($result) {
            if (PEAR::isError($result)) {
                return $result;
            }
            $query = $result;
        }
        $placeholder_type_guess = $placeholder_type = null;
        $question = '?';
        $colon = ':';
        $positions = array();
        $position = 0;
        while ($position < strlen($query)) {
            $q_position = strpos($query, $question, $position);
            $c_position = strpos($query, $colon, $position);
            if ($q_position && $c_position) {
                $p_position = min($q_position, $c_position);
            } elseif ($q_position) {
                $p_position = $q_position;
            } elseif ($c_position) {
                $p_position = $c_position;
            } else {
                break;
            }
            if (is_null($placeholder_type)) {
                $placeholder_type_guess = $query[$p_position];
            }
            
            $new_pos = $this->_skipDelimitedStrings($query, $position, $p_position);
            if (PEAR::isError($new_pos)) {
                return $new_pos;
            }
            if ($new_pos != $position) {
                $position = $new_pos;
                continue; //evaluate again starting from the new position
            }
            
            //make sure this is not part of an user defined variable
            $new_pos = $this->_skipUserDefinedVariable($query, $position);
            if ($new_pos != $position) {
                $position = $new_pos;
                continue; //evaluate again starting from the new position
            }

            if ($query[$position] == $placeholder_type_guess) {
                if (is_null($placeholder_type)) {
                    $placeholder_type = $query[$p_position];
                    $question = $colon = $placeholder_type;
                }
                if ($placeholder_type == ':') {
                    $regexp = '/^.{'.($position+1).'}('.$this->options['bindname_format'].').*$/s';
                    $parameter = preg_replace($regexp, '\\1', $query);
                    if ($parameter === '') {
                        $err =& $this->raiseError(MDB2_ERROR_SYNTAX, null, null,
                            'named parameter name must match "bindname_format" option', __FUNCTION__);
                        return $err;
                    }
                    $positions[$p_position] = $parameter;
                    $query = substr_replace($query, '?', $position, strlen($parameter)+1);
                } else {
                    $positions[$p_position] = count($positions);
                }
                $position = $p_position + 1;
            } else {
                $position = $p_position;
            }
        }
        $connection = $this->getConnection();
        if (PEAR::isError($connection)) {
            return $connection;
        }

        if (!$is_manip) {
            static $prep_statement_counter = 1;
            $statement_name = sprintf($this->options['statement_format'], $this->phptype, $prep_statement_counter++ . sha1(microtime() + mt_rand()));
            $statement_name = substr(strtolower($statement_name), 0, $this->options['max_identifiers_length']);
            $query = "PREPARE $statement_name FROM ".$this->quote($query, 'text');

            $statement =& $this->_doQuery($query, true, $connection);
            if (PEAR::isError($statement)) {
                return $statement;
            }
            $statement = $statement_name;
        } else {
            $statement = @mysqli_prepare($connection, $query);
            if (!$statement) {
                $err =& $this->raiseError(null, null, null,
                    'Unable to create prepared statement handle', __FUNCTION__);
                return $err;
            }
        }

        $class_name = 'MDB2_Statement_'.$this->phptype;
        $obj = new $class_name($this, $statement, $positions, $query, $types, $result_types, $is_manip, $limit, $offset);
        $this->debug($query, __FUNCTION__, array('is_manip' => $is_manip, 'when' => 'post', 'result' => $obj));
        return $obj;
    }

    // }}}
    // {{{ replace()

    /**
     * Execute a SQL REPLACE query. A REPLACE query is identical to a INSERT
     * query, except that if there is already a row in the table with the same
     * key field values, the REPLACE query just updates its values instead of
     * inserting a new row.
     *
     * The REPLACE type of query does not make part of the SQL standards. Since
     * practically only MySQL implements it natively, this type of query is
     * emulated through this method for other DBMS using standard types of
     * queries inside a transaction to assure the atomicity of the operation.
     *
     * @access public
     *
     * @param string $table name of the table on which the REPLACE query will
     *  be executed.
     * @param array $fields associative array that describes the fields and the
     *  values that will be inserted or updated in the specified table. The
     *  indexes of the array are the names of all the fields of the table. The
     *  values of the array are also associative arrays that describe the
     *  values and other properties of the table fields.
     *
     *  Here follows a list of field properties that need to be specified:
     *
     *    value:
     *          Value to be assigned to the specified field. This value may be
     *          of specified in database independent type format as this
     *          function can perform the necessary datatype conversions.
     *
     *    Default:
     *          this property is required unless the Null property
     *          is set to 1.
     *
     *    type
     *          Name of the type of the field. Currently, all types Metabase
     *          are supported except for clob and blob.
     *
     *    Default: no type conversion
     *
     *    null
     *          Boolean property that indicates that the value for this field
     *          should be set to null.
     *
     *          The default value for fields missing in INSERT queries may be
     *          specified the definition of a table. Often, the default value
     *          is already null, but since the REPLACE may be emulated using
     *          an UPDATE query, make sure that all fields of the table are
     *          listed in this function argument array.
     *
     *    Default: 0
     *
     *    key
     *          Boolean property that indicates that this field should be
     *          handled as a primary key or at least as part of the compound
     *          unique index of the table that will determine the row that will
     *          updated if it exists or inserted a new row otherwise.
     *
     *          This function will fail if no key field is specified or if the
     *          value of a key field is set to null because fields that are
     *          part of unique index they may not be null.
     *
     *    Default: 0
     *
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     */
    function replace($table, $fields)
    {
        $count = count($fields);
        $query = $values = '';
        $keys = $colnum = 0;
        for (reset($fields); $colnum < $count; next($fields), $colnum++) {
            $name = key($fields);
            if ($colnum > 0) {
                $query .= ',';
                $values.= ',';
            }
            $query.= $this->quoteIdentifier($name, true);
            if (isset($fields[$name]['null']) && $fields[$name]['null']) {
                $value = 'NULL';
            } else {
                $type = isset($fields[$name]['type']) ? $fields[$name]['type'] : null;
                $value = $this->quote($fields[$name]['value'], $type);
                if (PEAR::isError($value)) {
                    return $value;
                }
            }
            $values.= $value;
            if (isset($fields[$name]['key']) && $fields[$name]['key']) {
                if ($value === 'NULL') {
                    return $this->raiseError(MDB2_ERROR_CANNOT_REPLACE, null, null,
                        'key value '.$name.' may not be NULL', __FUNCTION__);
                }
                $keys++;
            }
        }
        if ($keys == 0) {
            return $this->raiseError(MDB2_ERROR_CANNOT_REPLACE, null, null,
                'not specified which fields are keys', __FUNCTION__);
        }

        $connection = $this->getConnection();
        if (PEAR::isError($connection)) {
            return $connection;
        }

        $table = $this->quoteIdentifier($table, true);
        $query = "REPLACE INTO $table ($query) VALUES ($values)";
        $result =& $this->_doQuery($query, true, $connection);
        if (PEAR::isError($result)) {
            return $result;
        }
        return $this->_affectedRows($connection, $result);
    }

    // }}}
    // {{{ nextID()

    /**
     * Returns the next free id of a sequence
     *
     * @param string $seq_name name of the sequence
     * @param boolean $ondemand when true the sequence is
     *                          automatic created, if it
     *                          not exists
     *
     * @return mixed MDB2 Error Object or id
     * @access public
     */
    function nextID($seq_name, $ondemand = true)
    {
        $sequence_name = $this->quoteIdentifier($this->getSequenceName($seq_name), true);
        $seqcol_name = $this->quoteIdentifier($this->options['seqcol_name'], true);
        $query = "INSERT INTO $sequence_name ($seqcol_name) VALUES (NULL)";
        $this->pushErrorHandling(PEAR_ERROR_RETURN);
        $this->expectError(MDB2_ERROR_NOSUCHTABLE);
        $result =& $this->_doQuery($query, true);
        $this->popExpect();
        $this->popErrorHandling();
        if (PEAR::isError($result)) {
            if ($ondemand && $result->getCode() == MDB2_ERROR_NOSUCHTABLE) {
                $this->loadModule('Manager', null, true);
                $result = $this->manager->createSequence($seq_name);
                if (PEAR::isError($result)) {
                    return $this->raiseError($result, null, null,
                        'on demand sequence '.$seq_name.' could not be created', __FUNCTION__);
                } else {
                    return $this->nextID($seq_name, false);
                }
            }
            return $result;
        }
        $value = $this->lastInsertID();
        if (is_numeric($value)) {
            $query = "DELETE FROM $sequence_name WHERE $seqcol_name < $value";
            $result =& $this->_doQuery($query, true);
            if (PEAR::isError($result)) {
                $this->warnings[] = 'nextID: could not delete previous sequence table values from '.$seq_name;
            }
        }
        return $value;
    }

    // }}}
    // {{{ lastInsertID()

    /**
     * Returns the autoincrement ID if supported or $id or fetches the current
     * ID in a sequence called: $table.(empty($field) ? '' : '_'.$field)
     *
     * @param string $table name of the table into which a new row was inserted
     * @param string $field name of the field into which a new row was inserted
     * @return mixed MDB2 Error Object or id
     * @access public
     */
    function lastInsertID($table = null, $field = null)
    {
        // not using mysql_insert_id() due to http://pear.php.net/bugs/bug.php?id=8051
        return $this->queryOne('SELECT LAST_INSERT_ID()', 'integer');
    }

    // }}}
    // {{{ currID()

    /**
     * Returns the current id of a sequence
     *
     * @param string $seq_name name of the sequence
     * @return mixed MDB2 Error Object or id
     * @access public
     */
    function currID($seq_name)
    {
        $sequence_name = $this->quoteIdentifier($this->getSequenceName($seq_name), true);
        $seqcol_name = $this->quoteIdentifier($this->options['seqcol_name'], true);
        $query = "SELECT MAX($seqcol_name) FROM $sequence_name";
        return $this->queryOne($query, 'integer');
    }
}

/**
 * MDB2 MySQLi result driver
 *
 * @package MDB2
 * @category Database
 * @author  Lukas Smith <smith@pooteeweet.org>
 */
class MDB2_Result_mysqli extends MDB2_Result_Common
{
    // }}}
    // {{{ fetchRow()

    /**
     * Fetch a row and insert the data into an existing array.
     *
     * @param int       $fetchmode  how the array data should be indexed
     * @param int    $rownum    number of the row where the data can be found
     * @return int data array on success, a MDB2 error on failure
     * @access public
     */
    function &fetchRow($fetchmode = MDB2_FETCHMODE_DEFAULT, $rownum = null)
    {
        if (!is_null($rownum)) {
            $seek = $this->seek($rownum);
            if (PEAR::isError($seek)) {
                return $seek;
            }
        }
        if ($fetchmode == MDB2_FETCHMODE_DEFAULT) {
            $fetchmode = $this->db->fetchmode;
        }
        if ($fetchmode & MDB2_FETCHMODE_ASSOC) {
            $row = @mysqli_fetch_assoc($this->result);
            if (is_array($row)
                && $this->db->options['portability'] & MDB2_PORTABILITY_FIX_CASE
            ) {
                $row = array_change_key_case($row, $this->db->options['field_case']);
            }
        } else {
           $row = @mysqli_fetch_row($this->result);
        }

        if (!$row) {
            if ($this->result === false) {
                $err =& $this->db->raiseError(MDB2_ERROR_NEED_MORE_DATA, null, null,
                    'resultset has already been freed', __FUNCTION__);
                return $err;
            }
            $null = null;
            return $null;
        }
        $mode = $this->db->options['portability'] & MDB2_PORTABILITY_EMPTY_TO_NULL;
        $rtrim = false;
        if ($this->db->options['portability'] & MDB2_PORTABILITY_RTRIM) {
            if (empty($this->types)) {
                $mode += MDB2_PORTABILITY_RTRIM;
            } else {
                $rtrim = true;
            }
        }
        if ($mode) {
            $this->db->_fixResultArrayValues($row, $mode);
        }
        if (!empty($this->types)) {
            $row = $this->db->datatype->convertResultRow($this->types, $row, $rtrim);
        }
        if (!empty($this->values)) {
            $this->_assignBindColumns($row);
        }
        if ($fetchmode === MDB2_FETCHMODE_OBJECT) {
            $object_class = $this->db->options['fetch_class'];
            if ($object_class == 'stdClass') {
                $row = (object) $row;
            } else {
                $row = &new $object_class($row);
            }
        }
        ++$this->rownum;
        return $row;
    }

    // }}}
    // {{{ _getColumnNames()

    /**
     * Retrieve the names of columns returned by the DBMS in a query result.
     *
     * @return  mixed   Array variable that holds the names of columns as keys
     *                  or an MDB2 error on failure.
     *                  Some DBMS may not return any columns when the result set
     *                  does not contain any rows.
     * @access private
     */
    function _getColumnNames()
    {
        $columns = array();
        $numcols = $this->numCols();
        if (PEAR::isError($numcols)) {
            return $numcols;
        }
        for ($column = 0; $column < $numcols; $column++) {
            $column_info = @mysqli_fetch_field_direct($this->result, $column);
            $columns[$column_info->name] = $column;
        }
        if ($this->db->options['portability'] & MDB2_PORTABILITY_FIX_CASE) {
            $columns = array_change_key_case($columns, $this->db->options['field_case']);
        }
        return $columns;
    }

    // }}}
    // {{{ numCols()

    /**
     * Count the number of columns returned by the DBMS in a query result.
     *
     * @return mixed integer value with the number of columns, a MDB2 error
     *                       on failure
     * @access public
     */
    function numCols()
    {
        $cols = @mysqli_num_fields($this->result);
        if (is_null($cols)) {
            if ($this->result === false) {
                return $this->db->raiseError(MDB2_ERROR_NEED_MORE_DATA, null, null,
                    'resultset has already been freed', __FUNCTION__);
            } elseif (is_null($this->result)) {
                return count($this->types);
            }
            return $this->db->raiseError(null, null, null,
                'Could not get column count', __FUNCTION__);
        }
        return $cols;
    }

    // }}}
    // {{{ nextResult()

    /**
     * Move the internal result pointer to the next available result
     *
     * @return true on success, false if there is no more result set or an error object on failure
     * @access public
     */
    function nextResult()
    {
        $connection = $this->db->getConnection();
        if (PEAR::isError($connection)) {
            return $connection;
        }

        if (!@mysqli_more_results($connection)) {
            return false;
        }
        if (!@mysqli_next_result($connection)) {
            return false;
        }
        if (!($this->result = @mysqli_use_result($connection))) {
            return false;
        }
        return MDB2_OK;
    }

    // }}}
    // {{{ free()

    /**
     * Free the internal resources associated with result.
     *
     * @return boolean true on success, false if result is invalid
     * @access public
     */
    function free()
    {
        if (is_object($this->result) && $this->db->connection) {
            $free = @mysqli_free_result($this->result);
            if ($free === false) {
                return $this->db->raiseError(null, null, null,
                    'Could not free result', __FUNCTION__);
            }
        }
        $this->result = false;
        return MDB2_OK;
    }
}

/**
 * MDB2 MySQLi buffered result driver
 *
 * @package MDB2
 * @category Database
 * @author  Lukas Smith <smith@pooteeweet.org>
 */
class MDB2_BufferedResult_mysqli extends MDB2_Result_mysqli
{
    // }}}
    // {{{ seek()

    /**
     * Seek to a specific row in a result set
     *
     * @param int    $rownum    number of the row where the data can be found
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function seek($rownum = 0)
    {
        if ($this->rownum != ($rownum - 1) && !@mysqli_data_seek($this->result, $rownum)) {
            if ($this->result === false) {
                return $this->db->raiseError(MDB2_ERROR_NEED_MORE_DATA, null, null,
                    'resultset has already been freed', __FUNCTION__);
            } elseif (is_null($this->result)) {
                return MDB2_OK;
            }
            return $this->db->raiseError(MDB2_ERROR_INVALID, null, null,
                'tried to seek to an invalid row number ('.$rownum.')', __FUNCTION__);
        }
        $this->rownum = $rownum - 1;
        return MDB2_OK;
    }

    // }}}
    // {{{ valid()

    /**
     * Check if the end of the result set has been reached
     *
     * @return mixed true or false on sucess, a MDB2 error on failure
     * @access public
     */
    function valid()
    {
        $numrows = $this->numRows();
        if (PEAR::isError($numrows)) {
            return $numrows;
        }
        return $this->rownum < ($numrows - 1);
    }

    // }}}
    // {{{ numRows()

    /**
     * Returns the number of rows in a result object
     *
     * @return mixed MDB2 Error Object or the number of rows
     * @access public
     */
    function numRows()
    {
        $rows = @mysqli_num_rows($this->result);
        if (is_null($rows)) {
            if ($this->result === false) {
                return $this->db->raiseError(MDB2_ERROR_NEED_MORE_DATA, null, null,
                    'resultset has already been freed', __FUNCTION__);
            } elseif (is_null($this->result)) {
                return 0;
            }
            return $this->db->raiseError(null, null, null,
                'Could not get row count', __FUNCTION__);
        }
        return $rows;
    }

    // }}}
    // {{{ nextResult()

    /**
     * Move the internal result pointer to the next available result
     *
     * @param a valid result resource
     * @return true on success, false if there is no more result set or an error object on failure
     * @access public
     */
    function nextResult()
    {
        $connection = $this->db->getConnection();
        if (PEAR::isError($connection)) {
            return $connection;
        }

        if (!@mysqli_more_results($connection)) {
            return false;
        }
        if (!@mysqli_next_result($connection)) {
            return false;
        }
        if (!($this->result = @mysqli_store_result($connection))) {
            return false;
        }
        return MDB2_OK;
    }
}

/**
 * MDB2 MySQLi statement driver
 *
 * @package MDB2
 * @category Database
 * @author  Lukas Smith <smith@pooteeweet.org>
 */
class MDB2_Statement_mysqli extends MDB2_Statement_Common
{
    // {{{ _execute()

    /**
     * Execute a prepared query statement helper method.
     *
     * @param mixed $result_class string which specifies which result class to use
     * @param mixed $result_wrap_class string which specifies which class to wrap results in
     * @return mixed a result handle or MDB2_OK on success, a MDB2 error on failure
     * @access private
     */
    function &_execute($result_class = true, $result_wrap_class = false)
    {
        if (is_null($this->statement)) {
            $result =& parent::_execute($result_class, $result_wrap_class);
            return $result;
        }
        $this->db->last_query = $this->query;
        $this->db->debug($this->query, 'execute', array('is_manip' => $this->is_manip, 'when' => 'pre', 'parameters' => $this->values));
        if ($this->db->getOption('disable_query')) {
            $result = $this->is_manip ? 0 : null;
            return $result;
        }

        $connection = $this->db->getConnection();
        if (PEAR::isError($connection)) {
            return $connection;
        }

        if (!is_object($this->statement)) {
            $query = 'EXECUTE '.$this->statement;
        }
        if (!empty($this->positions)) {
            $parameters = array(0 => $this->statement, 1 => '');
            $lobs = array();
            $i = 0;
            foreach ($this->positions as $parameter) {
                if (!array_key_exists($parameter, $this->values)) {
                    return $this->db->raiseError(MDB2_ERROR_NOT_FOUND, null, null,
                        'Unable to bind to missing placeholder: '.$parameter, __FUNCTION__);
                }
                $value = $this->values[$parameter];
                $type = array_key_exists($parameter, $this->types) ? $this->types[$parameter] : null;
                if (!is_object($this->statement)) {
                    if (is_resource($value) || $type == 'clob' || $type == 'blob' && $this->db->options['lob_allow_url_include']) {
                        if (!is_resource($value) && preg_match('/^(\w+:\/\/)(.*)$/', $value, $match)) {
                            if ($match[1] == 'file://') {
                                $value = $match[2];
                            }
                            $value = @fopen($value, 'r');
                            $close = true;
                        }
                        if (is_resource($value)) {
                            $data = '';
                            while (!@feof($value)) {
                                $data.= @fread($value, $this->db->options['lob_buffer_length']);
                            }
                            if ($close) {
                                @fclose($value);
                            }
                            $value = $data;
                        }
                    }
                    $quoted = $this->db->quote($value, $type);
                    if (PEAR::isError($quoted)) {
                        return $quoted;
                    }
                    $param_query = 'SET @'.$parameter.' = '.$quoted;
                    $result = $this->db->_doQuery($param_query, true, $connection);
                    if (PEAR::isError($result)) {
                        return $result;
                    }
                } else {
                    if (is_resource($value) || $type == 'clob' || $type == 'blob') {
                        $parameters[] = null;
                        $parameters[1].= 'b';
                        $lobs[$i] = $parameter;
                    } else {
                        $quoted = $this->db->quote($value, $type, false);
                        if (PEAR::isError($quoted)) {
                            return $quoted;
                        }
                        $parameters[] = $quoted;
                        $parameters[1].= $this->db->datatype->mapPrepareDatatype($type);
                    }
                    ++$i;
                }
            }

            if (!is_object($this->statement)) {
                $query.= ' USING @'.implode(', @', array_values($this->positions));
            } else {
                $result = @call_user_func_array('mysqli_stmt_bind_param', $parameters);
                if ($result === false) {
                    $err =& $this->db->raiseError(null, null, null,
                        'Unable to bind parameters', __FUNCTION__);
                    return $err;
                }

                foreach ($lobs as $i => $parameter) {
                    $value = $this->values[$parameter];
                    $close = false;
                    if (!is_resource($value)) {
                        $close = true;
                        if (preg_match('/^(\w+:\/\/)(.*)$/', $value, $match)) {
                            if ($match[1] == 'file://') {
                                $value = $match[2];
                            }
                            $value = @fopen($value, 'r');
                        } else {
                            $fp = @tmpfile();
                            @fwrite($fp, $value);
                            @rewind($fp);
                            $value = $fp;
                        }
                    }
                    while (!@feof($value)) {
                        $data = @fread($value, $this->db->options['lob_buffer_length']);
                        @mysqli_stmt_send_long_data($this->statement, $i, $data);
                    }
                    if ($close) {
                        @fclose($value);
                    }
                }
            }
        }

        if (!is_object($this->statement)) {
            $result = $this->db->_doQuery($query, $this->is_manip, $connection);
            if (PEAR::isError($result)) {
                return $result;
            }

            if ($this->is_manip) {
                $affected_rows = $this->db->_affectedRows($connection, $result);
                return $affected_rows;
            }

            $result =& $this->db->_wrapResult($result, $this->result_types,
                $result_class, $result_wrap_class, $this->limit, $this->offset);
        } else {
            if (!@mysqli_stmt_execute($this->statement)) {
                $err =& $this->db->raiseError(null, null, null,
                    'Unable to execute statement', __FUNCTION__);
                return $err;
            }

            if ($this->is_manip) {
                $affected_rows = @mysqli_stmt_affected_rows($this->statement);
                return $affected_rows;
            }

            if ($this->db->options['result_buffering']) {
                @mysqli_stmt_store_result($this->statement);
            }

            $result =& $this->db->_wrapResult($this->statement, $this->result_types,
                $result_class, $result_wrap_class, $this->limit, $this->offset);
        }

        $this->db->debug($this->query, 'execute', array('is_manip' => $this->is_manip, 'when' => 'post', 'result' => $result));
        return $result;
    }

    // }}}
    // {{{ free()

    /**
     * Release resources allocated for the specified prepared query.
     *
     * @return mixed MDB2_OK on success, a MDB2 error on failure
     * @access public
     */
    function free()
    {
        if (is_null($this->positions)) {
            return $this->db->raiseError(MDB2_ERROR, null, null,
                'Prepared statement has already been freed', __FUNCTION__);
        }
        $result = MDB2_OK;

        if (is_object($this->statement)) {
            if (!@mysqli_stmt_close($this->statement)) {
                $result = $this->db->raiseError(null, null, null,
                    'Could not free statement', __FUNCTION__);
            }
        } elseif (!is_null($this->statement)) {
            $connection = $this->db->getConnection();
            if (PEAR::isError($connection)) {
                return $connection;
            }

            $query = 'DEALLOCATE PREPARE '.$this->statement;
            $result = $this->db->_doQuery($query, true, $connection);
        }

        parent::free();
        return $result;
   }
}
?>

 program/lib/MDB2/Driver/pgsql.php

@@ -3,7 +3,7 @@
// +----------------------------------------------------------------------+

// | PHP versions 4 and 5                                                 |

// +----------------------------------------------------------------------+

// | Copyright (c) 1998-2006 Manuel Lemos, Tomas V.V.Cox,                 |

// | Copyright (c) 1998-2008 Manuel Lemos, Tomas V.V.Cox,                 |

// | Stig. S. Bakken, Lukas Smith                                         |

// | All rights reserved.                                                 |

// +----------------------------------------------------------------------+

@@ -43,7 +43,7 @@
// | Author: Paul Cooper <pgc@ucecom.com>                                 |

// +----------------------------------------------------------------------+

//

// $Id: pgsql.php,v 1.186 2007/11/10 13:27:03 quipo Exp $

// $Id: pgsql.php,v 1.197 2008/03/08 14:18:39 quipo Exp $



/**

 * MDB2 PostGreSQL driver

@@ -83,6 +83,7 @@
        $this->supported['LOBs'] = true;

        $this->supported['replace'] = 'emulated';

        $this->supported['sub_selects'] = true;

        $this->supported['triggers'] = true;

        $this->supported['auto_increment'] = 'emulated';

        $this->supported['primary_key'] = true;

        $this->supported['result_introspection'] = true;

@@ -91,8 +92,11 @@
        $this->supported['pattern_escaping'] = true;

        $this->supported['new_link'] = true;



        $this->options['DBA_username'] = false;

        $this->options['DBA_password'] = false;

        $this->options['multi_query'] = false;

        $this->options['disable_smart_seqname'] = false;

        $this->options['max_identifiers_length'] = 63;

    }



    // }}}

@@ -119,6 +123,8 @@
                $native_msg = 'Database connection has been lost.';

                $error_code = MDB2_ERROR_CONNECT_FAILED;

            }

        } else {

            $native_msg = @pg_last_error();

        }



        static $error_regexps;

@@ -128,8 +134,12 @@
                    => MDB2_ERROR_NOSUCHFIELD,

                '/(relation|sequence|table).*does not exist|class .* not found/i'

                    => MDB2_ERROR_NOSUCHTABLE,

                '/database .* does not exist/'

                    => MDB2_ERROR_NOT_FOUND,

                '/index .* does not exist/'

                    => MDB2_ERROR_NOT_FOUND,

                '/database .* already exists/i'

                    => MDB2_ERROR_ALREADY_EXISTS,

                '/relation .* already exists/i'

                    => MDB2_ERROR_ALREADY_EXISTS,

                '/(divide|division) by zero$/i'

@@ -202,7 +212,7 @@
        if (PEAR::isError($connection)) {

            return $connection;

        }

        if (version_compare(PHP_VERSION, '5.2.0RC5', '>=')) {

        if (is_resource($connection) && version_compare(PHP_VERSION, '5.2.0RC5', '>=')) {

            $text = @pg_escape_string($connection, $text);

        } else {

            $text = @pg_escape_string($text);

@@ -353,13 +363,18 @@
    // {{{ _doConnect()



    /**

     * Does the grunt work of connecting to the database

     * Do the grunt work of connecting to the database

     *

     * @return mixed connection resource on success, MDB2 Error Object on failure

     * @access protected

     **/

    function _doConnect($database_name, $persistent = false)

     */

    function _doConnect($username, $password, $database_name, $persistent = false)

    {

        if (!PEAR::loadExtension($this->phptype)) {

            return $this->raiseError(MDB2_ERROR_NOT_FOUND, null, null,

                'extension '.$this->phptype.' is not compiled into PHP', __FUNCTION__);

        }

        
        if ($database_name == '') {

            $database_name = 'template1';

        }

@@ -386,11 +401,11 @@
        if ($database_name) {

            $params[0].= ' dbname=\'' . addslashes($database_name) . '\'';

        }

        if ($this->dsn['username']) {

            $params[0].= ' user=\'' . addslashes($this->dsn['username']) . '\'';

        if ($username) {

            $params[0].= ' user=\'' . addslashes($username) . '\'';

        }

        if ($this->dsn['password']) {

            $params[0].= ' password=\'' . addslashes($this->dsn['password']) . '\'';

        if ($password) {

            $params[0].= ' password=\'' . addslashes($password) . '\'';

        }

        if (!empty($this->dsn['options'])) {

            $params[0].= ' options=' . $this->dsn['options'];

@@ -417,7 +432,6 @@
        }



        $connect_function = $persistent ? 'pg_pconnect' : 'pg_connect';



        $connection = @call_user_func_array($connect_function, $params);

        if (!$connection) {

            return $this->raiseError(MDB2_ERROR_CONNECT_FAILED, null, null,

@@ -449,7 +463,7 @@
     *

     * @return true on success, MDB2 Error Object on failure

     * @access public

     **/

     */

    function connect()

    {

        if (is_resource($this->connection)) {

@@ -463,22 +477,22 @@
            $this->disconnect(false);

        }



        if (!PEAR::loadExtension($this->phptype)) {

            return $this->raiseError(MDB2_ERROR_NOT_FOUND, null, null,

                'extension '.$this->phptype.' is not compiled into PHP', __FUNCTION__);

        }



        if ($this->database_name) {

            $connection = $this->_doConnect($this->database_name, $this->options['persistent']);

            $connection = $this->_doConnect($this->dsn['username'],

                                            $this->dsn['password'],

                                            $this->database_name,

                                            $this->options['persistent']);

            if (PEAR::isError($connection)) {

                return $connection;

            }



            $this->connection = $connection;

            $this->connected_dsn = $this->dsn;

            $this->connected_database_name = $this->database_name;

            $this->opened_persistent = $this->options['persistent'];

            $this->dbsyntax = $this->dsn['dbsyntax'] ? $this->dsn['dbsyntax'] : $this->phptype;

        }



        return MDB2_OK;

    }



@@ -501,13 +515,40 @@
                return $connection;

            }

        }



        if (is_array($charset)) {

            $charset   = array_shift($charset);

            $this->warnings[] = 'postgresql does not support setting client collation';

        }

        $result = @pg_set_client_encoding($connection, $charset);

        if ($result == -1) {

            return $this->raiseError(null, null, null,

                'Unable to set client charset: '.$charset, __FUNCTION__);

        }

        return MDB2_OK;

    }



    // }}}

    // {{{ databaseExists()



    /**

     * check if given database name is exists?

     *

     * @param string $name    name of the database that should be checked

     *

     * @return mixed true/false on success, a MDB2 error on failure

     * @access public

     */

    function databaseExists($name)

    {

        $res = $this->_doConnect($this->dsn['username'],

                                 $this->dsn['password'],

                                 $this->escape($name),

                                 $this->options['persistent']);

        if (!PEAR::isError($res)) {

            return true;

        }



        return false;

    }



    // }}}

@@ -560,11 +601,11 @@
     */

    function &standaloneQuery($query, $types = null, $is_manip = false)

    {

        $connection = $this->_doConnect('template1', false);

        $user = $this->options['DBA_username']? $this->options['DBA_username'] : $this->dsn['username'];

        $pass = $this->options['DBA_password']? $this->options['DBA_password'] : $this->dsn['password'];

        $connection = $this->_doConnect($user, $pass, $this->database_name, $this->options['persistent']);

        if (PEAR::isError($connection)) {

            $err =& $this->raiseError(MDB2_ERROR_CONNECT_FAILED, null, null,

                'Cannot connect to template1', __FUNCTION__);

            return $err;

            return $connection;

        }



        $offset = $this->offset;

@@ -572,17 +613,16 @@
        $this->offset = $this->limit = 0;

        $query = $this->_modifyQuery($query, $is_manip, $limit, $offset);



        $result =& $this->_doQuery($query, $is_manip, $connection, false);

        @pg_close($connection);

        if (PEAR::isError($result)) {

            return $result;

        $result =& $this->_doQuery($query, $is_manip, $connection, $this->database_name);

        if (!PEAR::isError($result)) {

            if ($is_manip) {

                $result =  $this->_affectedRows($connection, $result);

            } else {

                $result =& $this->_wrapResult($result, $types, true, false, $limit, $offset);

            }

        }



        if ($is_manip) {

            $affected_rows =  $this->_affectedRows($connection, $result);

            return $affected_rows;

        }

        $result =& $this->_wrapResult($result, $types, true, false, $limit, $offset);

        @pg_close($connection);

        return $result;

    }



@@ -910,8 +950,8 @@
            return $connection;

        }

        static $prep_statement_counter = 1;

        $statement_name = sprintf($this->options['statement_format'], $this->phptype, sha1(microtime() + mt_rand())) . $prep_statement_counter++;

        $statement_name = strtolower($statement_name);

        $statement_name = sprintf($this->options['statement_format'], $this->phptype, $prep_statement_counter++ . sha1(microtime() + mt_rand()));

        $statement_name = substr(strtolower($statement_name), 0, $this->options['max_identifiers_length']);

        if ($pgtypes === false) {

            $result = @pg_prepare($connection, $statement_name, $query);

            if (!$result) {

@@ -975,7 +1015,7 @@
                           WHERE d.adrelid = a.attrelid

                             AND d.adnum = a.attnum

                             AND a.atthasdef

                         ) FROM 'nextval[^\']*\'([^\']*)')

                         ) FROM 'nextval[^'']*''([^'']*)')

                        FROM pg_attribute a

                    LEFT JOIN pg_class c ON c.oid = a.attrelid

                    LEFT JOIN pg_attrdef d ON d.adrelid = a.attrelid AND d.adnum = a.attnum AND a.atthasdef

@@ -1017,9 +1057,11 @@
    {

        $sequence_name = $this->quoteIdentifier($this->getSequenceName($seq_name), true);

        $query = "SELECT NEXTVAL('$sequence_name')";

        $this->pushErrorHandling(PEAR_ERROR_RETURN);

        $this->expectError(MDB2_ERROR_NOSUCHTABLE);

        $result = $this->queryOne($query, 'integer');

        $this->popExpect();

        $this->popErrorHandling();

        if (PEAR::isError($result)) {

            if ($ondemand && $result->getCode() == MDB2_ERROR_NOSUCHTABLE) {

                $this->loadModule('Manager', null, true);

@@ -1052,7 +1094,7 @@
            return $this->queryOne('SELECT lastval()', 'integer');

        }

        $seq = $table.(empty($field) ? '' : '_'.$field);

        $sequence_name = $this->getSequenceName($seq);

        $sequence_name = $this->quoteIdentifier($this->getSequenceName($seq), true);

        return $this->queryOne("SELECT currval('$sequence_name')", 'integer');

    }




Diff truncated after the above file
program/lib/MDB2/Driver/sqlite.php