- Add support for MDB2's 'sqlsrv' driver (#1486395)

1 files changed, 516 insertions, 512 deletions

diff --git a/program/lib/MDB2/Driver/Reverse/Common.php b/program/lib/MDB2/Driver/Reverse/Common.php
index 18e9da931..5d9f27ccb 100644
--- a/program/lib/MDB2/Driver/Reverse/Common.php
+++ b/program/lib/MDB2/Driver/Reverse/Common.php
@@ -1,513 +1,517 @@
-<?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;

-    }

-}

+<?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 273526 2009-01-14 15:01:21Z quipo $
+//
+
+/**
+ * @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
+     *
+     * @param string $table [schema and] table name
+     *
+     * @return array array(schema, table)
+     * @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