- fixed #1485032 and updated MDB2 package+drivers

28 files changed, 10700 insertions, 8715 deletions

diff --git a/program/lib/MDB2.php b/program/lib/MDB2.php
index a8bbb0fb4..326152f95 100644
--- a/program/lib/MDB2.php
+++ b/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',            -32);
 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 @@ class MDB2
      */

     function apiVersion()

     {

-        return '2.5.0a2';

+        return '2.5.0b1';

     }

 

     // }}}

@@ -764,6 +766,7 @@ class MDB2
                 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 @@ class MDB2
                 //"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 @@ class MDB2_Driver_Common extends PEAR
         'LOBs' => false,

         'replace' => false,

         'sub_selects' => false,

+        'triggers' => false,

         'auto_increment' => false,

         'primary_key' => false,

         'result_introspection' => false,

@@ -1142,6 +1146,7 @@ class MDB2_Driver_Common extends PEAR
      *  <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 @@ class MDB2_Driver_Common extends PEAR
         '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 @@ class MDB2_Driver_Common extends PEAR
     }

 

     // }}}

+    // {{{ 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 @@ class MDB2_Driver_Common extends PEAR
     {

         $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 @@ class MDB2_Driver_Common extends PEAR
                     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 @@ class MDB2_Driver_Common extends PEAR
         }

 

         $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 @@ class MDB2_Driver_Common extends PEAR
                                 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 @@ class MDB2_Statement_Common
         $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)

diff --git a/program/lib/MDB2/Driver/Datatype/Common.php b/program/lib/MDB2/Driver/Datatype/Common.php
index 01423e44c..2134e64db 100644
--- a/program/lib/MDB2/Driver/Datatype/Common.php
+++ b/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;
+    }
+}
 ?>
\ No newline at end of file
diff --git a/program/lib/MDB2/Driver/Datatype/mssql.php b/program/lib/MDB2/Driver/Datatype/mssql.php
index 4bdad8c57..fff343c73 100644
--- a/program/lib/MDB2/Driver/Datatype/mssql.php
+++ b/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);
+    }
+    // }}}
+}
+
 ?>
\ No newline at end of file
diff --git a/program/lib/MDB2/Driver/Datatype/mysql.php b/program/lib/MDB2/Driver/Datatype/mysql.php
index 388d0b2b4..f54dd0a9c 100644
--- a/program/lib/MDB2/Driver/Datatype/mysql.php
+++ b/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 @@ class MDB2_Driver_Datatype_mysql extends MDB2_Driver_Datatype_Common
                 $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 @@ class MDB2_Driver_Datatype_mysql extends MDB2_Driver_Datatype_Common
         $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;

     }

 

     // }}}

diff --git a/program/lib/MDB2/Driver/Datatype/mysqli.php b/program/lib/MDB2/Driver/Datatype/mysqli.php
index 40f70f24a..deba9194e 100644
--- a/program/lib/MDB2/Driver/Datatype/mysqli.php
+++ b/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 @@ class MDB2_Driver_Datatype_mysqli extends MDB2_Driver_Datatype_Common
                 $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 @@ class MDB2_Driver_Datatype_mysqli extends MDB2_Driver_Datatype_Common
         $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;

     }

 

     // }}}

@@ -356,7 +443,6 @@ class MDB2_Driver_Datatype_mysqli extends MDB2_Driver_Datatype_Common
         case 'mediumtext':

         case 'longtext':

         case 'text':

-        case 'text':

         case 'varchar':

             $fixed = false;

         case 'string':

diff --git a/program/lib/MDB2/Driver/Datatype/pgsql.php b/program/lib/MDB2/Driver/Datatype/pgsql.php
index 8a7e3ff33..c31c7d83a 100644
--- a/program/lib/MDB2/Driver/Datatype/pgsql.php
+++ b/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 @@ class MDB2_Driver_Datatype_pgsql extends MDB2_Driver_Datatype_Common
                 $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 @@ class MDB2_Driver_Datatype_pgsql extends MDB2_Driver_Datatype_Common
             break;

         case 'datetime':

         case 'timestamp':

+        case 'timestamptz':

             $type[] = 'timestamp';

             $length = null;

             break;

@@ -461,6 +460,7 @@ class MDB2_Driver_Datatype_pgsql extends MDB2_Driver_Datatype_Common
             $length = null;

             break;

         case 'float':

+        case 'float4':

         case 'float8':

         case 'double':

         case 'real':

diff --git a/program/lib/MDB2/Driver/Datatype/sqlite.php b/program/lib/MDB2/Driver/Datatype/sqlite.php
index e518e45fa..0310cc77d 100644
--- a/program/lib/MDB2/Driver/Datatype/sqlite.php
+++ b/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 @@ class MDB2_Driver_Datatype_sqlite extends MDB2_Driver_Datatype_Common
                 $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 @@ class MDB2_Driver_Datatype_sqlite extends MDB2_Driver_Datatype_Common
             if (PEAR::isError($db)) {

                 return $db;

             }

-

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

                 'unknown database attribute type: '.$db_type, __FUNCTION__);

         }

diff --git a/program/lib/MDB2/Driver/Function/Common.php b/program/lib/MDB2/Driver/Function/Common.php
index 74971e2bb..d361b5586 100644
--- a/program/lib/MDB2/Driver/Function/Common.php
+++ b/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;

+    }

+

+    // }}}

+}

 ?>
\ No newline at end of file
diff --git a/program/lib/MDB2/Driver/Function/mssql.php b/program/lib/MDB2/Driver/Function/mssql.php
index 4ee028169..1038901b6 100644
--- a/program/lib/MDB2/Driver/Function/mssql.php
+++ b/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()';

+    }

+

+    // }}}

+}

+// }}}

 ?>
\ No newline at end of file
diff --git a/program/lib/MDB2/Driver/Function/mysql.php b/program/lib/MDB2/Driver/Function/mysql.php
index 90dea8174..d8ae7bbf6 100644
--- a/program/lib/MDB2/Driver/Function/mysql.php
+++ b/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()';

+    }

+

+    // }}}

+}

 ?>
\ No newline at end of file
diff --git a/program/lib/MDB2/Driver/Function/mysqli.php b/program/lib/MDB2/Driver/Function/mysqli.php
index 5af55c1fd..c1fe5d60b 100644
--- a/program/lib/MDB2/Driver/Function/mysqli.php
+++ b/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()';

+    }

+

+    // }}}

+}

 ?>
\ No newline at end of file
diff --git a/program/lib/MDB2/Driver/Function/pgsql.php b/program/lib/MDB2/Driver/Function/pgsql.php
index df1d455f3..8b23ec659 100644
--- a/program/lib/MDB2/Driver/Function/pgsql.php
+++ b/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()';

+    }

+

+    // }}}

+}

+?>
\ No newline at end of file
diff --git a/program/lib/MDB2/Driver/Function/sqlite.php b/program/lib/MDB2/Driver/Function/sqlite.php
index 3a4960bea..2761059d0 100644
--- a/program/lib/MDB2/Driver/Function/sqlite.php
+++ b/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;

+    }

+

+    // }}}

+}

+?>

diff --git a/program/lib/MDB2/Driver/Manager/Common.php b/program/lib/MDB2/Driver/Manager/Common.php
index da2e329ef..672f577ee 100644
--- a/program/lib/MDB2/Driver/Manager/Common.php
+++ b/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>

  */

 

 /**

@@ -199,6 +201,29 @@ class MDB2_Driver_Manager_Common extends MDB2_Module_Common
     }

 

     // }}}

+    // {{{ 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)) {

+            return $db;

+        }

+

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

+            'method not implemented', __FUNCTION__);

+    }

+

+    // }}}

     // {{{ dropDatabase()

 

     /**

@@ -360,6 +385,56 @@ class MDB2_Driver_Manager_Common extends MDB2_Module_Common
     }

 

     // }}}

+    // {{{ 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()

 

     /**

diff --git a/program/lib/MDB2/Driver/Manager/mssql.php b/program/lib/MDB2/Driver/Manager/mssql.php
index 9cc66f3b7..fc260f8e6 100644
--- a/program/lib/MDB2/Driver/Manager/mssql.php
+++ b/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;
+    }
+
+    // }}}
+}
+
+// }}}
 ?>
\ No newline at end of file
diff --git a/program/lib/MDB2/Driver/Manager/mysql.php b/program/lib/MDB2/Driver/Manager/mysql.php
index 84109be27..a055d8d01 100644
--- a/program/lib/MDB2/Driver/Manager/mysql.php
+++ b/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 @@ class MDB2_Driver_Manager_mysql extends MDB2_Driver_Manager_Common
         $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 @@ class MDB2_Driver_Manager_mysql extends MDB2_Driver_Manager_Common
 

         $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,11 +209,37 @@ class MDB2_Driver_Manager_mysql extends MDB2_Driver_Manager_Common
             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();

 

         if (!empty($options['comment'])) {

@@ -227,6 +274,112 @@ class MDB2_Driver_Manager_mysql extends MDB2_Driver_Manager_Common
     }

 

     // }}}

+    // {{{ 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;

+    }

+

+    // }}}

     // {{{ alterTable()

 

     /**

@@ -629,33 +782,34 @@ class MDB2_Driver_Manager_mysql extends MDB2_Driver_Manager_Common
      * 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 @@ class MDB2_Driver_Manager_mysql extends MDB2_Driver_Manager_Common
                 '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 @@ class MDB2_Driver_Manager_mysql extends MDB2_Driver_Manager_Common
             $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,17 +1002,211 @@ class MDB2_Driver_Manager_mysql extends MDB2_Driver_Manager_Common
             return $db;

         }

 

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

         if ($primary || strtolower($name) == 'primary') {

-            $query = "ALTER TABLE $table DROP PRIMARY KEY";

-        } else {

+            $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 INDEX $name";

+            $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;

+    }

+

+    // }}}

     // {{{ listTableConstraints()

 

     /**

@@ -904,8 +1259,8 @@ class MDB2_Driver_Manager_mysql extends MDB2_Driver_Manager_Common
         $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 @@ class MDB2_Driver_Manager_mysql extends MDB2_Driver_Manager_Common
             $query .= ' '.implode(' ', $options_strings);

         }

         $res = $db->exec($query);

-

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

             return $res;

         }

diff --git a/program/lib/MDB2/Driver/Manager/mysqli.php b/program/lib/MDB2/Driver/Manager/mysqli.php
index 42782fca5..db4f875dd 100644
--- a/program/lib/MDB2/Driver/Manager/mysqli.php
+++ b/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 @@ class MDB2_Driver_Manager_mysqli extends MDB2_Driver_Manager_Common
         $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 @@ class MDB2_Driver_Manager_mysqli extends MDB2_Driver_Manager_Common
 

         $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,11 +209,37 @@ class MDB2_Driver_Manager_mysqli extends MDB2_Driver_Manager_Common
             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();

 

         if (!empty($options['comment'])) {

@@ -227,6 +274,112 @@ class MDB2_Driver_Manager_mysqli extends MDB2_Driver_Manager_Common
     }

 

     // }}}

+    // {{{ 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;

+    }

+

+    // }}}

     // {{{ alterTable()

 

     /**

@@ -656,6 +809,7 @@ class MDB2_Driver_Manager_mysqli extends MDB2_Driver_Manager_Common
      *                                            'last_login' => array()

      *                                        )

      *                                    )

+     *

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

      * @access public

      */

@@ -800,10 +954,10 @@ class MDB2_Driver_Manager_mysqli extends MDB2_Driver_Manager_Common
                 '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 @@ class MDB2_Driver_Manager_mysqli extends MDB2_Driver_Manager_Common
             $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,18 +1001,212 @@ class MDB2_Driver_Manager_mysqli extends MDB2_Driver_Manager_Common
         if (PEAR::isError($db)) {

             return $db;

         }

-

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

+        

         if ($primary || strtolower($name) == 'primary') {

-            $query = "ALTER TABLE $table DROP PRIMARY KEY";

-        } else {

+            $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 INDEX $name";

+            $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;

+    }

+

+    // }}}

     // {{{ listTableConstraints()

 

     /**

@@ -904,8 +1259,8 @@ class MDB2_Driver_Manager_mysqli extends MDB2_Driver_Manager_Common
         $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;

                 }

@@ -969,10 +1324,6 @@ class MDB2_Driver_Manager_mysqli extends MDB2_Driver_Manager_Common
             $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))";

         if (!empty($options_strings)) {

             $query .= ' '.implode(' ', $options_strings);

diff --git a/program/lib/MDB2/Driver/Manager/pgsql.php b/program/lib/MDB2/Driver/Manager/pgsql.php
index d5ebbc840..1015c2bef 100644
--- a/program/lib/MDB2/Driver/Manager/pgsql.php
+++ b/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;
+    }
+}
 ?>
\ No newline at end of file
diff --git a/program/lib/MDB2/Driver/Manager/sqlite.php b/program/lib/MDB2/Driver/Manager/sqlite.php
index f126ff146..676127c94 100644
--- a/program/lib/MDB2/Driver/Manager/sqlite.php
+++ b/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';

@@ -404,6 +404,37 @@ class MDB2_Driver_Manager_sqlite extends MDB2_Driver_Manager_Common
     }

 

     // }}}

+    // {{{ 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);

+    }

+

+    // }}}

     // {{{ alterTable()

 

     /**

@@ -1207,7 +1238,7 @@ class MDB2_Driver_Manager_sqlite extends MDB2_Driver_Manager_Common
         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;

         }

 

diff --git a/program/lib/MDB2/Driver/Reverse/Common.php b/program/lib/MDB2/Driver/Reverse/Common.php
index 43a2f251b..18e9da931 100644
--- a/program/lib/MDB2/Driver/Reverse/Common.php
+++ b/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;

+    }

+}

 ?>
\ No newline at end of file
diff --git a/program/lib/MDB2/Driver/Reverse/mssql.php b/program/lib/MDB2/Driver/Reverse/mssql.php
index a27c95d57..0991190c4 100644
--- a/program/lib/MDB2/Driver/Reverse/mssql.php
+++ b/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 @@ class MDB2_Driver_Reverse_mssql extends MDB2_Driver_Reverse_Common
         }

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

     }

diff --git a/program/lib/MDB2/Driver/Reverse/pgsql.php b/program/lib/MDB2/Driver/Reverse/pgsql.php
index 930eea93f..7d5c9f134 100644
--- a/program/lib/MDB2/Driver/Reverse/pgsql.php
+++ b/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 @@ class MDB2_Driver_Reverse_pgsql extends MDB2_Driver_Reverse_Common
             $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 @@ class MDB2_Driver_Reverse_pgsql extends MDB2_Driver_Reverse_Common
                             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,

diff --git a/program/lib/MDB2/Driver/Reverse/sqlite.php b/program/lib/MDB2/Driver/Reverse/sqlite.php
index 2ba81c7c5..abd9cbcfb 100644
--- a/program/lib/MDB2/Driver/Reverse/sqlite.php
+++ b/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 @@ class MDB2_Driver_Reverse_sqlite extends MDB2_Driver_Reverse_Common
                     }

                     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+

diff --git a/program/lib/MDB2/Driver/mssql.php b/program/lib/MDB2/Driver/mssql.php
index f74acfea4..a16e33cbe 100644
--- a/program/lib/MDB2/Driver/mssql.php
+++ b/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 @@ class MDB2_Driver_mssql extends MDB2_Driver_Common
         $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 @@ class MDB2_Driver_mssql extends MDB2_Driver_Common
         $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 @@ class MDB2_Driver_mssql extends MDB2_Driver_Common
      * @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 @@ class MDB2_Driver_mssql extends MDB2_Driver_Common
                     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,39 +306,30 @@ class MDB2_Driver_mssql extends MDB2_Driver_Common
     }

 

     // }}}

-    // {{{ connect()

+    // {{{ _doConnect()

 

     /**

-     * Connect to the database

+     * do the grunt work of the connect

      *

-     * @return true on success, MDB2 Error Object on failure

+     * @return connection on success or MDB2 Error Object on failure

+     * @access protected

      */

-    function connect()

+    function _doConnect($username, $password, $persistent = false)

     {

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

-        }

-

-        if (!PEAR::loadExtension($this->phptype)) {

+        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',

-            $this->dsn['username'] ? $this->dsn['username'] : null,

-            $this->dsn['password'] ? $this->dsn['password'] : null,

+            $username ? $username : null,

+            $password ? $password : null,

         );

         if ($this->dsn['port']) {

             $params[0].= ((substr(PHP_OS, 0, 3) == 'WIN') ? ',' : ':').$this->dsn['port'];

         }

-        if (!$this->options['persistent']) {

+        if (!$persistent) {

             if (isset($this->dsn['new_link'])

                 && ($this->dsn['new_link'] == 'true' || $this->dsn['new_link'] === true)

             ) {

@@ -338,7 +339,7 @@ class MDB2_Driver_mssql extends MDB2_Driver_Common
             }

         }

 

-        $connect_function = $this->options['persistent'] ? 'mssql_pconnect' : 'mssql_connect';

+        $connect_function = $persistent ? 'mssql_pconnect' : 'mssql_connect';

 

         $connection = @call_user_func_array($connect_function, $params);

         if ($connection <= 0) {

@@ -346,6 +347,8 @@ class MDB2_Driver_mssql extends MDB2_Driver_Common
                 '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)) {

@@ -361,6 +364,38 @@ class MDB2_Driver_mssql extends MDB2_Driver_Common
            @mssql_query('SET DATEFORMAT ymd', $connection);

        }

 

+       return $connection;

+    }

+

+    // }}}

+    // {{{ 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']

+            ) {

+                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 = '';

@@ -382,6 +417,41 @@ class MDB2_Driver_mssql extends MDB2_Driver_Common
     }

 

     // }}}

+    // {{{ 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;

+    }

+

+    // }}}

     // {{{ disconnect()

 

     /**

@@ -417,6 +487,42 @@ class MDB2_Driver_mssql extends MDB2_Driver_Common
     }

 

     // }}}

+    // {{{ 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;

+    }

+

+    // }}}

     // {{{ _doQuery()

 

     /**

@@ -546,7 +652,7 @@ class MDB2_Driver_mssql extends MDB2_Driver_Common
         // 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 @@ class MDB2_Driver_mssql extends MDB2_Driver_Common
     {

         $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 @@ class MDB2_Driver_mssql extends MDB2_Driver_Common
         }

         $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 @@ class MDB2_Driver_mssql extends MDB2_Driver_Common
      *

      * @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 @@ class MDB2_Driver_mssql extends MDB2_Driver_Common
         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');

diff --git a/program/lib/MDB2/Driver/mysql.php b/program/lib/MDB2/Driver/mysql.php
index 1e0453936..96210e43b 100644
--- a/program/lib/MDB2/Driver/mysql.php
+++ b/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;
+    }
+}
 ?>
\ No newline at end of file
diff --git a/program/lib/MDB2/Driver/mysqli.php b/program/lib/MDB2/Driver/mysqli.php
index 5dc53d624..3f8f9611e 100644
--- a/program/lib/MDB2/Driver/mysqli.php
+++ b/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;
+   }
+}
 ?>
\ No newline at end of file
diff --git a/program/lib/MDB2/Driver/pgsql.php b/program/lib/MDB2/Driver/pgsql.php
index 49ab1218a..24af05655 100644
--- a/program/lib/MDB2/Driver/pgsql.php
+++ b/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 @@ class MDB2_Driver_pgsql extends MDB2_Driver_Common
         $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 @@ class MDB2_Driver_pgsql extends MDB2_Driver_Common
         $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 @@ class MDB2_Driver_pgsql extends MDB2_Driver_Common
                 $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 @@ class MDB2_Driver_pgsql extends MDB2_Driver_Common
                     => 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 @@ class MDB2_Driver_pgsql extends MDB2_Driver_Common
         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 @@ class MDB2_Driver_pgsql extends MDB2_Driver_Common
     // {{{ _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 @@ class MDB2_Driver_pgsql extends MDB2_Driver_Common
         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 @@ class MDB2_Driver_pgsql extends MDB2_Driver_Common
         }

 

         $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 @@ class MDB2_Driver_pgsql extends MDB2_Driver_Common
      *

      * @return true on success, MDB2 Error Object on failure

      * @access public

-     **/

+     */

     function connect()

     {

         if (is_resource($this->connection)) {

@@ -463,22 +477,22 @@ class MDB2_Driver_pgsql extends MDB2_Driver_Common
             $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,7 +515,10 @@ class MDB2_Driver_pgsql extends MDB2_Driver_Common
                 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,

@@ -511,6 +528,30 @@ class MDB2_Driver_pgsql extends MDB2_Driver_Common
     }

 

     // }}}

+    // {{{ 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;

+    }

+

+    // }}}

     // {{{ disconnect()

 

     /**

@@ -560,11 +601,11 @@ class MDB2_Driver_pgsql extends MDB2_Driver_Common
      */

     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 @@ class MDB2_Driver_pgsql extends MDB2_Driver_Common
         $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 @@ class MDB2_Driver_pgsql extends MDB2_Driver_Common
             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 @@ class MDB2_Driver_pgsql extends MDB2_Driver_Common
                     	   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 @@ class MDB2_Driver_pgsql extends MDB2_Driver_Common
     {

         $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 @@ class MDB2_Driver_pgsql extends MDB2_Driver_Common
             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 --git a/program/lib/MDB2/Driver/sqlite.php b/program/lib/MDB2/Driver/sqlite.php
index d61255347..e48bac329 100644
--- a/program/lib/MDB2/Driver/sqlite.php
+++ b/program/lib/MDB2/Driver/sqlite.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: sqlite.php,v 1.152 2007/11/27 07:44:41 quipo Exp $

+// $Id: sqlite.php,v 1.158 2008/03/08 14:18:39 quipo Exp $

 //

 

 /**

@@ -89,6 +89,7 @@ class MDB2_Driver_sqlite extends MDB2_Driver_Common
         $this->supported['transactions'] = true;

         $this->supported['savepoints'] = false;

         $this->supported['sub_selects'] = true;

+        $this->supported['triggers'] = true;

         $this->supported['auto_increment'] = true;

         $this->supported['primary_key'] = false; // requires alter table implementation

         $this->supported['result_introspection'] = false; // not implemented

@@ -97,11 +98,14 @@ class MDB2_Driver_sqlite extends MDB2_Driver_Common
         $this->supported['pattern_escaping'] = false;

         $this->supported['new_link'] = false;

 

+        $this->options['DBA_username'] = false;

+        $this->options['DBA_password'] = false;

         $this->options['base_transaction_name'] = '___php_MDB2_sqlite_auto_commit_off';

         $this->options['fixed_float'] = 0;

         $this->options['database_path'] = '';

         $this->options['database_extension'] = '';

         $this->options['server_version'] = '';

+        $this->options['max_identifiers_length'] = 128; //no real limit

     }

 

     // }}}

@@ -125,7 +129,7 @@ class MDB2_Driver_sqlite extends MDB2_Driver_Common
             

         // PHP 5.2+ prepends the function name to $php_errormsg, so we need

         // this hack to work around it, per bug #9599.

-        $native_msg = preg_replace('/^sqlite[a-z_]+\(\): /', '', $native_msg);

+        $native_msg = preg_replace('/^sqlite[a-z_]+\(\)[^:]*: /', '', $native_msg);

 

         if (is_null($error)) {

             static $error_regexps;

@@ -425,6 +429,24 @@ class MDB2_Driver_sqlite extends MDB2_Driver_Common
     }

 

     // }}}

+    // {{{ 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)

+    {

+        $database_file = $this->_getDatabaseFile($name);

+        $result = file_exists($database_file);

+        return $result;

+    }

+

+    // }}}

     // {{{ disconnect()

 

     /**

@@ -721,7 +743,7 @@ class MDB2_Driver_sqlite extends MDB2_Driver_Common
                 $query .= ',';

                 $values.= ',';

             }

-            $query.= $name;

+            $query.= $this->quoteIdentifier($name, true);

             if (isset($fields[$name]['null']) && $fields[$name]['null']) {

                 $value = 'NULL';

             } else {

@@ -750,6 +772,7 @@ class MDB2_Driver_sqlite extends MDB2_Driver_Common
             return $connection;

         }

 

+        $table = $this->quoteIdentifier($table, true);

         $query = "REPLACE INTO $table ($query) VALUES ($values)";

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

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

@@ -777,9 +800,11 @@ class MDB2_Driver_sqlite extends MDB2_Driver_Common
         $sequence_name = $this->quoteIdentifier($this->getSequenceName($seq_name), true);

         $seqcol_name = $this->options['seqcol_name'];

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