released 2.0.3

Implemented getForeignKeys() for PostgreSQL driver

.gitignore

@@ -0,0 +1,2 @@
+/vendor
+/composer.lock

composer.json

@@ -0,0 +1,16 @@
+{
+	"name": "dibi/dibi",
+	"description": "Dibi is Database Abstraction Library for PHP 5.",
+	"keywords": ["database", "dbal", "mysql", "postgresql", "sqlite", "mssql", "oracle", "access", "pdo", "odbc"],
+	"homepage": "http://dibiphp.com/",
+	"license": ["BSD-3", "GPLv2", "GPLv3"],
+	"authors": [
+		{
+			"name": "David Grudl",
+			"homepage": "http://davidgrudl.com"
+		}
+	],
+	"autoload": {
+		"classmap": ["dibi/"]
+	}
+}

dibi/Nette/DibiNetteExtension.php

@@ -0,0 +1,56 @@
+<?php
+
+/**
+ * This file is part of the "dibi" - smart database abstraction layer.
+ *
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
+ */
+
+
+
+/**
+ * Dibi extension for Nette Framework. Creates 'connection' service.
+ *
+ * @author     David Grudl
+ * @package    dibi\nette
+ * @phpversion 5.3
+ */
+class DibiNetteExtension extends Nette\Config\CompilerExtension
+{
+
+	public function loadConfiguration()
+	{
+		$container = $this->getContainerBuilder();
+		$config = $this->getConfig();
+
+		$useProfiler = isset($config['profiler'])
+			? $config['profiler']
+			: !$container->parameters['productionMode'];
+
+		unset($config['profiler']);
+
+		if (isset($config['flags'])) {
+			$flags = 0;
+			foreach ((array) $config['flags'] as $flag) {
+				$flags |= constant($flag);
+			}
+			$config['flags'] = $flags;
+		}
+
+		$connection = $container->addDefinition($this->prefix('connection'))
+			->setClass('DibiConnection', array($config));
+
+		if ($useProfiler) {
+			$panel = $container->addDefinition($this->prefix('panel'))
+				->setClass('DibiNettePanel')
+				->addSetup('Nette\Diagnostics\Debugger::$bar->addPanel(?)', array('@self'))
+				->addSetup('Nette\Diagnostics\Debugger::$blueScreen->addPanel(?)', array(array('@self', 'renderException')));
+
+			$connection->addSetup('$service->onEvent[] = ?', array(array($panel, 'logEvent')));
+		}
+	}
+
+}

dibi/Nette/DibiNettePanel.php

@@ -0,0 +1,171 @@
+<?php
+
+/**
+ * This file is part of the "dibi" - smart database abstraction layer.
+ *
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
+ */
+
+
+
+if (interface_exists('Nette\Diagnostics\IBarPanel')) {
+	class_alias('Nette\Diagnostics\IBarPanel', 'IBarPanel');
+}
+
+
+
+/**
+ * Dibi panel for Nette\Diagnostics.
+ *
+ * @author     David Grudl
+ * @package    dibi\nette
+ */
+class DibiNettePanel extends DibiObject implements IBarPanel
+{
+	/** @var int maximum SQL length */
+	static public $maxLength = 1000;
+
+	/** @var bool  explain queries? */
+	public $explain;
+
+	/** @var int */
+	public $filter;
+
+	/** @var array */
+	private $events = array();
+
+
+
+	public function __construct($explain = TRUE, $filter = NULL)
+	{
+		$this->filter = $filter ? (int) $filter : DibiEvent::QUERY;
+		$this->explain = $explain;
+	}
+
+
+
+	public function register(DibiConnection $connection)
+	{
+		if (is_callable('Nette\Diagnostics\Debugger::enable') && !class_exists('NDebugger')) {
+			class_alias('Nette\Diagnostics\Debugger', 'NDebugger'); // PHP 5.2 code compatibility
+		}
+		if (is_callable('NDebugger::enable')) {
+			NDebugger::$bar && NDebugger::$bar->addPanel($this);
+			NDebugger::$blueScreen && NDebugger::$blueScreen->addPanel(array($this, 'renderException'), __CLASS__);
+			$connection->onEvent[] = array($this, 'logEvent');
+		} elseif (is_callable('Debugger::enable')) {
+			Debugger::$bar && Debugger::$bar->addPanel($this);
+			Debugger::$blueScreen && Debugger::$blueScreen->addPanel(array($this, 'renderException'), __CLASS__);
+			$connection->onEvent[] = array($this, 'logEvent');
+		}
+	}
+
+
+
+	/**
+	 * After event notification.
+	 * @return void
+	 */
+	public function logEvent(DibiEvent $event)
+	{
+		if (($event->type & $this->filter) === 0) {
+			return;
+		}
+		$this->events[] = $event;
+	}
+
+
+
+	/**
+	 * Returns blue-screen custom tab.
+	 * @return mixed
+	 */
+	public function renderException($e)
+	{
+		if ($e instanceof DibiException && $e->getSql()) {
+			return array(
+				'tab' => 'SQL',
+				'panel' => dibi::dump($e->getSql(), TRUE),
+			);
+		}
+	}
+
+
+
+	/**
+	 * Returns HTML code for custom tab. (Nette\Diagnostics\IBarPanel)
+	 * @return mixed
+	 */
+	public function getTab()
+	{
+		$totalTime = 0;
+		foreach ($this->events as $event) {
+			$totalTime += $event->time;
+		}
+		return '<span title="dibi"><img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAQAAAC1+jfqAAAABGdBTUEAAK/INwWK6QAAABl0RVh0U29mdHdhcmUAQWRvYmUgSW1hZ2VSZWFkeXHJZTwAAAEYSURBVBgZBcHPio5hGAfg6/2+R980k6wmJgsJ5U/ZOAqbSc2GnXOwUg7BESgLUeIQ1GSjLFnMwsKGGg1qxJRmPM97/1zXFAAAAEADdlfZzr26miup2svnelq7d2aYgt3rebl585wN6+K3I1/9fJe7O/uIePP2SypJkiRJ0vMhr55FLCA3zgIAOK9uQ4MS361ZOSX+OrTvkgINSjS/HIvhjxNNFGgQsbSmabohKDNoUGLohsls6BaiQIMSs2FYmnXdUsygQYmumy3Nhi6igwalDEOJEjPKP7CA2aFNK8Bkyy3fdNCg7r9/fW3jgpVJbDmy5+PB2IYp4MXFelQ7izPrhkPHB+P5/PjhD5gCgCenx+VR/dODEwD+A3T7nqbxwf1HAAAAAElFTkSuQmCC" />'
+			. count($this->events) . ' queries'
+			. ($totalTime ? ' / ' . sprintf('%0.1f', $totalTime * 1000) . 'ms' : '')
+			. '</span>';
+	}
+
+
+
+	/**
+	 * Returns HTML code for custom panel. (Nette\Diagnostics\IBarPanel)
+	 * @return mixed
+	 */
+	public function getPanel()
+	{
+		$totalTime = $s = NULL;
+		$h = 'htmlSpecialChars';
+		foreach ($this->events as $event) {
+			$totalTime += $event->time;
+			$explain = NULL; // EXPLAIN is called here to work SELECT FOUND_ROWS()
+			if ($this->explain && $event->type === DibiEvent::SELECT) {
+				try {
+					$backup = array($event->connection->onEvent, dibi::$numOfQueries, dibi::$totalTime);
+					$event->connection->onEvent = NULL;
+					$cmd = is_string($this->explain) ? $this->explain : ($event->connection->getConfig('driver') === 'oracle' ? 'EXPLAIN PLAN' : 'EXPLAIN');
+					$explain = dibi::dump($event->connection->nativeQuery("$cmd $event->sql"), TRUE);
+				} catch (DibiException $e) {}
+				list($event->connection->onEvent, dibi::$numOfQueries, dibi::$totalTime) = $backup;
+			}
+
+			$s .= '<tr><td>' . sprintf('%0.3f', $event->time * 1000);
+			if ($explain) {
+				static $counter;
+				$counter++;
+				$s .= "<br /><a href='#' class='nette-toggler' rel='#nette-debug-DibiProfiler-row-$counter'>explain&nbsp;&#x25ba;</a>";
+			}
+
+			$s .= '</td><td class="nette-DibiProfiler-sql">' . dibi::dump(strlen($event->sql) > self::$maxLength ? substr($event->sql, 0, self::$maxLength) . '...' : $event->sql, TRUE);
+			if ($explain) {
+				$s .= "<div id='nette-debug-DibiProfiler-row-$counter' class='nette-collapsed'>{$explain}</div>";
+			}
+			if ($event->source) {
+				$helpers = 'Nette\Diagnostics\Helpers';
+				if (!class_exists($helpers)) {
+					$helpers = class_exists('NDebugHelpers') ? 'NDebugHelpers' : 'DebugHelpers';
+				}
+				$s .= call_user_func(array($helpers, 'editorLink'), $event->source[0], $event->source[1])->class('nette-DibiProfiler-source');
+			}
+
+			$s .= "</td><td>{$event->count}</td><td>{$h($event->connection->getConfig('driver') . '/' . $event->connection->getConfig('name'))}</td></tr>";
+		}
+
+		return empty($this->events) ? '' :
+			'<style> #nette-debug td.nette-DibiProfiler-sql { background: white !important }
+			#nette-debug .nette-DibiProfiler-source { color: #999 !important }
+			#nette-debug nette-DibiProfiler tr table { margin: 8px 0; max-height: 150px; overflow:auto } </style>
+			<h1>Queries: ' . count($this->events) . ($totalTime === NULL ? '' : ', time: ' . sprintf('%0.3f', $totalTime * 1000) . ' ms') . '</h1>
+			<div class="nette-inner nette-DibiProfiler">
+			<table>
+				<tr><th>Time&nbsp;ms</th><th>SQL Statement</th><th>Rows</th><th>Connection</th></tr>' . $s . '
+			</table>
+			</div>';
+	}
+
+}

dibi/Nette/IDebuggable.php

@@ -1,40 +0,0 @@
-<?php
-
-/**
- * Nette Framework
- *
- * Copyright (c) 2004, 2008 David Grudl (http://davidgrudl.com)
- *
- * This source file is subject to the "Nette license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://nettephp.com
- *
- * @copyright  Copyright (c) 2004, 2008 David Grudl
- * @license    http://nettephp.com/license  Nette license
- * @link       http://nettephp.com
- * @category   Nette
- * @package    Nette
- */
-
-/*namespace Nette;*/
-
-
-
-/**
- * Custom output for Nette::Debug.
- *
- * @author     David Grudl
- * @copyright  Copyright (c) 2004, 2008 David Grudl
- * @package    Nette
- */
-interface IDebuggable
-{
-
-	/**
-	 * Returns custom panels.
-	 * @return array
-	 */
-	function getPanels();
-
-}

dibi/dibi.php

@@ -1,78 +1,46 @@
 <?php
 
 /**
- * dibi - tiny'n'smart database abstraction layer
- * ----------------------------------------------
+ * dibi - smart database abstraction layer (http://dibiphp.com)
  *
- * Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
+ * Copyright (c) 2005, 2012 David Grudl (http://davidgrudl.com)
  *
- * This source file is subject to the "dibi license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://dibiphp.com
- *
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @license    http://dibiphp.com/license  dibi license
- * @link       http://dibiphp.com
- * @package    dibi
- * @version    $Id$
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
  */
 
 
 /**
  * Check PHP configuration.
  */
-if (version_compare(PHP_VERSION, '5.1.0', '<')) {
-	throw new Exception('dibi needs PHP 5.1.0 or newer.');
+if (version_compare(PHP_VERSION, '5.2.0', '<')) {
+	throw new Exception('dibi needs PHP 5.2.0 or newer.');
 }
 
+@set_magic_quotes_runtime(FALSE); // intentionally @
 
 
 
-/**
- * Compatibility with Nette
- */
-if (!class_exists('NotImplementedException', FALSE)) {
-	class NotImplementedException extends LogicException {}
-}
-
-if (!class_exists('NotSupportedException', FALSE)) {
-	class NotSupportedException extends LogicException {}
-}
-
-if (!class_exists('MemberAccessException', FALSE)) {
-	class MemberAccessException extends LogicException {}
-}
-
-if (!class_exists('InvalidStateException', FALSE)) {
-	class InvalidStateException extends RuntimeException {}
-}
-
-if (!class_exists('IOException', FALSE)) {
-	class IOException extends RuntimeException {}
-}
-
-if (!class_exists('FileNotFoundException', FALSE)) {
-	class FileNotFoundException extends IOException {}
-}
-
-if (!interface_exists(/*Nette::*/'IDebuggable', FALSE)) {
-	require_once dirname(__FILE__) . '/Nette/IDebuggable.php';
-}
-
-// dibi libraries
 require_once dirname(__FILE__) . '/libs/interfaces.php';
+require_once dirname(__FILE__) . '/libs/DibiDateTime.php';
 require_once dirname(__FILE__) . '/libs/DibiObject.php';
+require_once dirname(__FILE__) . '/libs/DibiLiteral.php';
+require_once dirname(__FILE__) . '/libs/DibiHashMap.php';
 require_once dirname(__FILE__) . '/libs/DibiException.php';
 require_once dirname(__FILE__) . '/libs/DibiConnection.php';
 require_once dirname(__FILE__) . '/libs/DibiResult.php';
+require_once dirname(__FILE__) . '/libs/DibiResultIterator.php';
+require_once dirname(__FILE__) . '/libs/DibiRow.php';
 require_once dirname(__FILE__) . '/libs/DibiTranslator.php';
-require_once dirname(__FILE__) . '/libs/DibiVariable.php';
-require_once dirname(__FILE__) . '/libs/DibiTableX.php';
 require_once dirname(__FILE__) . '/libs/DibiDataSource.php';
 require_once dirname(__FILE__) . '/libs/DibiFluent.php';
 require_once dirname(__FILE__) . '/libs/DibiDatabaseInfo.php';
-require_once dirname(__FILE__) . '/libs/DibiProfiler.php';
+require_once dirname(__FILE__) . '/libs/DibiEvent.php';
+require_once dirname(__FILE__) . '/libs/DibiFileLogger.php';
+require_once dirname(__FILE__) . '/libs/DibiFirePhpLogger.php';
+if (interface_exists('Nette\Diagnostics\IBarPanel') || interface_exists('IBarPanel')) {
+	require_once dirname(__FILE__) . '/Nette/DibiNettePanel.php';
+}
 
 
 
@@ -85,40 +53,39 @@ require_once dirname(__FILE__) . '/libs/DibiProfiler.php';
  * store connections info.
  *
  * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
  * @package    dibi
  */
 class dibi
 {
-	/**#@+
-	 * dibi column type
-	 */
-	const FIELD_TEXT =     's'; // as 'string'
-	const FIELD_BINARY =   'bin';
-	const FIELD_BOOL =     'b';
-	const FIELD_INTEGER =  'i';
-	const FIELD_FLOAT =    'f';
-	const FIELD_DATE =     'd';
-	const FIELD_DATETIME = 't';
-	const FIELD_TIME =     't';
-	/**#@-*/
+	/** column type */
+	const TEXT = 's', // as 'string'
+		BINARY = 'bin',
+		BOOL = 'b',
+		INTEGER = 'i',
+		FLOAT = 'f',
+		DATE = 'd',
+		DATETIME = 't',
+		TIME = 't';
 
-	/**
-	 * Identifier type
-	 */
-	const IDENTIFIER =     'n';
+	const IDENTIFIER = 'n';
 
-	/**#@+
-	 * dibi version
-	 */
-	const VERSION = '1.0';
-	const REVISION = '$WCREV$ released on $WCDATE$';
-	/**#@-*/
+	/** @deprecated */
+	const FIELD_TEXT = dibi::TEXT,
+		FIELD_BINARY = dibi::BINARY,
+		FIELD_BOOL = dibi::BOOL,
+		FIELD_INTEGER = dibi::INTEGER,
+		FIELD_FLOAT = dibi::FLOAT,
+		FIELD_DATE = dibi::DATE,
+		FIELD_DATETIME = dibi::DATETIME,
+		FIELD_TIME = dibi::TIME;
 
-	/**
-	 * Configuration options
-	 */
-	const RESULT_WITH_TABLES = 'resultWithTables'; // for MySQL
+	/** version */
+	const VERSION = '2.0.3',
+		REVISION = '$WCREV$ released on $WCDATE$';
+
+	/** sorting order */
+	const ASC = 'ASC',
+		DESC = 'DESC';
 
 	/** @var DibiConnection[]  Connection registry storage for DibiConnection objects */
 	private static $registry = array();
@@ -126,12 +93,6 @@ class dibi
 	/** @var DibiConnection  Current connection */
 	private static $connection;
 
-	/** @var array  Substitutions for identifiers */
-	private static $substs = array();
-
-	/** @var callback  Substitution fallback */
-	private static $substFallBack;
-
 	/** @var array  @see addHandler */
 	private static $handlers = array();
 
@@ -168,8 +129,8 @@ class dibi
 
 	/**
 	 * Creates a new DibiConnection object and connects it to specified database.
-	 * @param  array|string|ArrayObject connection parameters
-	 * @param  string       connection name
+	 * @param  mixed   connection parameters
+	 * @param  string  connection name
 	 * @return DibiConnection
 	 * @throws DibiException
 	 */
@@ -227,6 +188,18 @@ class dibi
 
 
 
+	/**
+	 * Sets connection.
+	 * @param  DibiConnection
+	 * @return DibiConnection
+	 */
+	public static function setConnection(DibiConnection $connection)
+	{
+		return self::$connection = $connection;
+	}
+
+
+
 	/**
 	 * Change active connection.
 	 * @param  string   connection registy name
@@ -240,18 +213,6 @@ class dibi
 
 
 
-	/**
-	 * Retrieve active connection profiler.
-	 * @return IDibiProfiler
-	 * @throws DibiException
-	 */
-	public static function getProfiler()
-	{
-		return self::getConnection()->getProfiler();
-	}
-
-
-
 	/********************* monostate for active connection ****************d*g**/
 
 
@@ -259,7 +220,7 @@ class dibi
 	/**
 	 * Generates and executes SQL query - Monostate for DibiConnection::query().
 	 * @param  array|mixed      one or more arguments
-	 * @return DibiResult|NULL  result set object (if any)
+	 * @return DibiResult|int   result set object (if any)
 	 * @throws DibiException
 	 */
 	public static function query($args)
@@ -273,7 +234,7 @@ class dibi
 	/**
 	 * Executes the SQL query - Monostate for DibiConnection::nativeQuery().
 	 * @param  string           SQL statement.
-	 * @return DibiResult|NULL  result set object (if any)
+	 * @return DibiResult|int   result set object (if any)
 	 */
 	public static function nativeQuery($sql)
 	{
@@ -295,6 +256,19 @@ class dibi
 
 
 
+	/**
+	 * Generates and returns SQL query as DibiDataSource - Monostate for DibiConnection::test().
+	 * @param  array|mixed      one or more arguments
+	 * @return DibiDataSource
+	 */
+	public static function dataSource($args)
+	{
+		$args = func_get_args();
+		return self::getConnection()->dataSource($args);
+	}
+
+
+
 	/**
 	 * Executes SQL query and fetch result - Monostate for DibiConnection::query() & fetch().
 	 * @param  array|mixed    one or more arguments
@@ -353,63 +327,91 @@ class dibi
 
 	/**
 	 * Gets the number of affected rows.
-	 * Monostate for DibiConnection::affectedRows()
+	 * Monostate for DibiConnection::getAffectedRows()
+	 * @return int  number of rows
+	 * @throws DibiException
+	 */
+	public static function getAffectedRows()
+	{
+		return self::getConnection()->getAffectedRows();
+	}
+
+
+
+	/**
+	 * Gets the number of affected rows. Alias for getAffectedRows().
 	 * @return int  number of rows
 	 * @throws DibiException
 	 */
 	public static function affectedRows()
 	{
-		return self::getConnection()->affectedRows();
+		return self::getConnection()->getAffectedRows();
 	}
 
 
 
 	/**
 	 * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query.
-	 * Monostate for DibiConnection::insertId()
+	 * Monostate for DibiConnection::getInsertId()
+	 * @param  string     optional sequence name
+	 * @return int
+	 * @throws DibiException
+	 */
+	public static function getInsertId($sequence=NULL)
+	{
+		return self::getConnection()->getInsertId($sequence);
+	}
+
+
+
+	/**
+	 * Retrieves the ID generated for an AUTO_INCREMENT column. Alias for getInsertId().
 	 * @param  string     optional sequence name
 	 * @return int
 	 * @throws DibiException
 	 */
 	public static function insertId($sequence=NULL)
 	{
-		return self::getConnection()->insertId($sequence);
+		return self::getConnection()->getInsertId($sequence);
 	}
 
 
 
 	/**
 	 * Begins a transaction - Monostate for DibiConnection::begin().
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiException
 	 */
-	public static function begin()
+	public static function begin($savepoint = NULL)
 	{
-		self::getConnection()->begin();
+		self::getConnection()->begin($savepoint);
 	}
 
 
 
 	/**
-	 * Commits statements in a transaction - Monostate for DibiConnection::commit().
+	 * Commits statements in a transaction - Monostate for DibiConnection::commit($savepoint = NULL).
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiException
 	 */
-	public static function commit()
+	public static function commit($savepoint = NULL)
 	{
-		self::getConnection()->commit();
+		self::getConnection()->commit($savepoint);
 	}
 
 
 
 	/**
 	 * Rollback changes in a transaction - Monostate for DibiConnection::rollback().
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiException
 	 */
-	public static function rollback()
+	public static function rollback($savepoint = NULL)
 	{
-		self::getConnection()->rollback();
+		self::getConnection()->rollback($savepoint);
 	}
 
 
@@ -471,7 +473,7 @@ class dibi
 	public static function select($args)
 	{
 		$args = func_get_args();
-		return self::getConnection()->command()->__call('select', $args);
+		return call_user_func_array(array(self::getConnection(), 'select'), $args);
 	}
 
 
@@ -481,7 +483,7 @@ class dibi
 	 * @param  array
 	 * @return DibiFluent
 	 */
-	public static function update($table, array $args)
+	public static function update($table, $args)
 	{
 		return self::getConnection()->update($table, $args);
 	}
@@ -493,7 +495,7 @@ class dibi
 	 * @param  array
 	 * @return DibiFluent
 	 */
-	public static function insert($table, array $args)
+	public static function insert($table, $args)
 	{
 		return self::getConnection()->insert($table, $args);
 	}
@@ -516,34 +518,23 @@ class dibi
 
 
 	/**
-	 * Pseudotype for timestamp representation.
-	 * @param  mixed  datetime
-	 * @return DibiVariable
+	 * @return DibiDateTime
 	 */
 	public static function datetime($time = NULL)
 	{
-		if ($time === NULL) {
-			$time = time(); // current time
-		} elseif (is_string($time)) {
-			$time = strtotime($time); // try convert to timestamp
-		} else {
-			$time = (int) $time;
-		}
-		return new DibiVariable($time, dibi::FIELD_DATETIME);
+		trigger_error(__METHOD__ . '() is deprecated; create DibiDateTime object instead.', E_USER_WARNING);
+		return new DibiDateTime($time);
 	}
 
 
 
 	/**
-	 * Pseudotype for date representation.
-	 * @param  mixed  date
-	 * @return DibiVariable
+	 * @deprecated
 	 */
 	public static function date($date = NULL)
 	{
-		$var = self::datetime($date);
-		$var->modifier = dibi::FIELD_DATE;
-		return $var;
+		trigger_error(__METHOD__ . '() is deprecated; create DibiDateTime object instead.', E_USER_WARNING);
+		return new DibiDateTime($date);
 	}
 
 
@@ -553,84 +544,46 @@ class dibi
 
 
 	/**
-	 * Create a new substitution pair for indentifiers.
-	 * @param  string from
-	 * @param  string to
-	 * @return void
+	 * Returns substitution hashmap - Monostate for DibiConnection::getSubstitutes().
+	 * @return DibiHashMap
 	 */
+	public static function getSubstitutes()
+	{
+		return self::getConnection()->getSubstitutes();
+	}
+
+
+
+	/** @deprecated */
 	public static function addSubst($expr, $subst)
 	{
-		self::$substs[$expr] = $subst;
+		trigger_error(__METHOD__ . '() is deprecated; use dibi::getSubstitutes()->expr = val; instead.', E_USER_WARNING);
+		self::getSubstitutes()->$expr = $subst;
 	}
 
 
 
-	/**
-	 * Sets substitution fallback handler.
-	 * @param  callback
-	 * @return void
-	 */
-	public static function setSubstFallback($callback)
-	{
-		if (!is_callable($callback)) {
-			throw new InvalidArgumentException("Invalid callback.");
-		}
-
-		self::$substFallBack = $callback;
-	}
-
-
-
-	/**
-	 * Remove substitution pair.
-	 * @param  mixed from or TRUE
-	 * @return void
-	 */
+	/** @deprecated */
 	public static function removeSubst($expr)
 	{
+		trigger_error(__METHOD__ . '() is deprecated; use unset(dibi::getSubstitutes()->expr) instead.', E_USER_WARNING);
+		$substitutes = self::getSubstitutes();
 		if ($expr === TRUE) {
-			self::$substs = array();
+			foreach ($substitutes as $expr => $foo) {
+				unset($substitutes->$expr);
+			}
 		} else {
-			unset(self::$substs[':'.$expr.':']);
+			unset($substitutes->$expr);
 		}
 	}
 
 
 
-	/**
-	 * Provides substitution.
-	 * @param  string
-	 * @return string
-	 */
-	public static function substitute($value)
+	/** @deprecated */
+	public static function setSubstFallback($callback)
 	{
-		if (strpos($value, ':') === FALSE) {
-			return $value;
-
-		} else {
-			return preg_replace_callback('#:(.*):#U', array('dibi', 'subCb'), $value);
-		}
-	}
-
-
-
-	/**
-	 * Substitution callback.
-	 * @param  array
-	 * @return string
-	 */
-	private static function subCb($m)
-	{
-		$m = $m[1];
-		if (isset(self::$substs[$m])) {
-			return self::$substs[$m];
-
-		} elseif (self::$substFallBack) {
-			return self::$substs[$m] = call_user_func(self::$substFallBack, $m);
-
-		} else {
-			return $m;
-		}
+		trigger_error(__METHOD__ . '() is deprecated; use dibi::getSubstitutes()->setCallback() instead.', E_USER_WARNING);
+		self::getSubstitutes()->setCallback($callback);
 	}
 
 
@@ -654,24 +607,27 @@ class dibi
 		} else {
 			if ($sql === NULL) $sql = self::$sql;
 
-			static $keywords1 = 'SELECT|UPDATE|INSERT(?:\s+INTO)?|REPLACE(?:\s+INTO)?|DELETE|FROM|WHERE|HAVING|GROUP\s+BY|ORDER\s+BY|LIMIT|SET|VALUES|LEFT\s+JOIN|INNER\s+JOIN|TRUNCATE';
-			static $keywords2 = 'ALL|DISTINCT|DISTINCTROW|AS|USING|ON|AND|OR|IN|IS|NOT|NULL|LIKE|TRUE|FALSE';
+			static $keywords1 = 'SELECT|(?:ON\s+DUPLICATE\s+KEY)?UPDATE|INSERT(?:\s+INTO)?|REPLACE(?:\s+INTO)?|DELETE|CALL|UNION|FROM|WHERE|HAVING|GROUP\s+BY|ORDER\s+BY|LIMIT|OFFSET|SET|VALUES|LEFT\s+JOIN|INNER\s+JOIN|TRUNCATE';
+			static $keywords2 = 'ALL|DISTINCT|DISTINCTROW|IGNORE|AS|USING|ON|AND|OR|IN|IS|NOT|NULL|LIKE|RLIKE|REGEXP|TRUE|FALSE';
 
 			// insert new lines
-			$sql = ' ' . $sql;
+			$sql = " $sql ";
 			$sql = preg_replace("#(?<=[\\s,(])($keywords1)(?=[\\s,)])#i", "\n\$1", $sql);
 
 			// reduce spaces
 			$sql = preg_replace('#[ \t]{2,}#', " ", $sql);
 
 			$sql = wordwrap($sql, 100);
-			$sql = htmlSpecialChars($sql);
-			$sql = preg_replace("#\n{2,}#", "\n", $sql);
+			$sql = preg_replace("#([ \t]*\r?\n){2,}#", "\n", $sql);
 
-			// syntax highlight
-			$sql = preg_replace_callback("#(/\\*.+?\\*/)|(\\*\\*.+?\\*\\*)|(?<=[\\s,(])($keywords1)(?=[\\s,)])|(?<=[\\s,(=])($keywords2)(?=[\\s,)=])#is", array('dibi', 'highlightCallback'), $sql);
-			$sql = trim($sql);
-			echo '<pre class="dump">', $sql, "</pre>\n";
+			if (PHP_SAPI === 'cli') {
+				echo trim($sql) . "\n\n";
+			} else {
+				// syntax highlight
+				$sql = htmlSpecialChars($sql);
+				$sql = preg_replace_callback("#(/\\*.+?\\*/)|(\\*\\*.+?\\*\\*)|(?<=[\\s,(])($keywords1)(?=[\\s,)])|(?<=[\\s,(=])($keywords2)(?=[\\s,)=])#is", array('dibi', 'highlightCallback'), $sql);
+				echo '<pre class="dump">', trim($sql), "</pre>\n";
+			}
 		}
 
 		if ($return) {
@@ -698,23 +654,4 @@ class dibi
 			return '<strong style="color:green">' . $matches[4] . '</strong>';
 	}
 
-
-
-	/**
-	 * Returns brief descriptions.
-	 * @return string
-	 * @return array
-	 */
-	public static function getColophon($sender = NULL)
-	{
-		$arr = array(
-			'Number of SQL queries: ' . dibi::$numOfQueries
-			. (dibi::$totalTime === NULL ? '' : ', elapsed time: ' . sprintf('%0.3f', dibi::$totalTime * 1000) . ' ms'),
-		);
-		if ($sender === 'bluescreen') {
-			$arr[] = 'dibi ' . dibi::VERSION . ' (revision ' . dibi::REVISION . ')';
-		}
-		return $arr;
-	}
-
 }

dibi/drivers/firebird.php

@@ -0,0 +1,888 @@
+<?php
+
+/**
+ * This file is part of the "dibi" - smart database abstraction layer.
+ *
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
+ */
+
+
+/**
+ * The dibi driver for Firebird/InterBase database.
+ *
+ * Driver options:
+ *   - database => the path to database file (server:/path/database.fdb)
+ *   - username (or user)
+ *   - password (or pass)
+ *   - charset => character encoding to set
+ *   - buffers (int) => buffers is the number of database buffers to allocate for the server-side cache. If 0 or omitted, server chooses its own default.
+ *   - resource (resource) => existing connection resource
+ *   - lazy, profiler, result, substitutes, ... => see DibiConnection options
+ *
+ * @author     Tomáš Kraina, Roman Sklenář
+ * @package    dibi\drivers
+ */
+class DibiFirebirdDriver extends DibiObject implements IDibiDriver, IDibiResultDriver, IDibiReflector
+{
+	const ERROR_EXCEPTION_THROWN = -836;
+
+	/** @var resource  Connection resource */
+	private $connection;
+
+	/** @var resource  Resultset resource */
+	private $resultSet;
+
+	/** @var bool */
+	private $autoFree = TRUE;
+
+	/** @var resource  Resultset resource */
+	private $transaction;
+
+	/** @var bool */
+	private $inTransaction = FALSE;
+
+
+	/**
+	 * @throws DibiNotSupportedException
+	 */
+	public function __construct()
+	{
+		if (!extension_loaded('interbase')) {
+			throw new DibiNotSupportedException("PHP extension 'interbase' is not loaded.");
+		}
+	}
+
+
+
+	/**
+	 * Connects to a database.
+	 * @return void
+	 * @throws DibiException
+	 */
+	public function connect(array &$config)
+	{
+		DibiConnection::alias($config, 'database', 'db');
+
+		if (isset($config['resource'])) {
+			$this->connection = $config['resource'];
+
+		} else {
+			// default values
+			if (!isset($config['username'])) $config['username'] = ini_get('ibase.default_password');
+			if (!isset($config['password'])) $config['password'] = ini_get('ibase.default_user');
+			if (!isset($config['database'])) $config['database'] = ini_get('ibase.default_db');
+			if (!isset($config['charset'])) $config['charset'] = ini_get('ibase.default_charset');
+			if (!isset($config['buffers'])) $config['buffers'] = 0;
+
+			DibiDriverException::tryError();
+			if (empty($config['persistent'])) {
+				$this->connection = ibase_connect($config['database'], $config['username'], $config['password'], $config['charset'], $config['buffers']); // intentionally @
+			} else {
+				$this->connection = ibase_pconnect($config['database'], $config['username'], $config['password'], $config['charset'], $config['buffers']); // intentionally @
+			}
+			if (DibiDriverException::catchError($msg)) {
+				throw new DibiDriverException($msg, ibase_errcode());
+			}
+
+			if (!is_resource($this->connection)) {
+				throw new DibiDriverException(ibase_errmsg(), ibase_errcode());
+			}
+		}
+
+	}
+
+
+
+	/**
+	 * Disconnects from a database.
+	 * @return void
+	 */
+	public function disconnect()
+	{
+		ibase_close($this->connection);
+	}
+
+
+
+	/**
+	 * Executes the SQL query.
+	 * @param  string      SQL statement.
+	 * @return IDibiResultDriver|NULL
+	 * @throws DibiDriverException|DibiException
+	 */
+	public function query($sql)
+	{
+		DibiDriverException::tryError();
+		$resource = $this->inTransaction ? $this->transaction : $this->connection;
+		$res = ibase_query($resource, $sql);
+
+		if (DibiDriverException::catchError($msg)) {
+			if (ibase_errcode() == self::ERROR_EXCEPTION_THROWN) {
+				preg_match('/exception (\d+) (\w+) (.*)/i', ibase_errmsg(), $match);
+				throw new DibiProcedureException($match[3], $match[1], $match[2], dibi::$sql);
+
+			} else {
+				throw new DibiDriverException(ibase_errmsg(), ibase_errcode(), dibi::$sql);
+			}
+		}
+
+		if ($res === FALSE) {
+			throw new DibiDriverException(ibase_errmsg(), ibase_errcode(), $sql);
+
+		} elseif (is_resource($res)) {
+			return $this->createResultDriver($res);
+		}
+	}
+
+
+
+	/**
+	 * Gets the number of affected rows by the last INSERT, UPDATE or DELETE query.
+	 * @return int|FALSE  number of rows or FALSE on error
+	 */
+	public function getAffectedRows()
+	{
+		return ibase_affected_rows($this->connection);
+	}
+
+
+
+	/**
+	 * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query.
+	 * @param  string     generator name
+	 * @return int|FALSE  int on success or FALSE on failure
+	 */
+	public function getInsertId($sequence)
+	{
+		return ibase_gen_id($sequence, 0, $this->connection);
+	}
+
+
+
+	/**
+	 * Begins a transaction (if supported).
+	 * @param  string  optional savepoint name
+	 * @return void
+	 * @throws DibiDriverException
+	 */
+	public function begin($savepoint = NULL)
+	{
+		if ($savepoint !== NULL) {
+			throw new DibiNotSupportedException('Savepoints are not supported in Firebird/Interbase.');
+		}
+		$this->transaction = ibase_trans($this->resource);
+		$this->inTransaction = TRUE;
+	}
+
+
+
+	/**
+	 * Commits statements in a transaction.
+	 * @param  string  optional savepoint name
+	 * @return void
+	 * @throws DibiDriverException
+	 */
+	public function commit($savepoint = NULL)
+	{
+		if ($savepoint !== NULL) {
+			throw new DibiNotSupportedException('Savepoints are not supported in Firebird/Interbase.');
+		}
+
+		if (!ibase_commit($this->transaction)) {
+			throw new DibiDriverException('Unable to handle operation - failure when commiting transaction.');
+		}
+
+		$this->inTransaction = FALSE;
+	}
+
+
+
+	/**
+	 * Rollback changes in a transaction.
+	 * @param  string  optional savepoint name
+	 * @return void
+	 * @throws DibiDriverException
+	 */
+	public function rollback($savepoint = NULL)
+	{
+		if ($savepoint !== NULL) {
+			throw new DibiNotSupportedException('Savepoints are not supported in Firebird/Interbase.');
+		}
+
+		if (!ibase_rollback($this->transaction)) {
+			throw new DibiDriverException('Unable to handle operation - failure when rolbacking transaction.');
+		}
+
+		$this->inTransaction = FALSE;
+	}
+
+
+
+	/**
+	 * Is in transaction?
+	 * @return bool
+	 */
+	public function inTransaction()
+	{
+		return $this->inTransaction;
+	}
+
+
+
+	/**
+	 * Returns the connection resource.
+	 * @return resource
+	 */
+	public function getResource()
+	{
+		return is_resource($this->connection) ? $this->connection : NULL;
+	}
+
+
+
+	/**
+	 * Returns the connection reflector.
+	 * @return IDibiReflector
+	 */
+	public function getReflector()
+	{
+		return $this;
+	}
+
+
+
+	/**
+	 * Result set driver factory.
+	 * @param  resource
+	 * @return IDibiResultDriver
+	 */
+	public function createResultDriver($resource)
+	{
+		$res = clone $this;
+		$res->resultSet = $resource;
+		return $res;
+	}
+
+
+
+	/********************* SQL ********************/
+
+
+
+	/**
+	 * Encodes data for use in a SQL statement.
+	 * @param  mixed     value
+	 * @param  string    type (dibi::TEXT, dibi::BOOL, ...)
+	 * @return string    encoded value
+	 * @throws InvalidArgumentException
+	 */
+	public function escape($value, $type)
+	{
+		switch ($type) {
+		case dibi::TEXT:
+		case dibi::BINARY:
+			return "'" . str_replace("'", "''", $value) . "'";
+
+		case dibi::IDENTIFIER:
+			return $value;
+
+		case dibi::BOOL:
+			return $value ? 1 : 0;
+
+		case dibi::DATE:
+			return $value instanceof DateTime ? $value->format("'Y-m-d'") : date("'Y-m-d'", $value);
+
+		case dibi::DATETIME:
+			return $value instanceof DateTime ? $value->format("'Y-m-d H:i:s'") : date("'Y-m-d H:i:s'", $value);
+
+		default:
+			throw new InvalidArgumentException('Unsupported type.');
+		}
+	}
+
+
+
+	/**
+	 * Encodes string for use in a LIKE statement.
+	 * @param  string
+	 * @param  int
+	 * @return string
+	 */
+	public function escapeLike($value, $pos)
+	{
+		throw new DibiNotImplementedException;
+	}
+
+
+
+	/**
+	 * Decodes data from result set.
+	 * @param  string    value
+	 * @param  string    type (dibi::BINARY)
+	 * @return string    decoded value
+	 * @throws InvalidArgumentException
+	 */
+	public function unescape($value, $type)
+	{
+		if ($type === dibi::BINARY) {
+			return $value;
+		}
+		throw new InvalidArgumentException('Unsupported type.');
+	}
+
+
+
+	/**
+	 * Injects LIMIT/OFFSET to the SQL query.
+	 * @param  string &$sql  The SQL query that will be modified.
+	 * @param  int $limit
+	 * @param  int $offset
+	 * @return void
+	 */
+	public function applyLimit(&$sql, $limit, $offset)
+	{
+		if ($limit < 0 && $offset < 1) return;
+
+		// see http://scott.yang.id.au/2004/01/limit-in-select-statements-in-firebird/
+		$sql = 'SELECT FIRST ' . (int) $limit . ($offset > 0 ? ' SKIP ' . (int) $offset : '') . ' * FROM (' . $sql . ')';
+	}
+
+
+
+	/********************* result set ********************/
+
+
+
+	/**
+	 * Automatically frees the resources allocated for this result set.
+	 * @return void
+	 */
+	public function __destruct()
+	{
+		$this->autoFree && $this->getResultResource() && $this->free();
+	}
+
+
+
+	/**
+	 * Returns the number of rows in a result set.
+	 * @return int
+	 */
+	public function getRowCount()
+	{
+		return ibase_num_fields($this->resultSet);
+	}
+
+
+
+	/**
+	 * Fetches the row at current position and moves the internal cursor to the next position.
+	 * @param  bool     TRUE for associative array, FALSE for numeric
+	 * @return array    array on success, nonarray if no next record
+	 */
+	public function fetch($assoc)
+	{
+		DibiDriverException::tryError();
+		$result = $assoc ? ibase_fetch_assoc($this->resultSet, IBASE_TEXT) : ibase_fetch_row($this->resultSet, IBASE_TEXT); // intentionally @
+
+		if (DibiDriverException::catchError($msg)) {
+			if (ibase_errcode() == self::ERROR_EXCEPTION_THROWN) {
+				preg_match('/exception (\d+) (\w+) (.*)/i', ibase_errmsg(), $match);
+				throw new DibiProcedureException($match[3], $match[1], $match[2], dibi::$sql);
+
+			} else {
+				throw new DibiDriverException($msg, ibase_errcode(), dibi::$sql);
+			}
+		}
+
+		return $result;
+	}
+
+
+
+	/**
+	 * Moves cursor position without fetching row.
+	 * @param  int      the 0-based cursor pos to seek to
+	 * @return boolean  TRUE on success, FALSE if unable to seek to specified record
+	 * @throws DibiException
+	 */
+	public function seek($row)
+	{
+		throw new DibiNotSupportedException("Firebird/Interbase do not support seek in result set.");
+	}
+
+
+
+	/**
+	 * Frees the resources allocated for this result set.
+	 * @return void
+	 */
+	public function free()
+	{
+		ibase_free_result($this->resultSet);
+		$this->resultSet = NULL;
+	}
+
+
+
+	/**
+	 * Returns the result set resource.
+	 * @return mysqli_result
+	 */
+	public function getResultResource()
+	{
+		$this->autoFree = FALSE;
+		return is_resource($this->resultSet) ? $this->resultSet : NULL;
+	}
+
+
+
+	/**
+	 * Returns metadata for all columns in a result set.
+	 * @return array
+	 */
+	public function getResultColumns()
+	{
+		$count = ibase_num_fields($this->resultSet);
+		$columns = array();
+		for ($i = 0; $i < $count; $i++) {
+			$row = (array) ibase_field_info($this->resultSet, $i);
+			$columns[] = array(
+				'name' => $row['name'],
+				'fullname' => $row['name'],
+				'table' => $row['relation'],
+				'nativetype' => $row['type'],
+			);
+		}
+		return $columns;
+	}
+
+
+
+	/********************* IDibiReflector ********************/
+
+
+
+	/**
+	 * Returns list of tables.
+	 * @return array
+	 */
+	public function getTables()
+	{
+		$res = $this->query("
+			SELECT TRIM(RDB\$RELATION_NAME),
+				CASE RDB\$VIEW_BLR WHEN NULL THEN 'TRUE' ELSE 'FALSE' END
+			FROM RDB\$RELATIONS
+			WHERE RDB\$SYSTEM_FLAG = 0;"
+		);
+		$tables = array();
+		while ($row = $res->fetch(FALSE)) {
+			$tables[] = array(
+				'name' => $row[0],
+				'view' => $row[1] === 'TRUE',
+			);
+		}
+		return $tables;
+	}
+
+
+
+	/**
+	 * Returns metadata for all columns in a table.
+	 * @param  string
+	 * @return array
+	 */
+	public function getColumns($table)
+	{
+		$table = strtoupper($table);
+		$res = $this->query("
+			SELECT TRIM(r.RDB\$FIELD_NAME) AS FIELD_NAME,
+				CASE f.RDB\$FIELD_TYPE
+					WHEN 261 THEN 'BLOB'
+					WHEN 14 THEN 'CHAR'
+					WHEN 40 THEN 'CSTRING'
+					WHEN 11 THEN 'D_FLOAT'
+					WHEN 27 THEN 'DOUBLE'
+					WHEN 10 THEN 'FLOAT'
+					WHEN 16 THEN 'INT64'
+					WHEN 8 THEN 'INTEGER'
+					WHEN 9 THEN 'QUAD'
+					WHEN 7 THEN 'SMALLINT'
+					WHEN 12 THEN 'DATE'
+					WHEN 13 THEN 'TIME'
+					WHEN 35 THEN 'TIMESTAMP'
+					WHEN 37 THEN 'VARCHAR'
+					ELSE 'UNKNOWN'
+				END AS FIELD_TYPE,
+				f.RDB\$FIELD_LENGTH AS FIELD_LENGTH,
+				r.RDB\$DEFAULT_VALUE AS DEFAULT_VALUE,
+				CASE r.RDB\$NULL_FLAG
+					WHEN 1 THEN 'FALSE' ELSE 'TRUE'
+				END AS NULLABLE
+			FROM RDB\$RELATION_FIELDS r
+				LEFT JOIN RDB\$FIELDS f ON r.RDB\$FIELD_SOURCE = f.RDB\$FIELD_NAME
+			WHERE r.RDB\$RELATION_NAME = '$table'
+			ORDER BY r.RDB\$FIELD_POSITION;"
+
+		);
+		$columns = array();
+		while ($row = $res->fetch(TRUE)) {
+			$key = $row['FIELD_NAME'];
+			$columns[$key] = array(
+				'name' => $key,
+				'table' => $table,
+				'nativetype' => trim($row['FIELD_TYPE']),
+				'size' => $row['FIELD_LENGTH'],
+				'nullable' => $row['NULLABLE'] === 'TRUE',
+				'default' => $row['DEFAULT_VALUE'],
+				'autoincrement' => FALSE,
+			);
+		}
+		return $columns;
+	}
+
+
+
+	/**
+	 * Returns metadata for all indexes in a table (the constraints are included).
+	 * @param  string
+	 * @return array
+	 */
+	public function getIndexes($table)
+	{
+		$table = strtoupper($table);
+		$res = $this->query("
+			SELECT TRIM(s.RDB\$INDEX_NAME) AS INDEX_NAME,
+				TRIM(s.RDB\$FIELD_NAME) AS FIELD_NAME,
+				i.RDB\$UNIQUE_FLAG AS UNIQUE_FLAG,
+				i.RDB\$FOREIGN_KEY AS FOREIGN_KEY,
+				TRIM(r.RDB\$CONSTRAINT_TYPE) AS CONSTRAINT_TYPE,
+				s.RDB\$FIELD_POSITION AS FIELD_POSITION
+			FROM RDB\$INDEX_SEGMENTS s
+				LEFT JOIN RDB\$INDICES i ON i.RDB\$INDEX_NAME = s.RDB\$INDEX_NAME
+				LEFT JOIN RDB\$RELATION_CONSTRAINTS r ON r.RDB\$INDEX_NAME = s.RDB\$INDEX_NAME
+			WHERE UPPER(i.RDB\$RELATION_NAME) = '$table'
+			ORDER BY s.RDB\$FIELD_POSITION"
+		);
+		$indexes = array();
+		while ($row = $res->fetch(TRUE)) {
+			$key = $row['INDEX_NAME'];
+			$indexes[$key]['name'] = $key;
+			$indexes[$key]['unique'] = $row['UNIQUE_FLAG'] === 1;
+			$indexes[$key]['primary'] = $row['CONSTRAINT_TYPE'] === 'PRIMARY KEY';
+			$indexes[$key]['table'] = $table;
+			$indexes[$key]['columns'][$row['FIELD_POSITION']] = $row['FIELD_NAME'];
+		}
+		return $indexes;
+	}
+
+
+
+	/**
+	 * Returns metadata for all foreign keys in a table.
+	 * @param  string
+	 * @return array
+	 */
+	public function getForeignKeys($table)
+	{
+		$table = strtoupper($table);
+		$res = $this->query("
+			SELECT TRIM(s.RDB\$INDEX_NAME) AS INDEX_NAME,
+				TRIM(s.RDB\$FIELD_NAME) AS FIELD_NAME,
+			FROM RDB\$INDEX_SEGMENTS s
+				LEFT JOIN RDB\$RELATION_CONSTRAINTS r ON r.RDB\$INDEX_NAME = s.RDB\$INDEX_NAME
+			WHERE UPPER(i.RDB\$RELATION_NAME) = '$table'
+				AND r.RDB\$CONSTRAINT_TYPE = 'FOREIGN KEY'
+			ORDER BY s.RDB\$FIELD_POSITION"
+		);
+		$keys = array();
+		while ($row = $res->fetch(TRUE)) {
+			$key = $row['INDEX_NAME'];
+			$keys[$key] = array(
+				'name' => $key,
+				'column' => $row['FIELD_NAME'],
+				'table' => $table,
+			);
+		}
+		return $keys;
+	}
+
+
+
+	/**
+	 * Returns list of indices in given table (the constraints are not listed).
+	 * @param  string
+	 * @return array
+	 */
+	public function getIndices($table)
+	{
+		$res = $this->query("
+			SELECT TRIM(RDB\$INDEX_NAME)
+			FROM RDB\$INDICES
+			WHERE RDB\$RELATION_NAME = UPPER('$table')
+				AND RDB\$UNIQUE_FLAG IS NULL
+				AND RDB\$FOREIGN_KEY IS NULL;"
+		);
+		$indices = array();
+		while ($row = $res->fetch(FALSE)) {
+			$indices[] = $row[0];
+		}
+		return $indices;
+	}
+
+
+
+	/**
+	 * Returns list of constraints in given table.
+	 * @param  string
+	 * @return array
+	 */
+	public function getConstraints($table)
+	{
+		$res = $this->query("
+			SELECT TRIM(RDB\$INDEX_NAME)
+			FROM RDB\$INDICES
+			WHERE RDB\$RELATION_NAME = UPPER('$table')
+				AND (
+					RDB\$UNIQUE_FLAG IS NOT NULL
+					OR RDB\$FOREIGN_KEY IS NOT NULL
+			);"
+		);
+		$constraints = array();
+		while ($row = $res->fetch(FALSE)) {
+			$constraints[] = $row[0];
+		}
+		return $constraints;
+	}
+
+
+
+	/**
+	 * Returns metadata for all triggers in a table or database.
+	 * (Only if user has permissions on ALTER TABLE, INSERT/UPDATE/DELETE record in table)
+	 * @param  string
+	 * @param  string
+	 * @return array
+	 */
+	public function getTriggersMeta($table = NULL)
+	{
+		$res = $this->query("
+			SELECT TRIM(RDB\$TRIGGER_NAME) AS TRIGGER_NAME,
+				TRIM(RDB\$RELATION_NAME) AS TABLE_NAME,
+				CASE RDB\$TRIGGER_TYPE
+					WHEN 1 THEN 'BEFORE'
+					WHEN 2 THEN 'AFTER'
+					WHEN 3 THEN 'BEFORE'
+					WHEN 4 THEN 'AFTER'
+					WHEN 5 THEN 'BEFORE'
+					WHEN 6 THEN 'AFTER'
+				END AS TRIGGER_TYPE,
+				CASE RDB\$TRIGGER_TYPE
+					WHEN 1 THEN 'INSERT'
+					WHEN 2 THEN 'INSERT'
+					WHEN 3 THEN 'UPDATE'
+					WHEN 4 THEN 'UPDATE'
+					WHEN 5 THEN 'DELETE'
+					WHEN 6 THEN 'DELETE'
+				END AS TRIGGER_EVENT,
+				CASE RDB\$TRIGGER_INACTIVE
+					WHEN 1 THEN 'FALSE' ELSE 'TRUE'
+				END AS TRIGGER_ENABLED
+			FROM RDB\$TRIGGERS
+			WHERE RDB\$SYSTEM_FLAG = 0"
+			. ($table === NULL ? ";" : " AND RDB\$RELATION_NAME = UPPER('$table');")
+		);
+		$triggers = array();
+		while ($row = $res->fetch(TRUE)) {
+			$triggers[$row['TRIGGER_NAME']] = array(
+				'name' => $row['TRIGGER_NAME'],
+				'table' => $row['TABLE_NAME'],
+				'type' => trim($row['TRIGGER_TYPE']),
+				'event' => trim($row['TRIGGER_EVENT']),
+				'enabled' => trim($row['TRIGGER_ENABLED']) === 'TRUE',
+			);
+		}
+		return $triggers;
+	}
+
+
+
+	/**
+	 * Returns list of triggers for given table.
+	 * (Only if user has permissions on ALTER TABLE, INSERT/UPDATE/DELETE record in table)
+	 * @param  string
+	 * @return array
+	 */
+	public function getTriggers($table = NULL)
+	{
+		$q = "SELECT TRIM(RDB\$TRIGGER_NAME)
+			FROM RDB\$TRIGGERS
+			WHERE RDB\$SYSTEM_FLAG = 0";
+		$q .= $table === NULL ? ";" : " AND RDB\$RELATION_NAME = UPPER('$table')";
+
+		$res = $this->query($q);
+		$triggers = array();
+		while ($row = $res->fetch(FALSE)) {
+			$triggers[] = $row[0];
+		}
+		return $triggers;
+	}
+
+
+
+	/**
+	 * Returns metadata from stored procedures and their input and output parameters.
+	 * @param  string
+	 * @return array
+	 */
+	public function getProceduresMeta()
+	{
+		$res = $this->query("
+			SELECT
+				TRIM(p.RDB\$PARAMETER_NAME) AS PARAMETER_NAME,
+				TRIM(p.RDB\$PROCEDURE_NAME) AS PROCEDURE_NAME,
+				CASE p.RDB\$PARAMETER_TYPE
+					WHEN 0 THEN 'INPUT'
+					WHEN 1 THEN 'OUTPUT'
+					ELSE 'UNKNOWN'
+				END AS PARAMETER_TYPE,
+				CASE f.RDB\$FIELD_TYPE
+					WHEN 261 THEN 'BLOB'
+					WHEN 14 THEN 'CHAR'
+					WHEN 40 THEN 'CSTRING'
+					WHEN 11 THEN 'D_FLOAT'
+					WHEN 27 THEN 'DOUBLE'
+					WHEN 10 THEN 'FLOAT'
+					WHEN 16 THEN 'INT64'
+					WHEN 8 THEN 'INTEGER'
+					WHEN 9 THEN 'QUAD'
+					WHEN 7 THEN 'SMALLINT'
+					WHEN 12 THEN 'DATE'
+					WHEN 13 THEN 'TIME'
+					WHEN 35 THEN 'TIMESTAMP'
+					WHEN 37 THEN 'VARCHAR'
+					ELSE 'UNKNOWN'
+				END AS FIELD_TYPE,
+				f.RDB\$FIELD_LENGTH AS FIELD_LENGTH,
+				p.RDB\$PARAMETER_NUMBER AS PARAMETER_NUMBER
+			FROM RDB\$PROCEDURE_PARAMETERS p
+				LEFT JOIN RDB\$FIELDS f ON f.RDB\$FIELD_NAME = p.RDB\$FIELD_SOURCE
+			ORDER BY p.RDB\$PARAMETER_TYPE, p.RDB\$PARAMETER_NUMBER;"
+		);
+		$procedures = array();
+		while ($row = $res->fetch(TRUE)) {
+			$key = $row['PROCEDURE_NAME'];
+			$io = trim($row['PARAMETER_TYPE']);
+			$num = $row['PARAMETER_NUMBER'];
+			$procedures[$key]['name'] = $row['PROCEDURE_NAME'];
+			$procedures[$key]['params'][$io][$num]['name'] = $row['PARAMETER_NAME'];
+			$procedures[$key]['params'][$io][$num]['type'] = trim($row['FIELD_TYPE']);
+			$procedures[$key]['params'][$io][$num]['size'] = $row['FIELD_LENGTH'];
+		}
+		return $procedures;
+	}
+
+
+
+	/**
+	 * Returns list of stored procedures.
+	 * @return array
+	 */
+	public function getProcedures()
+	{
+		$res = $this->query("
+			SELECT TRIM(RDB\$PROCEDURE_NAME)
+			FROM RDB\$PROCEDURES;"
+		);
+		$procedures = array();
+		while ($row = $res->fetch(FALSE)) {
+			$procedures[] = $row[0];
+		}
+		return $procedures;
+	}
+
+
+
+	/**
+	 * Returns list of generators.
+	 * @return array
+	 */
+	public function getGenerators()
+	{
+		$res = $this->query("
+			SELECT TRIM(RDB\$GENERATOR_NAME)
+			FROM RDB\$GENERATORS
+			WHERE RDB\$SYSTEM_FLAG = 0;"
+		);
+		$generators = array();
+		while ($row = $res->fetch(FALSE)) {
+			$generators[] = $row[0];
+		}
+		return $generators;
+	}
+
+
+
+	/**
+	 * Returns list of user defined functions (UDF).
+	 * @return array
+	 */
+	public function getFunctions()
+	{
+		$res = $this->query("
+			SELECT TRIM(RDB\$FUNCTION_NAME)
+			FROM RDB\$FUNCTIONS
+			WHERE RDB\$SYSTEM_FLAG = 0;"
+		);
+		$functions = array();
+		while ($row = $res->fetch(FALSE)) {
+			$functions[] = $row[0];
+		}
+		return $functions;
+	}
+
+}
+
+
+
+
+/**
+ * Database procedure exception.
+ *
+ * @author     Roman Sklenář
+ * @copyright  Copyright (c) 2010
+ * @package    dibi\drivers
+ */
+class DibiProcedureException extends DibiException
+{
+	/** @var string */
+	protected $severity;
+
+
+	/**
+	 * Construct the exception.
+	 * @param  string  Message describing the exception
+	 * @param  int     Some code
+	 * @param  string SQL command
+	 */
+	public function __construct($message = NULL, $code = 0, $severity = NULL, $sql = NULL)
+	{
+		parent::__construct($message, (int) $code, $sql);
+		$this->severity = $severity;
+	}
+
+
+
+	/**
+	 * Gets the exception severity.
+	 * @return string
+	 */
+	public function getSeverity()
+	{
+		$this->severity;
+	}
+
+}

dibi/drivers/mssql.php

@@ -1,58 +1,51 @@
 <?php
 
 /**
- * dibi - tiny'n'smart database abstraction layer
- * ----------------------------------------------
+ * This file is part of the "dibi" - smart database abstraction layer.
  *
- * Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
  *
- * This source file is subject to the "dibi license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://dibiphp.com
- *
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @license    http://dibiphp.com/license  dibi license
- * @link       http://dibiphp.com
- * @package    dibi
- * @version    $Id$
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
  */
 
+require_once dirname(__FILE__) . '/mssql.reflector.php';
 
 /**
  * The dibi driver for MS SQL database.
  *
- * Connection options:
- *   - 'host' - the MS SQL server host name. It can also include a port number (hostname:port)
- *   - 'username' (or 'user')
- *   - 'password' (or 'pass')
- *   - 'persistent' - try to find a persistent link?
- *   - 'database' - the database name to select
- *   - 'lazy' - if TRUE, connection will be established only when required
+ * Driver options:
+ *   - host => the MS SQL server host name. It can also include a port number (hostname:port)
+ *   - username (or user)
+ *   - password (or pass)
+ *   - database => the database name to select
+ *   - persistent (bool) => try to find a persistent link?
+ *   - resource (resource) => existing connection resource
+ *   - lazy, profiler, result, substitutes, ... => see DibiConnection options
  *
  * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @package    dibi
+ * @package    dibi\drivers
  */
-class DibiMsSqlDriver extends DibiObject implements IDibiDriver
+class DibiMsSqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriver
 {
-
 	/** @var resource  Connection resource */
 	private $connection;
 
-
 	/** @var resource  Resultset resource */
 	private $resultSet;
 
+	/** @var bool */
+	private $autoFree = TRUE;
+
 
 
 	/**
-	 * @throws DibiException
+	 * @throws DibiNotSupportedException
 	 */
 	public function __construct()
 	{
 		if (!extension_loaded('mssql')) {
-			throw new DibiDriverException("PHP extension 'mssql' is not loaded.");
+			throw new DibiNotSupportedException("PHP extension 'mssql' is not loaded.");
 		}
 	}
 
@@ -65,11 +58,9 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver
 	 */
 	public function connect(array &$config)
 	{
-		DibiConnection::alias($config, 'username', 'user');
-		DibiConnection::alias($config, 'password', 'pass');
-		DibiConnection::alias($config, 'host', 'hostname');
-
-		if (empty($config['persistent'])) {
+		if (isset($config['resource'])) {
+			$this->connection = $config['resource'];
+		} elseif (empty($config['persistent'])) {
 			$this->connection = @mssql_connect($config['host'], $config['username'], $config['password'], TRUE); // intentionally @
 		} else {
 			$this->connection = @mssql_pconnect($config['host'], $config['username'], $config['password']); // intentionally @
@@ -79,7 +70,7 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver
 			throw new DibiDriverException("Can't connect to DB.");
 		}
 
-		if (isset($config['database']) && !@mssql_select_db($config['database'], $this->connection)) { // intentionally @
+		if (isset($config['database']) && !@mssql_select_db($this->escape($config['database'], dibi::IDENTIFIER), $this->connection)) { // intentionally @
 			throw new DibiDriverException("Can't select DB '$config[database]'.");
 		}
 	}
@@ -100,18 +91,19 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver
 	/**
 	 * Executes the SQL query.
 	 * @param  string      SQL statement.
-	 * @return IDibiDriver|NULL
+	 * @return IDibiResultDriver|NULL
 	 * @throws DibiDriverException
 	 */
 	public function query($sql)
 	{
-		$this->resultSet = @mssql_query($sql, $this->connection); // intentionally @
+		$res = @mssql_query($sql, $this->connection); // intentionally @
 
-		if ($this->resultSet === FALSE) {
-			throw new DibiDriverException('Query error', 0, $sql);
+		if ($res === FALSE) {
+			throw new DibiDriverException(mssql_get_last_message(), 0, $sql);
+
+		} elseif (is_resource($res)) {
+			return $this->createResultDriver($res);
 		}
-
-		return is_resource($this->resultSet) ? clone $this : NULL;
 	}
 
 
@@ -120,7 +112,7 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver
 	 * Gets the number of affected rows by the last INSERT, UPDATE or DELETE query.
 	 * @return int|FALSE  number of rows or FALSE on error
 	 */
-	public function affectedRows()
+	public function getAffectedRows()
 	{
 		return mssql_rows_affected($this->connection);
 	}
@@ -131,19 +123,25 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver
 	 * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query.
 	 * @return int|FALSE  int on success or FALSE on failure
 	 */
-	public function insertId($sequence)
+	public function getInsertId($sequence)
 	{
-		throw new NotSupportedException('MS SQL does not support autoincrementing.');
+		$res = mssql_query('SELECT @@IDENTITY', $this->connection);
+		if (is_resource($res)) {
+			$row = mssql_fetch_row($res);
+			return $row[0];
+		}
+		return FALSE;
 	}
 
 
 
 	/**
 	 * Begins a transaction (if supported).
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function begin()
+	public function begin($savepoint = NULL)
 	{
 		$this->query('BEGIN TRANSACTION');
 	}
@@ -152,10 +150,11 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver
 
 	/**
 	 * Commits statements in a transaction.
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function commit()
+	public function commit($savepoint = NULL)
 	{
 		$this->query('COMMIT');
 	}
@@ -164,10 +163,11 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver
 
 	/**
 	 * Rollback changes in a transaction.
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function rollback()
+	public function rollback($savepoint = NULL)
 	{
 		$this->query('ROLLBACK');
 	}
@@ -180,7 +180,32 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getResource()
 	{
-		return $this->connection;
+		return is_resource($this->connection) ? $this->connection : NULL;
+	}
+
+
+
+	/**
+	 * Returns the connection reflector.
+	 * @return IDibiReflector
+	 */
+	public function getReflector()
+	{
+		return new DibiMsSqlReflector($this);
+	}
+
+
+
+	/**
+	 * Result set driver factory.
+	 * @param  resource
+	 * @return IDibiResultDriver
+	 */
+	public function createResultDriver($resource)
+	{
+		$res = clone $this;
+		$res->resultSet = $resource;
+		return $res;
 	}
 
 
@@ -190,32 +215,31 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver
 
 
 	/**
-	 * Encodes data for use in an SQL statement.
-	 * @param  string    value
-	 * @param  string    type (dibi::FIELD_TEXT, dibi::FIELD_BOOL, ...)
+	 * Encodes data for use in a SQL statement.
+	 * @param  mixed     value
+	 * @param  string    type (dibi::TEXT, dibi::BOOL, ...)
 	 * @return string    encoded value
 	 * @throws InvalidArgumentException
 	 */
 	public function escape($value, $type)
 	{
 		switch ($type) {
-		case dibi::FIELD_TEXT:
-		case dibi::FIELD_BINARY:
+		case dibi::TEXT:
+		case dibi::BINARY:
 			return "'" . str_replace("'", "''", $value) . "'";
 
 		case dibi::IDENTIFIER:
 			// @see http://msdn.microsoft.com/en-us/library/ms176027.aspx
-			$value = str_replace(array('[', ']'), array('[[', ']]'), $value);
-			return '[' . str_replace('.', '].[', $value) . ']';
+			return '[' . str_replace(array('[', ']'), array('[[', ']]'), $value) . ']';
 
-		case dibi::FIELD_BOOL:
-			return $value ? -1 : 0;
+		case dibi::BOOL:
+			return $value ? 1 : 0;
 
-		case dibi::FIELD_DATE:
-			return date("'Y-m-d'", $value);
+		case dibi::DATE:
+			return $value instanceof DateTime ? $value->format("'Y-m-d'") : date("'Y-m-d'", $value);
 
-		case dibi::FIELD_DATETIME:
-			return date("'Y-m-d H:i:s'", $value);
+		case dibi::DATETIME:
+			return $value instanceof DateTime ? $value->format("'Y-m-d H:i:s'") : date("'Y-m-d H:i:s'", $value);
 
 		default:
 			throw new InvalidArgumentException('Unsupported type.');
@@ -224,15 +248,32 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver
 
 
 
+	/**
+	 * Encodes string for use in a LIKE statement.
+	 * @param  string
+	 * @param  int
+	 * @return string
+	 */
+	public function escapeLike($value, $pos)
+	{
+		$value = strtr($value, array("'" => "''", '%' => '[%]', '_' => '[_]', '[' => '[[]'));
+		return ($pos <= 0 ? "'%" : "'") . $value . ($pos >= 0 ? "%'" : "'");
+	}
+
+
+
 	/**
 	 * Decodes data from result set.
 	 * @param  string    value
-	 * @param  string    type (dibi::FIELD_BINARY)
+	 * @param  string    type (dibi::BINARY)
 	 * @return string    decoded value
 	 * @throws InvalidArgumentException
 	 */
 	public function unescape($value, $type)
 	{
+		if ($type === dibi::BINARY) {
+			return $value;
+		}
 		throw new InvalidArgumentException('Unsupported type.');
 	}
 
@@ -247,13 +288,13 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver
 	 */
 	public function applyLimit(&$sql, $limit, $offset)
 	{
-		// offset suppot is missing...
+		// offset support is missing
 		if ($limit >= 0) {
-			$sql = 'SELECT TOP ' . (int) $limit . ' * FROM (' . $sql . ')';
+			$sql = 'SELECT TOP ' . (int) $limit . ' * FROM (' . $sql . ') t';
 		}
 
 		if ($offset) {
-			throw new NotImplementedException('Offset is not implemented.');
+			throw new DibiNotImplementedException('Offset is not implemented.');
 		}
 	}
 
@@ -263,11 +304,22 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver
 
 
 
+	/**
+	 * Automatically frees the resources allocated for this result set.
+	 * @return void
+	 */
+	public function __destruct()
+	{
+		$this->autoFree && $this->getResultResource() && $this->free();
+	}
+
+
+
 	/**
 	 * Returns the number of rows in a result set.
 	 * @return int
 	 */
-	public function rowCount()
+	public function getRowCount()
 	{
 		return mssql_num_rows($this->resultSet);
 	}
@@ -278,7 +330,6 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver
 	 * Fetches the row at current position and moves the internal cursor to the next position.
 	 * @param  bool     TRUE for associative array, FALSE for numeric
 	 * @return array    array on success, nonarray if no next record
-	 * @internal
 	 */
 	public function fetch($assoc)
 	{
@@ -291,7 +342,6 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver
 	 * Moves cursor position without fetching row.
 	 * @param  int      the 0-based cursor pos to seek to
 	 * @return boolean  TRUE on success, FALSE if unable to seek to specified record
-	 * @throws DibiException
 	 */
 	public function seek($row)
 	{
@@ -316,20 +366,20 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver
 	 * Returns metadata for all columns in a result set.
 	 * @return array
 	 */
-	public function getColumnsMeta()
+	public function getResultColumns()
 	{
 		$count = mssql_num_fields($this->resultSet);
-		$res = array();
+		$columns = array();
 		for ($i = 0; $i < $count; $i++) {
 			$row = (array) mssql_fetch_field($this->resultSet, $i);
-			$res[] = array(
+			$columns[] = array(
 				'name' => $row['name'],
 				'fullname' => $row['column_source'] ? $row['column_source'] . '.' . $row['name'] : $row['name'],
 				'table' => $row['column_source'],
 				'nativetype' => $row['type'],
 			);
 		}
-		return $res;
+		return $columns;
 	}
 
 
@@ -340,58 +390,9 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getResultResource()
 	{
-		return $this->resultSet;
+		$this->autoFree = FALSE;
+		return is_resource($this->resultSet) ? $this->resultSet : NULL;
 	}
 
 
-
-	/********************* reflection ****************d*g**/
-
-
-
-	/**
-	 * Returns list of tables.
-	 * @return array
-	 */
-	public function getTables()
-	{
-		throw new NotImplementedException;
-	}
-
-
-
-	/**
-	 * Returns metadata for all columns in a table.
-	 * @param  string
-	 * @return array
-	 */
-	public function getColumns($table)
-	{
-		throw new NotImplementedException;
-	}
-
-
-
-	/**
-	 * Returns metadata for all indexes in a table.
-	 * @param  string
-	 * @return array
-	 */
-	public function getIndexes($table)
-	{
-		throw new NotImplementedException;
-	}
-
-
-
-	/**
-	 * Returns metadata for all foreign keys in a table.
-	 * @param  string
-	 * @return array
-	 */
-	public function getForeignKeys($table)
-	{
-		throw new NotImplementedException;
-	}
-
 }

dibi/drivers/mssql.reflector.php

@@ -0,0 +1,225 @@
+<?php
+
+/**
+ * This file is part of the "dibi" - smart database abstraction layer.
+ *
+ * Copyright (c) 2005, 2010 David Grudl (http://davidgrudl.com)
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
+ *
+ * @package    dibi\drivers
+ */
+
+
+/**
+ * The dibi reflector for MsSQL databases.
+ *
+ * @author     Steven Bredenberg
+ * @package    dibi\drivers
+ * @internal
+ */
+class DibiMsSqlReflector extends DibiObject implements IDibiReflector
+{
+	/** @var IDibiDriver */
+	private $driver;
+
+
+
+	public function __construct(IDibiDriver $driver)
+	{
+		$this->driver = $driver;
+	}
+
+
+
+	/**
+	 * Returns list of tables.
+	 * @return array
+	 */
+	public function getTables()
+	{
+		$res = $this->driver->query("
+			SELECT TABLE_NAME, TABLE_TYPE
+			FROM INFORMATION_SCHEMA.TABLES
+		");
+		$tables = array();
+		while ($row = $res->fetch(FALSE)) {
+			$tables[] = array(
+				'name' => $row[0],
+				'view' => isset($row[1]) && $row[1] === 'VIEW',
+			);
+		}
+		return $tables;
+	}
+
+
+
+	/**
+	 * Returns count of rows in a table
+	 * @param  string
+	 * @return integer
+	 */
+	public function getTableCount($table, $fallback=true)
+	{
+		if (empty($table)) {
+			return false;
+		}
+		$result = $this->driver->query("
+			SELECT MAX(rowcnt)
+			FROM sys.sysindexes
+			WHERE id=OBJECT_ID({$this->driver->escape($table, dibi::IDENTIFIER)})
+		");
+		$row = $result->fetch(FALSE);
+
+		if (!is_array($row) || count($row) < 1) {
+			if ($fallback) {
+				$row = $this->driver->query("SELECT COUNT(*) FROM {$this->driver->escape($table, dibi::IDENTIFIER)}")->fetch(FALSE);
+				$count = intval($row[0]);
+			} else {
+				$count = false;
+			}
+		} else {
+			$count = intval($row[0]);
+		}
+
+		return $count;
+	}
+
+
+
+	/**
+	 * Returns metadata for all columns in a table.
+	 * @param  string
+	 * @return array
+	 */
+	public function getColumns($table)
+	{
+		$res = $this->driver->query("
+			SELECT * FROM
+			INFORMATION_SCHEMA.COLUMNS
+			WHERE TABLE_NAME = {$this->driver->escape($table, dibi::TEXT)}
+			ORDER BY TABLE_NAME, ORDINAL_POSITION
+		");
+		$columns = array();
+		while ($row = $res->fetch(TRUE)) {
+			$size = false;
+			$type = strtoupper($row['DATA_TYPE']);
+
+			$size_cols = array(
+				'DATETIME'=>'DATETIME_PRECISION',
+				'DECIMAL'=>'NUMERIC_PRECISION',
+				'CHAR'=>'CHARACTER_MAXIMUM_LENGTH',
+				'NCHAR'=>'CHARACTER_OCTET_LENGTH',
+				'NVARCHAR'=>'CHARACTER_OCTET_LENGTH',
+				'VARCHAR'=>'CHARACTER_OCTET_LENGTH'
+			);
+
+			if (isset($size_cols[$type])) {
+				if ($size_cols[$type]) {
+					$size = $row[$size_cols[$type]];
+				}
+			}
+
+			$columns[] = array(
+				'name' => $row['COLUMN_NAME'],
+				'table' => $table,
+				'nativetype' => $type,
+				'size' => $size,
+				'unsigned' => NULL,
+				'nullable' => $row['IS_NULLABLE'] === 'YES',
+				'default' => $row['COLUMN_DEFAULT'],
+				'autoincrement' => false,
+				'vendor' => $row,
+			);
+		}
+
+		return $columns;
+	}
+
+
+
+	/**
+	 * Returns metadata for all indexes in a table.
+	 * @param  string
+	 * @return array
+	 */
+	public function getIndexes($table)
+	{
+		$res = $this->driver->query(
+			"SELECT ind.name index_name, ind.index_id, ic.index_column_id,
+					col.name column_name, ind.is_unique, ind.is_primary_key
+			FROM sys.indexes ind
+			INNER JOIN sys.index_columns ic ON
+				(ind.object_id = ic.object_id AND ind.index_id = ic.index_id)
+			INNER JOIN sys.columns col ON
+				(ic.object_id = col.object_id and ic.column_id = col.column_id)
+			INNER JOIN sys.tables t ON
+				(ind.object_id = t.object_id)
+			WHERE t.name = {$this->driver->escape($table, dibi::TEXT)}
+				AND t.is_ms_shipped = 0
+			ORDER BY
+				t.name, ind.name, ind.index_id, ic.index_column_id
+		");
+
+		$indexes = array();
+		while ($row = $res->fetch(TRUE)) {
+			$index_name = $row['index_name'];
+
+			if (!isset($indexes[$index_name])) {
+				$indexes[$index_name] = array();
+				$indexes[$index_name]['name'] = $index_name;
+				$indexes[$index_name]['unique'] = (bool)$row['is_unique'];
+				$indexes[$index_name]['primary'] = (bool)$row['is_primary_key'];
+				$indexes[$index_name]['columns'] = array();
+			}
+			$indexes[$index_name]['columns'][] = $row['column_name'];
+		}
+
+		return array_values($indexes);
+	}
+
+
+
+	/**
+	 * Returns metadata for all foreign keys in a table.
+	 * @param  string
+	 * @return array
+	 */
+	public function getForeignKeys($table)
+	{
+		$res = $this->driver->query("
+			SELECT f.name AS foreign_key,
+			OBJECT_NAME(f.parent_object_id) AS table_name,
+			COL_NAME(fc.parent_object_id,
+			fc.parent_column_id) AS column_name,
+			OBJECT_NAME (f.referenced_object_id) AS reference_table_name,
+			COL_NAME(fc.referenced_object_id,
+			fc.referenced_column_id) AS reference_column_name,
+			fc.*
+			FROM sys.foreign_keys AS f
+			INNER JOIN sys.foreign_key_columns AS fc
+			ON f.OBJECT_ID = fc.constraint_object_id
+			WHERE OBJECT_NAME(f.parent_object_id) = {$this->driver->escape($table, dibi::TEXT)}
+		");
+
+		$keys = array();
+		while ($row = $res->fetch(TRUE)) {
+			$key_name = $row['foreign_key'];
+
+			if (!isset($keys[$key_name])) {
+				$keys[$key_name]['name'] = $row['foreign_key']; // foreign key name
+				$keys[$key_name]['local'] = array($row['column_name']); // local columns
+				$keys[$key_name]['table'] = $row['reference_table_name']; // referenced table
+				$keys[$key_name]['foreign'] = array($row['reference_column_name']); // referenced columns
+				$keys[$key_name]['onDelete'] = false;
+				$keys[$key_name]['onUpdate'] = false;
+			} else {
+				$keys[$key_name]['local'][] = $row['column_name']; // local columns
+				$keys[$key_name]['foreign'][] = $row['reference_column_name']; // referenced columns
+			}
+		}
+		return array_values($keys);
+	}
+
+}

dibi/drivers/mssql2005.php

@@ -0,0 +1,401 @@
+<?php
+
+/**
+ * This file is part of the "dibi" - smart database abstraction layer.
+ *
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
+ */
+
+
+/**
+ * The dibi driver for MS SQL Driver 2005 database.
+ *
+ * Driver options:
+ *   - host => the MS SQL server host name. It can also include a port number (hostname:port)
+ *   - username (or user)
+ *   - password (or pass)
+ *   - database => the database name to select
+ *   - options (array) => connection options {@link http://msdn.microsoft.com/en-us/library/cc296161(SQL.90).aspx}
+ *   - charset => character encoding to set (default is UTF-8)
+ *   - resource (resource) => existing connection resource
+ *   - lazy, profiler, result, substitutes, ... => see DibiConnection options
+ *
+ * @author     David Grudl
+ * @package    dibi\drivers
+ */
+class DibiMsSql2005Driver extends DibiObject implements IDibiDriver, IDibiResultDriver
+{
+	/** @var resource  Connection resource */
+	private $connection;
+
+	/** @var resource  Resultset resource */
+	private $resultSet;
+
+	/** @var bool */
+	private $autoFree = TRUE;
+
+	/** @var int|FALSE  Affected rows */
+	private $affectedRows = FALSE;
+
+
+
+	/**
+	 * @throws DibiNotSupportedException
+	 */
+	public function __construct()
+	{
+		if (!extension_loaded('sqlsrv')) {
+			throw new DibiNotSupportedException("PHP extension 'sqlsrv' is not loaded.");
+		}
+	}
+
+
+
+	/**
+	 * Connects to a database.
+	 * @return void
+	 * @throws DibiException
+	 */
+	public function connect(array &$config)
+	{
+		DibiConnection::alias($config, 'options|UID', 'username');
+		DibiConnection::alias($config, 'options|PWD', 'password');
+		DibiConnection::alias($config, 'options|Database', 'database');
+		DibiConnection::alias($config, 'options|CharacterSet', 'charset');
+
+		if (isset($config['resource'])) {
+			$this->connection = $config['resource'];
+
+		} else {
+			$this->connection = sqlsrv_connect($config['host'], (array) $config['options']);
+		}
+
+		if (!is_resource($this->connection)) {
+			$info = sqlsrv_errors();
+			throw new DibiDriverException($info[0]['message'], $info[0]['code']);
+		}
+	}
+
+
+
+	/**
+	 * Disconnects from a database.
+	 * @return void
+	 */
+	public function disconnect()
+	{
+		sqlsrv_close($this->connection);
+	}
+
+
+
+	/**
+	 * Executes the SQL query.
+	 * @param  string      SQL statement.
+	 * @return IDibiResultDriver|NULL
+	 * @throws DibiDriverException
+	 */
+	public function query($sql)
+	{
+		$this->affectedRows = FALSE;
+		$res = sqlsrv_query($this->connection, $sql);
+
+		if ($res === FALSE) {
+			$info = sqlsrv_errors();
+			throw new DibiDriverException($info[0]['message'], $info[0]['code'], $sql);
+
+		} elseif (is_resource($res)) {
+			$this->affectedRows = sqlsrv_rows_affected($res);
+			return $this->createResultDriver($res);
+		}
+	}
+
+
+
+	/**
+	 * Gets the number of affected rows by the last INSERT, UPDATE or DELETE query.
+	 * @return int|FALSE  number of rows or FALSE on error
+	 */
+	public function getAffectedRows()
+	{
+		return $this->affectedRows;
+	}
+
+
+
+	/**
+	 * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query.
+	 * @return int|FALSE  int on success or FALSE on failure
+	 */
+	public function getInsertId($sequence)
+	{
+		$res = sqlsrv_query($this->connection, 'SELECT @@IDENTITY');
+		if (is_resource($res)) {
+			$row = sqlsrv_fetch_array($res, SQLSRV_FETCH_NUMERIC);
+			return $row[0];
+		}
+		return FALSE;
+	}
+
+
+
+	/**
+	 * Begins a transaction (if supported).
+	 * @param  string  optional savepoint name
+	 * @return void
+	 * @throws DibiDriverException
+	 */
+	public function begin($savepoint = NULL)
+	{
+		sqlsrv_begin_transaction($this->connection);
+	}
+
+
+
+	/**
+	 * Commits statements in a transaction.
+	 * @param  string  optional savepoint name
+	 * @return void
+	 * @throws DibiDriverException
+	 */
+	public function commit($savepoint = NULL)
+	{
+		sqlsrv_commit($this->connection);
+	}
+
+
+
+	/**
+	 * Rollback changes in a transaction.
+	 * @param  string  optional savepoint name
+	 * @return void
+	 * @throws DibiDriverException
+	 */
+	public function rollback($savepoint = NULL)
+	{
+		sqlsrv_rollback($this->connection);
+	}
+
+
+
+	/**
+	 * Returns the connection resource.
+	 * @return mixed
+	 */
+	public function getResource()
+	{
+		return is_resource($this->connection) ? $this->connection : NULL;
+	}
+
+
+
+	/**
+	 * Returns the connection reflector.
+	 * @return IDibiReflector
+	 */
+	public function getReflector()
+	{
+		throw new DibiNotSupportedException;
+	}
+
+
+
+	/**
+	 * Result set driver factory.
+	 * @param  resource
+	 * @return IDibiResultDriver
+	 */
+	public function createResultDriver($resource)
+	{
+		$res = clone $this;
+		$res->resultSet = $resource;
+		return $res;
+	}
+
+
+
+	/********************* SQL ****************d*g**/
+
+
+
+	/**
+	 * Encodes data for use in a SQL statement.
+	 * @param  mixed     value
+	 * @param  string    type (dibi::TEXT, dibi::BOOL, ...)
+	 * @return string    encoded value
+	 * @throws InvalidArgumentException
+	 */
+	public function escape($value, $type)
+	{
+		switch ($type) {
+		case dibi::TEXT:
+		case dibi::BINARY:
+			return "'" . str_replace("'", "''", $value) . "'";
+
+		case dibi::IDENTIFIER:
+			// @see http://msdn.microsoft.com/en-us/library/ms176027.aspx
+			return '[' . str_replace(array('[', ']'), array('[[', ']]'), $value) . ']';
+
+		case dibi::BOOL:
+			return $value ? 1 : 0;
+
+		case dibi::DATE:
+			return $value instanceof DateTime ? $value->format("'Y-m-d'") : date("'Y-m-d'", $value);
+
+		case dibi::DATETIME:
+			return $value instanceof DateTime ? $value->format("'Y-m-d H:i:s'") : date("'Y-m-d H:i:s'", $value);
+
+		default:
+			throw new InvalidArgumentException('Unsupported type.');
+		}
+	}
+
+
+
+	/**
+	 * Encodes string for use in a LIKE statement.
+	 * @param  string
+	 * @param  int
+	 * @return string
+	 */
+	public function escapeLike($value, $pos)
+	{
+		$value = strtr($value, array("'" => "''", '%' => '[%]', '_' => '[_]', '[' => '[[]'));
+		return ($pos <= 0 ? "'%" : "'") . $value . ($pos >= 0 ? "%'" : "'");
+	}
+
+
+
+	/**
+	 * Decodes data from result set.
+	 * @param  string    value
+	 * @param  string    type (dibi::BINARY)
+	 * @return string    decoded value
+	 * @throws InvalidArgumentException
+	 */
+	public function unescape($value, $type)
+	{
+		if ($type === dibi::BINARY) {
+			return $value;
+		}
+		throw new InvalidArgumentException('Unsupported type.');
+	}
+
+
+
+	/**
+	 * Injects LIMIT/OFFSET to the SQL query.
+	 * @param  string &$sql  The SQL query that will be modified.
+	 * @param  int $limit
+	 * @param  int $offset
+	 * @return void
+	 */
+	public function applyLimit(&$sql, $limit, $offset)
+	{
+		// offset support is missing
+		if ($limit >= 0) {
+			$sql = 'SELECT TOP ' . (int) $limit . ' * FROM (' . $sql . ')';
+		}
+
+		if ($offset) {
+			throw new DibiNotImplementedException('Offset is not implemented.');
+		}
+	}
+
+
+
+	/********************* result set ****************d*g**/
+
+
+
+	/**
+	 * Automatically frees the resources allocated for this result set.
+	 * @return void
+	 */
+	public function __destruct()
+	{
+		$this->autoFree && $this->getResultResource() && $this->free();
+	}
+
+
+
+	/**
+	 * Returns the number of rows in a result set.
+	 * @return int
+	 */
+	public function getRowCount()
+	{
+		throw new DibiNotSupportedException('Row count is not available for unbuffered queries.');
+	}
+
+
+
+	/**
+	 * Fetches the row at current position and moves the internal cursor to the next position.
+	 * @param  bool     TRUE for associative array, FALSE for numeric
+	 * @return array    array on success, nonarray if no next record
+	 */
+	public function fetch($assoc)
+	{
+		return sqlsrv_fetch_array($this->resultSet, $assoc ? SQLSRV_FETCH_ASSOC : SQLSRV_FETCH_NUMERIC);
+	}
+
+
+
+	/**
+	 * Moves cursor position without fetching row.
+	 * @param  int      the 0-based cursor pos to seek to
+	 * @return boolean  TRUE on success, FALSE if unable to seek to specified record
+	 */
+	public function seek($row)
+	{
+		throw new DibiNotSupportedException('Cannot seek an unbuffered result set.');
+	}
+
+
+
+	/**
+	 * Frees the resources allocated for this result set.
+	 * @return void
+	 */
+	public function free()
+	{
+		sqlsrv_free_stmt($this->resultSet);
+		$this->resultSet = NULL;
+	}
+
+
+
+	/**
+	 * Returns metadata for all columns in a result set.
+	 * @return array
+	 */
+	public function getResultColumns()
+	{
+		$columns = array();
+		foreach ((array) sqlsrv_field_metadata($this->resultSet) as $fieldMetadata) {
+			$columns[] = array(
+				'name' => $fieldMetadata['Name'],
+				'fullname' => $fieldMetadata['Name'],
+				'nativetype' => $fieldMetadata['Type'],
+			);
+		}
+		return $columns;
+	}
+
+
+
+	/**
+	 * Returns the result set resource.
+	 * @return mixed
+	 */
+	public function getResultResource()
+	{
+		$this->autoFree = FALSE;
+		return is_resource($this->resultSet) ? $this->resultSet : NULL;
+	}
+
+}

dibi/drivers/mysql.php

@@ -1,55 +1,53 @@
 <?php
 
 /**
- * dibi - tiny'n'smart database abstraction layer
- * ----------------------------------------------
+ * This file is part of the "dibi" - smart database abstraction layer.
  *
- * Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
  *
- * This source file is subject to the "dibi license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://dibiphp.com
- *
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @license    http://dibiphp.com/license  dibi license
- * @link       http://dibiphp.com
- * @package    dibi
- * @version    $Id$
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
  */
 
 
+require_once dirname(__FILE__) . '/mysql.reflector.php';
+
+
 /**
  * The dibi driver for MySQL database.
  *
- * Connection options:
- *   - 'host' - the MySQL server host name
- *   - 'port' - the port number to attempt to connect to the MySQL server
- *   - 'socket' - the socket or named pipe
- *   - 'username' (or 'user')
- *   - 'password' (or 'pass')
- *   - 'persistent' - try to find a persistent link?
- *   - 'database' - the database name to select
- *   - 'charset' - character encoding to set
- *   - 'unbuffered' - sends query without fetching and buffering the result rows automatically?
- *   - 'options' - driver specific constants (MYSQL_*)
- *   - 'sqlmode' - see http://dev.mysql.com/doc/refman/5.0/en/server-sql-mode.html
- *   - 'lazy' - if TRUE, connection will be established only when required
+ * Driver options:
+ *   - host => the MySQL server host name
+ *   - port (int) => the port number to attempt to connect to the MySQL server
+ *   - socket => the socket or named pipe
+ *   - username (or user)
+ *   - password (or pass)
+ *   - database => the database name to select
+ *   - flags (int) => driver specific constants (MYSQL_CLIENT_*)
+ *   - charset => character encoding to set (default is utf8)
+ *   - persistent (bool) => try to find a persistent link?
+ *   - unbuffered (bool) => sends query without fetching and buffering the result rows automatically?
+ *   - sqlmode => see http://dev.mysql.com/doc/refman/5.0/en/server-sql-mode.html
+ *   - resource (resource) => existing connection resource
+ *   - lazy, profiler, result, substitutes, ... => see DibiConnection options
  *
  * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @package    dibi
+ * @package    dibi\drivers
  */
-class DibiMySqlDriver extends DibiObject implements IDibiDriver
+class DibiMySqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriver
 {
+	const ERROR_ACCESS_DENIED = 1045;
+	const ERROR_DUPLICATE_ENTRY = 1062;
+	const ERROR_DATA_TRUNCATED = 1265;
 
 	/** @var resource  Connection resource */
 	private $connection;
 
-
 	/** @var resource  Resultset resource */
 	private $resultSet;
 
+	/** @var bool */
+	private $autoFree = TRUE;
 
 	/** @var bool  Is buffered (seekable and countable)? */
 	private $buffered;
@@ -57,12 +55,12 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver
 
 
 	/**
-	 * @throws DibiException
+	 * @throws DibiNotSupportedException
 	 */
 	public function __construct()
 	{
 		if (!extension_loaded('mysql')) {
-			throw new DibiDriverException("PHP extension 'mysql' is not loaded.");
+			throw new DibiNotSupportedException("PHP extension 'mysql' is not loaded.");
 		}
 	}
 
@@ -75,35 +73,37 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver
 	 */
 	public function connect(array &$config)
 	{
-		DibiConnection::alias($config, 'username', 'user');
-		DibiConnection::alias($config, 'password', 'pass');
-		DibiConnection::alias($config, 'host', 'hostname');
-		DibiConnection::alias($config, 'options');
+		if (isset($config['resource'])) {
+			$this->connection = $config['resource'];
 
-		// default values
-		if (!isset($config['username'])) $config['username'] = ini_get('mysql.default_user');
-		if (!isset($config['password'])) $config['password'] = ini_get('mysql.default_password');
-		if (!isset($config['host'])) {
-			$host = ini_get('mysql.default_host');
-			if ($host) {
-				$config['host'] = $host;
-				$config['port'] = ini_get('mysql.default_port');
-			} else {
-				if (!isset($config['socket'])) $config['socket'] = ini_get('mysql.default_socket');
-				$config['host'] = NULL;
+		} else {
+			// default values
+			DibiConnection::alias($config, 'flags', 'options');
+			if (!isset($config['charset'])) $config['charset'] = 'utf8';
+			if (!isset($config['username'])) $config['username'] = ini_get('mysql.default_user');
+			if (!isset($config['password'])) $config['password'] = ini_get('mysql.default_password');
+			if (!isset($config['host'])) {
+				$host = ini_get('mysql.default_host');
+				if ($host) {
+					$config['host'] = $host;
+					$config['port'] = ini_get('mysql.default_port');
+				} else {
+					if (!isset($config['socket'])) $config['socket'] = ini_get('mysql.default_socket');
+					$config['host'] = NULL;
+				}
 			}
-		}
 
-		if (empty($config['socket'])) {
-			$host = $config['host'] . (empty($config['port']) ? '' : ':' . $config['port']);
-		} else {
-			$host = ':' . $config['socket'];
-		}
+			if (empty($config['socket'])) {
+				$host = $config['host'] . (empty($config['port']) ? '' : ':' . $config['port']);
+			} else {
+				$host = ':' . $config['socket'];
+			}
 
-		if (empty($config['persistent'])) {
-			$this->connection = @mysql_connect($host, $config['username'], $config['password'], TRUE, $config['options']); // intentionally @
-		} else {
-			$this->connection = @mysql_pconnect($host, $config['username'], $config['password'], $config['options']); // intentionally @
+			if (empty($config['persistent'])) {
+				$this->connection = @mysql_connect($host, $config['username'], $config['password'], TRUE, $config['flags']); // intentionally @
+			} else {
+				$this->connection = @mysql_pconnect($host, $config['username'], $config['password'], $config['flags']); // intentionally @
+			}
 		}
 
 		if (!is_resource($this->connection)) {
@@ -117,10 +117,7 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver
 				$ok = @mysql_set_charset($config['charset'], $this->connection); // intentionally @
 			}
 			if (!$ok) {
-				$ok = @mysql_query("SET NAMES '$config[charset]'", $this->connection); // intentionally @
-				if (!$ok) {
-					throw new DibiDriverException(mysql_error($this->connection), mysql_errno($this->connection));
-				}
+				$this->query("SET NAMES '$config[charset]'");
 			}
 		}
 
@@ -131,11 +128,11 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver
 		}
 
 		if (isset($config['sqlmode'])) {
-			if (!@mysql_query("SET sql_mode='$config[sqlmode]'", $this->connection)) { // intentionally @
-				throw new DibiDriverException(mysql_error($this->connection), mysql_errno($this->connection));
-			}
+			$this->query("SET sql_mode='$config[sqlmode]'");
 		}
 
+		$this->query("SET time_zone='" . date('P') . "'");
+
 		$this->buffered = empty($config['unbuffered']);
 	}
 
@@ -155,22 +152,41 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver
 	/**
 	 * Executes the SQL query.
 	 * @param  string      SQL statement.
-	 * @return IDibiDriver|NULL
+	 * @return IDibiResultDriver|NULL
 	 * @throws DibiDriverException
 	 */
 	public function query($sql)
 	{
 		if ($this->buffered) {
-			$this->resultSet = @mysql_query($sql, $this->connection); // intentionally @
+			$res = @mysql_query($sql, $this->connection); // intentionally @
 		} else {
-			$this->resultSet = @mysql_unbuffered_query($sql, $this->connection); // intentionally @
+			$res = @mysql_unbuffered_query($sql, $this->connection); // intentionally @
 		}
 
 		if (mysql_errno($this->connection)) {
 			throw new DibiDriverException(mysql_error($this->connection), mysql_errno($this->connection), $sql);
-		}
 
-		return is_resource($this->resultSet) ? clone $this : NULL;
+		} elseif (is_resource($res)) {
+			return $this->createResultDriver($res);
+		}
+	}
+
+
+
+	/**
+	 * Retrieves information about the most recently executed query.
+	 * @return array
+	 */
+	public function getInfo()
+	{
+		$res = array();
+		preg_match_all('#(.+?): +(\d+) *#', mysql_info($this->connection), $matches, PREG_SET_ORDER);
+		if (preg_last_error()) throw new DibiPcreException;
+
+		foreach ($matches as $m) {
+			$res[$m[1]] = (int) $m[2];
+		}
+		return $res;
 	}
 
 
@@ -179,7 +195,7 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver
 	 * Gets the number of affected rows by the last INSERT, UPDATE or DELETE query.
 	 * @return int|FALSE  number of rows or FALSE on error
 	 */
-	public function affectedRows()
+	public function getAffectedRows()
 	{
 		return mysql_affected_rows($this->connection);
 	}
@@ -190,7 +206,7 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver
 	 * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query.
 	 * @return int|FALSE  int on success or FALSE on failure
 	 */
-	public function insertId($sequence)
+	public function getInsertId($sequence)
 	{
 		return mysql_insert_id($this->connection);
 	}
@@ -199,36 +215,39 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver
 
 	/**
 	 * Begins a transaction (if supported).
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function begin()
+	public function begin($savepoint = NULL)
 	{
-		$this->query('START TRANSACTION');
+		$this->query($savepoint ? "SAVEPOINT $savepoint" : 'START TRANSACTION');
 	}
 
 
 
 	/**
 	 * Commits statements in a transaction.
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function commit()
+	public function commit($savepoint = NULL)
 	{
-		$this->query('COMMIT');
+		$this->query($savepoint ? "RELEASE SAVEPOINT $savepoint" : 'COMMIT');
 	}
 
 
 
 	/**
 	 * Rollback changes in a transaction.
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function rollback()
+	public function rollback($savepoint = NULL)
 	{
-		$this->query('ROLLBACK');
+		$this->query($savepoint ? "ROLLBACK TO SAVEPOINT $savepoint" : 'ROLLBACK');
 	}
 
 
@@ -239,7 +258,32 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getResource()
 	{
-		return $this->connection;
+		return is_resource($this->connection) ? $this->connection : NULL;
+	}
+
+
+
+	/**
+	 * Returns the connection reflector.
+	 * @return IDibiReflector
+	 */
+	public function getReflector()
+	{
+		return new DibiMySqlReflector($this);
+	}
+
+
+
+	/**
+	 * Result set driver factory.
+	 * @param  resource
+	 * @return IDibiResultDriver
+	 */
+	public function createResultDriver($resource)
+	{
+		$res = clone $this;
+		$res->resultSet = $resource;
+		return $res;
 	}
 
 
@@ -249,32 +293,39 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver
 
 
 	/**
-	 * Encodes data for use in an SQL statement.
-	 * @param  string    value
-	 * @param  string    type (dibi::FIELD_TEXT, dibi::FIELD_BOOL, ...)
+	 * Encodes data for use in a SQL statement.
+	 * @param  mixed     value
+	 * @param  string    type (dibi::TEXT, dibi::BOOL, ...)
 	 * @return string    encoded value
 	 * @throws InvalidArgumentException
 	 */
 	public function escape($value, $type)
 	{
 		switch ($type) {
-		case dibi::FIELD_TEXT:
-		case dibi::FIELD_BINARY:
+		case dibi::TEXT:
+			if (!is_resource($this->connection)) {
+				throw new DibiException('Lost connection to server.');
+			}
 			return "'" . mysql_real_escape_string($value, $this->connection) . "'";
 
+		case dibi::BINARY:
+			if (!is_resource($this->connection)) {
+				throw new DibiException('Lost connection to server.');
+			}
+			return "_binary'" . mysql_real_escape_string($value, $this->connection) . "'";
+
 		case dibi::IDENTIFIER:
 			// @see http://dev.mysql.com/doc/refman/5.0/en/identifiers.html
-			$value = str_replace('`', '``', $value);
-			return '`' . str_replace('.', '`.`', $value) . '`';
+			return '`' . str_replace('`', '``', $value) . '`';
 
-		case dibi::FIELD_BOOL:
+		case dibi::BOOL:
 			return $value ? 1 : 0;
 
-		case dibi::FIELD_DATE:
-			return date("'Y-m-d'", $value);
+		case dibi::DATE:
+			return $value instanceof DateTime ? $value->format("'Y-m-d'") : date("'Y-m-d'", $value);
 
-		case dibi::FIELD_DATETIME:
-			return date("'Y-m-d H:i:s'", $value);
+		case dibi::DATETIME:
+			return $value instanceof DateTime ? $value->format("'Y-m-d H:i:s'") : date("'Y-m-d H:i:s'", $value);
 
 		default:
 			throw new InvalidArgumentException('Unsupported type.');
@@ -283,15 +334,32 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver
 
 
 
+	/**
+	 * Encodes string for use in a LIKE statement.
+	 * @param  string
+	 * @param  int
+	 * @return string
+	 */
+	public function escapeLike($value, $pos)
+	{
+		$value = addcslashes(str_replace('\\', '\\\\', $value), "\x00\n\r\\'%_");
+		return ($pos <= 0 ? "'%" : "'") . $value . ($pos >= 0 ? "%'" : "'");
+	}
+
+
+
 	/**
 	 * Decodes data from result set.
 	 * @param  string    value
-	 * @param  string    type (dibi::FIELD_BINARY)
+	 * @param  string    type (dibi::BINARY)
 	 * @return string    decoded value
 	 * @throws InvalidArgumentException
 	 */
 	public function unescape($value, $type)
 	{
+		if ($type === dibi::BINARY) {
+			return $value;
+		}
 		throw new InvalidArgumentException('Unsupported type.');
 	}
 
@@ -319,14 +387,25 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver
 
 
 
+	/**
+	 * Automatically frees the resources allocated for this result set.
+	 * @return void
+	 */
+	public function __destruct()
+	{
+		$this->autoFree && $this->getResultResource() && $this->free();
+	}
+
+
+
 	/**
 	 * Returns the number of rows in a result set.
 	 * @return int
 	 */
-	public function rowCount()
+	public function getRowCount()
 	{
 		if (!$this->buffered) {
-			throw new DibiDriverException('Row count is not available for unbuffered queries.');
+			throw new DibiNotSupportedException('Row count is not available for unbuffered queries.');
 		}
 		return mysql_num_rows($this->resultSet);
 	}
@@ -337,7 +416,6 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver
 	 * Fetches the row at current position and moves the internal cursor to the next position.
 	 * @param  bool     TRUE for associative array, FALSE for numeric
 	 * @return array    array on success, nonarray if no next record
-	 * @internal
 	 */
 	public function fetch($assoc)
 	{
@@ -355,7 +433,7 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver
 	public function seek($row)
 	{
 		if (!$this->buffered) {
-			throw new DibiDriverException('Cannot seek an unbuffered result set.');
+			throw new DibiNotSupportedException('Cannot seek an unbuffered result set.');
 		}
 
 		return mysql_data_seek($this->resultSet, $row);
@@ -379,13 +457,13 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver
 	 * Returns metadata for all columns in a result set.
 	 * @return array
 	 */
-	public function getColumnsMeta()
+	public function getResultColumns()
 	{
 		$count = mysql_num_fields($this->resultSet);
-		$res = array();
+		$columns = array();
 		for ($i = 0; $i < $count; $i++) {
 			$row = (array) mysql_fetch_field($this->resultSet, $i);
-			$res[] = array(
+			$columns[] = array(
 				'name' => $row['name'],
 				'table' => $row['table'],
 				'fullname' => $row['table'] ? $row['table'] . '.' . $row['name'] : $row['name'],
@@ -393,7 +471,7 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver
 				'vendor' => $row,
 			);
 		}
-		return $res;
+		return $columns;
 	}
 
 
@@ -404,91 +482,8 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getResultResource()
 	{
-		return $this->resultSet;
-	}
-
-
-
-	/********************* reflection ****************d*g**/
-
-
-
-	/**
-	 * Returns list of tables.
-	 * @return array
-	 */
-	public function getTables()
-	{
-		$this->query("SHOW FULL TABLES");
-		$res = array();
-		while ($row = $this->fetch(FALSE)) {
-			$res[] = array(
-				'name' => $row[0],
-				'view' => isset($row[1]) && $row[1] === 'VIEW',
-			);
-		}
-		$this->free();
-		return $res;
-	}
-
-
-
-	/**
-	 * Returns metadata for all columns in a table.
-	 * @param  string
-	 * @return array
-	 */
-	public function getColumns($table)
-	{
-		$this->query("SHOW COLUMNS FROM `$table`");
-		$res = array();
-		while ($row = $this->fetch(TRUE)) {
-			$type = explode('(', $row['Type']);
-			$res[] = array(
-				'name' => $row['Field'],
-				'table' => $table,
-				'nativetype' => strtoupper($type[0]),
-				'size' => isset($type[1]) ? (int) $type[1] : NULL,
-				'nullable' => $row['Null'] === 'YES',
-				'default' => $row['Default'],
-				'autoincrement' => $row['Extra'] === 'auto_increment',
-			);
-		}
-		$this->free();
-		return $res;
-	}
-
-
-
-	/**
-	 * Returns metadata for all indexes in a table.
-	 * @param  string
-	 * @return array
-	 */
-	public function getIndexes($table)
-	{
-		$this->query("SHOW INDEX FROM `$table`");
-		$res = array();
-		while ($row = $this->fetch(TRUE)) {
-			$res[$row['Key_name']]['name'] = $row['Key_name'];
-			$res[$row['Key_name']]['unique'] = !$row['Non_unique'];
-			$res[$row['Key_name']]['primary'] = $row['Key_name'] === 'PRIMARY';
-			$res[$row['Key_name']]['columns'][$row['Seq_in_index'] - 1] = $row['Column_name'];
-		}
-		$this->free();
-		return array_values($res);
-	}
-
-
-
-	/**
-	 * Returns metadata for all foreign keys in a table.
-	 * @param  string
-	 * @return array
-	 */
-	public function getForeignKeys($table)
-	{
-		throw new NotImplementedException;
+		$this->autoFree = FALSE;
+		return is_resource($this->resultSet) ? $this->resultSet : NULL;
 	}
 
 }

dibi/drivers/mysql.reflector.php

@@ -0,0 +1,129 @@
+<?php
+
+/**
+ * This file is part of the "dibi" - smart database abstraction layer.
+ *
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
+ */
+
+
+/**
+ * The dibi reflector for MySQL databases.
+ *
+ * @author     David Grudl
+ * @package    dibi\drivers
+ * @internal
+ */
+class DibiMySqlReflector extends DibiObject implements IDibiReflector
+{
+	/** @var IDibiDriver */
+	private $driver;
+
+
+
+	public function __construct(IDibiDriver $driver)
+	{
+		$this->driver = $driver;
+	}
+
+
+
+	/**
+	 * Returns list of tables.
+	 * @return array
+	 */
+	public function getTables()
+	{
+		/*$this->query("
+			SELECT TABLE_NAME as name, TABLE_TYPE = 'VIEW' as view
+			FROM INFORMATION_SCHEMA.TABLES
+			WHERE TABLE_SCHEMA = DATABASE()
+		");*/
+		$res = $this->driver->query("SHOW FULL TABLES");
+		$tables = array();
+		while ($row = $res->fetch(FALSE)) {
+			$tables[] = array(
+				'name' => $row[0],
+				'view' => isset($row[1]) && $row[1] === 'VIEW',
+			);
+		}
+		return $tables;
+	}
+
+
+
+	/**
+	 * Returns metadata for all columns in a table.
+	 * @param  string
+	 * @return array
+	 */
+	public function getColumns($table)
+	{
+		/*$table = $this->escape($table, dibi::TEXT);
+		$this->query("
+			SELECT *
+			FROM INFORMATION_SCHEMA.COLUMNS
+			WHERE TABLE_NAME = $table AND TABLE_SCHEMA = DATABASE()
+		");*/
+		$res = $this->driver->query("SHOW FULL COLUMNS FROM {$this->driver->escape($table, dibi::IDENTIFIER)}");
+		$columns = array();
+		while ($row = $res->fetch(TRUE)) {
+			$type = explode('(', $row['Type']);
+			$columns[] = array(
+				'name' => $row['Field'],
+				'table' => $table,
+				'nativetype' => strtoupper($type[0]),
+				'size' => isset($type[1]) ? (int) $type[1] : NULL,
+				'unsigned' => (bool) strstr($row['Type'], 'unsigned'),
+				'nullable' => $row['Null'] === 'YES',
+				'default' => $row['Default'],
+				'autoincrement' => $row['Extra'] === 'auto_increment',
+				'vendor' => $row,
+			);
+		}
+		return $columns;
+	}
+
+
+
+	/**
+	 * Returns metadata for all indexes in a table.
+	 * @param  string
+	 * @return array
+	 */
+	public function getIndexes($table)
+	{
+		/*$table = $this->escape($table, dibi::TEXT);
+		$this->query("
+			SELECT *
+			FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE
+			WHERE TABLE_NAME = $table AND TABLE_SCHEMA = DATABASE()
+			AND REFERENCED_COLUMN_NAME IS NULL
+		");*/
+		$res = $this->driver->query("SHOW INDEX FROM {$this->driver->escape($table, dibi::IDENTIFIER)}");
+		$indexes = array();
+		while ($row = $res->fetch(TRUE)) {
+			$indexes[$row['Key_name']]['name'] = $row['Key_name'];
+			$indexes[$row['Key_name']]['unique'] = !$row['Non_unique'];
+			$indexes[$row['Key_name']]['primary'] = $row['Key_name'] === 'PRIMARY';
+			$indexes[$row['Key_name']]['columns'][$row['Seq_in_index'] - 1] = $row['Column_name'];
+		}
+		return array_values($indexes);
+	}
+
+
+
+	/**
+	 * Returns metadata for all foreign keys in a table.
+	 * @param  string
+	 * @return array
+	 */
+	public function getForeignKeys($table)
+	{
+		throw new DibiNotImplementedException;
+	}
+
+}

dibi/drivers/mysqli.php

@@ -1,55 +1,54 @@
 <?php
 
 /**
- * dibi - tiny'n'smart database abstraction layer
- * ----------------------------------------------
+ * This file is part of the "dibi" - smart database abstraction layer.
  *
- * Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
  *
- * This source file is subject to the "dibi license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://dibiphp.com
- *
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @license    http://dibiphp.com/license  dibi license
- * @link       http://dibiphp.com
- * @package    dibi
- * @version    $Id$
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
  */
 
 
+require_once dirname(__FILE__) . '/mysql.reflector.php';
+
+
 /**
  * The dibi driver for MySQL database via improved extension.
  *
- * Connection options:
- *   - 'host' - the MySQL server host name
- *   - 'port' - the port number to attempt to connect to the MySQL server
- *   - 'socket' - the socket or named pipe
- *   - 'username' (or 'user')
- *   - 'password' (or 'pass')
- *   - 'persistent' - try to find a persistent link?
- *   - 'database' - the database name to select
- *   - 'charset' - character encoding to set
- *   - 'unbuffered' - sends query without fetching and buffering the result rows automatically?
- *   - 'options' - driver specific constants (MYSQLI_*)
- *   - 'sqlmode' - see http://dev.mysql.com/doc/refman/5.0/en/server-sql-mode.html
- *   - 'lazy' - if TRUE, connection will be established only when required
+ * Driver options:
+ *   - host => the MySQL server host name
+ *   - port (int) => the port number to attempt to connect to the MySQL server
+ *   - socket => the socket or named pipe
+ *   - username (or user)
+ *   - password (or pass)
+ *   - database => the database name to select
+ *   - options (array) => array of driver specific constants (MYSQLI_*) and values {@see mysqli_options}
+ *   - flags (int) => driver specific constants (MYSQLI_CLIENT_*) {@see mysqli_real_connect}
+ *   - charset => character encoding to set (default is utf8)
+ *   - persistent (bool) => try to find a persistent link?
+ *   - unbuffered (bool) => sends query without fetching and buffering the result rows automatically?
+ *   - sqlmode => see http://dev.mysql.com/doc/refman/5.0/en/server-sql-mode.html
+ *   - resource (mysqli) => existing connection resource
+ *   - lazy, profiler, result, substitutes, ... => see DibiConnection options
  *
  * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @package    dibi
+ * @package    dibi\drivers
  */
-class DibiMySqliDriver extends DibiObject implements IDibiDriver
+class DibiMySqliDriver extends DibiObject implements IDibiDriver, IDibiResultDriver
 {
+	const ERROR_ACCESS_DENIED = 1045;
+	const ERROR_DUPLICATE_ENTRY = 1062;
+	const ERROR_DATA_TRUNCATED = 1265;
 
 	/** @var mysqli  Connection resource */
 	private $connection;
 
-
 	/** @var mysqli_result  Resultset resource */
 	private $resultSet;
 
+	/** @var bool */
+	private $autoFree = TRUE;
 
 	/** @var bool  Is buffered (seekable and countable)? */
 	private $buffered;
@@ -57,12 +56,12 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver
 
 
 	/**
-	 * @throws DibiException
+	 * @throws DibiNotSupportedException
 	 */
 	public function __construct()
 	{
 		if (!extension_loaded('mysqli')) {
-			throw new DibiDriverException("PHP extension 'mysqli' is not loaded.");
+			throw new DibiNotSupportedException("PHP extension 'mysqli' is not loaded.");
 		}
 	}
 
@@ -75,33 +74,47 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver
 	 */
 	public function connect(array &$config)
 	{
-		DibiConnection::alias($config, 'username', 'user');
-		DibiConnection::alias($config, 'password', 'pass');
-		DibiConnection::alias($config, 'host', 'hostname');
-		DibiConnection::alias($config, 'options');
-		DibiConnection::alias($config, 'database');
+		mysqli_report(MYSQLI_REPORT_OFF);
+		if (isset($config['resource'])) {
+			$this->connection = $config['resource'];
 
-		// default values
-		if (!isset($config['username'])) $config['username'] = ini_get('mysqli.default_user');
-		if (!isset($config['password'])) $config['password'] = ini_get('mysqli.default_pw');
-		if (!isset($config['socket'])) $config['socket'] = ini_get('mysqli.default_socket');
-		if (!isset($config['port'])) $config['port'] = NULL;
-		if (!isset($config['host'])) {
-			$host = ini_get('mysqli.default_host');
-			if ($host) {
-				$config['host'] = $host;
-				$config['port'] = ini_get('mysqli.default_port');
-			} else {
-				$config['host'] = NULL;
-				$config['port'] = NULL;
+		} else {
+			// default values
+			if (!isset($config['charset'])) $config['charset'] = 'utf8';
+			if (!isset($config['username'])) $config['username'] = ini_get('mysqli.default_user');
+			if (!isset($config['password'])) $config['password'] = ini_get('mysqli.default_pw');
+			if (!isset($config['socket'])) $config['socket'] = ini_get('mysqli.default_socket');
+			if (!isset($config['port'])) $config['port'] = NULL;
+			if (!isset($config['host'])) {
+				$host = ini_get('mysqli.default_host');
+				if ($host) {
+					$config['host'] = $host;
+					$config['port'] = ini_get('mysqli.default_port');
+				} else {
+					$config['host'] = NULL;
+					$config['port'] = NULL;
+				}
 			}
-		}
 
-		$this->connection = mysqli_init();
-		@mysqli_real_connect($this->connection, $config['host'], $config['username'], $config['password'], $config['database'], $config['port'], $config['socket'], $config['options']); // intentionally @
+			$foo = & $config['flags'];
+			$foo = & $config['database'];
 
-		if ($errno = mysqli_connect_errno()) {
-			throw new DibiDriverException(mysqli_connect_error(), $errno);
+			$this->connection = mysqli_init();
+			if (isset($config['options'])) {
+				if (is_scalar($config['options'])) {
+					$config['flags'] = $config['options']; // back compatibility
+					trigger_error(__CLASS__ . ": configuration item 'options' must be array; for constants MYSQLI_CLIENT_* use 'flags'.", E_USER_NOTICE);
+				} else {
+					foreach ((array) $config['options'] as $key => $value) {
+						mysqli_options($this->connection, $key, $value);
+					}
+				}
+			}
+			@mysqli_real_connect($this->connection, (empty($config['persistent']) ? '' : 'p:') . $config['host'], $config['username'], $config['password'], $config['database'], $config['port'], $config['socket'], $config['flags']); // intentionally @
+
+			if ($errno = mysqli_connect_errno()) {
+				throw new DibiDriverException(mysqli_connect_error(), $errno);
+			}
 		}
 
 		if (isset($config['charset'])) {
@@ -111,19 +124,16 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver
 				$ok = @mysqli_set_charset($this->connection, $config['charset']); // intentionally @
 			}
 			if (!$ok) {
-				$ok = @mysqli_query($this->connection, "SET NAMES '$config[charset]'"); // intentionally @
-				if (!$ok) {
-					throw new DibiDriverException(mysqli_error($this->connection), mysqli_errno($this->connection));
-				}
+				$this->query("SET NAMES '$config[charset]'");
 			}
 		}
 
 		if (isset($config['sqlmode'])) {
-			if (!@mysqli_query($this->connection, "SET sql_mode='$config[sqlmode]'")) { // intentionally @
-				throw new DibiDriverException(mysqli_error($this->connection), mysqli_errno($this->connection));
-			}
+			$this->query("SET sql_mode='$config[sqlmode]'");
 		}
 
+		$this->query("SET time_zone='" . date('P') . "'");
+
 		$this->buffered = empty($config['unbuffered']);
 	}
 
@@ -143,18 +153,37 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver
 	/**
 	 * Executes the SQL query.
 	 * @param  string      SQL statement.
-	 * @return IDibiDriver|NULL
+	 * @return IDibiResultDriver|NULL
 	 * @throws DibiDriverException
 	 */
 	public function query($sql)
 	{
-		$this->resultSet = @mysqli_query($this->connection, $sql, $this->buffered ? MYSQLI_STORE_RESULT : MYSQLI_USE_RESULT); // intentionally @
+		$res = @mysqli_query($this->connection, $sql, $this->buffered ? MYSQLI_STORE_RESULT : MYSQLI_USE_RESULT); // intentionally @
 
 		if (mysqli_errno($this->connection)) {
 			throw new DibiDriverException(mysqli_error($this->connection), mysqli_errno($this->connection), $sql);
-		}
 
-		return is_object($this->resultSet) ? clone $this : NULL;
+		} elseif (is_object($res)) {
+			return $this->createResultDriver($res);
+		}
+	}
+
+
+
+	/**
+	 * Retrieves information about the most recently executed query.
+	 * @return array
+	 */
+	public function getInfo()
+	{
+		$res = array();
+		preg_match_all('#(.+?): +(\d+) *#', mysqli_info($this->connection), $matches, PREG_SET_ORDER);
+		if (preg_last_error()) throw new DibiPcreException;
+
+		foreach ($matches as $m) {
+			$res[$m[1]] = (int) $m[2];
+		}
+		return $res;
 	}
 
 
@@ -163,9 +192,9 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver
 	 * Gets the number of affected rows by the last INSERT, UPDATE or DELETE query.
 	 * @return int|FALSE  number of rows or FALSE on error
 	 */
-	public function affectedRows()
+	public function getAffectedRows()
 	{
-		return mysqli_affected_rows($this->connection);
+		return mysqli_affected_rows($this->connection) === -1 ? FALSE : mysqli_affected_rows($this->connection);
 	}
 
 
@@ -174,7 +203,7 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver
 	 * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query.
 	 * @return int|FALSE  int on success or FALSE on failure
 	 */
-	public function insertId($sequence)
+	public function getInsertId($sequence)
 	{
 		return mysqli_insert_id($this->connection);
 	}
@@ -183,36 +212,39 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver
 
 	/**
 	 * Begins a transaction (if supported).
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function begin()
+	public function begin($savepoint = NULL)
 	{
-		$this->query('START TRANSACTION');
+		$this->query($savepoint ? "SAVEPOINT $savepoint" : 'START TRANSACTION');
 	}
 
 
 
 	/**
 	 * Commits statements in a transaction.
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function commit()
+	public function commit($savepoint = NULL)
 	{
-		$this->query('COMMIT');
+		$this->query($savepoint ? "RELEASE SAVEPOINT $savepoint" : 'COMMIT');
 	}
 
 
 
 	/**
 	 * Rollback changes in a transaction.
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function rollback()
+	public function rollback($savepoint = NULL)
 	{
-		$this->query('ROLLBACK');
+		$this->query($savepoint ? "ROLLBACK TO SAVEPOINT $savepoint" : 'ROLLBACK');
 	}
 
 
@@ -223,7 +255,32 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getResource()
 	{
-		return $this->connection;
+		return @$this->connection->thread_id ? $this->connection : NULL;
+	}
+
+
+
+	/**
+	 * Returns the connection reflector.
+	 * @return IDibiReflector
+	 */
+	public function getReflector()
+	{
+		return new DibiMySqlReflector($this);
+	}
+
+
+
+	/**
+	 * Result set driver factory.
+	 * @param  mysqli_result
+	 * @return IDibiResultDriver
+	 */
+	public function createResultDriver(mysqli_result $resource)
+	{
+		$res = clone $this;
+		$res->resultSet = $resource;
+		return $res;
 	}
 
 
@@ -233,31 +290,32 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver
 
 
 	/**
-	 * Encodes data for use in an SQL statement.
-	 * @param  string    value
-	 * @param  string    type (dibi::FIELD_TEXT, dibi::FIELD_BOOL, ...)
+	 * Encodes data for use in a SQL statement.
+	 * @param  mixed     value
+	 * @param  string    type (dibi::TEXT, dibi::BOOL, ...)
 	 * @return string    encoded value
 	 * @throws InvalidArgumentException
 	 */
 	public function escape($value, $type)
 	{
 		switch ($type) {
-		case dibi::FIELD_TEXT:
-		case dibi::FIELD_BINARY:
+		case dibi::TEXT:
 			return "'" . mysqli_real_escape_string($this->connection, $value) . "'";
 
-		case dibi::IDENTIFIER:
-			$value = str_replace('`', '``', $value);
-			return '`' . str_replace('.', '`.`', $value) . '`';
+		case dibi::BINARY:
+			return "_binary'" . mysqli_real_escape_string($this->connection, $value) . "'";
 
-		case dibi::FIELD_BOOL:
+		case dibi::IDENTIFIER:
+			return '`' . str_replace('`', '``', $value) . '`';
+
+		case dibi::BOOL:
 			return $value ? 1 : 0;
 
-		case dibi::FIELD_DATE:
-			return date("'Y-m-d'", $value);
+		case dibi::DATE:
+			return $value instanceof DateTime ? $value->format("'Y-m-d'") : date("'Y-m-d'", $value);
 
-		case dibi::FIELD_DATETIME:
-			return date("'Y-m-d H:i:s'", $value);
+		case dibi::DATETIME:
+			return $value instanceof DateTime ? $value->format("'Y-m-d H:i:s'") : date("'Y-m-d H:i:s'", $value);
 
 		default:
 			throw new InvalidArgumentException('Unsupported type.');
@@ -266,15 +324,32 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver
 
 
 
+	/**
+	 * Encodes string for use in a LIKE statement.
+	 * @param  string
+	 * @param  int
+	 * @return string
+	 */
+	public function escapeLike($value, $pos)
+	{
+		$value = addcslashes(str_replace('\\', '\\\\', $value), "\x00\n\r\\'%_");
+		return ($pos <= 0 ? "'%" : "'") . $value . ($pos >= 0 ? "%'" : "'");
+	}
+
+
+
 	/**
 	 * Decodes data from result set.
 	 * @param  string    value
-	 * @param  string    type (dibi::FIELD_BINARY)
+	 * @param  string    type (dibi::BINARY)
 	 * @return string    decoded value
 	 * @throws InvalidArgumentException
 	 */
 	public function unescape($value, $type)
 	{
+		if ($type === dibi::BINARY) {
+			return $value;
+		}
 		throw new InvalidArgumentException('Unsupported type.');
 	}
 
@@ -302,14 +377,25 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver
 
 
 
+	/**
+	 * Automatically frees the resources allocated for this result set.
+	 * @return void
+	 */
+	public function __destruct()
+	{
+		$this->autoFree && $this->getResultResource() && @$this->free();
+	}
+
+
+
 	/**
 	 * Returns the number of rows in a result set.
 	 * @return int
 	 */
-	public function rowCount()
+	public function getRowCount()
 	{
 		if (!$this->buffered) {
-			throw new DibiDriverException('Row count is not available for unbuffered queries.');
+			throw new DibiNotSupportedException('Row count is not available for unbuffered queries.');
 		}
 		return mysqli_num_rows($this->resultSet);
 	}
@@ -320,7 +406,6 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver
 	 * Fetches the row at current position and moves the internal cursor to the next position.
 	 * @param  bool     TRUE for associative array, FALSE for numeric
 	 * @return array    array on success, nonarray if no next record
-	 * @internal
 	 */
 	public function fetch($assoc)
 	{
@@ -338,7 +423,7 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver
 	public function seek($row)
 	{
 		if (!$this->buffered) {
-			throw new DibiDriverException('Cannot seek an unbuffered result set.');
+			throw new DibiNotSupportedException('Cannot seek an unbuffered result set.');
 		}
 		return mysqli_data_seek($this->resultSet, $row);
 	}
@@ -361,7 +446,7 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver
 	 * Returns metadata for all columns in a result set.
 	 * @return array
 	 */
-	public function getColumnsMeta()
+	public function getResultColumns()
 	{
 		static $types;
 		if (empty($types)) {
@@ -371,13 +456,14 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver
 					$types[$value] = substr($key, 12);
 				}
 			}
+			$types[MYSQLI_TYPE_TINY] = $types[MYSQLI_TYPE_SHORT] = $types[MYSQLI_TYPE_LONG] = 'INT';
 		}
 
 		$count = mysqli_num_fields($this->resultSet);
-		$res = array();
+		$columns = array();
 		for ($i = 0; $i < $count; $i++) {
 			$row = (array) mysqli_fetch_field_direct($this->resultSet, $i);
-			$res[] = array(
+			$columns[] = array(
 				'name' => $row['name'],
 				'table' => $row['orgtable'],
 				'fullname' => $row['table'] ? $row['table'] . '.' . $row['name'] : $row['name'],
@@ -385,7 +471,7 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver
 				'vendor' => $row,
 			);
 		}
-		return $res;
+		return $columns;
 	}
 
 
@@ -396,109 +482,8 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getResultResource()
 	{
-		return $this->resultSet;
-	}
-
-
-
-	/********************* reflection ****************d*g**/
-
-
-
-	/**
-	 * Returns list of tables.
-	 * @return array
-	 */
-	public function getTables()
-	{
-		/*$this->query("
-			SELECT TABLE_NAME as name, TABLE_TYPE = 'VIEW' as view
-			FROM INFORMATION_SCHEMA.TABLES
-			WHERE TABLE_SCHEMA = DATABASE()
-		");*/
-		$this->query("SHOW FULL TABLES");
-		$res = array();
-		while ($row = $this->fetch(FALSE)) {
-			$res[] = array(
-				'name' => $row[0],
-				'view' => isset($row[1]) && $row[1] === 'VIEW',
-			);
-		}
-		$this->free();
-		return $res;
-	}
-
-
-
-	/**
-	 * Returns metadata for all columns in a table.
-	 * @param  string
-	 * @return array
-	 */
-	public function getColumns($table)
-	{
-		/*$table = $this->escape($table, dibi::FIELD_TEXT);
-		$this->query("
-			SELECT *
-			FROM INFORMATION_SCHEMA.COLUMNS
-			WHERE TABLE_NAME = $table AND TABLE_SCHEMA = DATABASE()
-		");*/
-		$this->query("SHOW COLUMNS FROM `$table`");
-		$res = array();
-		while ($row = $this->fetch(TRUE)) {
-			$type = explode('(', $row['Type']);
-			$res[] = array(
-				'name' => $row['Field'],
-				'table' => $table,
-				'nativetype' => strtoupper($type[0]),
-				'size' => isset($type[1]) ? (int) $type[1] : NULL,
-				'nullable' => $row['Null'] === 'YES',
-				'default' => $row['Default'],
-				'autoincrement' => $row['Extra'] === 'auto_increment',
-			);
-		}
-		$this->free();
-		return $res;
-	}
-
-
-
-	/**
-	 * Returns metadata for all indexes in a table.
-	 * @param  string
-	 * @return array
-	 */
-	public function getIndexes($table)
-	{
-		/*$table = $this->escape($table, dibi::FIELD_TEXT);
-		$this->query("
-			SELECT *
-			FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE
-			WHERE TABLE_NAME = $table AND TABLE_SCHEMA = DATABASE()
-			AND REFERENCED_COLUMN_NAME IS NULL
-		");*/
-		$this->query("SHOW INDEX FROM `$table`");
-		$res = array();
-		while ($row = $this->fetch(TRUE)) {
-			$res[$row['Key_name']]['name'] = $row['Key_name'];
-			$res[$row['Key_name']]['unique'] = !$row['Non_unique'];
-			$res[$row['Key_name']]['primary'] = $row['Key_name'] === 'PRIMARY';
-			$res[$row['Key_name']]['columns'][$row['Seq_in_index'] - 1] = $row['Column_name'];
-		}
-		$this->free();
-		return array_values($res);
-	}
-
-
-
-	/**
-	 * Returns metadata for all foreign keys in a table.
-	 * @param  string
-	 * @return array
-	 */
-	public function getForeignKeys($table)
-	{
-		throw new NotImplementedException;
+		$this->autoFree = FALSE;
+		return @$this->resultSet->type === NULL ? NULL : $this->resultSet;
 	}
 
 }

dibi/drivers/odbc.php

@@ -1,48 +1,42 @@
 <?php
 
 /**
- * dibi - tiny'n'smart database abstraction layer
- * ----------------------------------------------
+ * This file is part of the "dibi" - smart database abstraction layer.
  *
- * Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
  *
- * This source file is subject to the "dibi license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://dibiphp.com
- *
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @license    http://dibiphp.com/license  dibi license
- * @link       http://dibiphp.com
- * @package    dibi
- * @version    $Id$
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
  */
 
 
 /**
  * The dibi driver interacting with databases via ODBC connections.
  *
- * Connection options:
- *   - 'dsn' - driver specific DSN
- *   - 'username' (or 'user')
- *   - 'password' (or 'pass')
- *   - 'persistent' - try to find a persistent link?
- *   - 'lazy' - if TRUE, connection will be established only when required
+ * Driver options:
+ *   - dsn => driver specific DSN
+ *   - username (or user)
+ *   - password (or pass)
+ *   - persistent (bool) => try to find a persistent link?
+ *   - resource (resource) => existing connection resource
+ *   - lazy, profiler, result, substitutes, ... => see DibiConnection options
  *
  * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @package    dibi
+ * @package    dibi\drivers
  */
-class DibiOdbcDriver extends DibiObject implements IDibiDriver
+class DibiOdbcDriver extends DibiObject implements IDibiDriver, IDibiResultDriver, IDibiReflector
 {
-
 	/** @var resource  Connection resource */
 	private $connection;
 
-
 	/** @var resource  Resultset resource */
 	private $resultSet;
 
+	/** @var bool */
+	private $autoFree = TRUE;
+
+	/** @var int|FALSE  Affected rows */
+	private $affectedRows = FALSE;
 
 	/** @var int  Cursor */
 	private $row = 0;
@@ -50,12 +44,12 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver
 
 
 	/**
-	 * @throws DibiException
+	 * @throws DibiNotSupportedException
 	 */
 	public function __construct()
 	{
 		if (!extension_loaded('odbc')) {
-			throw new DibiDriverException("PHP extension 'odbc' is not loaded.");
+			throw new DibiNotSupportedException("PHP extension 'odbc' is not loaded.");
 		}
 	}
 
@@ -68,18 +62,19 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver
 	 */
 	public function connect(array &$config)
 	{
-		DibiConnection::alias($config, 'username', 'user');
-		DibiConnection::alias($config, 'password', 'pass');
-
-		// default values
-		if (!isset($config['username'])) $config['username'] = ini_get('odbc.default_user');
-		if (!isset($config['password'])) $config['password'] = ini_get('odbc.default_pw');
-		if (!isset($config['dsn'])) $config['dsn'] = ini_get('odbc.default_db');
-
-		if (empty($config['persistent'])) {
-			$this->connection = @odbc_connect($config['dsn'], $config['username'], $config['password']); // intentionally @
+		if (isset($config['resource'])) {
+			$this->connection = $config['resource'];
 		} else {
-			$this->connection = @odbc_pconnect($config['dsn'], $config['username'], $config['password']); // intentionally @
+			// default values
+			if (!isset($config['username'])) $config['username'] = ini_get('odbc.default_user');
+			if (!isset($config['password'])) $config['password'] = ini_get('odbc.default_pw');
+			if (!isset($config['dsn'])) $config['dsn'] = ini_get('odbc.default_db');
+
+			if (empty($config['persistent'])) {
+				$this->connection = @odbc_connect($config['dsn'], $config['username'], $config['password']); // intentionally @
+			} else {
+				$this->connection = @odbc_pconnect($config['dsn'], $config['username'], $config['password']); // intentionally @
+			}
 		}
 
 		if (!is_resource($this->connection)) {
@@ -103,18 +98,21 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver
 	/**
 	 * Executes the SQL query.
 	 * @param  string      SQL statement.
-	 * @return IDibiDriver|NULL
+	 * @return IDibiResultDriver|NULL
 	 * @throws DibiDriverException
 	 */
 	public function query($sql)
 	{
-		$this->resultSet = @odbc_exec($this->connection, $sql); // intentionally @
+		$this->affectedRows = FALSE;
+		$res = @odbc_exec($this->connection, $sql); // intentionally @
 
-		if ($this->resultSet === FALSE) {
+		if ($res === FALSE) {
 			throw new DibiDriverException(odbc_errormsg($this->connection) . ' ' . odbc_error($this->connection), 0, $sql);
-		}
 
-		return is_resource($this->resultSet) ? clone $this : NULL;
+		} elseif (is_resource($res)) {
+			$this->affectedRows = odbc_num_rows($res);
+			return $this->createResultDriver($res);
+		}
 	}
 
 
@@ -123,9 +121,9 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver
 	 * Gets the number of affected rows by the last INSERT, UPDATE or DELETE query.
 	 * @return int|FALSE  number of rows or FALSE on error
 	 */
-	public function affectedRows()
+	public function getAffectedRows()
 	{
-		return odbc_num_rows($this->resultSet);
+		return $this->affectedRows;
 	}
 
 
@@ -134,19 +132,20 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver
 	 * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query.
 	 * @return int|FALSE  int on success or FALSE on failure
 	 */
-	public function insertId($sequence)
+	public function getInsertId($sequence)
 	{
-		throw new NotSupportedException('ODBC does not support autoincrementing.');
+		throw new DibiNotSupportedException('ODBC does not support autoincrementing.');
 	}
 
 
 
 	/**
 	 * Begins a transaction (if supported).
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function begin()
+	public function begin($savepoint = NULL)
 	{
 		if (!odbc_autocommit($this->connection, FALSE)) {
 			throw new DibiDriverException(odbc_errormsg($this->connection) . ' ' . odbc_error($this->connection));
@@ -157,10 +156,11 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver
 
 	/**
 	 * Commits statements in a transaction.
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function commit()
+	public function commit($savepoint = NULL)
 	{
 		if (!odbc_commit($this->connection)) {
 			throw new DibiDriverException(odbc_errormsg($this->connection) . ' ' . odbc_error($this->connection));
@@ -172,10 +172,11 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver
 
 	/**
 	 * Rollback changes in a transaction.
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function rollback()
+	public function rollback($savepoint = NULL)
 	{
 		if (!odbc_rollback($this->connection)) {
 			throw new DibiDriverException(odbc_errormsg($this->connection) . ' ' . odbc_error($this->connection));
@@ -185,13 +186,49 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver
 
 
 
+	/**
+	 * Is in transaction?
+	 * @return bool
+	 */
+	public function inTransaction()
+	{
+		return !odbc_autocommit($this->connection);
+	}
+
+
+
 	/**
 	 * Returns the connection resource.
 	 * @return mixed
 	 */
 	public function getResource()
 	{
-		return $this->connection;
+		return is_resource($this->connection) ? $this->connection : NULL;
+	}
+
+
+
+	/**
+	 * Returns the connection reflector.
+	 * @return IDibiReflector
+	 */
+	public function getReflector()
+	{
+		return $this;
+	}
+
+
+
+	/**
+	 * Result set driver factory.
+	 * @param  resource
+	 * @return IDibiResultDriver
+	 */
+	public function createResultDriver($resource)
+	{
+		$res = clone $this;
+		$res->resultSet = $resource;
+		return $res;
 	}
 
 
@@ -201,31 +238,30 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver
 
 
 	/**
-	 * Encodes data for use in an SQL statement.
-	 * @param  string    value
-	 * @param  string    type (dibi::FIELD_TEXT, dibi::FIELD_BOOL, ...)
+	 * Encodes data for use in a SQL statement.
+	 * @param  mixed     value
+	 * @param  string    type (dibi::TEXT, dibi::BOOL, ...)
 	 * @return string    encoded value
 	 * @throws InvalidArgumentException
 	 */
 	public function escape($value, $type)
 	{
 		switch ($type) {
-		case dibi::FIELD_TEXT:
-		case dibi::FIELD_BINARY:
+		case dibi::TEXT:
+		case dibi::BINARY:
 			return "'" . str_replace("'", "''", $value) . "'";
 
 		case dibi::IDENTIFIER:
-			$value = str_replace(array('[', ']'), array('[[', ']]'), $value);
-			return '[' . str_replace('.', '].[', $value) . ']';
+			return '[' . str_replace(array('[', ']'), array('[[', ']]'), $value) . ']';
 
-		case dibi::FIELD_BOOL:
-			return $value ? -1 : 0;
+		case dibi::BOOL:
+			return $value ? 1 : 0;
 
-		case dibi::FIELD_DATE:
-			return date("#m/d/Y#", $value);
+		case dibi::DATE:
+			return $value instanceof DateTime ? $value->format("#m/d/Y#") : date("#m/d/Y#", $value);
 
-		case dibi::FIELD_DATETIME:
-			return date("#m/d/Y H:i:s#", $value);
+		case dibi::DATETIME:
+			return $value instanceof DateTime ? $value->format("#m/d/Y H:i:s#") : date("#m/d/Y H:i:s#", $value);
 
 		default:
 			throw new InvalidArgumentException('Unsupported type.');
@@ -234,15 +270,32 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver
 
 
 
+	/**
+	 * Encodes string for use in a LIKE statement.
+	 * @param  string
+	 * @param  int
+	 * @return string
+	 */
+	public function escapeLike($value, $pos)
+	{
+		$value = strtr($value, array("'" => "''", '%' => '[%]', '_' => '[_]', '[' => '[[]'));
+		return ($pos <= 0 ? "'%" : "'") . $value . ($pos >= 0 ? "%'" : "'");
+	}
+
+
+
 	/**
 	 * Decodes data from result set.
 	 * @param  string    value
-	 * @param  string    type (dibi::FIELD_BINARY)
+	 * @param  string    type (dibi::BINARY)
 	 * @return string    decoded value
 	 * @throws InvalidArgumentException
 	 */
 	public function unescape($value, $type)
 	{
+		if ($type === dibi::BINARY) {
+			return $value;
+		}
 		throw new InvalidArgumentException('Unsupported type.');
 	}
 
@@ -257,12 +310,12 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver
 	 */
 	public function applyLimit(&$sql, $limit, $offset)
 	{
-		// offset suppot is missing...
+		// offset support is missing
 		if ($limit >= 0) {
 			$sql = 'SELECT TOP ' . (int) $limit . ' * FROM (' . $sql . ')';
 		}
 
-		if ($offset) throw new InvalidArgumentException('Offset is not implemented in driver odbc.');
+		if ($offset) throw new DibiNotSupportedException('Offset is not implemented in driver odbc.');
 	}
 
 
@@ -271,11 +324,22 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver
 
 
 
+	/**
+	 * Automatically frees the resources allocated for this result set.
+	 * @return void
+	 */
+	public function __destruct()
+	{
+		$this->autoFree && $this->getResultResource() && $this->free();
+	}
+
+
+
 	/**
 	 * Returns the number of rows in a result set.
 	 * @return int
 	 */
-	public function rowCount()
+	public function getRowCount()
 	{
 		// will return -1 with many drivers :-(
 		return odbc_num_rows($this->resultSet);
@@ -287,7 +351,6 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver
 	 * Fetches the row at current position and moves the internal cursor to the next position.
 	 * @param  bool     TRUE for associative array, FALSE for numeric
 	 * @return array    array on success, nonarray if no next record
-	 * @internal
 	 */
 	public function fetch($assoc)
 	{
@@ -309,7 +372,6 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver
 	 * Moves cursor position without fetching row.
 	 * @param  int      the 0-based cursor pos to seek to
 	 * @return boolean  TRUE on success, FALSE if unable to seek to specified record
-	 * @throws DibiException
 	 */
 	public function seek($row)
 	{
@@ -335,19 +397,19 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver
 	 * Returns metadata for all columns in a result set.
 	 * @return array
 	 */
-	public function getColumnsMeta()
+	public function getResultColumns()
 	{
 		$count = odbc_num_fields($this->resultSet);
-		$res = array();
+		$columns = array();
 		for ($i = 1; $i <= $count; $i++) {
-			$res[] = array(
+			$columns[] = array(
 				'name'      => odbc_field_name($this->resultSet, $i),
 				'table'     => NULL,
 				'fullname'  => odbc_field_name($this->resultSet, $i),
 				'nativetype'=> odbc_field_type($this->resultSet, $i),
 			);
 		}
-		return $res;
+		return $columns;
 	}
 
 
@@ -358,12 +420,13 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getResultResource()
 	{
-		return $this->resultSet;
+		$this->autoFree = FALSE;
+		return is_resource($this->resultSet) ? $this->resultSet : NULL;
 	}
 
 
 
-	/********************* reflection ****************d*g**/
+	/********************* IDibiReflector ****************d*g**/
 
 
 
@@ -373,18 +436,18 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getTables()
 	{
-		$result = odbc_tables($this->connection);
-		$res = array();
-		while ($row = odbc_fetch_array($result)) {
+		$res = odbc_tables($this->connection);
+		$tables = array();
+		while ($row = odbc_fetch_array($res)) {
 			if ($row['TABLE_TYPE'] === 'TABLE' || $row['TABLE_TYPE'] === 'VIEW') {
-				$res[] = array(
+				$tables[] = array(
 					'name' => $row['TABLE_NAME'],
 					'view' => $row['TABLE_TYPE'] === 'VIEW',
 				);
 			}
 		}
-		odbc_free_result($result);
-		return $res;
+		odbc_free_result($res);
+		return $tables;
 	}
 
 
@@ -396,11 +459,11 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getColumns($table)
 	{
-		$result = odbc_columns($this->connection);
-		$res = array();
-		while ($row = odbc_fetch_array($result)) {
+		$res = odbc_columns($this->connection);
+		$columns = array();
+		while ($row = odbc_fetch_array($res)) {
 			if ($row['TABLE_NAME'] === $table) {
-				$res[] = array(
+				$columns[] = array(
 					'name' => $row['COLUMN_NAME'],
 					'table' => $table,
 					'nativetype' => $row['TYPE_NAME'],
@@ -410,8 +473,8 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver
 				);
 			}
 		}
-		odbc_free_result($result);
-		return $res;
+		odbc_free_result($res);
+		return $columns;
 	}
 
 
@@ -423,7 +486,7 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getIndexes($table)
 	{
-		throw new NotImplementedException;
+		throw new DibiNotImplementedException;
 	}
 
 
@@ -435,7 +498,7 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getForeignKeys($table)
 	{
-		throw new NotImplementedException;
+		throw new DibiNotImplementedException;
 	}
 
 }

dibi/drivers/oracle.php

@@ -1,61 +1,57 @@
 <?php
 
 /**
- * dibi - tiny'n'smart database abstraction layer
- * ----------------------------------------------
+ * This file is part of the "dibi" - smart database abstraction layer.
  *
- * Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
  *
- * This source file is subject to the "dibi license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://dibiphp.com
- *
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @license    http://dibiphp.com/license  dibi license
- * @link       http://dibiphp.com
- * @package    dibi
- * @version    $Id$
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
  */
 
 
 /**
  * The dibi driver for Oracle database.
  *
- * Connection options:
- *   - 'database' (or 'db') - the name of the local Oracle instance or the name of the entry in tnsnames.ora
- *   - 'username' (or 'user')
- *   - 'password' (or 'pass')
- *   - 'charset' - character encoding to set
- *   - 'lazy' - if TRUE, connection will be established only when required
+ * Driver options:
+ *   - database => the name of the local Oracle instance or the name of the entry in tnsnames.ora
+ *   - username (or user)
+ *   - password (or pass)
+ *   - charset => character encoding to set
+ *   - formatDate => how to format date in SQL (@see date)
+ *   - formatDateTime => how to format datetime in SQL (@see date)
+ *   - resource (resource) => existing connection resource
+ *   - lazy, profiler, result, substitutes, ... => see DibiConnection options
  *
  * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @package    dibi
+ * @package    dibi\drivers
  */
-class DibiOracleDriver extends DibiObject implements IDibiDriver
+class DibiOracleDriver extends DibiObject implements IDibiDriver, IDibiResultDriver, IDibiReflector
 {
-
 	/** @var resource  Connection resource */
 	private $connection;
 
-
 	/** @var resource  Resultset resource */
 	private $resultSet;
 
+	/** @var bool */
+	private $autoFree = TRUE;
 
 	/** @var bool */
 	private $autocommit = TRUE;
 
+	/** @var string  Date and datetime format */
+	private $fmtDate, $fmtDateTime;
+
 
 
 	/**
-	 * @throws DibiException
+	 * @throws DibiNotSupportedException
 	 */
 	public function __construct()
 	{
 		if (!extension_loaded('oci8')) {
-			throw new DibiDriverException("PHP extension 'oci8' is not loaded.");
+			throw new DibiNotSupportedException("PHP extension 'oci8' is not loaded.");
 		}
 	}
 
@@ -68,12 +64,15 @@ class DibiOracleDriver extends DibiObject implements IDibiDriver
 	 */
 	public function connect(array &$config)
 	{
-		DibiConnection::alias($config, 'username', 'user');
-		DibiConnection::alias($config, 'password', 'pass');
-		DibiConnection::alias($config, 'database', 'db');
-		DibiConnection::alias($config, 'charset');
+		$foo = & $config['charset'];
+		$this->fmtDate = isset($config['formatDate']) ? $config['formatDate'] : 'U';
+		$this->fmtDateTime = isset($config['formatDateTime']) ? $config['formatDateTime'] : 'U';
 
-		$this->connection = @oci_new_connect($config['username'], $config['password'], $config['database'], $config['charset']); // intentionally @
+		if (isset($config['resource'])) {
+			$this->connection = $config['resource'];
+		} else {
+			$this->connection = @oci_new_connect($config['username'], $config['password'], $config['database'], $config['charset']); // intentionally @
+		}
 
 		if (!$this->connection) {
 			$err = oci_error();
@@ -97,25 +96,25 @@ class DibiOracleDriver extends DibiObject implements IDibiDriver
 	/**
 	 * Executes the SQL query.
 	 * @param  string      SQL statement.
-	 * @return IDibiDriver|NULL
+	 * @return IDibiResultDriver|NULL
 	 * @throws DibiDriverException
 	 */
 	public function query($sql)
 	{
-
-		$this->resultSet = oci_parse($this->connection, $sql);
-		if ($this->resultSet) {
-			oci_execute($this->resultSet, $this->autocommit ? OCI_COMMIT_ON_SUCCESS : OCI_DEFAULT);
-			$err = oci_error($this->resultSet);
+		$res = oci_parse($this->connection, $sql);
+		if ($res) {
+			oci_execute($res, $this->autocommit ? OCI_COMMIT_ON_SUCCESS : OCI_DEFAULT);
+			$err = oci_error($res);
 			if ($err) {
 				throw new DibiDriverException($err['message'], $err['code'], $sql);
+
+			} elseif (is_resource($res)) {
+				return $this->createResultDriver($res);
 			}
 		} else {
 			$err = oci_error($this->connection);
 			throw new DibiDriverException($err['message'], $err['code'], $sql);
 		}
-
-		return is_resource($this->resultSet) ? clone $this : NULL;
 	}
 
 
@@ -124,9 +123,9 @@ class DibiOracleDriver extends DibiObject implements IDibiDriver
 	 * Gets the number of affected rows by the last INSERT, UPDATE or DELETE query.
 	 * @return int|FALSE  number of rows or FALSE on error
 	 */
-	public function affectedRows()
+	public function getAffectedRows()
 	{
-		throw new NotImplementedException;
+		throw new DibiNotImplementedException;
 	}
 
 
@@ -135,19 +134,20 @@ class DibiOracleDriver extends DibiObject implements IDibiDriver
 	 * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query.
 	 * @return int|FALSE  int on success or FALSE on failure
 	 */
-	public function insertId($sequence)
+	public function getInsertId($sequence)
 	{
-		throw new NotSupportedException('Oracle does not support autoincrementing.');
+		$row = $this->query("SELECT $sequence.CURRVAL AS ID FROM DUAL")->fetch(TRUE);
+		return isset($row['ID']) ? (int) $row['ID'] : FALSE;
 	}
 
 
 
 	/**
 	 * Begins a transaction (if supported).
+	 * @param  string  optional savepoint name
 	 * @return void
-	 * @throws DibiDriverException
 	 */
-	public function begin()
+	public function begin($savepoint = NULL)
 	{
 		$this->autocommit = FALSE;
 	}
@@ -156,10 +156,11 @@ class DibiOracleDriver extends DibiObject implements IDibiDriver
 
 	/**
 	 * Commits statements in a transaction.
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function commit()
+	public function commit($savepoint = NULL)
 	{
 		if (!oci_commit($this->connection)) {
 			$err = oci_error($this->connection);
@@ -172,10 +173,11 @@ class DibiOracleDriver extends DibiObject implements IDibiDriver
 
 	/**
 	 * Rollback changes in a transaction.
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function rollback()
+	public function rollback($savepoint = NULL)
 	{
 		if (!oci_rollback($this->connection)) {
 			$err = oci_error($this->connection);
@@ -192,7 +194,32 @@ class DibiOracleDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getResource()
 	{
-		return $this->connection;
+		return is_resource($this->connection) ? $this->connection : NULL;
+	}
+
+
+
+	/**
+	 * Returns the connection reflector.
+	 * @return IDibiReflector
+	 */
+	public function getReflector()
+	{
+		return $this;
+	}
+
+
+
+	/**
+	 * Result set driver factory.
+	 * @param  resource
+	 * @return IDibiResultDriver
+	 */
+	public function createResultDriver($resource)
+	{
+		$res = clone $this;
+		$res->resultSet = $resource;
+		return $res;
 	}
 
 
@@ -202,32 +229,31 @@ class DibiOracleDriver extends DibiObject implements IDibiDriver
 
 
 	/**
-	 * Encodes data for use in an SQL statement.
-	 * @param  string    value
-	 * @param  string    type (dibi::FIELD_TEXT, dibi::FIELD_BOOL, ...)
+	 * Encodes data for use in a SQL statement.
+	 * @param  mixed     value
+	 * @param  string    type (dibi::TEXT, dibi::BOOL, ...)
 	 * @return string    encoded value
 	 * @throws InvalidArgumentException
 	 */
 	public function escape($value, $type)
 	{
 		switch ($type) {
-		case dibi::FIELD_TEXT:
-		case dibi::FIELD_BINARY:
+		case dibi::TEXT:
+		case dibi::BINARY:
 			return "'" . str_replace("'", "''", $value) . "'"; // TODO: not tested
 
 		case dibi::IDENTIFIER:
 			// @see http://download.oracle.com/docs/cd/B10500_01/server.920/a96540/sql_elements9a.htm
-			$value = str_replace('"', '""', $value);
-			return '"' . str_replace('.', '"."', $value) . '"';
+			return '"' . str_replace('"', '""', $value) . '"';
 
-		case dibi::FIELD_BOOL:
+		case dibi::BOOL:
 			return $value ? 1 : 0;
 
-		case dibi::FIELD_DATE:
-			return date("U", $value);
+		case dibi::DATE:
+			return $value instanceof DateTime ? $value->format($this->fmtDate) : date($this->fmtDate, $value);
 
-		case dibi::FIELD_DATETIME:
-			return date("U", $value);
+		case dibi::DATETIME:
+			return $value instanceof DateTime ? $value->format($this->fmtDateTime) : date($this->fmtDateTime, $value);
 
 		default:
 			throw new InvalidArgumentException('Unsupported type.');
@@ -236,15 +262,33 @@ class DibiOracleDriver extends DibiObject implements IDibiDriver
 
 
 
+	/**
+	 * Encodes string for use in a LIKE statement.
+	 * @param  string
+	 * @param  int
+	 * @return string
+	 */
+	public function escapeLike($value, $pos)
+	{
+		$value = addcslashes(str_replace('\\', '\\\\', $value), "\x00\\%_");
+		$value = str_replace("'", "''", $value);
+		return ($pos <= 0 ? "'%" : "'") . $value . ($pos >= 0 ? "%'" : "'");
+	}
+
+
+
 	/**
 	 * Decodes data from result set.
 	 * @param  string    value
-	 * @param  string    type (dibi::FIELD_BINARY)
+	 * @param  string    type (dibi::BINARY)
 	 * @return string    decoded value
 	 * @throws InvalidArgumentException
 	 */
 	public function unescape($value, $type)
 	{
+		if ($type === dibi::BINARY) {
+			return $value;
+		}
 		throw new InvalidArgumentException('Unsupported type.');
 	}
 
@@ -259,8 +303,13 @@ class DibiOracleDriver extends DibiObject implements IDibiDriver
 	 */
 	public function applyLimit(&$sql, $limit, $offset)
 	{
-		if ($limit < 0 && $offset < 1) return;
-		$sql .= ' LIMIT ' . $limit . ($offset > 0 ? ' OFFSET ' . (int) $offset : '');
+		if ($offset > 0) {
+			// see http://www.oracle.com/technology/oramag/oracle/06-sep/o56asktom.html
+			$sql = 'SELECT * FROM (SELECT t.*, ROWNUM AS "__rnum" FROM (' . $sql . ') t ' . ($limit >= 0 ? 'WHERE ROWNUM <= ' . ((int) $offset + (int) $limit) : '') . ') WHERE "__rnum" > '. (int) $offset;
+
+		} elseif ($limit >= 0) {
+			$sql = 'SELECT * FROM (' . $sql . ') WHERE ROWNUM <= ' . (int) $limit;
+		}
 	}
 
 
@@ -269,13 +318,24 @@ class DibiOracleDriver extends DibiObject implements IDibiDriver
 
 
 
+	/**
+	 * Automatically frees the resources allocated for this result set.
+	 * @return void
+	 */
+	public function __destruct()
+	{
+		$this->autoFree && $this->getResultResource() && $this->free();
+	}
+
+
+
 	/**
 	 * Returns the number of rows in a result set.
 	 * @return int
 	 */
-	public function rowCount()
+	public function getRowCount()
 	{
-		return oci_num_rows($this->resultSet);
+		throw new DibiNotSupportedException('Row count is not available for unbuffered queries.');
 	}
 
 
@@ -284,7 +344,6 @@ class DibiOracleDriver extends DibiObject implements IDibiDriver
 	 * Fetches the row at current position and moves the internal cursor to the next position.
 	 * @param  bool     TRUE for associative array, FALSE for numeric
 	 * @return array    array on success, nonarray if no next record
-	 * @internal
 	 */
 	public function fetch($assoc)
 	{
@@ -297,11 +356,10 @@ class DibiOracleDriver extends DibiObject implements IDibiDriver
 	 * Moves cursor position without fetching row.
 	 * @param  int      the 0-based cursor pos to seek to
 	 * @return boolean  TRUE on success, FALSE if unable to seek to specified record
-	 * @throws DibiException
 	 */
 	public function seek($row)
 	{
-		throw new NotImplementedException;
+		throw new DibiNotImplementedException;
 	}
 
 
@@ -322,19 +380,19 @@ class DibiOracleDriver extends DibiObject implements IDibiDriver
 	 * Returns metadata for all columns in a result set.
 	 * @return array
 	 */
-	public function getColumnsMeta()
+	public function getResultColumns()
 	{
 		$count = oci_num_fields($this->resultSet);
-		$res = array();
+		$columns = array();
 		for ($i = 1; $i <= $count; $i++) {
-			$res[] = array(
-				'name'      => oci_field_name($this->resultSet, $i),
-				'table'     => NULL,
-				'fullname'  => oci_field_name($this->resultSet, $i),
+			$columns[] = array(
+				'name' => oci_field_name($this->resultSet, $i),
+				'table' => NULL,
+				'fullname' => oci_field_name($this->resultSet, $i),
 				'nativetype'=> oci_field_type($this->resultSet, $i),
 			);
 		}
-		return $res;
+		return $columns;
 	}
 
 
@@ -345,12 +403,13 @@ class DibiOracleDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getResultResource()
 	{
-		return $this->resultSet;
+		$this->autoFree = FALSE;
+		return is_resource($this->resultSet) ? $this->resultSet : NULL;
 	}
 
 
 
-	/********************* reflection ****************d*g**/
+	/********************* IDibiReflector ****************d*g**/
 
 
 
@@ -360,7 +419,17 @@ class DibiOracleDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getTables()
 	{
-		throw new NotImplementedException;
+		$res = $this->query('SELECT * FROM cat');
+		$tables = array();
+		while ($row = $res->fetch(FALSE)) {
+			if ($row[1] === 'TABLE' || $row[1] === 'VIEW') {
+				$tables[] = array(
+					'name' => $row[0],
+					'view' => $row[1] === 'VIEW',
+				);
+			}
+		}
+		return $tables;
 	}
 
 
@@ -372,7 +441,7 @@ class DibiOracleDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getColumns($table)
 	{
-		throw new NotImplementedException;
+		throw new DibiNotImplementedException;
 	}
 
 
@@ -384,7 +453,7 @@ class DibiOracleDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getIndexes($table)
 	{
-		throw new NotImplementedException;
+		throw new DibiNotImplementedException;
 	}
 
 
@@ -396,7 +465,7 @@ class DibiOracleDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getForeignKeys($table)
 	{
-		throw new NotImplementedException;
+		throw new DibiNotImplementedException;
 	}
 
 }

dibi/drivers/pdo.php

@@ -1,62 +1,56 @@
 <?php
 
 /**
- * dibi - tiny'n'smart database abstraction layer
- * ----------------------------------------------
+ * This file is part of the "dibi" - smart database abstraction layer.
  *
- * Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
  *
- * This source file is subject to the "dibi license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://dibiphp.com
- *
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @license    http://dibiphp.com/license  dibi license
- * @link       http://dibiphp.com
- * @package    dibi
- * @version    $Id$
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
  */
 
 
+require_once dirname(__FILE__) . '/mysql.reflector.php';
+require_once dirname(__FILE__) . '/sqlite.reflector.php';
+
+
 /**
  * The dibi driver for PDO.
  *
- * Connection options:
- *   - 'dsn' - driver specific DSN
- *   - 'username' (or 'user')
- *   - 'password' (or 'pass')
- *   - 'options' - driver specific options array
- *   - 'pdo' - PDO object (optional)
- *   - 'lazy' - if TRUE, connection will be established only when required
+ * Driver options:
+ *   - dsn => driver specific DSN
+ *   - username (or user)
+ *   - password (or pass)
+ *   - options (array) => driver specific options {@see PDO::__construct}
+ *   - resource (PDO) => existing connection
+ *   - lazy, profiler, result, substitutes, ... => see DibiConnection options
  *
  * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @package    dibi
+ * @package    dibi\drivers
  */
-class DibiPdoDriver extends DibiObject implements IDibiDriver
+class DibiPdoDriver extends DibiObject implements IDibiDriver, IDibiResultDriver
 {
-
 	/** @var PDO  Connection resource */
 	private $connection;
 
-
 	/** @var PDOStatement  Resultset resource */
 	private $resultSet;
 
-
 	/** @var int|FALSE  Affected rows */
 	private $affectedRows = FALSE;
 
+	/** @var string */
+	private $driverName;
+
 
 
 	/**
-	 * @throws DibiException
+	 * @throws DibiNotSupportedException
 	 */
 	public function __construct()
 	{
 		if (!extension_loaded('pdo')) {
-			throw new DibiDriverException("PHP extension 'pdo' is not loaded.");
+			throw new DibiNotSupportedException("PHP extension 'pdo' is not loaded.");
 		}
 	}
 
@@ -69,14 +63,12 @@ class DibiPdoDriver extends DibiObject implements IDibiDriver
 	 */
 	public function connect(array &$config)
 	{
-		DibiConnection::alias($config, 'username', 'user');
-		DibiConnection::alias($config, 'password', 'pass');
-		DibiConnection::alias($config, 'dsn');
-		DibiConnection::alias($config, 'pdo');
-		DibiConnection::alias($config, 'options');
+		$foo = & $config['dsn'];
+		$foo = & $config['options'];
+		DibiConnection::alias($config, 'resource', 'pdo');
 
-		if ($config['pdo'] instanceof PDO) {
-			$this->connection = $config['pdo'];
+		if ($config['resource'] instanceof PDO) {
+			$this->connection = $config['resource'];
 
 		} else try {
 			$this->connection = new PDO($config['dsn'], $config['username'], $config['password'], $config['options']);
@@ -88,6 +80,8 @@ class DibiPdoDriver extends DibiObject implements IDibiDriver
 		if (!$this->connection) {
 			throw new DibiDriverException('Connecting error.');
 		}
+
+		$this->driverName = $this->connection->getAttribute(PDO::ATTR_DRIVER_NAME);
 	}
 
 
@@ -106,17 +100,17 @@ class DibiPdoDriver extends DibiObject implements IDibiDriver
 	/**
 	 * Executes the SQL query.
 	 * @param  string      SQL statement.
-	 * @return IDibiDriver|NULL
+	 * @return IDibiResultDriver|NULL
 	 * @throws DibiDriverException
 	 */
 	public function query($sql)
 	{
 		// must detect if SQL returns result set or num of affected rows
 		$cmd = strtoupper(substr(ltrim($sql), 0, 6));
-		$list = array('UPDATE'=>1, 'DELETE'=>1, 'INSERT'=>1, 'REPLAC'=>1);
+		static $list = array('UPDATE'=>1, 'DELETE'=>1, 'INSERT'=>1, 'REPLAC'=>1);
+		$this->affectedRows = FALSE;
 
 		if (isset($list[$cmd])) {
-			$this->resultSet = NULL;
 			$this->affectedRows = $this->connection->exec($sql);
 
 			if ($this->affectedRows === FALSE) {
@@ -124,18 +118,15 @@ class DibiPdoDriver extends DibiObject implements IDibiDriver
 				throw new DibiDriverException("SQLSTATE[$err[0]]: $err[2]", $err[1], $sql);
 			}
 
-			return NULL;
-
 		} else {
-			$this->resultSet = $this->connection->query($sql);
-			$this->affectedRows = FALSE;
+			$res = $this->connection->query($sql);
 
-			if ($this->resultSet === FALSE) {
+			if ($res === FALSE) {
 				$err = $this->connection->errorInfo();
 				throw new DibiDriverException("SQLSTATE[$err[0]]: $err[2]", $err[1], $sql);
+			} else {
+				return $this->createResultDriver($res);
 			}
-
-			return clone $this;
 		}
 	}
 
@@ -145,7 +136,7 @@ class DibiPdoDriver extends DibiObject implements IDibiDriver
 	 * Gets the number of affected rows by the last INSERT, UPDATE or DELETE query.
 	 * @return int|FALSE  number of rows or FALSE on error
 	 */
-	public function affectedRows()
+	public function getAffectedRows()
 	{
 		return $this->affectedRows;
 	}
@@ -156,7 +147,7 @@ class DibiPdoDriver extends DibiObject implements IDibiDriver
 	 * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query.
 	 * @return int|FALSE  int on success or FALSE on failure
 	 */
-	public function insertId($sequence)
+	public function getInsertId($sequence)
 	{
 		return $this->connection->lastInsertId();
 	}
@@ -165,10 +156,11 @@ class DibiPdoDriver extends DibiObject implements IDibiDriver
 
 	/**
 	 * Begins a transaction (if supported).
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function begin()
+	public function begin($savepoint = NULL)
 	{
 		if (!$this->connection->beginTransaction()) {
 			$err = $this->connection->errorInfo();
@@ -180,10 +172,11 @@ class DibiPdoDriver extends DibiObject implements IDibiDriver
 
 	/**
 	 * Commits statements in a transaction.
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function commit()
+	public function commit($savepoint = NULL)
 	{
 		if (!$this->connection->commit()) {
 			$err = $this->connection->errorInfo();
@@ -195,10 +188,11 @@ class DibiPdoDriver extends DibiObject implements IDibiDriver
 
 	/**
 	 * Rollback changes in a transaction.
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function rollback()
+	public function rollback($savepoint = NULL)
 	{
 		if (!$this->connection->rollBack()) {
 			$err = $this->connection->errorInfo();
@@ -219,61 +213,90 @@ class DibiPdoDriver extends DibiObject implements IDibiDriver
 
 
 
+	/**
+	 * Returns the connection reflector.
+	 * @return IDibiReflector
+	 */
+	public function getReflector()
+	{
+		switch ($this->driverName) {
+		case 'mysql':
+			return new DibiMySqlReflector($this);
+
+		case 'sqlite':
+		case 'sqlite2':
+			return new DibiSqliteReflector($this);
+
+		default:
+			throw new DibiNotSupportedException;
+		}
+	}
+
+
+
+	/**
+	 * Result set driver factory.
+	 * @param  PDOStatement
+	 * @return IDibiResultDriver
+	 */
+	public function createResultDriver(PDOStatement $resource)
+	{
+		$res = clone $this;
+		$res->resultSet = $resource;
+		return $res;
+	}
+
+
+
 	/********************* SQL ****************d*g**/
 
 
 
 	/**
-	 * Encodes data for use in an SQL statement.
-	 * @param  string    value
-	 * @param  string    type (dibi::FIELD_TEXT, dibi::FIELD_BOOL, ...)
+	 * Encodes data for use in a SQL statement.
+	 * @param  mixed     value
+	 * @param  string    type (dibi::TEXT, dibi::BOOL, ...)
 	 * @return string    encoded value
 	 * @throws InvalidArgumentException
 	 */
 	public function escape($value, $type)
 	{
 		switch ($type) {
-		case dibi::FIELD_TEXT:
+		case dibi::TEXT:
 			return $this->connection->quote($value, PDO::PARAM_STR);
 
-		case dibi::FIELD_BINARY:
+		case dibi::BINARY:
 			return $this->connection->quote($value, PDO::PARAM_LOB);
 
 		case dibi::IDENTIFIER:
-			switch ($this->connection->getAttribute(PDO::ATTR_DRIVER_NAME)) {
+			switch ($this->driverName) {
 			case 'mysql':
-				$value = str_replace('`', '``', $value);
-				return '`' . str_replace('.', '`.`', $value) . '`';
+				return '`' . str_replace('`', '``', $value) . '`';
 
 			case 'pgsql':
-				$a = strrpos($value, '.');
-				if ($a === FALSE) {
-					return '"' . str_replace('"', '""', $value) . '"';
-				} else {
-					return substr($value, 0, $a) . '."' . str_replace('"', '""', substr($value, $a + 1)) . '"';
-				}
+				return '"' . str_replace('"', '""', $value) . '"';
 
 			case 'sqlite':
 			case 'sqlite2':
-				$value = strtr($value, '[]', '  ');
+				return '[' . strtr($value, '[]', '  ') . ']';
+
 			case 'odbc':
 			case 'oci': // TODO: not tested
 			case 'mssql':
-				$value = str_replace(array('[', ']'), array('[[', ']]'), $value);
-				return '[' . str_replace('.', '].[', $value) . ']';
+				return '[' . str_replace(array('[', ']'), array('[[', ']]'), $value) . ']';
 
 			default:
 				return $value;
 			}
 
-		case dibi::FIELD_BOOL:
+		case dibi::BOOL:
 			return $this->connection->quote($value, PDO::PARAM_BOOL);
 
-		case dibi::FIELD_DATE:
-			return date("'Y-m-d'", $value);
+		case dibi::DATE:
+			return $value instanceof DateTime ? $value->format("'Y-m-d'") : date("'Y-m-d'", $value);
 
-		case dibi::FIELD_DATETIME:
-			return date("'Y-m-d H:i:s'", $value);
+		case dibi::DATETIME:
+			return $value instanceof DateTime ? $value->format("'Y-m-d H:i:s'") : date("'Y-m-d H:i:s'", $value);
 
 		default:
 			throw new InvalidArgumentException('Unsupported type.');
@@ -282,15 +305,31 @@ class DibiPdoDriver extends DibiObject implements IDibiDriver
 
 
 
+	/**
+	 * Encodes string for use in a LIKE statement.
+	 * @param  string
+	 * @param  int
+	 * @return string
+	 */
+	public function escapeLike($value, $pos)
+	{
+		throw new DibiNotImplementedException;
+	}
+
+
+
 	/**
 	 * Decodes data from result set.
 	 * @param  string    value
-	 * @param  string    type (dibi::FIELD_BINARY)
+	 * @param  string    type (dibi::BINARY)
 	 * @return string    decoded value
 	 * @throws InvalidArgumentException
 	 */
 	public function unescape($value, $type)
 	{
+		if ($type === dibi::BINARY) {
+			return $value;
+		}
 		throw new InvalidArgumentException('Unsupported type.');
 	}
 
@@ -305,7 +344,43 @@ class DibiPdoDriver extends DibiObject implements IDibiDriver
 	 */
 	public function applyLimit(&$sql, $limit, $offset)
 	{
-		throw new NotSupportedException('PDO does not support applying limit or offset.');
+		if ($limit < 0 && $offset < 1) return;
+
+		switch ($this->driverName) {
+		case 'mysql':
+			$sql .= ' LIMIT ' . ($limit < 0 ? '18446744073709551615' : (int) $limit)
+				. ($offset > 0 ? ' OFFSET ' . (int) $offset : '');
+			break;
+
+		case 'pgsql':
+			if ($limit >= 0) $sql .= ' LIMIT ' . (int) $limit;
+			if ($offset > 0) $sql .= ' OFFSET ' . (int) $offset;
+			break;
+
+		case 'sqlite':
+		case 'sqlite2':
+			$sql .= ' LIMIT ' . $limit . ($offset > 0 ? ' OFFSET ' . (int) $offset : '');
+			break;
+
+		case 'oci':
+			if ($offset > 0) {
+				$sql = 'SELECT * FROM (SELECT t.*, ROWNUM AS "__rnum" FROM (' . $sql . ') t ' . ($limit >= 0 ? 'WHERE ROWNUM <= ' . ((int) $offset + (int) $limit) : '') . ') WHERE "__rnum" > '. (int) $offset;
+			} elseif ($limit >= 0) {
+				$sql = 'SELECT * FROM (' . $sql . ') WHERE ROWNUM <= ' . (int) $limit;
+			}
+			break;
+
+		case 'odbc':
+		case 'mssql':
+			if ($offset < 1) {
+				$sql = 'SELECT TOP ' . (int) $limit . ' * FROM (' . $sql . ')';
+				break;
+			}
+			// intentionally break omitted
+
+		default:
+			throw new DibiNotSupportedException('PDO or driver does not support applying limit or offset.');
+		}
 	}
 
 
@@ -318,9 +393,9 @@ class DibiPdoDriver extends DibiObject implements IDibiDriver
 	 * Returns the number of rows in a result set.
 	 * @return int
 	 */
-	public function rowCount()
+	public function getRowCount()
 	{
-		throw new DibiDriverException('Row count is not available for unbuffered queries.');
+		return $this->resultSet->rowCount();
 	}
 
 
@@ -329,7 +404,6 @@ class DibiPdoDriver extends DibiObject implements IDibiDriver
 	 * Fetches the row at current position and moves the internal cursor to the next position.
 	 * @param  bool     TRUE for associative array, FALSE for numeric
 	 * @return array    array on success, nonarray if no next record
-	 * @internal
 	 */
 	public function fetch($assoc)
 	{
@@ -342,11 +416,10 @@ class DibiPdoDriver extends DibiObject implements IDibiDriver
 	 * Moves cursor position without fetching row.
 	 * @param  int      the 0-based cursor pos to seek to
 	 * @return boolean  TRUE on success, FALSE if unable to seek to specified record
-	 * @throws DibiException
 	 */
 	public function seek($row)
 	{
-		throw new DibiDriverException('Cannot seek an unbuffered result set.');
+		throw new DibiNotSupportedException('Cannot seek an unbuffered result set.');
 	}
 
 
@@ -367,16 +440,23 @@ class DibiPdoDriver extends DibiObject implements IDibiDriver
 	 * @return array
 	 * @throws DibiException
 	 */
-	public function getColumnsMeta()
+	public function getResultColumns()
 	{
 		$count = $this->resultSet->columnCount();
-		$res = array();
+		$columns = array();
 		for ($i = 0; $i < $count; $i++) {
 			$row = @$this->resultSet->getColumnMeta($i); // intentionally @
 			if ($row === FALSE) {
-				throw new DibiDriverException('Driver does not support meta data.');
+				throw new DibiNotSupportedException('Driver does not support meta data.');
 			}
-			$res[] = array(
+			// PHP < 5.2.3 compatibility
+			// @see: http://php.net/manual/en/pdostatement.getcolumnmeta.php#pdostatement.getcolumnmeta.changelog
+			$row = $row + array(
+				'table' => NULL,
+				'native_type' => 'VAR_STRING',
+			);
+
+			$columns[] = array(
 				'name' => $row['name'],
 				'table' => $row['table'],
 				'nativetype' => $row['native_type'],
@@ -384,7 +464,7 @@ class DibiPdoDriver extends DibiObject implements IDibiDriver
 				'vendor' => $row,
 			);
 		}
-		return $res;
+		return $columns;
 	}
 
 
@@ -398,55 +478,4 @@ class DibiPdoDriver extends DibiObject implements IDibiDriver
 		return $this->resultSet;
 	}
 
-
-
-	/********************* reflection ****************d*g**/
-
-
-
-	/**
-	 * Returns list of tables.
-	 * @return array
-	 */
-	public function getTables()
-	{
-		throw new NotImplementedException;
-	}
-
-
-
-	/**
-	 * Returns metadata for all columns in a table.
-	 * @param  string
-	 * @return array
-	 */
-	public function getColumns($table)
-	{
-		throw new NotImplementedException;
-	}
-
-
-
-	/**
-	 * Returns metadata for all indexes in a table.
-	 * @param  string
-	 * @return array
-	 */
-	public function getIndexes($table)
-	{
-		throw new NotImplementedException;
-	}
-
-
-
-	/**
-	 * Returns metadata for all foreign keys in a table.
-	 * @param  string
-	 * @return array
-	 */
-	public function getForeignKeys($table)
-	{
-		throw new NotImplementedException;
-	}
-
 }

dibi/drivers/postgre.php

@@ -1,49 +1,43 @@
 <?php
 
 /**
- * dibi - tiny'n'smart database abstraction layer
- * ----------------------------------------------
+ * This file is part of the "dibi" - smart database abstraction layer.
  *
- * Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
  *
- * This source file is subject to the "dibi license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://dibiphp.com
- *
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @license    http://dibiphp.com/license  dibi license
- * @link       http://dibiphp.com
- * @package    dibi
- * @version    $Id$
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
  */
 
 
 /**
  * The dibi driver for PostgreSQL database.
  *
- * Connection options:
- *   - 'host','hostaddr','port','dbname','user','password','connect_timeout','options','sslmode','service' - see PostgreSQL API
- *   - 'string' - or use connection string
- *   - 'persistent' - try to find a persistent link?
- *   - 'charset' - character encoding to set
- *   - 'schema' - the schema search path
- *   - 'lazy' - if TRUE, connection will be established only when required
+ * Driver options:
+ *   - host, hostaddr, port, dbname, user, password, connect_timeout, options, sslmode, service => see PostgreSQL API
+ *   - string => or use connection string
+ *   - schema => the schema search path
+ *   - charset => character encoding to set (default is utf8)
+ *   - persistent (bool) => try to find a persistent link?
+ *   - resource (resource) => existing connection resource
+ *   - lazy, profiler, result, substitutes, ... => see DibiConnection options
  *
  * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @package    dibi
+ * @package    dibi\drivers
  */
-class DibiPostgreDriver extends DibiObject implements IDibiDriver
+class DibiPostgreDriver extends DibiObject implements IDibiDriver, IDibiResultDriver, IDibiReflector
 {
-
 	/** @var resource  Connection resource */
 	private $connection;
 
-
 	/** @var resource  Resultset resource */
 	private $resultSet;
 
+	/** @var bool */
+	private $autoFree = TRUE;
+
+	/** @var int|FALSE  Affected rows */
+	private $affectedRows = FALSE;
 
 	/** @var bool  Escape method */
 	private $escMethod = FALSE;
@@ -51,12 +45,12 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 
 
 	/**
-	 * @throws DibiException
+	 * @throws DibiNotSupportedException
 	 */
 	public function __construct()
 	{
 		if (!extension_loaded('pgsql')) {
-			throw new DibiDriverException("PHP extension 'pgsql' is not loaded.");
+			throw new DibiNotSupportedException("PHP extension 'pgsql' is not loaded.");
 		}
 	}
 
@@ -69,23 +63,31 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 	 */
 	public function connect(array &$config)
 	{
-		if (isset($config['string'])) {
-			$string = $config['string'];
-		} else {
-			$string = '';
-			foreach (array('host','hostaddr','port','dbname','user','password','connect_timeout','options','sslmode','service') as $key) {
-				if (isset($config[$key])) $string .= $key . '=' . $config[$key] . ' ';
-			}
-		}
+		if (isset($config['resource'])) {
+			$this->connection = $config['resource'];
 
-		DibiDriverException::tryError();
-		if (empty($config['persistent'])) {
-			$this->connection = pg_connect($string, PGSQL_CONNECT_FORCE_NEW);
 		} else {
-			$this->connection = pg_pconnect($string, PGSQL_CONNECT_FORCE_NEW);
-		}
-		if (DibiDriverException::catchError($msg)) {
-			throw new DibiDriverException($msg, 0);
+			if (!isset($config['charset'])) $config['charset'] = 'utf8';
+			if (isset($config['string'])) {
+				$string = $config['string'];
+			} else {
+				$string = '';
+				DibiConnection::alias($config, 'user', 'username');
+				DibiConnection::alias($config, 'dbname', 'database');
+				foreach (array('host','hostaddr','port','dbname','user','password','connect_timeout','options','sslmode','service') as $key) {
+					if (isset($config[$key])) $string .= $key . '=' . $config[$key] . ' ';
+				}
+			}
+
+			DibiDriverException::tryError();
+			if (empty($config['persistent'])) {
+				$this->connection = pg_connect($string, PGSQL_CONNECT_FORCE_NEW);
+			} else {
+				$this->connection = pg_pconnect($string, PGSQL_CONNECT_FORCE_NEW);
+			}
+			if (DibiDriverException::catchError($msg)) {
+				throw new DibiDriverException($msg, 0);
+			}
 		}
 
 		if (!is_resource($this->connection)) {
@@ -101,7 +103,7 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 		}
 
 		if (isset($config['schema'])) {
-			$this->query('SET search_path TO ' . $config['schema']);
+			$this->query('SET search_path TO "' . $config['schema'] . '"');
 		}
 
 		$this->escMethod = version_compare(PHP_VERSION , '5.2.0', '>=');
@@ -123,19 +125,23 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 	/**
 	 * Executes the SQL query.
 	 * @param  string      SQL statement.
-	 * @param  bool        update affected rows?
-	 * @return IDibiDriver|NULL
+	 * @return IDibiResultDriver|NULL
 	 * @throws DibiDriverException
 	 */
 	public function query($sql)
 	{
-		$this->resultSet = @pg_query($this->connection, $sql); // intentionally @
+		$this->affectedRows = FALSE;
+		$res = @pg_query($this->connection, $sql); // intentionally @
 
-		if ($this->resultSet === FALSE) {
+		if ($res === FALSE) {
 			throw new DibiDriverException(pg_last_error($this->connection), 0, $sql);
-		}
 
-		return is_resource($this->resultSet) && pg_num_fields($this->resultSet) ? clone $this : NULL;
+		} elseif (is_resource($res)) {
+			$this->affectedRows = pg_affected_rows($res);
+			if (pg_num_fields($res)) {
+				return $this->createResultDriver($res);
+			}
+		}
 	}
 
 
@@ -144,9 +150,9 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 	 * Gets the number of affected rows by the last INSERT, UPDATE or DELETE query.
 	 * @return int|FALSE  number of rows or FALSE on error
 	 */
-	public function affectedRows()
+	public function getAffectedRows()
 	{
-		return pg_affected_rows($this->resultSet);
+		return $this->affectedRows;
 	}
 
 
@@ -155,19 +161,18 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 	 * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query.
 	 * @return int|FALSE  int on success or FALSE on failure
 	 */
-	public function insertId($sequence)
+	public function getInsertId($sequence)
 	{
 		if ($sequence === NULL) {
 			// PostgreSQL 8.1 is needed
-			$has = $this->query("SELECT LASTVAL()");
+			$res = $this->query("SELECT LASTVAL()");
 		} else {
-			$has = $this->query("SELECT CURRVAL('$sequence')");
+			$res = $this->query("SELECT CURRVAL('$sequence')");
 		}
 
-		if (!$has) return FALSE;
+		if (!$res) return FALSE;
 
-		$row = $this->fetch(FALSE);
-		$this->free();
+		$row = $res->fetch(FALSE);
 		return is_array($row) ? $row[0] : FALSE;
 	}
 
@@ -175,36 +180,50 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 
 	/**
 	 * Begins a transaction (if supported).
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function begin()
+	public function begin($savepoint = NULL)
 	{
-		$this->query('START TRANSACTION');
+		$this->query($savepoint ? "SAVEPOINT $savepoint" : 'START TRANSACTION');
 	}
 
 
 
 	/**
 	 * Commits statements in a transaction.
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function commit()
+	public function commit($savepoint = NULL)
 	{
-		$this->query('COMMIT');
+		$this->query($savepoint ? "RELEASE SAVEPOINT $savepoint" : 'COMMIT');
 	}
 
 
 
 	/**
 	 * Rollback changes in a transaction.
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function rollback()
+	public function rollback($savepoint = NULL)
 	{
-		$this->query('ROLLBACK');
+		$this->query($savepoint ? "ROLLBACK TO SAVEPOINT $savepoint" : 'ROLLBACK');
+	}
+
+
+
+	/**
+	 * Is in transaction?
+	 * @return bool
+	 */
+	public function inTransaction()
+	{
+		return !in_array(pg_transaction_status($this->connection), array(PGSQL_TRANSACTION_UNKNOWN, PGSQL_TRANSACTION_IDLE), TRUE);
 	}
 
 
@@ -215,7 +234,32 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getResource()
 	{
-		return $this->connection;
+		return is_resource($this->connection) ? $this->connection : NULL;
+	}
+
+
+
+	/**
+	 * Returns the connection reflector.
+	 * @return IDibiReflector
+	 */
+	public function getReflector()
+	{
+		return $this;
+	}
+
+
+
+	/**
+	 * Result set driver factory.
+	 * @param  resource
+	 * @return IDibiResultDriver
+	 */
+	public function createResultDriver($resource)
+	{
+		$res = clone $this;
+		$res->resultSet = $resource;
+		return $res;
 	}
 
 
@@ -225,24 +269,30 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 
 
 	/**
-	 * Encodes data for use in an SQL statement.
-	 * @param  string    value
-	 * @param  string    type (dibi::FIELD_TEXT, dibi::FIELD_BOOL, ...)
+	 * Encodes data for use in a SQL statement.
+	 * @param  mixed     value
+	 * @param  string    type (dibi::TEXT, dibi::BOOL, ...)
 	 * @return string    encoded value
 	 * @throws InvalidArgumentException
 	 */
 	public function escape($value, $type)
 	{
 		switch ($type) {
-		case dibi::FIELD_TEXT:
+		case dibi::TEXT:
 			if ($this->escMethod) {
+				if (!is_resource($this->connection)) {
+					throw new DibiException('Lost connection to server.');
+				}
 				return "'" . pg_escape_string($this->connection, $value) . "'";
 			} else {
 				return "'" . pg_escape_string($value) . "'";
 			}
 
-		case dibi::FIELD_BINARY:
+		case dibi::BINARY:
 			if ($this->escMethod) {
+				if (!is_resource($this->connection)) {
+					throw new DibiException('Lost connection to server.');
+				}
 				return "'" . pg_escape_bytea($this->connection, $value) . "'";
 			} else {
 				return "'" . pg_escape_bytea($value) . "'";
@@ -250,22 +300,16 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 
 		case dibi::IDENTIFIER:
 			// @see http://www.postgresql.org/docs/8.2/static/sql-syntax-lexical.html#SQL-SYNTAX-IDENTIFIERS
-			$a = strrpos($value, '.');
-			if ($a === FALSE) {
-				return '"' . str_replace('"', '""', $value) . '"';
-			} else {
-				// table.col delimite as table."col"
-				return substr($value, 0, $a) . '."' . str_replace('"', '""', substr($value, $a + 1)) . '"';
-			}
+			return '"' . str_replace('"', '""', $value) . '"';
 
-		case dibi::FIELD_BOOL:
+		case dibi::BOOL:
 			return $value ? 'TRUE' : 'FALSE';
 
-		case dibi::FIELD_DATE:
-			return date("'Y-m-d'", $value);
+		case dibi::DATE:
+			return $value instanceof DateTime ? $value->format("'Y-m-d'") : date("'Y-m-d'", $value);
 
-		case dibi::FIELD_DATETIME:
-			return date("'Y-m-d H:i:s'", $value);
+		case dibi::DATETIME:
+			return $value instanceof DateTime ? $value->format("'Y-m-d H:i:s'") : date("'Y-m-d H:i:s'", $value);
 
 		default:
 			throw new InvalidArgumentException('Unsupported type.');
@@ -274,22 +318,39 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 
 
 
+	/**
+	 * Encodes string for use in a LIKE statement.
+	 * @param  string
+	 * @param  int
+	 * @return string
+	 */
+	public function escapeLike($value, $pos)
+	{
+		if ($this->escMethod) {
+			$value = pg_escape_string($this->connection, $value);
+		} else {
+			$value = pg_escape_string($value);
+	}
+
+		$value = strtr($value, array( '%' => '\\\\%', '_' => '\\\\_'));
+		return ($pos <= 0 ? "'%" : "'") . $value . ($pos >= 0 ? "%'" : "'");
+	}
+
+
+
 	/**
 	 * Decodes data from result set.
 	 * @param  string    value
-	 * @param  string    type (dibi::FIELD_BINARY)
+	 * @param  string    type (dibi::BINARY)
 	 * @return string    decoded value
 	 * @throws InvalidArgumentException
 	 */
 	public function unescape($value, $type)
 	{
-		switch ($type) {
-		case dibi::FIELD_BINARY:
+		if ($type === dibi::BINARY) {
 			return pg_unescape_bytea($value);
-
-		default:
-			throw new InvalidArgumentException('Unsupported type.');
 		}
+		throw new InvalidArgumentException('Unsupported type.');
 	}
 
 
@@ -316,11 +377,22 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 
 
 
+	/**
+	 * Automatically frees the resources allocated for this result set.
+	 * @return void
+	 */
+	public function __destruct()
+	{
+		$this->autoFree && $this->getResultResource() && $this->free();
+	}
+
+
+
 	/**
 	 * Returns the number of rows in a result set.
 	 * @return int
 	 */
-	public function rowCount()
+	public function getRowCount()
 	{
 		return pg_num_rows($this->resultSet);
 	}
@@ -331,7 +403,6 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 	 * Fetches the row at current position and moves the internal cursor to the next position.
 	 * @param  bool     TRUE for associative array, FALSE for numeric
 	 * @return array    array on success, nonarray if no next record
-	 * @internal
 	 */
 	public function fetch($assoc)
 	{
@@ -344,7 +415,6 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 	 * Moves cursor position without fetching row.
 	 * @param  int      the 0-based cursor pos to seek to
 	 * @return boolean  TRUE on success, FALSE if unable to seek to specified record
-	 * @throws DibiException
 	 */
 	public function seek($row)
 	{
@@ -369,11 +439,11 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 	 * Returns metadata for all columns in a result set.
 	 * @return array
 	 */
-	public function getColumnsMeta()
+	public function getResultColumns()
 	{
 		$hasTable = version_compare(PHP_VERSION , '5.2.0', '>=');
 		$count = pg_num_fields($this->resultSet);
-		$res = array();
+		$columns = array();
 		for ($i = 0; $i < $count; $i++) {
 			$row = array(
 				'name'      => pg_field_name($this->resultSet, $i),
@@ -381,9 +451,9 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 				'nativetype'=> pg_field_type($this->resultSet, $i),
 			);
 			$row['fullname'] = $row['table'] ? $row['table'] . '.' . $row['name'] : $row['name'];
-			$res[] = $row;
+			$columns[] = $row;
 		}
-		return $res;
+		return $columns;
 	}
 
 
@@ -394,12 +464,13 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getResultResource()
 	{
-		return $this->resultSet;
+		$this->autoFree = FALSE;
+		return is_resource($this->resultSet) ? $this->resultSet : NULL;
 	}
 
 
 
-	/********************* reflection ****************d*g**/
+	/********************* IDibiReflector ****************d*g**/
 
 
 
@@ -409,19 +480,25 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getTables()
 	{
-		$version = pg_version($this->connection);
-		if ($version['server'] < 8) {
-			throw new NotSupportedException('Reflection requires PostgreSQL 8.');
+		$version = pg_parameter_status($this->resource, 'server_version');
+		if ($version < 7.4) {
+			throw new DibiDriverException('Reflection requires PostgreSQL 7.4 and newer.');
 		}
 
-		$this->query("
-			SELECT table_name as name, CAST(table_type = 'VIEW' AS INTEGER) as view
-			FROM information_schema.tables
-			WHERE table_schema = current_schema()
+		$res = $this->query("
+			SELECT
+				table_name AS name,
+				CASE table_type
+					WHEN 'VIEW' THEN 1
+					ELSE 0
+				END AS view
+			FROM
+				information_schema.tables
+			WHERE
+				table_schema = current_schema()
 		");
-		$res = pg_fetch_all($this->resultSet);
-		$this->free();
-		return $res;
+		$tables = pg_fetch_all($res->resultSet);
+		return $tables ? $tables : array();
 	}
 
 
@@ -433,25 +510,25 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getColumns($table)
 	{
-		$_table = $this->escape($table, dibi::FIELD_TEXT);
-		$this->query("
+		$_table = $this->escape($table, dibi::TEXT);
+		$res = $this->query("
 			SELECT indkey
 			FROM pg_class
 			LEFT JOIN pg_index on pg_class.oid = pg_index.indrelid AND pg_index.indisprimary
 			WHERE pg_class.relname = $_table
 		");
-		$primary = (int) pg_fetch_object($this->resultSet)->indkey;
+		$primary = (int) pg_fetch_object($res->resultSet)->indkey;
 
-		$this->query("
+		$res = $this->query("
 			SELECT *
 			FROM information_schema.columns
 			WHERE table_name = $_table AND table_schema = current_schema()
 			ORDER BY ordinal_position
 		");
-		$res = array();
-		while ($row = $this->fetch(TRUE)) {
+		$columns = array();
+		while ($row = $res->fetch(TRUE)) {
 			$size = (int) max($row['character_maximum_length'], $row['numeric_precision']);
-			$res[] = array(
+			$columns[] = array(
 				'name' => $row['column_name'],
 				'table' => $table,
 				'nativetype' => strtoupper($row['udt_name']),
@@ -462,8 +539,7 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 				'vendor' => $row,
 			);
 		}
-		$this->free();
-		return $res;
+		return $columns;
 	}
 
 
@@ -475,8 +551,8 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getIndexes($table)
 	{
-		$_table = $this->escape($table, dibi::FIELD_TEXT);
-		$this->query("
+		$_table = $this->escape($table, dibi::TEXT);
+		$res = $this->query("
 			SELECT ordinal_position, column_name
 			FROM information_schema.columns
 			WHERE table_name = $_table AND table_schema = current_schema()
@@ -484,11 +560,11 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 		");
 
 		$columns = array();
-		while ($row = $this->fetch(TRUE)) {
+		while ($row = $res->fetch(TRUE)) {
 			$columns[$row['ordinal_position']] = $row['column_name'];
 		}
 
-		$this->query("
+		$res = $this->query("
 			SELECT pg_class2.relname, indisunique, indisprimary, indkey
 			FROM pg_class
 			LEFT JOIN pg_index on pg_class.oid = pg_index.indrelid
@@ -496,17 +572,16 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 			WHERE pg_class.relname = $_table
 		");
 
-		$res = array();
-		while ($row = $this->fetch(TRUE)) {
-			$res[$row['relname']]['name'] = $row['relname'];
-			$res[$row['relname']]['unique'] = $row['indisunique'] === 't';
-			$res[$row['relname']]['primary'] = $row['indisprimary'] === 't';
+		$indexes = array();
+		while ($row = $res->fetch(TRUE)) {
+			$indexes[$row['relname']]['name'] = $row['relname'];
+			$indexes[$row['relname']]['unique'] = $row['indisunique'] === 't';
+			$indexes[$row['relname']]['primary'] = $row['indisprimary'] === 't';
 			foreach (explode(' ', $row['indkey']) as $index) {
-				$res[$row['relname']]['columns'][] = $columns[$index];
+				$indexes[$row['relname']]['columns'][] = $columns[$index];
 			}
 		}
-		$this->free();
-		return array_values($res);
+		return array_values($indexes);
 	}
 
 
@@ -518,7 +593,72 @@ class DibiPostgreDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getForeignKeys($table)
 	{
-		throw new NotImplementedException;
+		$_table = $this->escape($table, dibi::TEXT);
+
+		$res = $this->query("
+			SELECT
+				c.conname AS name,
+				lt.attname AS local,
+				c.confrelid::regclass AS table,
+				ft.attname AS foreign,
+
+				CASE c.confupdtype
+					WHEN 'a' THEN 'NO ACTION'
+					WHEN 'r' THEN 'RESTRICT'
+					WHEN 'c' THEN 'CASCADE'
+					WHEN 'n' THEN 'SET NULL'
+					WHEN 'd' THEN 'SET DEFAULT'
+					ELSE 'UNKNOWN'
+				END AS \"onUpdate\",
+
+				CASE c.confdeltype
+					WHEN 'a' THEN 'NO ACTION'
+					WHEN 'r' THEN 'RESTRICT'
+					WHEN 'c' THEN 'CASCADE'
+					WHEN 'n' THEN 'SET NULL'
+					WHEN 'd' THEN 'SET DEFAULT'
+					ELSE 'UNKNOWN'
+				END AS \"onDelete\",
+
+				c.conkey,
+				lt.attnum AS lnum,
+				c.confkey,
+				ft.attnum AS fnum
+			FROM
+				pg_constraint c
+				JOIN pg_attribute lt ON c.conrelid = lt.attrelid AND lt.attnum = ANY (c.conkey)
+				JOIN pg_attribute ft ON c.confrelid = ft.attrelid AND ft.attnum = ANY (c.confkey)
+			WHERE
+				c.contype = 'f'
+				AND
+				c.conrelid = $_table::regclass
+		");
+
+		$fKeys = $references = array();
+		while ($row = $res->fetch(TRUE)) {
+			if (!isset($fKeys[$row['name']])) {
+				$fKeys[$row['name']] = array(
+					'name' => $row['name'],
+					'table' => $row['table'],
+					'local' => array(),
+					'foreign' => array(),
+					'onUpdate' => $row['onUpdate'],
+					'onDelete' => $row['onDelete'],
+				);
+
+				$l = explode(',', trim($row['conkey'], '{}'));
+				$f = explode(',', trim($row['confkey'], '{}'));
+
+				$references[$row['name']] = array_combine($l, $f);
+			}
+
+			if (isset($references[$row['name']][$row['lnum']]) && $references[$row['name']][$row['lnum']] === $row['fnum']) {
+				$fKeys[$row['name']]['local'][] = $row['local'];
+				$fKeys[$row['name']]['foreign'][] = $row['foreign'];
+			}
+		}
+
+		return $fKeys;
 	}
 
 }

dibi/drivers/sqlite.php

@@ -1,66 +1,61 @@
 <?php
 
 /**
- * dibi - tiny'n'smart database abstraction layer
- * ----------------------------------------------
+ * This file is part of the "dibi" - smart database abstraction layer.
  *
- * Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
  *
- * This source file is subject to the "dibi license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://dibiphp.com
- *
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @license    http://dibiphp.com/license  dibi license
- * @link       http://dibiphp.com
- * @package    dibi
- * @version    $Id$
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
  */
 
 
+require_once dirname(__FILE__) . '/sqlite.reflector.php';
+
+
 /**
  * The dibi driver for SQLite database.
  *
- * Connection options:
- *   - 'database' (or 'file') - the filename of the SQLite database
- *   - 'persistent' - try to find a persistent link?
- *   - 'unbuffered' - sends query without fetching and buffering the result rows automatically?
- *   - 'lazy' - if TRUE, connection will be established only when required
- *   - 'formatDate' - how to format date in SQL (@see date)
- *   - 'formatDateTime' - how to format datetime in SQL (@see date)
+ * Driver options:
+ *   - database (or file) => the filename of the SQLite database
+ *   - persistent (bool) => try to find a persistent link?
+ *   - unbuffered (bool) => sends query without fetching and buffering the result rows automatically?
+ *   - formatDate => how to format date in SQL (@see date)
+ *   - formatDateTime => how to format datetime in SQL (@see date)
+ *   - dbcharset => database character encoding (will be converted to 'charset')
+ *   - charset => character encoding to set (default is UTF-8)
+ *   - resource (resource) => existing connection resource
+ *   - lazy, profiler, result, substitutes, ... => see DibiConnection options
  *
  * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @package    dibi
+ * @package    dibi\drivers
  */
-class DibiSqliteDriver extends DibiObject implements IDibiDriver
+class DibiSqliteDriver extends DibiObject implements IDibiDriver, IDibiResultDriver
 {
-
 	/** @var resource  Connection resource */
 	private $connection;
 
-
 	/** @var resource  Resultset resource */
 	private $resultSet;
 
-
 	/** @var bool  Is buffered (seekable and countable)? */
 	private $buffered;
 
-
 	/** @var string  Date and datetime format */
 	private $fmtDate, $fmtDateTime;
 
+	/** @var string  character encoding */
+	private $dbcharset, $charset;
+
 
 
 	/**
-	 * @throws DibiException
+	 * @throws DibiNotSupportedException
 	 */
 	public function __construct()
 	{
 		if (!extension_loaded('sqlite')) {
-			throw new DibiDriverException("PHP extension 'sqlite' is not loaded.");
+			throw new DibiNotSupportedException("PHP extension 'sqlite' is not loaded.");
 		}
 	}
 
@@ -78,7 +73,9 @@ class DibiSqliteDriver extends DibiObject implements IDibiDriver
 		$this->fmtDateTime = isset($config['formatDateTime']) ? $config['formatDateTime'] : 'U';
 
 		$errorMsg = '';
-		if (empty($config['persistent'])) {
+		if (isset($config['resource'])) {
+			$this->connection = $config['resource'];
+		} elseif (empty($config['persistent'])) {
 			$this->connection = @sqlite_open($config['database'], 0666, $errorMsg); // intentionally @
 		} else {
 			$this->connection = @sqlite_popen($config['database'], 0666, $errorMsg); // intentionally @
@@ -89,6 +86,12 @@ class DibiSqliteDriver extends DibiObject implements IDibiDriver
 		}
 
 		$this->buffered = empty($config['unbuffered']);
+
+		$this->dbcharset = empty($config['dbcharset']) ? 'UTF-8' : $config['dbcharset'];
+		$this->charset = empty($config['charset']) ? 'UTF-8' : $config['charset'];
+		if (strcasecmp($this->dbcharset, $this->charset) === 0) {
+			$this->dbcharset = $this->charset = NULL;
+		}
 	}
 
 
@@ -107,22 +110,27 @@ class DibiSqliteDriver extends DibiObject implements IDibiDriver
 	/**
 	 * Executes the SQL query.
 	 * @param  string      SQL statement.
-	 * @return IDibiDriver|NULL
+	 * @return IDibiResultDriver|NULL
 	 * @throws DibiDriverException
 	 */
 	public function query($sql)
 	{
+		if ($this->dbcharset !== NULL) {
+			$sql = iconv($this->charset, $this->dbcharset . '//IGNORE', $sql);
+		}
+
 		DibiDriverException::tryError();
 		if ($this->buffered) {
-			$this->resultSet = sqlite_query($this->connection, $sql);
+			$res = sqlite_query($this->connection, $sql);
 		} else {
-			$this->resultSet = sqlite_unbuffered_query($this->connection, $sql);
+			$res = sqlite_unbuffered_query($this->connection, $sql);
 		}
 		if (DibiDriverException::catchError($msg)) {
 			throw new DibiDriverException($msg, sqlite_last_error($this->connection), $sql);
-		}
 
-		return is_resource($this->resultSet) ? clone $this : NULL;
+		} elseif (is_resource($res)) {
+			return $this->createResultDriver($res);
+		}
 	}
 
 
@@ -131,7 +139,7 @@ class DibiSqliteDriver extends DibiObject implements IDibiDriver
 	 * Gets the number of affected rows by the last INSERT, UPDATE or DELETE query.
 	 * @return int|FALSE  number of rows or FALSE on error
 	 */
-	public function affectedRows()
+	public function getAffectedRows()
 	{
 		return sqlite_changes($this->connection);
 	}
@@ -142,7 +150,7 @@ class DibiSqliteDriver extends DibiObject implements IDibiDriver
 	 * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query.
 	 * @return int|FALSE  int on success or FALSE on failure
 	 */
-	public function insertId($sequence)
+	public function getInsertId($sequence)
 	{
 		return sqlite_last_insert_rowid($this->connection);
 	}
@@ -151,10 +159,11 @@ class DibiSqliteDriver extends DibiObject implements IDibiDriver
 
 	/**
 	 * Begins a transaction (if supported).
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function begin()
+	public function begin($savepoint = NULL)
 	{
 		$this->query('BEGIN');
 	}
@@ -163,10 +172,11 @@ class DibiSqliteDriver extends DibiObject implements IDibiDriver
 
 	/**
 	 * Commits statements in a transaction.
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function commit()
+	public function commit($savepoint = NULL)
 	{
 		$this->query('COMMIT');
 	}
@@ -175,10 +185,11 @@ class DibiSqliteDriver extends DibiObject implements IDibiDriver
 
 	/**
 	 * Rollback changes in a transaction.
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	public function rollback()
+	public function rollback($savepoint = NULL)
 	{
 		$this->query('ROLLBACK');
 	}
@@ -191,7 +202,32 @@ class DibiSqliteDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getResource()
 	{
-		return $this->connection;
+		return is_resource($this->connection) ? $this->connection : NULL;
+	}
+
+
+
+	/**
+	 * Returns the connection reflector.
+	 * @return IDibiReflector
+	 */
+	public function getReflector()
+	{
+		return new DibiSqliteReflector($this);
+	}
+
+
+
+	/**
+	 * Result set driver factory.
+	 * @param  resource
+	 * @return IDibiResultDriver
+	 */
+	public function createResultDriver($resource)
+	{
+		$res = clone $this;
+		$res->resultSet = $resource;
+		return $res;
 	}
 
 
@@ -201,30 +237,30 @@ class DibiSqliteDriver extends DibiObject implements IDibiDriver
 
 
 	/**
-	 * Encodes data for use in an SQL statement.
-	 * @param  string    value
-	 * @param  string    type (dibi::FIELD_TEXT, dibi::FIELD_BOOL, ...)
+	 * Encodes data for use in a SQL statement.
+	 * @param  mixed     value
+	 * @param  string    type (dibi::TEXT, dibi::BOOL, ...)
 	 * @return string    encoded value
 	 * @throws InvalidArgumentException
 	 */
 	public function escape($value, $type)
 	{
 		switch ($type) {
-		case dibi::FIELD_TEXT:
-		case dibi::FIELD_BINARY:
+		case dibi::TEXT:
+		case dibi::BINARY:
 			return "'" . sqlite_escape_string($value) . "'";
 
 		case dibi::IDENTIFIER:
-			return '[' . str_replace('.', '].[', strtr($value, '[]', '  ')) . ']';
+			return '[' . strtr($value, '[]', '  ') . ']';
 
-		case dibi::FIELD_BOOL:
+		case dibi::BOOL:
 			return $value ? 1 : 0;
 
-		case dibi::FIELD_DATE:
-			return date($this->fmtDate, $value);
+		case dibi::DATE:
+			return $value instanceof DateTime ? $value->format($this->fmtDate) : date($this->fmtDate, $value);
 
-		case dibi::FIELD_DATETIME:
-			return date($this->fmtDateTime, $value);
+		case dibi::DATETIME:
+			return $value instanceof DateTime ? $value->format($this->fmtDateTime) : date($this->fmtDateTime, $value);
 
 		default:
 			throw new InvalidArgumentException('Unsupported type.');
@@ -233,15 +269,31 @@ class DibiSqliteDriver extends DibiObject implements IDibiDriver
 
 
 
+	/**
+	 * Encodes string for use in a LIKE statement.
+	 * @param  string
+	 * @param  int
+	 * @return string
+	 */
+	public function escapeLike($value, $pos)
+	{
+		throw new DibiNotSupportedException;
+	}
+
+
+
 	/**
 	 * Decodes data from result set.
 	 * @param  string    value
-	 * @param  string    type (dibi::FIELD_BINARY)
+	 * @param  string    type (dibi::BINARY)
 	 * @return string    decoded value
 	 * @throws InvalidArgumentException
 	 */
 	public function unescape($value, $type)
 	{
+		if ($type === dibi::BINARY) {
+			return $value;
+		}
 		throw new InvalidArgumentException('Unsupported type.');
 	}
 
@@ -270,10 +322,10 @@ class DibiSqliteDriver extends DibiObject implements IDibiDriver
 	 * Returns the number of rows in a result set.
 	 * @return int
 	 */
-	public function rowCount()
+	public function getRowCount()
 	{
 		if (!$this->buffered) {
-			throw new DibiDriverException('Row count is not available for unbuffered queries.');
+			throw new DibiNotSupportedException('Row count is not available for unbuffered queries.');
 		}
 		return sqlite_num_rows($this->resultSet);
 	}
@@ -284,14 +336,17 @@ class DibiSqliteDriver extends DibiObject implements IDibiDriver
 	 * Fetches the row at current position and moves the internal cursor to the next position.
 	 * @param  bool     TRUE for associative array, FALSE for numeric
 	 * @return array    array on success, nonarray if no next record
-	 * @internal
 	 */
 	public function fetch($assoc)
 	{
 		$row = sqlite_fetch_array($this->resultSet, $assoc ? SQLITE_ASSOC : SQLITE_NUM);
-		if ($assoc && $row) {
+		$charset = $this->charset === NULL ? NULL : $this->charset . '//TRANSLIT';
+		if ($row && ($assoc || $charset)) {
 			$tmp = array();
 			foreach ($row as $k => $v) {
+				if ($charset !== NULL && is_string($v)) {
+					$v = iconv($this->dbcharset, $charset, $v);
+				}
 				$tmp[str_replace(array('[', ']'), '', $k)] = $v;
 			}
 			return $tmp;
@@ -310,7 +365,7 @@ class DibiSqliteDriver extends DibiObject implements IDibiDriver
 	public function seek($row)
 	{
 		if (!$this->buffered) {
-			throw new DibiDriverException('Cannot seek an unbuffered result set.');
+			throw new DibiNotSupportedException('Cannot seek an unbuffered result set.');
 		}
 		return sqlite_seek($this->resultSet, $row);
 	}
@@ -332,21 +387,21 @@ class DibiSqliteDriver extends DibiObject implements IDibiDriver
 	 * Returns metadata for all columns in a result set.
 	 * @return array
 	 */
-	public function getColumnsMeta()
+	public function getResultColumns()
 	{
 		$count = sqlite_num_fields($this->resultSet);
-		$res = array();
+		$columns = array();
 		for ($i = 0; $i < $count; $i++) {
 			$name = str_replace(array('[', ']'), '', sqlite_field_name($this->resultSet, $i));
 			$pair = explode('.', $name);
-			$res[] = array(
+			$columns[] = array(
 				'name'  => isset($pair[1]) ? $pair[1] : $pair[0],
 				'table' => isset($pair[1]) ? $pair[0] : NULL,
 				'fullname' => $name,
 				'nativetype' => NULL,
 			);
 		}
-		return $res;
+		return $columns;
 	}
 
 
@@ -357,66 +412,40 @@ class DibiSqliteDriver extends DibiObject implements IDibiDriver
 	 */
 	public function getResultResource()
 	{
-		return $this->resultSet;
+		return is_resource($this->resultSet) ? $this->resultSet : NULL;
 	}
 
 
 
-	/********************* reflection ****************d*g**/
+	/********************* user defined functions ****************d*g**/
 
 
 
 	/**
-	 * Returns list of tables.
-	 * @return array
+	 * Registers an user defined function for use in SQL statements.
+	 * @param  string  function name
+	 * @param  mixed   callback
+	 * @param  int     num of arguments
+	 * @return void
 	 */
-	public function getTables()
+	public function registerFunction($name, $callback, $numArgs = -1)
 	{
-		$this->query("
-			SELECT name, type = 'view' as view FROM sqlite_master WHERE type IN ('table', 'view')
-			UNION ALL
-			SELECT name, type = 'view' as view FROM sqlite_temp_master WHERE type IN ('table', 'view')
-			ORDER BY name
-		");
-		$res = sqlite_fetch_all($this->resultSet, SQLITE_ASSOC);
-		$this->free();
-		return $res;
+		sqlite_create_function($this->connection, $name, $callback, $numArgs);
 	}
 
 
 
 	/**
-	 * Returns metadata for all columns in a table.
-	 * @param  string
-	 * @return array
+	 * Registers an aggregating user defined function for use in SQL statements.
+	 * @param  string  function name
+	 * @param  mixed   callback called for each row of the result set
+	 * @param  mixed   callback called to aggregate the "stepped" data from each row
+	 * @param  int     num of arguments
+	 * @return void
 	 */
-	public function getColumns($table)
+	public function registerAggregateFunction($name, $rowCallback, $agrCallback, $numArgs = -1)
 	{
-		throw new NotImplementedException;
-	}
-
-
-
-	/**
-	 * Returns metadata for all indexes in a table.
-	 * @param  string
-	 * @return array
-	 */
-	public function getIndexes($table)
-	{
-		throw new NotImplementedException;
-	}
-
-
-
-	/**
-	 * Returns metadata for all foreign keys in a table.
-	 * @param  string
-	 * @return array
-	 */
-	public function getForeignKeys($table)
-	{
-		throw new NotImplementedException;
+		sqlite_create_aggregate($this->connection, $name, $rowCallback, $agrCallback, $numArgs);
 	}
 
 }

dibi/drivers/sqlite.reflector.php

@@ -0,0 +1,170 @@
+<?php
+
+/**
+ * This file is part of the "dibi" - smart database abstraction layer.
+ *
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
+ */
+
+
+/**
+ * The dibi reflector for SQLite database.
+ *
+ * @author     David Grudl
+ * @package    dibi\drivers
+ * @internal
+ */
+class DibiSqliteReflector extends DibiObject implements IDibiReflector
+{
+	/** @var IDibiDriver */
+	private $driver;
+
+
+
+	public function __construct(IDibiDriver $driver)
+	{
+		$this->driver = $driver;
+	}
+
+
+
+	/**
+	 * Returns list of tables.
+	 * @return array
+	 */
+	public function getTables()
+	{
+		$res = $this->driver->query("
+			SELECT name, type = 'view' as view FROM sqlite_master WHERE type IN ('table', 'view')
+			UNION ALL
+			SELECT name, type = 'view' as view FROM sqlite_temp_master WHERE type IN ('table', 'view')
+			ORDER BY name
+		");
+		$tables = array();
+		while ($row = $res->fetch(TRUE)) {
+			$tables[] = $row;
+		}
+		return $tables;
+	}
+
+
+
+	/**
+	 * Returns metadata for all columns in a table.
+	 * @param  string
+	 * @return array
+	 */
+	public function getColumns($table)
+	{
+		$meta = $this->driver->query("
+			SELECT sql FROM sqlite_master WHERE type = 'table' AND name = {$this->driver->escape($table, dibi::TEXT)}
+			UNION ALL
+			SELECT sql FROM sqlite_temp_master WHERE type = 'table' AND name = {$this->driver->escape($table, dibi::TEXT)}
+		")->fetch(TRUE);
+
+		$res = $this->driver->query("PRAGMA table_info({$this->driver->escape($table, dibi::IDENTIFIER)})");
+		$columns = array();
+		while ($row = $res->fetch(TRUE)) {
+			$column = $row['name'];
+			$pattern = "/(\"$column\"|\[$column\]|$column)\\s+[^,]+\\s+PRIMARY\\s+KEY\\s+AUTOINCREMENT/Ui";
+			$type = explode('(', $row['type']);
+			$columns[] = array(
+				'name' => $column,
+				'table' => $table,
+				'fullname' => "$table.$column",
+				'nativetype' => strtoupper($type[0]),
+				'size' => isset($type[1]) ? (int) $type[1] : NULL,
+				'nullable' => $row['notnull'] == '0',
+				'default' => $row['dflt_value'],
+				'autoincrement' => (bool) preg_match($pattern, $meta['sql']),
+				'vendor' => $row,
+			);
+		}
+		return $columns;
+	}
+
+
+
+	/**
+	 * Returns metadata for all indexes in a table.
+	 * @param  string
+	 * @return array
+	 */
+	public function getIndexes($table)
+	{
+		$res = $this->driver->query("PRAGMA index_list({$this->driver->escape($table, dibi::IDENTIFIER)})");
+		$indexes = array();
+		while ($row = $res->fetch(TRUE)) {
+			$indexes[$row['name']]['name'] = $row['name'];
+			$indexes[$row['name']]['unique'] = (bool) $row['unique'];
+		}
+
+		foreach ($indexes as $index => $values) {
+			$res = $this->driver->query("PRAGMA index_info({$this->driver->escape($index, dibi::IDENTIFIER)})");
+			while ($row = $res->fetch(TRUE)) {
+				$indexes[$index]['columns'][$row['seqno']] = $row['name'];
+			}
+		}
+
+		$columns = $this->getColumns($table);
+		foreach ($indexes as $index => $values) {
+			$column = $indexes[$index]['columns'][0];
+			$primary = FALSE;
+			foreach ($columns as $info) {
+				if ($column == $info['name']) {
+					$primary = $info['vendor']['pk'];
+					break;
+				}
+			}
+			$indexes[$index]['primary'] = (bool) $primary;
+		}
+		if (!$indexes) { // @see http://www.sqlite.org/lang_createtable.html#rowid
+			foreach ($columns as $column) {
+				if ($column['vendor']['pk']) {
+					$indexes[] = array(
+						'name' => 'ROWID',
+						'unique' => TRUE,
+						'primary' => TRUE,
+						'columns' => array($column['name']),
+					);
+					break;
+				}
+			}
+		}
+
+		return array_values($indexes);
+	}
+
+
+
+	/**
+	 * Returns metadata for all foreign keys in a table.
+	 * @param  string
+	 * @return array
+	 */
+	public function getForeignKeys($table)
+	{
+		if (!($this->driver instanceof DibiSqlite3Driver)) {
+			// throw new DibiNotSupportedException; // @see http://www.sqlite.org/foreignkeys.html
+		}
+		$res = $this->driver->query("PRAGMA foreign_key_list({$this->driver->escape($table, dibi::IDENTIFIER)})");
+		$keys = array();
+		while ($row = $res->fetch(TRUE)) {
+			$keys[$row['id']]['name'] = $row['id']; // foreign key name
+			$keys[$row['id']]['local'][$row['seq']] = $row['from']; // local columns
+			$keys[$row['id']]['table'] = $row['table']; // referenced table
+			$keys[$row['id']]['foreign'][$row['seq']] = $row['to']; // referenced columns
+			$keys[$row['id']]['onDelete'] = $row['on_delete'];
+			$keys[$row['id']]['onUpdate'] = $row['on_update'];
+
+			if ($keys[$row['id']]['foreign'][0] == NULL) {
+				$keys[$row['id']]['foreign'] = NULL;
+			}
+		}
+		return array_values($keys);
+	}
+
+}

dibi/drivers/sqlite3.php

@@ -0,0 +1,454 @@
+<?php
+
+/**
+ * This file is part of the "dibi" - smart database abstraction layer.
+ *
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
+ */
+
+
+require_once dirname(__FILE__) . '/sqlite.reflector.php';
+
+
+/**
+ * The dibi driver for SQLite3 database.
+ *
+ * Driver options:
+ *   - database (or file) => the filename of the SQLite3 database
+ *   - formatDate => how to format date in SQL (@see date)
+ *   - formatDateTime => how to format datetime in SQL (@see date)
+ *   - dbcharset => database character encoding (will be converted to 'charset')
+ *   - charset => character encoding to set (default is UTF-8)
+ *   - resource (SQLite3) => existing connection resource
+ *   - lazy, profiler, result, substitutes, ... => see DibiConnection options
+ *
+ * @author     David Grudl
+ * @package    dibi\drivers
+ */
+class DibiSqlite3Driver extends DibiObject implements IDibiDriver, IDibiResultDriver
+{
+	/** @var SQLite3  Connection resource */
+	private $connection;
+
+	/** @var SQLite3Result  Resultset resource */
+	private $resultSet;
+
+	/** @var bool */
+	private $autoFree = TRUE;
+
+	/** @var string  Date and datetime format */
+	private $fmtDate, $fmtDateTime;
+
+	/** @var string  character encoding */
+	private $dbcharset, $charset;
+
+
+
+	/**
+	 * @throws DibiNotSupportedException
+	 */
+	public function __construct()
+	{
+		if (!extension_loaded('sqlite3')) {
+			throw new DibiNotSupportedException("PHP extension 'sqlite3' is not loaded.");
+		}
+	}
+
+
+
+	/**
+	 * Connects to a database.
+	 * @return void
+	 * @throws DibiException
+	 */
+	public function connect(array &$config)
+	{
+		DibiConnection::alias($config, 'database', 'file');
+		$this->fmtDate = isset($config['formatDate']) ? $config['formatDate'] : 'U';
+		$this->fmtDateTime = isset($config['formatDateTime']) ? $config['formatDateTime'] : 'U';
+
+		if (isset($config['resource']) && $config['resource'] instanceof SQLite3) {
+			$this->connection = $config['resource'];
+		} else try {
+			$this->connection = new SQLite3($config['database']);
+
+		} catch (Exception $e) {
+			throw new DibiDriverException($e->getMessage(), $e->getCode());
+		}
+
+		$this->dbcharset = empty($config['dbcharset']) ? 'UTF-8' : $config['dbcharset'];
+		$this->charset = empty($config['charset']) ? 'UTF-8' : $config['charset'];
+		if (strcasecmp($this->dbcharset, $this->charset) === 0) {
+			$this->dbcharset = $this->charset = NULL;
+		}
+
+		// enable foreign keys support (defaultly disabled; if disabled then foreign key constraints are not enforced)
+		$version = SQLite3::version();
+		if ($version['versionNumber'] >= '3006019') {
+			$this->query("PRAGMA foreign_keys = ON");
+		}
+	}
+
+
+
+	/**
+	 * Disconnects from a database.
+	 * @return void
+	 */
+	public function disconnect()
+	{
+		$this->connection->close();
+	}
+
+
+
+	/**
+	 * Executes the SQL query.
+	 * @param  string      SQL statement.
+	 * @return IDibiResultDriver|NULL
+	 * @throws DibiDriverException
+	 */
+	public function query($sql)
+	{
+		if ($this->dbcharset !== NULL) {
+			$sql = iconv($this->charset, $this->dbcharset . '//IGNORE', $sql);
+		}
+
+		$res = @$this->connection->query($sql); // intentionally @
+		if ($this->connection->lastErrorCode()) {
+			throw new DibiDriverException($this->connection->lastErrorMsg(), $this->connection->lastErrorCode(), $sql);
+
+		} elseif ($res instanceof SQLite3Result) {
+			return $this->createResultDriver($res);
+		}
+	}
+
+
+
+	/**
+	 * Gets the number of affected rows by the last INSERT, UPDATE or DELETE query.
+	 * @return int|FALSE  number of rows or FALSE on error
+	 */
+	public function getAffectedRows()
+	{
+		return $this->connection->changes();
+	}
+
+
+
+	/**
+	 * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query.
+	 * @return int|FALSE  int on success or FALSE on failure
+	 */
+	public function getInsertId($sequence)
+	{
+		return $this->connection->lastInsertRowID();
+	}
+
+
+
+	/**
+	 * Begins a transaction (if supported).
+	 * @param  string  optional savepoint name
+	 * @return void
+	 * @throws DibiDriverException
+	 */
+	public function begin($savepoint = NULL)
+	{
+		$this->query($savepoint ? "SAVEPOINT $savepoint" : 'BEGIN');
+	}
+
+
+
+	/**
+	 * Commits statements in a transaction.
+	 * @param  string  optional savepoint name
+	 * @return void
+	 * @throws DibiDriverException
+	 */
+	public function commit($savepoint = NULL)
+	{
+		$this->query($savepoint ? "RELEASE SAVEPOINT $savepoint" : 'COMMIT');
+	}
+
+
+
+	/**
+	 * Rollback changes in a transaction.
+	 * @param  string  optional savepoint name
+	 * @return void
+	 * @throws DibiDriverException
+	 */
+	public function rollback($savepoint = NULL)
+	{
+		$this->query($savepoint ? "ROLLBACK TO SAVEPOINT $savepoint" : 'ROLLBACK');
+	}
+
+
+
+	/**
+	 * Returns the connection resource.
+	 * @return mixed
+	 */
+	public function getResource()
+	{
+		return $this->connection;
+	}
+
+
+
+	/**
+	 * Returns the connection reflector.
+	 * @return IDibiReflector
+	 */
+	public function getReflector()
+	{
+		return new DibiSqliteReflector($this);
+	}
+
+
+
+	/**
+	 * Result set driver factory.
+	 * @param  SQLite3Result
+	 * @return IDibiResultDriver
+	 */
+	public function createResultDriver(SQLite3Result $resource)
+	{
+		$res = clone $this;
+		$res->resultSet = $resource;
+		return $res;
+	}
+
+
+
+	/********************* SQL ****************d*g**/
+
+
+
+	/**
+	 * Encodes data for use in a SQL statement.
+	 * @param  mixed     value
+	 * @param  string    type (dibi::TEXT, dibi::BOOL, ...)
+	 * @return string    encoded value
+	 * @throws InvalidArgumentException
+	 */
+	public function escape($value, $type)
+	{
+		switch ($type) {
+		case dibi::TEXT:
+			return "'" . $this->connection->escapeString($value) . "'";
+
+		case dibi::BINARY:
+			return "X'" . bin2hex((string) $value) . "'";
+
+		case dibi::IDENTIFIER:
+			return '[' . strtr($value, '[]', '  ') . ']';
+
+		case dibi::BOOL:
+			return $value ? 1 : 0;
+
+		case dibi::DATE:
+			return $value instanceof DateTime ? $value->format($this->fmtDate) : date($this->fmtDate, $value);
+
+		case dibi::DATETIME:
+			return $value instanceof DateTime ? $value->format($this->fmtDateTime) : date($this->fmtDateTime, $value);
+
+		default:
+			throw new InvalidArgumentException('Unsupported type.');
+		}
+	}
+
+
+
+	/**
+	 * Encodes string for use in a LIKE statement.
+	 * @param  string
+	 * @param  int
+	 * @return string
+	 */
+	public function escapeLike($value, $pos)
+	{
+		$value = addcslashes($this->connection->escapeString($value), '%_\\');
+		return ($pos <= 0 ? "'%" : "'") . $value . ($pos >= 0 ? "%'" : "'") . " ESCAPE '\\'";
+	}
+
+
+
+	/**
+	 * Decodes data from result set.
+	 * @param  string    value
+	 * @param  string    type (dibi::BINARY)
+	 * @return string    decoded value
+	 * @throws InvalidArgumentException
+	 */
+	public function unescape($value, $type)
+	{
+		if ($type === dibi::BINARY) {
+			return $value;
+		}
+		throw new InvalidArgumentException('Unsupported type.');
+	}
+
+
+
+	/**
+	 * Injects LIMIT/OFFSET to the SQL query.
+	 * @param  string &$sql  The SQL query that will be modified.
+	 * @param  int $limit
+	 * @param  int $offset
+	 * @return void
+	 */
+	public function applyLimit(&$sql, $limit, $offset)
+	{
+		if ($limit < 0 && $offset < 1) return;
+		$sql .= ' LIMIT ' . $limit . ($offset > 0 ? ' OFFSET ' . (int) $offset : '');
+	}
+
+
+
+	/********************* result set ****************d*g**/
+
+
+
+	/**
+	 * Automatically frees the resources allocated for this result set.
+	 * @return void
+	 */
+	public function __destruct()
+	{
+		$this->autoFree && $this->resultSet && @$this->free();
+	}
+
+
+
+	/**
+	 * Returns the number of rows in a result set.
+	 * @return int
+	 * @throws DibiNotSupportedException
+	 */
+	public function getRowCount()
+	{
+		throw new DibiNotSupportedException('Row count is not available for unbuffered queries.');
+	}
+
+
+
+	/**
+	 * Fetches the row at current position and moves the internal cursor to the next position.
+	 * @param  bool     TRUE for associative array, FALSE for numeric
+	 * @return array    array on success, nonarray if no next record
+	 */
+	public function fetch($assoc)
+	{
+		$row = $this->resultSet->fetchArray($assoc ? SQLITE3_ASSOC : SQLITE3_NUM);
+		$charset = $this->charset === NULL ? NULL : $this->charset . '//TRANSLIT';
+		if ($row && ($assoc || $charset)) {
+			$tmp = array();
+			foreach ($row as $k => $v) {
+				if ($charset !== NULL && is_string($v)) {
+					$v = iconv($this->dbcharset, $charset, $v);
+				}
+				$tmp[str_replace(array('[', ']'), '', $k)] = $v;
+			}
+			return $tmp;
+		}
+		return $row;
+	}
+
+
+
+	/**
+	 * Moves cursor position without fetching row.
+	 * @param  int      the 0-based cursor pos to seek to
+	 * @return boolean  TRUE on success, FALSE if unable to seek to specified record
+	 * @throws DibiNotSupportedException
+	 */
+	public function seek($row)
+	{
+		throw new DibiNotSupportedException('Cannot seek an unbuffered result set.');
+	}
+
+
+
+	/**
+	 * Frees the resources allocated for this result set.
+	 * @return void
+	 */
+	public function free()
+	{
+		$this->resultSet->finalize();
+		$this->resultSet = NULL;
+	}
+
+
+
+	/**
+	 * Returns metadata for all columns in a result set.
+	 * @return array
+	 */
+	public function getResultColumns()
+	{
+		$count = $this->resultSet->numColumns();
+		$columns = array();
+		static $types = array(SQLITE3_INTEGER => 'int', SQLITE3_FLOAT => 'float', SQLITE3_TEXT => 'text', SQLITE3_BLOB => 'blob', SQLITE3_NULL => 'null');
+		for ($i = 0; $i < $count; $i++) {
+			$columns[] = array(
+				'name'  => $this->resultSet->columnName($i),
+				'table' => NULL,
+				'fullname' => $this->resultSet->columnName($i),
+				'nativetype' => $types[$this->resultSet->columnType($i)],
+			);
+		}
+		return $columns;
+	}
+
+
+
+	/**
+	 * Returns the result set resource.
+	 * @return mixed
+	 */
+	public function getResultResource()
+	{
+		$this->autoFree = FALSE;
+		return $this->resultSet;
+	}
+
+
+
+	/********************* user defined functions ****************d*g**/
+
+
+
+	/**
+	 * Registers an user defined function for use in SQL statements.
+	 * @param  string  function name
+	 * @param  mixed   callback
+	 * @param  int     num of arguments
+	 * @return void
+	 */
+	public function registerFunction($name, $callback, $numArgs = -1)
+	{
+		$this->connection->createFunction($name, $callback, $numArgs);
+	}
+
+
+
+	/**
+	 * Registers an aggregating user defined function for use in SQL statements.
+	 * @param  string  function name
+	 * @param  mixed   callback called for each row of the result set
+	 * @param  mixed   callback called to aggregate the "stepped" data from each row
+	 * @param  int     num of arguments
+	 * @return void
+	 */
+	public function registerAggregateFunction($name, $rowCallback, $agrCallback, $numArgs = -1)
+	{
+		$this->connection->createAggregate($name, $rowCallback, $agrCallback, $numArgs);
+	}
+
+}

dibi/libs/DibiConnection.php

@@ -1,21 +1,12 @@
 <?php
 
 /**
- * dibi - tiny'n'smart database abstraction layer
- * ----------------------------------------------
+ * This file is part of the "dibi" - smart database abstraction layer.
  *
- * Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
  *
- * This source file is subject to the "dibi license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://dibiphp.com
- *
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @license    http://dibiphp.com/license  dibi license
- * @link       http://dibiphp.com
- * @package    dibi
- * @version    $Id$
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
  */
 
 
@@ -24,56 +15,81 @@
  * dibi connection.
  *
  * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
  * @package    dibi
+ *
+ * @property-read bool $connected
+ * @property-read mixed $config
+ * @property-read IDibiDriver $driver
+ * @property-read int $affectedRows
+ * @property-read int $insertId
+ * @property-read DibiDatabaseInfo $databaseInfo
  */
 class DibiConnection extends DibiObject
 {
+	/** @var array of function(DibiEvent $event); Occurs after query is executed */
+	public $onEvent;
+
 	/** @var array  Current connection configuration */
 	private $config;
 
-	/** @var IDibiDriver  Driver */
+	/** @var IDibiDriver */
 	private $driver;
 
-	/** @var IDibiProfiler  Profiler */
-	private $profiler;
+	/** @var DibiTranslator */
+	private $translator;
 
 	/** @var bool  Is connected? */
 	private $connected = FALSE;
 
-	/** @var bool  Is in transaction? */
-	private $inTxn = FALSE;
+	/** @var DibiHashMap Substitutes for identifiers */
+	private $substitutes;
 
 
 
 	/**
-	 * Creates object and (optionally) connects to a database.
-	 * @param  array|string|ArrayObject connection parameters
-	 * @param  string       connection name
+	 * Connection options: (see driver-specific options too)
+	 *   - lazy (bool) => if TRUE, connection will be established only when required
+	 *   - result (array) => result set options
+	 *       - formatDateTime => date-time format (if empty, DateTime objects will be returned)
+	 *   - profiler (array or bool)
+	 *       - run (bool) => enable profiler?
+	 *       - file => file to log
+	 *   - substitutes (array) => map of driver specific substitutes (under development)
+
+	 * @param  mixed   connection parameters
+	 * @param  string  connection name
 	 * @throws DibiException
 	 */
 	public function __construct($config, $name = NULL)
 	{
-		if (class_exists(/*Nette::*/'Debug', FALSE)) {
-			/*Nette::*/Debug::addColophon(array('dibi', 'getColophon'));
-		}
+		class_exists('dibi'); // ensure class dibi is loaded
 
 		// DSN string
 		if (is_string($config)) {
 			parse_str($config, $config);
 
-		} elseif ($config instanceof ArrayObject) {
-			$config = (array) $config;
+		} elseif ($config instanceof Traversable) {
+			$tmp = array();
+			foreach ($config as $key => $val) {
+				$tmp[$key] = $val instanceof Traversable ? iterator_to_array($val) : $val;
+			}
+			$config = $tmp;
 
 		} elseif (!is_array($config)) {
-			throw new InvalidArgumentException('Configuration must be array, string or ArrayObject.');
+			throw new InvalidArgumentException('Configuration must be array, string or object.');
 		}
 
+		self::alias($config, 'username', 'user');
+		self::alias($config, 'password', 'pass');
+		self::alias($config, 'host', 'hostname');
+		self::alias($config, 'result|formatDate', 'resultDate');
+		self::alias($config, 'result|formatDateTime', 'resultDateTime');
+
 		if (!isset($config['driver'])) {
 			$config['driver'] = dibi::$defaultDriver;
 		}
 
-		$driver = preg_replace('#[^a-z0-9_]#', '_', $config['driver']);
+		$driver = preg_replace('#[^a-z0-9_]#', '_', strtolower($config['driver']));
 		$class = "Dibi" . $driver . "Driver";
 		if (!class_exists($class, FALSE)) {
 			include_once dirname(__FILE__) . "/../drivers/$driver.php";
@@ -86,16 +102,35 @@ class DibiConnection extends DibiObject
 		$config['name'] = $name;
 		$this->config = $config;
 		$this->driver = new $class;
+		$this->translator = new DibiTranslator($this);
 
-		if (!empty($config['profiler'])) {
-			$class = $config['profiler'];
-			if (is_numeric($class) || is_bool($class)) {
-				$class = 'DibiProfiler';
+		// profiler
+		$profilerCfg = & $config['profiler'];
+		if (is_scalar($profilerCfg)) {
+			$profilerCfg = array('run' => (bool) $profilerCfg);
+		}
+		if (!empty($profilerCfg['run'])) {
+			$filter = isset($profilerCfg['filter']) ? $profilerCfg['filter'] : DibiEvent::QUERY;
+
+			if (isset($profilerCfg['file'])) {
+				$this->onEvent[] = array(new DibiFileLogger($profilerCfg['file'], $filter), 'logEvent');
 			}
-			if (!class_exists($class)) {
-				throw new DibiException("Unable to create instance of dibi profiler '$class'.");
+
+			if (DibiFirePhpLogger::isAvailable()) {
+				$this->onEvent[] = array(new DibiFirePhpLogger($filter), 'logEvent');
+			}
+
+			if (class_exists('DibiNettePanel', FALSE)) {
+				$panel = new DibiNettePanel(isset($profilerCfg['explain']) ? $profilerCfg['explain'] : TRUE, $filter);
+				$panel->register($this);
+			}
+		}
+
+		$this->substitutes = new DibiHashMap(create_function('$expr', 'return ":$expr:";'));
+		if (!empty($config['substitutes'])) {
+			foreach ($config['substitutes'] as $key => $value) {
+				$this->substitutes->$key = $value;
 			}
-			$this->setProfiler(new $class);
 		}
 
 		if (empty($config['lazy'])) {
@@ -112,7 +147,7 @@ class DibiConnection extends DibiObject
 	public function __destruct()
 	{
 		// disconnects and rolls back transaction - do not rely on auto-disconnect and rollback!
-		$this->disconnect();
+		$this->connected && $this->driver->getResource() && $this->disconnect();
 	}
 
 
@@ -121,17 +156,17 @@ class DibiConnection extends DibiObject
 	 * Connects to a database.
 	 * @return void
 	 */
-	final protected function connect()
+	final public function connect()
 	{
-		if (!$this->connected) {
-			if ($this->profiler !== NULL) {
-				$ticket = $this->profiler->before($this, IDibiProfiler::CONNECT);
-			}
+		$event = $this->onEvent ? new DibiEvent($this, DibiEvent::CONNECT) : NULL;
+		try {
 			$this->driver->connect($this->config);
 			$this->connected = TRUE;
-			if (isset($ticket)) {
-				$this->profiler->after($ticket);
-			}
+			$event && $this->onEvent($event->done());
+
+		} catch (DibiException $e) {
+			$event && $this->onEvent($event->done($e));
+			throw $e;
 		}
 	}
 
@@ -143,13 +178,8 @@ class DibiConnection extends DibiObject
 	 */
 	final public function disconnect()
 	{
-		if ($this->connected) {
-			if ($this->inTxn) {
-				$this->rollback();
-			}
-			$this->driver->disconnect();
-			$this->connected = FALSE;
-		}
+		$this->driver->disconnect();
+		$this->connected = FALSE;
 	}
 
 
@@ -194,27 +224,27 @@ class DibiConnection extends DibiObject
 	 * @param  string alias key
 	 * @return void
 	 */
-	public static function alias(&$config, $key, $alias=NULL)
+	public static function alias(&$config, $key, $alias)
 	{
-		if (isset($config[$key])) return;
+		$foo = & $config;
+		foreach (explode('|', $key) as $key) $foo = & $foo[$key];
 
-		if ($alias !== NULL && isset($config[$alias])) {
-			$config[$key] = $config[$alias];
+		if (!isset($foo) && isset($config[$alias])) {
+			$foo = $config[$alias];
 			unset($config[$alias]);
-		} else {
-			$config[$key] = NULL;
 		}
 	}
 
 
 
 	/**
-	 * Returns the connection resource.
-	 * @return resource
+	 * Returns the driver and connects to a database in lazy mode.
+	 * @return IDibiDriver
 	 */
-	final public function getResource()
+	final public function getDriver()
 	{
-		return $this->driver->getResource();
+		$this->connected || $this->connect();
+		return $this->driver;
 	}
 
 
@@ -222,19 +252,27 @@ class DibiConnection extends DibiObject
 	/**
 	 * Generates (translates) and executes SQL query.
 	 * @param  array|mixed      one or more arguments
-	 * @return DibiResult|NULL  result set object (if any)
+	 * @return DibiResult|int   result set object (if any)
 	 * @throws DibiException
 	 */
 	final public function query($args)
 	{
 		$args = func_get_args();
-		$this->connect();
-		$trans = new DibiTranslator($this->driver);
-		if ($trans->translate($args)) {
-			return $this->nativeQuery($trans->sql);
-		} else {
-			throw new DibiException('SQL translate error: ' . $trans->sql);
-		}
+		return $this->nativeQuery($this->translateArgs($args));
+	}
+
+
+
+	/**
+	 * Generates SQL query.
+	 * @param  array|mixed      one or more arguments
+	 * @return string
+	 * @throws DibiException
+	 */
+	final public function translate($args)
+	{
+		$args = func_get_args();
+		return $this->translateArgs($args);
 	}
 
 
@@ -247,11 +285,45 @@ class DibiConnection extends DibiObject
 	final public function test($args)
 	{
 		$args = func_get_args();
-		$this->connect();
-		$trans = new DibiTranslator($this->driver);
-		$ok = $trans->translate($args);
-		dibi::dump($trans->sql);
-		return $ok;
+		try {
+			dibi::dump($this->translateArgs($args));
+			return TRUE;
+
+		} catch (DibiException $e) {
+			if ($e->getSql()) {
+				dibi::dump($e->getSql());
+			} else {
+				echo get_class($e) . ': ' . $e->getMessage() . (PHP_SAPI === 'cli' ? "\n" : '<br>');
+			}
+			return FALSE;
+		}
+	}
+
+
+
+	/**
+	 * Generates (translates) and returns SQL query as DibiDataSource.
+	 * @param  array|mixed      one or more arguments
+	 * @return DibiDataSource
+	 * @throws DibiException
+	 */
+	final public function dataSource($args)
+	{
+		$args = func_get_args();
+		return new DibiDataSource($this->translateArgs($args), $this);
+	}
+
+
+
+	/**
+	 * Generates SQL query.
+	 * @param  array
+	 * @return string
+	 */
+	private function translateArgs($args)
+	{
+		$this->connected || $this->connect();
+		return $this->translator->translate($args);
 	}
 
 
@@ -259,41 +331,30 @@ class DibiConnection extends DibiObject
 	/**
 	 * Executes the SQL query.
 	 * @param  string           SQL statement.
-	 * @return DibiResult|NULL  result set object (if any)
+	 * @return DibiResult|int   result set object (if any)
 	 * @throws DibiException
 	 */
 	final public function nativeQuery($sql)
 	{
-		$this->connect();
+		$this->connected || $this->connect();
 
-		if ($this->profiler !== NULL) {
-			$event = IDibiProfiler::QUERY;
-			if (preg_match('#\s*(SELECT|UPDATE|INSERT|DELETE)#i', $sql, $matches)) {
-				static $events = array(
-					'SELECT' => IDibiProfiler::SELECT, 'UPDATE' => IDibiProfiler::UPDATE,
-					'INSERT' => IDibiProfiler::INSERT, 'DELETE' => IDibiProfiler::DELETE,
-				);
-				$event = $events[strtoupper($matches[1])];
-			}
-			$ticket = $this->profiler->before($this, $event, $sql);
-		}
-		// TODO: move to profiler?
-		dibi::$numOfQueries++;
 		dibi::$sql = $sql;
-		dibi::$elapsedTime = FALSE;
-		$time = -microtime(TRUE);
+		$event = $this->onEvent ? new DibiEvent($this, DibiEvent::QUERY, $sql) : NULL;
+		try {
+			$res = $this->driver->query($sql);
 
-		if ($res = $this->driver->query($sql)) { // intentionally =
-			$res = new DibiResult($res, $this->config);
+		} catch (DibiException $e) {
+			$event && $this->onEvent($event->done($e));
+			throw $e;
 		}
 
-		$time += microtime(TRUE);
-		dibi::$elapsedTime = $time;
-		dibi::$totalTime += $time;
-
-		if (isset($ticket)) {
-			$this->profiler->after($ticket, $res);
+		if ($res) {
+			$res = $this->createResultSet($res);
+		} else {
+			$res = $this->driver->getAffectedRows();
 		}
+
+		$event && $this->onEvent($event->done($res));
 		return $res;
 	}
 
@@ -304,47 +365,73 @@ class DibiConnection extends DibiObject
 	 * @return int  number of rows
 	 * @throws DibiException
 	 */
-	public function affectedRows()
+	public function getAffectedRows()
 	{
-		$rows = $this->driver->affectedRows();
+		$this->connected || $this->connect();
+		$rows = $this->driver->getAffectedRows();
 		if (!is_int($rows) || $rows < 0) throw new DibiException('Cannot retrieve number of affected rows.');
 		return $rows;
 	}
 
 
 
+	/**
+	 * Gets the number of affected rows. Alias for getAffectedRows().
+	 * @return int  number of rows
+	 * @throws DibiException
+	 */
+	public function affectedRows()
+	{
+		return $this->getAffectedRows();
+	}
+
+
+
 	/**
 	 * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query.
 	 * @param  string     optional sequence name
 	 * @return int
 	 * @throws DibiException
 	 */
-	public function insertId($sequence = NULL)
+	public function getInsertId($sequence = NULL)
 	{
-		$id = $this->driver->insertId($sequence);
+		$this->connected || $this->connect();
+		$id = $this->driver->getInsertId($sequence);
 		if ($id < 1) throw new DibiException('Cannot retrieve last generated ID.');
 		return (int) $id;
 	}
 
 
 
+	/**
+	 * Retrieves the ID generated for an AUTO_INCREMENT column. Alias for getInsertId().
+	 * @param  string     optional sequence name
+	 * @return int
+	 * @throws DibiException
+	 */
+	public function insertId($sequence = NULL)
+	{
+		return $this->getInsertId($sequence);
+	}
+
+
+
 	/**
 	 * Begins a transaction (if supported).
+	 * @param  string  optional savepoint name
 	 * @return void
 	 */
-	public function begin()
+	public function begin($savepoint = NULL)
 	{
-		$this->connect();
-		if ($this->inTxn) {
-			throw new DibiException('There is already an active transaction.');
-		}
-		if ($this->profiler !== NULL) {
-			$ticket = $this->profiler->before($this, IDibiProfiler::BEGIN);
-		}
-		$this->driver->begin();
-		$this->inTxn = TRUE;
-		if (isset($ticket)) {
-			$this->profiler->after($ticket);
+		$this->connected || $this->connect();
+		$event = $this->onEvent ? new DibiEvent($this, DibiEvent::BEGIN, $savepoint) : NULL;
+		try {
+			$this->driver->begin($savepoint);
+			$event && $this->onEvent($event->done());
+
+		} catch (DibiException $e) {
+			$event && $this->onEvent($event->done($e));
+			throw $e;
 		}
 	}
 
@@ -352,20 +439,20 @@ class DibiConnection extends DibiObject
 
 	/**
 	 * Commits statements in a transaction.
+	 * @param  string  optional savepoint name
 	 * @return void
 	 */
-	public function commit()
+	public function commit($savepoint = NULL)
 	{
-		if (!$this->inTxn) {
-			throw new DibiException('There is no active transaction.');
-		}
-		if ($this->profiler !== NULL) {
-			$ticket = $this->profiler->before($this, IDibiProfiler::COMMIT);
-		}
-		$this->driver->commit();
-		$this->inTxn = FALSE;
-		if (isset($ticket)) {
-			$this->profiler->after($ticket);
+		$this->connected || $this->connect();
+		$event = $this->onEvent ? new DibiEvent($this, DibiEvent::COMMIT, $savepoint) : NULL;
+		try {
+			$this->driver->commit($savepoint);
+			$event && $this->onEvent($event->done());
+
+		} catch (DibiException $e) {
+			$event && $this->onEvent($event->done($e));
+			throw $e;
 		}
 	}
 
@@ -373,74 +460,35 @@ class DibiConnection extends DibiObject
 
 	/**
 	 * Rollback changes in a transaction.
+	 * @param  string  optional savepoint name
 	 * @return void
 	 */
-	public function rollback()
+	public function rollback($savepoint = NULL)
 	{
-		if (!$this->inTxn) {
-			throw new DibiException('There is no active transaction.');
-		}
-		if ($this->profiler !== NULL) {
-			$ticket = $this->profiler->before($this, IDibiProfiler::ROLLBACK);
-		}
-		$this->driver->rollback();
-		$this->inTxn = FALSE;
-		if (isset($ticket)) {
-			$this->profiler->after($ticket);
+		$this->connected || $this->connect();
+		$event = $this->onEvent ? new DibiEvent($this, DibiEvent::ROLLBACK, $savepoint) : NULL;
+		try {
+			$this->driver->rollback($savepoint);
+			$event && $this->onEvent($event->done());
+
+		} catch (DibiException $e) {
+			$event && $this->onEvent($event->done($e));
+			throw $e;
 		}
 	}
 
 
 
 	/**
-	 * Encodes data for use in an SQL statement.
-	 * @param  string    unescaped string
-	 * @param  string    type (dibi::FIELD_TEXT, dibi::FIELD_BOOL, ...)
-	 * @return string    escaped and quoted string
+	 * Result set factory.
+	 * @param  IDibiResultDriver
+	 * @return DibiResult
 	 */
-	public function escape($value, $type = dibi::FIELD_TEXT)
+	public function createResultSet(IDibiResultDriver $resultDriver)
 	{
-		$this->connect(); // MySQL & PDO require connection
-		return $this->driver->escape($value, $type);
-	}
-
-
-
-	/**
-	 * Decodes data from result set.
-	 * @param  string    value
-	 * @param  string    type (dibi::FIELD_BINARY)
-	 * @return string    decoded value
-	 */
-	public function unescape($value, $type = dibi::FIELD_BINARY)
-	{
-		return $this->driver->unescape($value, $type);
-	}
-
-
-
-	/**
-	 * Delimites identifier (table's or column's name, etc.).
-	 * @param  string    identifier
-	 * @return string    delimited identifier
-	 */
-	public function delimite($value)
-	{
-		return $this->driver->escape($value, dibi::IDENTIFIER);
-	}
-
-
-
-	/**
-	 * Injects LIMIT/OFFSET to the SQL query.
-	 * @param  string &$sql  The SQL query that will be modified.
-	 * @param  int $limit
-	 * @param  int $offset
-	 * @return void
-	 */
-	public function applyLimit(&$sql, $limit, $offset)
-	{
-		$this->driver->applyLimit($sql, $limit, $offset);
+		$res = new DibiResult($resultDriver);
+		return $res->setFormat(dibi::DATE, $this->config['result']['formatDate'])
+			->setFormat(dibi::DATETIME, $this->config['result']['formatDateTime']);
 	}
 
 
@@ -476,8 +524,11 @@ class DibiConnection extends DibiObject
 	 * @param  array
 	 * @return DibiFluent
 	 */
-	public function update($table, array $args)
+	public function update($table, $args)
 	{
+		if (!(is_array($args) || $args instanceof Traversable)) {
+			throw new InvalidArgumentException('Arguments must be array or Traversable.');
+		}
 		return $this->command()->update('%n', $table)->set($args);
 	}
 
@@ -488,10 +539,15 @@ class DibiConnection extends DibiObject
 	 * @param  array
 	 * @return DibiFluent
 	 */
-	public function insert($table, array $args)
+	public function insert($table, $args)
 	{
+		if ($args instanceof Traversable) {
+			$args = iterator_to_array($args);
+		} elseif (!is_array($args)) {
+			throw new InvalidArgumentException('Arguments must be array or Traversable.');
+		}
 		return $this->command()->insert()
-			->into('%n', $table, '(%n)', array_keys($args))->values('%l', array_values($args));
+			->into('%n', $table, '(%n)', array_keys($args))->values('%l', $args);
 	}
 
 
@@ -507,27 +563,98 @@ class DibiConnection extends DibiObject
 
 
 
-	/********************* profiler ****************d*g**/
+	/********************* substitutions ****************d*g**/
 
 
 
 	/**
-	 * @param  IDibiProfiler
-	 * @return void
+	 * Returns substitution hashmap.
+	 * @return DibiHashMap
 	 */
-	public function setProfiler(IDibiProfiler $profiler = NULL)
+	public function getSubstitutes()
 	{
-		$this->profiler = $profiler;
+		return $this->substitutes;
 	}
 
 
 
 	/**
-	 * @return IDibiProfiler
+	 * Provides substitution.
+	 * @return string
 	 */
-	public function getProfiler()
+	public function substitute($value)
 	{
-		return $this->profiler;
+		return strpos($value, ':') === FALSE ? $value : preg_replace_callback('#:([^:\s]*):#', array($this, 'subCb'), $value);
+	}
+
+
+
+	/**
+	 * Substitution callback.
+	 */
+	private function subCb($m)
+	{
+		return $this->substitutes->{$m[1]};
+	}
+
+
+
+	/********************* shortcuts ****************d*g**/
+
+
+
+	/**
+	 * Executes SQL query and fetch result - shortcut for query() & fetch().
+	 * @param  array|mixed    one or more arguments
+	 * @return DibiRow
+	 * @throws DibiException
+	 */
+	public function fetch($args)
+	{
+		$args = func_get_args();
+		return $this->query($args)->fetch();
+	}
+
+
+
+	/**
+	 * Executes SQL query and fetch results - shortcut for query() & fetchAll().
+	 * @param  array|mixed    one or more arguments
+	 * @return array of DibiRow
+	 * @throws DibiException
+	 */
+	public function fetchAll($args)
+	{
+		$args = func_get_args();
+		return $this->query($args)->fetchAll();
+	}
+
+
+
+	/**
+	 * Executes SQL query and fetch first column - shortcut for query() & fetchSingle().
+	 * @param  array|mixed    one or more arguments
+	 * @return string
+	 * @throws DibiException
+	 */
+	public function fetchSingle($args)
+	{
+		$args = func_get_args();
+		return $this->query($args)->fetchSingle();
+	}
+
+
+
+	/**
+	 * Executes SQL query and fetch pairs - shortcut for query() & fetchPairs().
+	 * @param  array|mixed    one or more arguments
+	 * @return string
+	 * @throws DibiException
+	 */
+	public function fetchPairs($args)
+	{
+		$args = func_get_args();
+		return $this->query($args)->fetchPairs();
 	}
 
 
@@ -543,13 +670,12 @@ class DibiConnection extends DibiObject
 	 */
 	public function loadFile($file)
 	{
-		$this->connect();
-
+		$this->connected || $this->connect();
 		@set_time_limit(0); // intentionally @
 
 		$handle = @fopen($file, 'r'); // intentionally @
 		if (!$handle) {
-			throw new FileNotFoundException("Cannot open file '$file'.");
+			throw new RuntimeException("Cannot open file '$file'.");
 		}
 
 		$count = 0;
@@ -563,6 +689,10 @@ class DibiConnection extends DibiObject
 				$count++;
 			}
 		}
+		if (trim($sql) !== '') {
+			$this->driver->query($sql);
+			$count++;
+		}
 		fclose($handle);
 		return $count;
 	}
@@ -575,7 +705,8 @@ class DibiConnection extends DibiObject
 	 */
 	public function getDatabaseInfo()
 	{
-		return new DibiDatabaseInfo($this->driver, isset($this->config['database']) ? $this->config['database'] : NULL);
+		$this->connected || $this->connect();
+		return new DibiDatabaseInfo($this->driver->getReflector(), isset($this->config['database']) ? $this->config['database'] : NULL);
 	}
 
 
@@ -585,7 +716,7 @@ class DibiConnection extends DibiObject
 	 */
 	public function __wakeup()
 	{
-		throw new NotSupportedException('You cannot serialize or unserialize ' . $this->getClass() . ' instances.');
+		throw new DibiNotSupportedException('You cannot serialize or unserialize ' . $this->getClass() . ' instances.');
 	}
 
 
@@ -595,7 +726,7 @@ class DibiConnection extends DibiObject
 	 */
 	public function __sleep()
 	{
-		throw new NotSupportedException('You cannot serialize or unserialize ' . $this->getClass() . ' instances.');
+		throw new DibiNotSupportedException('You cannot serialize or unserialize ' . $this->getClass() . ' instances.');
 	}
 
 }

dibi/libs/DibiDataSource.php

@@ -1,21 +1,12 @@
 <?php
 
 /**
- * dibi - tiny'n'smart database abstraction layer
- * ----------------------------------------------
+ * This file is part of the "dibi" - smart database abstraction layer.
  *
- * Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
  *
- * This source file is subject to the "dibi license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://dibiphp.com
- *
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @license    http://dibiphp.com/license  dibi license
- * @link       http://dibiphp.com
- * @package    dibi
- * @version    $Id$
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
  */
 
 
@@ -24,8 +15,12 @@
  * Default implementation of IDataSource for dibi.
  *
  * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
  * @package    dibi
+ *
+ * @property-read DibiConnection $connection
+ * @property-read DibiResult $result
+ * @property-read DibiResultIterator $iterator
+ * @property-read int $totalCount
  */
 class DibiDataSource extends DibiObject implements IDataSource
 {
@@ -35,58 +30,310 @@ class DibiDataSource extends DibiObject implements IDataSource
 	/** @var string */
 	private $sql;
 
+	/** @var DibiResult */
+	private $result;
+
 	/** @var int */
 	private $count;
 
+	/** @var int */
+	private $totalCount;
+
+	/** @var array */
+	private $cols = array();
+
+	/** @var array */
+	private $sorting = array();
+
+	/** @var array */
+	private $conds = array();
+
+	/** @var int */
+	private $offset;
+
+	/** @var int */
+	private $limit;
+
 
 
 	/**
-	 * @param  string  SQL command or table name, as data source
+	 * @param  string  SQL command or table or view name, as data source
 	 * @param  DibiConnection  connection
 	 */
-	public function __construct($sql, DibiConnection $connection = NULL)
+	public function __construct($sql, DibiConnection $connection)
 	{
-		if (strpos($sql, ' ') === FALSE) {
-			// table name
-			$this->sql = $sql;
+		if (strpbrk($sql, " \t\r\n") === FALSE) {
+			$this->sql = $connection->getDriver()->escape($sql, dibi::IDENTIFIER); // table name
 		} else {
-			// SQL command
-			$this->sql = '(' . $sql . ') AS [source]';
+			$this->sql = '(' . $sql . ') t'; // SQL command
 		}
-
-		$this->connection = $connection === NULL ? dibi::getConnection() : $connection;
+		$this->connection = $connection;
 	}
 
 
 
 	/**
-	 * @param  int  offset
-	 * @param  int  limit
-	 * @param  array columns
-	 * @return ArrayIterator
+	 * Selects columns to query.
+	 * @param  string|array  column name or array of column names
+	 * @param  string  		 column alias
+	 * @return DibiDataSource  provides a fluent interface
 	 */
-	public function getIterator($offset = NULL, $limit = NULL)
+	public function select($col, $as = NULL)
 	{
-		return $this->connection->query('
-			SELECT *
-			FROM', $this->sql, '
-			%ofs %lmt', $offset, $limit
-		);
+		if (is_array($col)) {
+			$this->cols = $col;
+		} else {
+			$this->cols[$col] = $as;
+		}
+		$this->result = NULL;
+		return $this;
 	}
 
 
 
 	/**
+	 * Adds conditions to query.
+	 * @param  mixed  conditions
+	 * @return DibiDataSource  provides a fluent interface
+	 */
+	public function where($cond)
+	{
+		if (is_array($cond)) {
+			// TODO: not consistent with select and orderBy
+			$this->conds[] = $cond;
+		} else {
+			$this->conds[] = func_get_args();
+		}
+		$this->result = $this->count = NULL;
+		return $this;
+	}
+
+
+
+	/**
+	 * Selects columns to order by.
+	 * @param  string|array  column name or array of column names
+	 * @param  string  		 sorting direction
+	 * @return DibiDataSource  provides a fluent interface
+	 */
+	public function orderBy($row, $sorting = 'ASC')
+	{
+		if (is_array($row)) {
+			$this->sorting = $row;
+		} else {
+			$this->sorting[$row] = $sorting;
+		}
+		$this->result = NULL;
+		return $this;
+	}
+
+
+
+	/**
+	 * Limits number of rows.
+	 * @param  int limit
+	 * @param  int offset
+	 * @return DibiDataSource  provides a fluent interface
+	 */
+	public function applyLimit($limit, $offset = NULL)
+	{
+		$this->limit = $limit;
+		$this->offset = $offset;
+		$this->result = $this->count = NULL;
+		return $this;
+	}
+
+
+
+	/**
+	 * Returns the dibi connection.
+	 * @return DibiConnection
+	 */
+	final public function getConnection()
+	{
+		return $this->connection;
+	}
+
+
+
+	/********************* executing ****************d*g**/
+
+
+
+	/**
+	 * Returns (and queries) DibiResult.
+	 * @return DibiResult
+	 */
+	public function getResult()
+	{
+		if ($this->result === NULL) {
+			$this->result = $this->connection->nativeQuery($this->__toString());
+		}
+		return $this->result;
+	}
+
+
+
+	/**
+	 * @return DibiResultIterator
+	 */
+	public function getIterator()
+	{
+		return $this->getResult()->getIterator();
+	}
+
+
+
+	/**
+	 * Generates, executes SQL query and fetches the single row.
+	 * @return DibiRow|FALSE  array on success, FALSE if no next record
+	 */
+	public function fetch()
+	{
+		return $this->getResult()->fetch();
+	}
+
+
+
+	/**
+	 * Like fetch(), but returns only first field.
+	 * @return mixed  value on success, FALSE if no next record
+	 */
+	public function fetchSingle()
+	{
+		return $this->getResult()->fetchSingle();
+	}
+
+
+
+	/**
+	 * Fetches all records from table.
+	 * @return array
+	 */
+	public function fetchAll()
+	{
+		return $this->getResult()->fetchAll();
+	}
+
+
+
+	/**
+	 * Fetches all records from table and returns associative tree.
+	 * @param  string  associative descriptor
+	 * @return array
+	 */
+	public function fetchAssoc($assoc)
+	{
+		return $this->getResult()->fetchAssoc($assoc);
+	}
+
+
+
+	/**
+	 * Fetches all records from table like $key => $value pairs.
+	 * @param  string  associative key
+	 * @param  string  value
+	 * @return array
+	 */
+	public function fetchPairs($key = NULL, $value = NULL)
+	{
+		return $this->getResult()->fetchPairs($key, $value);
+	}
+
+
+
+	/**
+	 * Discards the internal cache.
+	 * @return void
+	 */
+	public function release()
+	{
+		$this->result = $this->count = $this->totalCount = NULL;
+	}
+
+
+
+	/********************* exporting ****************d*g**/
+
+
+
+	/**
+	 * Returns this data source wrapped in DibiFluent object.
+	 * @return DibiFluent
+	 */
+	public function toFluent()
+	{
+		return $this->connection->select('*')->from('(%SQL) t', $this->__toString());
+	}
+
+
+
+	/**
+	 * Returns this data source wrapped in DibiDataSource object.
+	 * @return DibiDataSource
+	 */
+	public function toDataSource()
+	{
+		return new self($this->__toString(), $this->connection);
+	}
+
+
+
+	/**
+	 * Returns SQL query.
+	 * @return string
+	 */
+	public function __toString()
+	{
+		try {
+			return $this->connection->translate('
+SELECT %n', (empty($this->cols) ? '*' : $this->cols), '
+FROM %SQL', $this->sql, '
+%ex', $this->conds ? array('WHERE %and', $this->conds) : NULL, '
+%ex', $this->sorting ? array('ORDER BY %by', $this->sorting) : NULL, '
+%ofs %lmt', $this->offset, $this->limit
+			);
+		} catch (Exception $e) {
+			trigger_error($e->getMessage(), E_USER_ERROR);
+		}
+	}
+
+
+
+	/********************* counting ****************d*g**/
+
+
+
+	/**
+	 * Returns the number of rows in a given data source.
 	 * @return int
 	 */
 	public function count()
 	{
 		if ($this->count === NULL) {
-			$this->count = $this->connection->query('
-				SELECT COUNT(*) FROM', $this->sql
-			)->fetchSingle();
+			$this->count = $this->conds || $this->offset || $this->limit
+				? (int) $this->connection->nativeQuery(
+					'SELECT COUNT(*) FROM (' . $this->__toString() . ') t'
+				)->fetchSingle()
+				: $this->getTotalCount();
 		}
 		return $this->count;
 	}
 
+
+
+	/**
+	 * Returns the number of rows in a given data source.
+	 * @return int
+	 */
+	public function getTotalCount()
+	{
+		if ($this->totalCount === NULL) {
+			$this->totalCount = (int) $this->connection->nativeQuery(
+				'SELECT COUNT(*) FROM ' . $this->sql
+			)->fetchSingle();
+		}
+		return $this->totalCount;
+	}
+
 }

dibi/libs/DibiDatabaseInfo.php

@@ -1,21 +1,12 @@
 <?php
 
 /**
- * dibi - tiny'n'smart database abstraction layer
- * ----------------------------------------------
+ * This file is part of the "dibi" - smart database abstraction layer.
  *
- * Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
  *
- * This source file is subject to the "dibi license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://dibiphp.com
- *
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @license    http://dibiphp.com/license  dibi license
- * @link       http://dibiphp.com
- * @package    dibi
- * @version    $Id$
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
  */
 
 
@@ -24,13 +15,16 @@
  * Reflection metadata class for a database.
  *
  * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @package    dibi
+ * @package    dibi\reflection
+ *
+ * @property-read string $name
+ * @property-read array $tables
+ * @property-read array $tableNames
  */
 class DibiDatabaseInfo extends DibiObject
 {
-	/** @var IDibiDriver */
-	private $driver;
+	/** @var IDibiReflector */
+	private $reflector;
 
 	/** @var string */
 	private $name;
@@ -40,9 +34,9 @@ class DibiDatabaseInfo extends DibiObject
 
 
 
-	public function __construct(IDibiDriver $driver, $name)
+	public function __construct(IDibiReflector $reflector, $name)
 	{
-		$this->driver = $driver;
+		$this->reflector = $reflector;
 		$this->name = $name;
 	}
 
@@ -85,7 +79,7 @@ class DibiDatabaseInfo extends DibiObject
 
 
 	/**
-	 * @param string
+	 * @param  string
 	 * @return DibiTableInfo
 	 */
 	public function getTable($name)
@@ -103,7 +97,7 @@ class DibiDatabaseInfo extends DibiObject
 
 
 	/**
-	 * @param string
+	 * @param  string
 	 * @return bool
 	 */
 	public function hasTable($name)
@@ -121,8 +115,8 @@ class DibiDatabaseInfo extends DibiObject
 	{
 		if ($this->tables === NULL) {
 			$this->tables = array();
-			foreach ($this->driver->getTables() as $info) {
-				$this->tables[strtolower($info['name'])] = new DibiTableInfo($this->driver, $info);
+			foreach ($this->reflector->getTables() as $info) {
+				$this->tables[strtolower($info['name'])] = new DibiTableInfo($this->reflector, $info);
 			}
 		}
 	}
@@ -136,13 +130,20 @@ class DibiDatabaseInfo extends DibiObject
  * Reflection metadata class for a database table.
  *
  * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @package    dibi
+ * @package    dibi\reflection
+ *
+ * @property-read string $name
+ * @property-read bool $view
+ * @property-read array $columns
+ * @property-read array $columnNames
+ * @property-read array $foreignKeys
+ * @property-read array $indexes
+ * @property-read DibiIndexInfo $primaryKey
  */
 class DibiTableInfo extends DibiObject
 {
-	/** @var IDibiDriver */
-	private $driver;
+	/** @var IDibiReflector */
+	private $reflector;
 
 	/** @var string */
 	private $name;
@@ -164,9 +165,9 @@ class DibiTableInfo extends DibiObject
 
 
 
-	public function __construct(IDibiDriver $driver, array $info)
+	public function __construct(IDibiReflector $reflector, array $info)
 	{
-		$this->driver = $driver;
+		$this->reflector = $reflector;
 		$this->name = $info['name'];
 		$this->view = !empty($info['view']);
 	}
@@ -220,7 +221,7 @@ class DibiTableInfo extends DibiObject
 
 
 	/**
-	 * @param string
+	 * @param  string
 	 * @return DibiColumnInfo
 	 */
 	public function getColumn($name)
@@ -238,7 +239,7 @@ class DibiTableInfo extends DibiObject
 
 
 	/**
-	 * @param string
+	 * @param  string
 	 * @return bool
 	 */
 	public function hasColumn($name)
@@ -289,8 +290,8 @@ class DibiTableInfo extends DibiObject
 	{
 		if ($this->columns === NULL) {
 			$this->columns = array();
-			foreach ($this->driver->getColumns($this->name) as $info) {
-				$this->columns[strtolower($info['name'])] = new DibiColumnInfo($this->driver, $info);
+			foreach ($this->reflector->getColumns($this->name) as $info) {
+				$this->columns[strtolower($info['name'])] = new DibiColumnInfo($this->reflector, $info);
 			}
 		}
 	}
@@ -305,7 +306,7 @@ class DibiTableInfo extends DibiObject
 		if ($this->indexes === NULL) {
 			$this->initColumns();
 			$this->indexes = array();
-			foreach ($this->driver->getIndexes($this->name) as $info) {
+			foreach ($this->reflector->getIndexes($this->name) as $info) {
 				foreach ($info['columns'] as $key => $name) {
 					$info['columns'][$key] = $this->columns[strtolower($name)];
 				}
@@ -324,7 +325,7 @@ class DibiTableInfo extends DibiObject
 	 */
 	protected function initForeignKeys()
 	{
-		throw new NotImplementedException;
+		throw new DibiNotImplementedException;
 	}
 
 }
@@ -333,33 +334,144 @@ class DibiTableInfo extends DibiObject
 
 
 /**
- * Reflection metadata class for a table column.
+ * Reflection metadata class for a result set.
  *
  * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @package    dibi
+ * @package    dibi\reflection
+ *
+ * @property-read array $columns
+ * @property-read array $columnNames
+ */
+class DibiResultInfo extends DibiObject
+{
+	/** @var IDibiResultDriver */
+	private $driver;
+
+	/** @var array */
+	private $columns;
+
+	/** @var array */
+	private $names;
+
+
+
+	public function __construct(IDibiResultDriver $driver)
+	{
+		$this->driver = $driver;
+	}
+
+
+
+	/**
+	 * @return array of DibiColumnInfo
+	 */
+	public function getColumns()
+	{
+		$this->initColumns();
+		return array_values($this->columns);
+	}
+
+
+
+	/**
+	 * @param  bool
+	 * @return array of string
+	 */
+	public function getColumnNames($fullNames = FALSE)
+	{
+		$this->initColumns();
+		$res = array();
+		foreach ($this->columns as $column) {
+			$res[] = $fullNames ? $column->getFullName() : $column->getName();
+		}
+		return $res;
+	}
+
+
+
+	/**
+	 * @param  string
+	 * @return DibiColumnInfo
+	 */
+	public function getColumn($name)
+	{
+		$this->initColumns();
+		$l = strtolower($name);
+		if (isset($this->names[$l])) {
+			return $this->names[$l];
+
+		} else {
+			throw new DibiException("Result set has no column '$name'.");
+		}
+	}
+
+
+
+	/**
+	 * @param  string
+	 * @return bool
+	 */
+	public function hasColumn($name)
+	{
+		$this->initColumns();
+		return isset($this->names[strtolower($name)]);
+	}
+
+
+
+	/**
+	 * @return void
+	 */
+	protected function initColumns()
+	{
+		if ($this->columns === NULL) {
+			$this->columns = array();
+			$reflector = $this->driver instanceof IDibiReflector ? $this->driver : NULL;
+			foreach ($this->driver->getResultColumns() as $info) {
+				$this->columns[] = $this->names[$info['name']] = new DibiColumnInfo($reflector, $info);
+			}
+		}
+	}
+
+}
+
+
+
+
+/**
+ * Reflection metadata class for a table or result set column.
+ *
+ * @author     David Grudl
+ * @package    dibi\reflection
+ *
+ * @property-read string $name
+ * @property-read string $fullName
+ * @property-read DibiTableInfo $table
+ * @property-read string $type
+ * @property-read mixed $nativeType
+ * @property-read int $size
+ * @property-read bool $unsigned
+ * @property-read bool $nullable
+ * @property-read bool $autoIncrement
+ * @property-read mixed $default
  */
 class DibiColumnInfo extends DibiObject
 {
 	/** @var array */
 	private static $types;
 
-	/** @var IDibiDriver */
-	private $driver;
+	/** @var IDibiReflector|NULL when created by DibiResultInfo */
+	private $reflector;
 
 	/** @var array (name, nativetype, [table], [fullname], [size], [nullable], [default], [autoincrement], [vendor]) */
 	private $info;
 
-	/** @var string */
-	private $type;
 
 
-
-	public function __construct(IDibiDriver $driver, array $info)
+	public function __construct(IDibiReflector $reflector = NULL, array $info)
 	{
-		$this->driver = $driver;
+		$this->reflector = $reflector;
 		$this->info = $info;
-		$this->type = self::detectType($this->info['nativetype']);
 	}
 
 
@@ -374,6 +486,16 @@ class DibiColumnInfo extends DibiObject
 
 
 
+	/**
+	 * @return string
+	 */
+	public function getFullName()
+	{
+		return isset($this->info['fullname']) ? $this->info['fullname'] : NULL;
+	}
+
+
+
 	/**
 	 * @return bool
 	 */
@@ -389,10 +511,20 @@ class DibiColumnInfo extends DibiObject
 	 */
 	public function getTable()
 	{
-		if (empty($this->info['table'])) {
-			throw new DibiException("Table name is unknown.");
+		if (empty($this->info['table']) || !$this->reflector) {
+			throw new DibiException("Table is unknown or not available.");
 		}
-		return new DibiTableInfo($this->driver, array('name' => $this->info['table']));
+		return new DibiTableInfo($this->reflector, array('name' => $this->info['table']));
+	}
+
+
+
+	/**
+	 * @return string
+	 */
+	public function getTableName()
+	{
+		return isset($this->info['table']) ? $this->info['table'] : NULL;
 	}
 
 
@@ -402,7 +534,7 @@ class DibiColumnInfo extends DibiObject
 	 */
 	public function getType()
 	{
-		return $this->type;
+		return self::getTypeCache()->{$this->info['nativetype']};
 	}
 
 
@@ -427,6 +559,16 @@ class DibiColumnInfo extends DibiObject
 
 
 
+	/**
+	 * @return bool
+	 */
+	public function isUnsigned()
+	{
+		return isset($this->info['unsigned']) ? (bool) $this->info['unsigned'] : NULL;
+	}
+
+
+
 	/**
 	 * @return bool
 	 */
@@ -472,28 +614,41 @@ class DibiColumnInfo extends DibiObject
 	 * Heuristic type detection.
 	 * @param  string
 	 * @return string
+	 * @internal
 	 */
 	public static function detectType($type)
 	{
 		static $patterns = array(
-			'BYTE|COUNTER|SERIAL|INT|LONG' => dibi::FIELD_INTEGER,
-			'CURRENCY|REAL|MONEY|FLOAT|DOUBLE|DECIMAL|NUMERIC' => dibi::FIELD_FLOAT,
-			'^TIME$' => dibi::FIELD_TIME,
-			'TIME' => dibi::FIELD_DATETIME, // DATETIME, TIMESTAMP
-			'YEAR|DATE' => dibi::FIELD_DATE,
-			'BYTEA|BLOB|BIN' => dibi::FIELD_BINARY,
-			'BOOL|BIT' => dibi::FIELD_BOOL,
+			'^_' => dibi::TEXT, // PostgreSQL arrays
+			'BYTEA|BLOB|BIN' => dibi::BINARY,
+			'TEXT|CHAR' => dibi::TEXT,
+			'YEAR|BYTE|COUNTER|SERIAL|INT|LONG' => dibi::INTEGER,
+			'CURRENCY|REAL|MONEY|FLOAT|DOUBLE|DECIMAL|NUMERIC|NUMBER' => dibi::FLOAT,
+			'^TIME$' => dibi::TIME,
+			'TIME' => dibi::DATETIME, // DATETIME, TIMESTAMP
+			'DATE' => dibi::DATE,
+			'BOOL|BIT' => dibi::BOOL,
 		);
 
-		if (!isset(self::$types[$type])) {
-			self::$types[$type] = dibi::FIELD_TEXT;
-			foreach ($patterns as $s => $val) {
-				if (preg_match("#$s#i", $type)) {
-					return self::$types[$type] = $val;
-				}
+		foreach ($patterns as $s => $val) {
+			if (preg_match("#$s#i", $type)) {
+				return $val;
 			}
 		}
-		return self::$types[$type];
+		return dibi::TEXT;
+	}
+
+
+
+	/**
+	 * @internal
+	 */
+	public static function getTypeCache()
+	{
+		if (self::$types === NULL) {
+			self::$types = new DibiHashMap(array(__CLASS__, 'detectType'));
+		}
+		return self::$types;
 	}
 
 }
@@ -505,9 +660,11 @@ class DibiColumnInfo extends DibiObject
  * Reflection metadata class for a foreign key.
  *
  * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @package    dibi
+ * @package    dibi\reflection
  * @todo
+ *
+ * @property-read string $name
+ * @property-read array $references
  */
 class DibiForeignKeyInfo extends DibiObject
 {
@@ -551,11 +708,15 @@ class DibiForeignKeyInfo extends DibiObject
 
 
 /**
- * Reflection metadata class for a index or primary key
+ * Reflection metadata class for a index or primary key.
  *
  * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @package    dibi
+ * @package    dibi\reflection
+ *
+ * @property-read string $name
+ * @property-read array $columns
+ * @property-read bool $unique
+ * @property-read bool $primary
  */
 class DibiIndexInfo extends DibiObject
 {
@@ -600,7 +761,6 @@ class DibiIndexInfo extends DibiObject
 
 
 
-
 	/**
 	 * @return bool
 	 */

dibi/libs/DibiDateTime.php

@@ -0,0 +1,88 @@
+<?php
+
+/**
+ * This file is part of the "dibi" - smart database abstraction layer.
+ *
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
+ */
+
+
+
+/**
+ * DateTime with serialization and timestamp support for PHP 5.2.
+ *
+ * @author     David Grudl
+ * @package    dibi
+ */
+class DibiDateTime extends DateTime
+{
+
+	public function __construct($time = 'now', DateTimeZone $timezone = NULL)
+	{
+		if (is_numeric($time)) {
+			$time = date('Y-m-d H:i:s', $time);
+		}
+		if ($timezone === NULL) {
+			parent::__construct($time);
+		} else {
+			parent::__construct($time, $timezone);
+		}
+	}
+
+
+
+	public function modifyClone($modify = '')
+	{
+		$dolly = clone($this);
+		return $modify ? $dolly->modify($modify) : $dolly;
+	}
+
+
+
+	public function modify($modify)
+	{
+		parent::modify($modify);
+		return $this;
+	}
+
+
+
+	public function __sleep()
+	{
+		$this->fix = array($this->format('Y-m-d H:i:s'), $this->getTimezone()->getName());
+		return array('fix');
+	}
+
+
+
+	public function __wakeup()
+	{
+		$this->__construct($this->fix[0], new DateTimeZone($this->fix[1]));
+		unset($this->fix);
+	}
+
+
+
+	public function getTimestamp()
+	{
+		return (int) $this->format('U');
+	}
+
+
+
+	public function setTimestamp($timestamp)
+	{
+		return $this->__construct(date('Y-m-d H:i:s', $timestamp), new DateTimeZone($this->getTimezone()->getName())); // getTimeZone() crashes in PHP 5.2.6
+	}
+
+
+
+	public function __toString()
+	{
+		return $this->format('Y-m-d H:i:s');
+	}
+
+}

dibi/libs/DibiEvent.php

@@ -0,0 +1,104 @@
+<?php
+
+/**
+ * This file is part of the "dibi" - smart database abstraction layer.
+ *
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
+ */
+
+
+
+/**
+ * Profiler & logger event.
+ *
+ * @author     David Grudl
+ * @package    dibi
+ */
+class DibiEvent
+{
+	/** event type */
+	const CONNECT = 1,
+		SELECT = 4,
+		INSERT = 8,
+		DELETE = 16,
+		UPDATE = 32,
+		QUERY = 60, // SELECT | INSERT | DELETE | UPDATE
+		BEGIN = 64,
+		COMMIT = 128,
+		ROLLBACK = 256,
+		TRANSACTION = 448, // BEGIN | COMMIT | ROLLBACK
+		ALL = 1023;
+
+	/** @var DibiConnection */
+	public $connection;
+
+	/** @var int */
+	public $type;
+
+	/** @var string */
+	public $sql;
+
+	/** @var DibiResult|DibiDriverException|NULL */
+	public $result;
+
+	/** @var float */
+	public $time;
+
+	/** @var int */
+	public $count;
+
+	/** @var array */
+	public $source;
+
+
+
+	public function __construct(DibiConnection $connection, $type, $sql = NULL)
+	{
+		$this->connection = $connection;
+		$this->type = $type;
+		$this->sql = trim($sql);
+		$this->time = -microtime(TRUE);
+
+		if ($type === self::QUERY && preg_match('#\(?\s*(SELECT|UPDATE|INSERT|DELETE)#iA', $this->sql, $matches)) {
+			static $types = array(
+				'SELECT' => self::SELECT, 'UPDATE' => self::UPDATE,
+				'INSERT' => self::INSERT, 'DELETE' => self::DELETE,
+			);
+			$this->type = $types[strtoupper($matches[1])];
+		}
+
+		$rc = new ReflectionClass('dibi');
+		$dibiDir = dirname($rc->getFileName()) . DIRECTORY_SEPARATOR;
+		foreach (debug_backtrace(FALSE) as $row) {
+			if (isset($row['file']) && is_file($row['file']) && strpos($row['file'], $dibiDir) !== 0) {
+				$this->source = array($row['file'], (int) $row['line']);
+				break;
+			}
+		}
+
+		dibi::$elapsedTime = FALSE;
+		dibi::$numOfQueries++;
+		dibi::$sql = $sql;
+	}
+
+
+
+	public function done($result = NULL)
+	{
+		$this->result = $result;
+		try {
+			$this->count = $result instanceof DibiResult ? count($result) : NULL;
+		} catch (DibiException $e) {
+			$this->count = NULL;
+		}
+
+		$this->time += microtime(TRUE);
+		dibi::$elapsedTime = $this->time;
+		dibi::$totalTime += $this->time;
+		return $this;
+	}
+
+}

dibi/libs/DibiException.php

@@ -1,21 +1,12 @@
 <?php
 
 /**
- * dibi - tiny'n'smart database abstraction layer
- * ----------------------------------------------
+ * This file is part of the "dibi" - smart database abstraction layer.
  *
- * Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
  *
- * This source file is subject to the "dibi license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://dibiphp.com
- *
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @license    http://dibiphp.com/license  dibi license
- * @link       http://dibiphp.com
- * @package    dibi
- * @version    $Id$
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
  */
 
 
@@ -24,43 +15,24 @@
  * dibi common exception.
  *
  * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
  * @package    dibi
  */
 class DibiException extends Exception
 {
-}
-
-
-
-
-/**
- * database server exception.
- *
- * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @package    dibi
- */
-class DibiDriverException extends DibiException implements /*Nette::*/IDebuggable
-{
-	/** @var string */
-	private static $errorMsg;
-
 	/** @var string */
 	private $sql;
 
 
 	/**
-	 * Construct an dibi driver exception.
-	 * @param string  Message describing the exception
-	 * @param int     Some code
+	 * Construct a dibi exception.
+	 * @param  string  Message describing the exception
+	 * @param  int     Some code
 	 * @param  string SQL command
 	 */
 	public function __construct($message = NULL, $code = 0, $sql = NULL)
 	{
 		parent::__construct($message, (int) $code);
 		$this->sql = $sql;
-		// TODO: add $profiler->exception($this);
 	}
 
 
@@ -83,35 +55,31 @@ class DibiDriverException extends DibiException implements /*Nette::*/IDebuggabl
 		return parent::__toString() . ($this->sql ? "\nSQL: " . $this->sql : '');
 	}
 
+}
 
 
-	/********************* interface Nette::IDebuggable ****************d*g**/
-
-
-	/**
-	 * Returns custom panels.
-	 * @return array
-	 */
-	public function getPanels()
-	{
-		$panels = array();
-		if ($this->sql !== NULL) {
-			$panels['SQL'] = array(
-				'expanded' => TRUE,
-				'content' => dibi::dump($this->sql, TRUE),
-			);
-		}
-		return $panels;
-	}
 
 
+/**
+ * database server exception.
+ *
+ * @author     David Grudl
+ * @package    dibi
+ */
+class DibiDriverException extends DibiException
+{
 
 	/********************* error catching ****************d*g**/
 
 
 
+	/** @var string */
+	private static $errorMsg;
+
+
+
 	/**
-	 * Starts catching potential errors/warnings
+	 * Starts catching potential errors/warnings.
 	 * @return void
 	 */
 	public static function tryError()
@@ -153,4 +121,45 @@ class DibiDriverException extends DibiException implements /*Nette::*/IDebuggabl
 		self::$errorMsg = $message;
 	}
 
-}
+}
+
+
+
+
+/**
+ * PCRE exception.
+ *
+ * @author     David Grudl
+ * @package    dibi
+ */
+class DibiPcreException extends Exception {
+
+	public function __construct($message = '%msg.')
+	{
+		static $messages = array(
+			PREG_INTERNAL_ERROR => 'Internal error',
+			PREG_BACKTRACK_LIMIT_ERROR => 'Backtrack limit was exhausted',
+			PREG_RECURSION_LIMIT_ERROR => 'Recursion limit was exhausted',
+			PREG_BAD_UTF8_ERROR => 'Malformed UTF-8 data',
+			5 => 'Offset didn\'t correspond to the begin of a valid UTF-8 code point', // PREG_BAD_UTF8_OFFSET_ERROR
+		);
+		$code = preg_last_error();
+		parent::__construct(str_replace('%msg', isset($messages[$code]) ? $messages[$code] : 'Unknown error', $message), $code);
+	}
+}
+
+
+
+/**
+ * @package    dibi
+ */
+class DibiNotImplementedException extends DibiException
+{}
+
+
+
+/**
+ * @package    dibi
+ */
+class DibiNotSupportedException extends DibiException
+{}

dibi/libs/DibiFileLogger.php

@@ -0,0 +1,78 @@
+<?php
+
+/**
+ * This file is part of the "dibi" - smart database abstraction layer.
+ *
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
+ */
+
+
+
+/**
+ * dibi file logger.
+ *
+ * @author     David Grudl
+ * @package    dibi
+ */
+class DibiFileLogger extends DibiObject
+{
+	/** @var string  Name of the file where SQL errors should be logged */
+	public $file;
+
+	/** @var int */
+	public $filter;
+
+
+
+	public function __construct($file, $filter = NULL)
+	{
+		$this->file = $file;
+		$this->filter = $filter ? (int) $filter : DibiEvent::QUERY;
+	}
+
+
+
+	/**
+	 * After event notification.
+	 * @return void
+	 */
+	public function logEvent(DibiEvent $event)
+	{
+		if (($event->type & $this->filter) === 0) {
+			return;
+		}
+
+		$handle = fopen($this->file, 'a');
+		if (!$handle) return; // or throw exception?
+		flock($handle, LOCK_EX);
+
+		if ($event->result instanceof Exception) {
+			$message = $event->result->getMessage();
+			if ($code = $event->result->getCode()) {
+				$message = "[$code] $message";
+			}
+			fwrite($handle,
+				"ERROR: $message"
+				. "\n-- SQL: " . $event->sql
+				. "\n-- driver: " . $event->connection->getConfig('driver') . '/' . $event->connection->getConfig('name')
+				. ";\n-- " . date('Y-m-d H:i:s')
+				. "\n\n"
+			);
+		} else {
+			fwrite($handle,
+				"OK: " . $event->sql
+				. ($event->count ? ";\n-- rows: " . $event->count : '')
+				. "\n-- takes: " . sprintf('%0.3f', $event->time * 1000) . ' ms'
+				. "\n-- source: " . implode(':', $event->source)
+				. "\n-- driver: " . $event->connection->getConfig('driver') . '/' . $event->connection->getConfig('name')
+				. "\n-- " . date('Y-m-d H:i:s')
+				. "\n\n"
+			);
+		}
+		fclose($handle);
+	}
+
+}

dibi/libs/DibiFirePhpLogger.php

@@ -0,0 +1,96 @@
+<?php
+
+/**
+ * This file is part of the "dibi" - smart database abstraction layer.
+ *
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
+ */
+
+
+
+/**
+ * dibi FirePHP logger.
+ *
+ * @author     David Grudl
+ * @package    dibi
+ */
+class DibiFirePhpLogger extends DibiObject
+{
+	/** maximum number of rows */
+	static public $maxQueries = 30;
+
+	/** maximum SQL length */
+	static public $maxLength = 1000;
+
+	/** @var int */
+	public $filter;
+
+	/** @var int  Elapsed time for all queries */
+	public $totalTime = 0;
+
+	/** @var int  Number of all queries */
+	public $numOfQueries = 0;
+
+	/** @var array */
+	private static $fireTable = array(array('Time', 'SQL Statement', 'Rows', 'Connection'));
+
+
+
+	/**
+	 * @return bool
+	 */
+	public static function isAvailable()
+	{
+		return isset($_SERVER['HTTP_USER_AGENT']) && strpos($_SERVER['HTTP_USER_AGENT'], 'FirePHP/');
+	}
+
+
+
+	public function __construct($filter = NULL)
+	{
+		$this->filter = $filter ? (int) $filter : DibiEvent::QUERY;
+	}
+
+
+
+	/**
+	 * After event notification.
+	 * @return void
+	 */
+	public function logEvent(DibiEvent $event)
+	{
+		if (headers_sent() || ($event->type & $this->filter) === 0 || count(self::$fireTable) > self::$maxQueries) {
+			return;
+		}
+
+		$this->totalTime += $event->time;
+		$this->numOfQueries++;
+		self::$fireTable[] = array(
+			sprintf('%0.3f', $event->time * 1000),
+			strlen($event->sql) > self::$maxLength ? substr($event->sql, 0, self::$maxLength) . '...' : $event->sql,
+			$event->result instanceof Exception ? 'ERROR' : (string) $event->count,
+			$event->connection->getConfig('driver') . '/' . $event->connection->getConfig('name')
+		);
+
+		header('X-Wf-Protocol-dibi: http://meta.wildfirehq.org/Protocol/JsonStream/0.2');
+		header('X-Wf-dibi-Plugin-1: http://meta.firephp.org/Wildfire/Plugin/FirePHP/Library-FirePHPCore/0.2.0');
+		header('X-Wf-dibi-Structure-1: http://meta.firephp.org/Wildfire/Structure/FirePHP/FirebugConsole/0.1');
+
+		$payload = json_encode(array(
+			array(
+				'Type' => 'TABLE',
+				'Label' => 'dibi profiler (' . $this->numOfQueries . ' SQL queries took ' . sprintf('%0.3f', $this->totalTime * 1000) . ' ms)',
+			),
+			self::$fireTable,
+		));
+		foreach (str_split($payload, 4990) as $num => $s) {
+			$num++;
+			header("X-Wf-dibi-1-1-d$num: |$s|\\"); // protocol-, structure-, plugin-, message-index
+		}
+		header("X-Wf-dibi-1-1-d$num: |$s|");
+	}
+
+}

dibi/libs/DibiFluent.php

@@ -1,21 +1,12 @@
 <?php
 
 /**
- * dibi - tiny'n'smart database abstraction layer
- * ----------------------------------------------
+ * This file is part of the "dibi" - smart database abstraction layer.
  *
- * Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
  *
- * This source file is subject to the "dibi license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://dibiphp.com
- *
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @license    http://dibiphp.com/license  dibi license
- * @link       http://dibiphp.com
- * @package    dibi
- * @version    $Id$
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
  */
 
 
@@ -24,24 +15,39 @@
  * dibi SQL builder via fluent interfaces. EXPERIMENTAL!
  *
  * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
  * @package    dibi
+ *
+ * @property-read string $command
+ * @property-read DibiConnection $connection
+ * @property-read DibiResultIterator $iterator
+ * @method DibiFluent select($field)
+ * @method DibiFluent distinct()
+ * @method DibiFluent from($table)
+ * @method DibiFluent where($cond)
+ * @method DibiFluent groupBy($field)
+ * @method DibiFluent having($cond)
+ * @method DibiFluent orderBy($field)
+ * @method DibiFluent limit(int $limit)
+ * @method DibiFluent offset(int $offset)
  */
-class DibiFluent extends DibiObject
+class DibiFluent extends DibiObject implements IDataSource
 {
+	const REMOVE = FALSE;
+
 	/** @var array */
 	public static $masks = array(
 		'SELECT' => array('SELECT', 'DISTINCT', 'FROM', 'WHERE', 'GROUP BY',
-			'HAVING', 'ORDER BY', 'LIMIT', 'OFFSET', '%end'),
-		'UPDATE' => array('UPDATE', 'SET', 'WHERE', 'ORDER BY', 'LIMIT', '%end'),
-		'INSERT' => array('INSERT', 'INTO', 'VALUES', 'SELECT', '%end'),
-		'DELETE' => array('DELETE', 'FROM', 'USING', 'WHERE', 'ORDER BY', 'LIMIT', '%end'),
+			'HAVING', 'ORDER BY', 'LIMIT', 'OFFSET'),
+		'UPDATE' => array('UPDATE', 'SET', 'WHERE', 'ORDER BY', 'LIMIT'),
+		'INSERT' => array('INSERT', 'INTO', 'VALUES', 'SELECT'),
+		'DELETE' => array('DELETE', 'FROM', 'USING', 'WHERE', 'ORDER BY', 'LIMIT'),
 	);
 
-	/** @var array */
+	/** @var array  default modifiers for arrays */
 	public static $modifiers = array(
 		'SELECT' => '%n',
-		'IN' => '%l',
+		'FROM' => '%n',
+		'IN' => '%in',
 		'VALUES' => '%l',
 		'SET' => '%a',
 		'WHERE' => '%and',
@@ -50,10 +56,10 @@ class DibiFluent extends DibiObject
 		'GROUP BY' => '%by',
 	);
 
-	/** @var array */
+	/** @var array  clauses separators */
 	public static $separators = array(
 		'SELECT' => ',',
-		'FROM' => FALSE,
+		'FROM' => ',',
 		'WHERE' => 'AND',
 		'GROUP BY' => ',',
 		'HAVING' => 'AND',
@@ -65,9 +71,20 @@ class DibiFluent extends DibiObject
 		'INTO' => FALSE,
 	);
 
+	/** @var array  clauses */
+	public static $clauseSwitches = array(
+		'JOIN' => 'FROM',
+		'INNER JOIN' => 'FROM',
+		'LEFT JOIN' => 'FROM',
+		'RIGHT JOIN' => 'FROM',
+	);
+
 	/** @var DibiConnection */
 	private $connection;
 
+	/** @var array */
+	private $setups = array();
+
 	/** @var string */
 	private $command;
 
@@ -80,6 +97,9 @@ class DibiFluent extends DibiObject
 	/** @var array */
 	private $cursor;
 
+	/** @var DibiHashMap  normalized clauses */
+	private static $normalizer;
+
 
 
 	/**
@@ -88,6 +108,10 @@ class DibiFluent extends DibiObject
 	public function __construct(DibiConnection $connection)
 	{
 		$this->connection = $connection;
+
+		if (self::$normalizer === NULL) {
+			self::$normalizer = new DibiHashMap(array(__CLASS__, '_formatClause'));
+		}
 	}
 
 
@@ -100,7 +124,7 @@ class DibiFluent extends DibiObject
 	 */
 	public function __call($clause, $args)
 	{
-		$clause = self::_formatClause($clause);
+		$clause = self::$normalizer->$clause;
 
 		// lazy initialization
 		if ($this->command === NULL) {
@@ -112,24 +136,9 @@ class DibiFluent extends DibiObject
 			$this->command = $clause;
 		}
 
-		// special types or argument
-		if (count($args) === 1) {
-			$arg = $args[0];
-			// TODO: really ignore TRUE?
-			if ($arg === TRUE) { // flag
-				$args = array();
-
-			} elseif (is_string($arg) && preg_match('#^[a-z][a-z0-9_.]*$#i', $arg)) { // identifier
-				$args = array('%n', $arg);
-
-			} elseif (is_array($arg)) { // any array
-				if (isset(self::$modifiers[$clause])) {
-					$args = array(self::$modifiers[$clause], $arg);
-
-				} elseif (is_string(key($arg))) { // associative array
-					$args = array('%a', $arg);
-				}
-			}
+		// auto-switch to a clause
+		if (isset(self::$clauseSwitches[$clause])) {
+			$this->cursor = & $this->clauses[self::$clauseSwitches[$clause]];
 		}
 
 		if (array_key_exists($clause, $this->clauses)) {
@@ -137,14 +146,14 @@ class DibiFluent extends DibiObject
 			$this->cursor = & $this->clauses[$clause];
 
 			// TODO: really delete?
-			if ($args === array(FALSE)) {
+			if ($args === array(self::REMOVE)) {
 				$this->cursor = NULL;
 				return $this;
 			}
 
 			if (isset(self::$separators[$clause])) {
 				$sep = self::$separators[$clause];
-				if ($sep === FALSE) {
+				if ($sep === FALSE) { // means: replace
 					$this->cursor = array();
 
 				} elseif (!empty($this->cursor)) {
@@ -154,7 +163,7 @@ class DibiFluent extends DibiObject
 
 		} else {
 			// append to currect flow
-			if ($args === array(FALSE)) {
+			if ($args === array(self::REMOVE)) {
 				return $this;
 			}
 
@@ -165,7 +174,33 @@ class DibiFluent extends DibiObject
 			$this->cursor = array();
 		}
 
-		array_splice($this->cursor, count($this->cursor), 0, $args);
+		// special types or argument
+		if (count($args) === 1) {
+			$arg = $args[0];
+			// TODO: really ignore TRUE?
+			if ($arg === TRUE) { // flag
+				return $this;
+
+			} elseif (is_string($arg) && preg_match('#^[a-z:_][a-z0-9_.:]*\z#i', $arg)) { // identifier
+				$args = array('%n', $arg);
+
+			} elseif (is_array($arg) || ($arg instanceof Traversable && !$arg instanceof self)) { // any array
+				if (isset(self::$modifiers[$clause])) {
+					$args = array(self::$modifiers[$clause], $arg);
+
+				} elseif (is_string(key($arg))) { // associative array
+					$args = array('%a', $arg);
+				}
+			} // case $arg === FALSE is handled above
+		}
+
+		foreach ($args as $arg) {
+			if ($arg instanceof self) {
+				$arg = "($arg)";
+			}
+			$this->cursor[] = $arg;
+		}
+
 		return $this;
 	}
 
@@ -178,9 +213,10 @@ class DibiFluent extends DibiObject
 	 */
 	public function clause($clause, $remove = FALSE)
 	{
-		$this->cursor = & $this->clauses[self::_formatClause($clause)];
+		$this->cursor = & $this->clauses[self::$normalizer->$clause];
 
-		if ($remove) {
+		if ($remove) { // deprecated, use removeClause
+			trigger_error(__METHOD__ . '(..., TRUE) is deprecated; use removeClause() instead.', E_USER_NOTICE);
 			$this->cursor = NULL;
 
 		} elseif ($this->cursor === NULL) {
@@ -192,6 +228,19 @@ class DibiFluent extends DibiObject
 
 
 
+	/**
+	 * Removes a clause.
+	 * @param  string clause name
+	 * @return DibiFluent  provides a fluent interface
+	 */
+	public function removeClause($clause)
+	{
+		$this->clauses[self::$normalizer->$clause] = NULL;
+		return $this;
+	}
+
+
+
 	/**
 	 * Change a SQL flag.
 	 * @param  string  flag name
@@ -234,14 +283,45 @@ class DibiFluent extends DibiObject
 
 
 
+	/**
+	 * Returns the dibi connection.
+	 * @return DibiConnection
+	 */
+	final public function getConnection()
+	{
+		return $this->connection;
+	}
+
+
+
+	/**
+	 * Adds DibiResult setup.
+	 * @param  string  method
+	 * @param  mixed   args
+	 * @return DibiFluent  provides a fluent interface
+	 */
+	public function setupResult($method)
+	{
+		$this->setups[] = func_get_args();
+		return $this;
+	}
+
+
+
+	/********************* executing ****************d*g**/
+
+
+
 	/**
 	 * Generates and executes SQL query.
-	 * @return DibiResult|NULL  result set object (if any)
+	 * @param  mixed what to return?
+	 * @return DibiResult|int  result set object (if any)
 	 * @throws DibiException
 	 */
-	public function execute()
+	public function execute($return = NULL)
 	{
-		return $this->connection->query($this->_export());
+		$res = $this->query($this->_export());
+		return $return === dibi::IDENTIFIER ? $this->connection->getInsertId() : $res;
 	}
 
 
@@ -249,14 +329,14 @@ class DibiFluent extends DibiObject
 	/**
 	 * Generates, executes SQL query and fetches the single row.
 	 * @return DibiRow|FALSE  array on success, FALSE if no next record
-	 * @throws DibiException
 	 */
 	public function fetch()
 	{
 		if ($this->command === 'SELECT') {
-			$this->clauses['LIMIT'] = array(1);
+			return $this->query($this->_export(NULL, array('%lmt', 1)))->fetch();
+		} else {
+			return $this->query($this->_export())->fetch();
 		}
-		return $this->execute()->fetch();
 	}
 
 
@@ -268,9 +348,10 @@ class DibiFluent extends DibiObject
 	public function fetchSingle()
 	{
 		if ($this->command === 'SELECT') {
-			$this->clauses['LIMIT'] = array(1);
+			return $this->query($this->_export(NULL, array('%lmt', 1)))->fetchSingle();
+		} else {
+			return $this->query($this->_export())->fetchSingle();
 		}
-		return $this->execute()->fetchSingle();
 	}
 
 
@@ -283,22 +364,19 @@ class DibiFluent extends DibiObject
 	 */
 	public function fetchAll($offset = NULL, $limit = NULL)
 	{
-		return $this->execute()->fetchAll($offset, $limit);
+		return $this->query($this->_export(NULL, array('%ofs %lmt', $offset, $limit)))->fetchAll();
 	}
 
 
 
 	/**
 	 * Fetches all records from table and returns associative tree.
-	 * Associative descriptor:  assoc1,#,assoc2,=,assoc3,@
-	 * builds a tree:           $data[assoc1][index][assoc2]['assoc3']->value = {record}
 	 * @param  string  associative descriptor
 	 * @return array
-	 * @throws InvalidArgumentException
 	 */
 	public function fetchAssoc($assoc)
 	{
-		return $this->execute()->fetchAssoc($assoc);
+		return $this->query($this->_export())->fetchAssoc($assoc);
 	}
 
 
@@ -308,11 +386,23 @@ class DibiFluent extends DibiObject
 	 * @param  string  associative key
 	 * @param  string  value
 	 * @return array
-	 * @throws InvalidArgumentException
 	 */
 	public function fetchPairs($key = NULL, $value = NULL)
 	{
-		return $this->execute()->fetchPairs($key, $value);
+		return $this->query($this->_export())->fetchPairs($key, $value);
+	}
+
+
+
+	/**
+	 * Required by the IteratorAggregate interface.
+	 * @param  int  offset
+	 * @param  int  limit
+	 * @return DibiResultIterator
+	 */
+	public function getIterator($offset = NULL, $limit = NULL)
+	{
+		return $this->query($this->_export(NULL, array('%ofs %lmt', $offset, $limit)))->getIterator();
 	}
 
 
@@ -329,18 +419,73 @@ class DibiFluent extends DibiObject
 
 
 
+	/**
+	 * @return int
+	 */
+	public function count()
+	{
+		return (int) $this->query(array(
+			'SELECT COUNT(*) FROM (%ex', $this->_export(), ') AS [data]'
+		))->fetchSingle();
+	}
+
+
+
+	/**
+	 * @return DibiResult
+	 */
+	private function query($args)
+	{
+		$res = $this->connection->query($args);
+		foreach ($this->setups as $setup) {
+			call_user_func_array(array($res, array_shift($setup)), $setup);
+		}
+		return $res;
+	}
+
+
+
+	/********************* exporting ****************d*g**/
+
+
+
+	/**
+	 * @return DibiDataSource
+	 */
+	public function toDataSource()
+	{
+		return new DibiDataSource($this->connection->translate($this->_export()), $this->connection);
+	}
+
+
+
+	/**
+	 * Returns SQL query.
+	 * @return string
+	 */
+	final public function __toString()
+	{
+		try {
+			return $this->connection->translate($this->_export());
+		} catch (Exception $e) {
+			trigger_error($e->getMessage(), E_USER_ERROR);
+		}
+	}
+
+
+
 	/**
 	 * Generates parameters for DibiTranslator.
 	 * @param  string clause name
 	 * @return array
 	 */
-	protected function _export($clause = NULL)
+	protected function _export($clause = NULL, $args = array())
 	{
 		if ($clause === NULL) {
 			$data = $this->clauses;
 
 		} else {
-			$clause = self::_formatClause($clause);
+			$clause = self::$normalizer->$clause;
 			if (array_key_exists($clause, $this->clauses)) {
 				$data = array($clause => $this->clauses[$clause]);
 			} else {
@@ -348,18 +493,16 @@ class DibiFluent extends DibiObject
 			}
 		}
 
-		$args = array();
 		foreach ($data as $clause => $statement) {
 			if ($statement !== NULL) {
-				if ($clause[0] !== '%') {
-					$args[] = $clause;
-					if ($clause === $this->command) {
-						$args[] = implode(' ', array_keys($this->flags));
-					}
+				$args[] = $clause;
+				if ($clause === $this->command && $this->flags) {
+					$args[] = implode(' ', array_keys($this->flags));
 				}
-				array_splice($args, count($args), 0, $statement);
+				foreach ($statement as $arg) $args[] = $arg;
 			}
 		}
+
 		return $args;
 	}
 
@@ -369,37 +512,27 @@ class DibiFluent extends DibiObject
 	 * Format camelCase clause name to UPPER CASE.
 	 * @param  string
 	 * @return string
+	 * @internal
 	 */
-	private static function _formatClause($s)
+	public static function _formatClause($s)
 	{
 		if ($s === 'order' || $s === 'group') {
 			$s .= 'By';
 			trigger_error("Did you mean '$s'?", E_USER_NOTICE);
 		}
-		return strtoupper(preg_replace('#[A-Z]#', ' $0', $s));
-
+		return strtoupper(preg_replace('#[a-z](?=[A-Z])#', '$0 ', $s));
 	}
 
 
 
-	/**
-	 * Returns (highlighted) SQL query.
-	 * @return string
-	 */
-	final public function __toString()
+	public function __clone()
 	{
-		ob_start();
-		$this->test();
-		return ob_get_clean();
+		// remove references
+		foreach ($this->clauses as $clause => $val) {
+			$this->clauses[$clause] = & $val;
+			unset($val);
+		}
+		$this->cursor = & $foo;
 	}
 
 }
-
-
-// PHP < 5.2 compatibility
-if (!function_exists('array_fill_keys')) {
-	function array_fill_keys($keys, $value)
-	{
-		return array_combine($keys, array_fill(0, count($keys), $value));
-	}
-}

dibi/libs/DibiHashMap.php

@@ -0,0 +1,82 @@
+<?php
+
+/**
+ * This file is part of the "dibi" - smart database abstraction layer.
+ *
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
+ */
+
+
+
+/**
+ * Lazy cached storage.
+ *
+ * @author     David Grudl
+ * @package    dibi
+ * @internal
+ */
+abstract class DibiHashMapBase
+{
+	private $callback;
+
+
+	public function __construct($callback)
+	{
+		$this->setCallback($callback);
+	}
+
+
+
+	public function setCallback($callback)
+	{
+		if (!is_callable($callback)) {
+			$able = is_callable($callback, TRUE, $textual);
+			throw new InvalidArgumentException("Handler '$textual' is not " . ($able ? 'callable.' : 'valid PHP callback.'));
+		}
+		$this->callback = $callback;
+	}
+
+
+
+	public function getCallback()
+	{
+		return $this->callback;
+	}
+
+}
+
+
+
+/**
+ * Lazy cached storage.
+ *
+ * @author     David Grudl
+ * @internal
+ */
+final class DibiHashMap extends DibiHashMapBase
+{
+
+	public function __set($nm, $val)
+	{
+		if ($nm == '') {
+			$nm = "\xFF";
+		}
+		$this->$nm = $val;
+	}
+
+
+
+	public function __get($nm)
+	{
+		if ($nm == '') {
+			$nm = "\xFF";
+			return isset($this->$nm) ? $this->$nm : $this->$nm = call_user_func($this->getCallback(), '');
+		} else {
+			return $this->$nm = call_user_func($this->getCallback(), $nm);
+		}
+	}
+
+}

dibi/libs/DibiLiteral.php

@@ -0,0 +1,40 @@
+<?php
+
+/**
+ * This file is part of the "dibi" - smart database abstraction layer.
+ *
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
+ */
+
+
+
+/**
+ * SQL literal value.
+ *
+ * @author     David Grudl
+ */
+class DibiLiteral extends DibiObject
+{
+	/** @var string */
+	private $value;
+
+
+	public function __construct($value)
+	{
+		$this->value = (string) $value;
+	}
+
+
+
+	/**
+	 * @return string
+	 */
+	public function __toString()
+	{
+		return $this->value;
+	}
+
+}

dibi/libs/DibiObject.php

@@ -1,21 +1,12 @@
 <?php
 
 /**
- * dibi - tiny'n'smart database abstraction layer
- * ----------------------------------------------
+ * This file is part of the "dibi" - smart database abstraction layer.
  *
- * Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
  *
- * This source file is subject to the "dibi license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://dibiphp.com
- *
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @license    http://dibiphp.com/license  dibi license
- * @link       http://dibiphp.com
- * @package    dibi
- * @version    $Id$
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
  */
 
 
@@ -23,7 +14,7 @@
 /**
  * DibiObject is the ultimate ancestor of all instantiable classes.
  *
- * DibiObject is copy of Nette::Object from Nette Framework (http://nettephp.com).
+ * DibiObject is copy of Nette\Object from Nette Framework (http://nette.org).
  *
  * It defines some handful methods and enhances object core of PHP:
  *   - access to undeclared members throws exceptions
@@ -59,7 +50,6 @@
  * </code>
  *
  * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
  * @package    dibi
  */
 abstract class DibiObject
@@ -82,7 +72,7 @@ abstract class DibiObject
 
 	/**
 	 * Access to reflection.
-	 * @return ReflectionObject
+	 * @return \ReflectionObject
 	 */
 	final public function getReflection()
 	{
@@ -96,14 +86,14 @@ abstract class DibiObject
 	 * @param  string  method name
 	 * @param  array   arguments
 	 * @return mixed
-	 * @throws ::MemberAccessException
+	 * @throws \LogicException
 	 */
 	public function __call($name, $args)
 	{
 		$class = get_class($this);
 
 		if ($name === '') {
-			throw new /*::*/MemberAccessException("Call to class '$class' method without name.");
+			throw new LogicException("Call to class '$class' method without name.");
 		}
 
 		// event functionality
@@ -131,7 +121,7 @@ abstract class DibiObject
 			return call_user_func_array($cb, $args);
 		}
 
-		throw new /*::*/MemberAccessException("Call to undefined method $class::$name().");
+		throw new LogicException("Call to undefined method $class::$name().");
 	}
 
 
@@ -141,12 +131,12 @@ abstract class DibiObject
 	 * @param  string  method name (in lower case!)
 	 * @param  array   arguments
 	 * @return mixed
-	 * @throws ::MemberAccessException
+	 * @throws \LogicException
 	 */
 	public static function __callStatic($name, $args)
 	{
 		$class = get_called_class();
-		throw new /*::*/MemberAccessException("Call to undefined static method $class::$name().");
+		throw new LogicException("Call to undefined static method $class::$name().");
 	}
 
 
@@ -217,14 +207,14 @@ abstract class DibiObject
 	 * Returns property value. Do not call directly.
 	 * @param  string  property name
 	 * @return mixed   property value
-	 * @throws ::MemberAccessException if the property is not defined.
+	 * @throws \LogicException if the property is not defined.
 	 */
 	public function &__get($name)
 	{
 		$class = get_class($this);
 
 		if ($name === '') {
-			throw new /*::*/MemberAccessException("Cannot read an class '$class' property without name.");
+			throw new LogicException("Cannot read a class '$class' property without name.");
 		}
 
 		// property getter support
@@ -232,7 +222,7 @@ abstract class DibiObject
 		$m = 'get' . $name;
 		if (self::hasAccessor($class, $m)) {
 			// ampersands:
-			// - uses &__get() because declaration should be forward compatible (e.g. with Nette::Web::Html)
+			// - uses &__get() because declaration should be forward compatible (e.g. with Nette\Web\Html)
 			// - doesn't call &$this->$m because user could bypass property setter by: $x = & $obj->property; $x = 'new value';
 			$val = $this->$m();
 			return $val;
@@ -245,7 +235,7 @@ abstract class DibiObject
 		}
 
 		$name = func_get_arg(0);
-		throw new /*::*/MemberAccessException("Cannot read an undeclared property $class::\$$name.");
+		throw new LogicException("Cannot read an undeclared property $class::\$$name.");
 	}
 
 
@@ -255,14 +245,14 @@ abstract class DibiObject
 	 * @param  string  property name
 	 * @param  mixed   property value
 	 * @return void
-	 * @throws ::MemberAccessException if the property is not defined or is read-only
+	 * @throws \LogicException if the property is not defined or is read-only
 	 */
 	public function __set($name, $value)
 	{
 		$class = get_class($this);
 
 		if ($name === '') {
-			throw new /*::*/MemberAccessException("Cannot assign to an class '$class' property without name.");
+			throw new LogicException("Cannot assign to a class '$class' property without name.");
 		}
 
 		// property setter support
@@ -275,12 +265,12 @@ abstract class DibiObject
 
 			} else {
 				$name = func_get_arg(0);
-				throw new /*::*/MemberAccessException("Cannot assign to a read-only property $class::\$$name.");
+				throw new LogicException("Cannot assign to a read-only property $class::\$$name.");
 			}
 		}
 
 		$name = func_get_arg(0);
-		throw new /*::*/MemberAccessException("Cannot assign to an undeclared property $class::\$$name.");
+		throw new LogicException("Cannot assign to an undeclared property $class::\$$name.");
 	}
 
 
@@ -302,12 +292,12 @@ abstract class DibiObject
 	 * Access to undeclared property.
 	 * @param  string  property name
 	 * @return void
-	 * @throws ::MemberAccessException
+	 * @throws \LogicException
 	 */
 	public function __unset($name)
 	{
 		$class = get_class($this);
-		throw new /*::*/MemberAccessException("Cannot unset an property $class::\$$name.");
+		throw new LogicException("Cannot unset the property $class::\$$name.");
 	}
 
 

dibi/libs/DibiProfiler.php

@@ -1,229 +0,0 @@
-<?php
-
-/**
- * dibi - tiny'n'smart database abstraction layer
- * ----------------------------------------------
- *
- * Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
- *
- * This source file is subject to the "dibi license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://dibiphp.com
- *
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @license    http://dibiphp.com/license  dibi license
- * @link       http://dibiphp.com
- * @package    dibi
- * @version    $Id$
- */
-
-
-
-/**
- * dibi basic logger & profiler (experimental).
- *
- * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @package    dibi
- */
-class DibiProfiler extends DibiObject implements IDibiProfiler
-{
-	/** @var string  Name of the file where SQL errors should be logged */
-	private $file;
-
-	/** @var bool  log to firebug? */
-	private $useFirebug;
-
-	/** @var int */
-	private $filter = self::ALL;
-
-	/** @var array */
-	public $tickets = array();
-
-	/** @var array */
-	public static $table = array(array('Time', 'SQL Statement', 'Rows', 'Connection'));
-
-
-
-	public function __construct()
-	{
-		$this->useFirebug = isset($_SERVER['HTTP_USER_AGENT']) && strpos($_SERVER['HTTP_USER_AGENT'], 'FirePHP/');
-	}
-
-
-
-	/**
-	 * @param  string  filename
-	 * @return void
-	 */
-	public function setFile($file)
-	{
-		$this->file = $file;
-	}
-
-
-
-	/**
-	 * @param  int
-	 * @return void
-	 */
-	public function setFilter($filter)
-	{
-		$this->filter = (int) $filter;
-	}
-
-
-
-	/**
-	 * Before event notification.
-	 * @param  DibiConnection
-	 * @param  int     event name
-	 * @param  string  sql
-	 * @return int
-	 */
-	public function before(DibiConnection $connection, $event, $sql = NULL)
-	{
-		$this->tickets[] = array($connection, $event, $sql);
-		end($this->tickets);
-		return key($this->tickets);
-	}
-
-
-
-	/**
-	 * After event notification.
-	 * @param  int
-	 * @param  DibiResult
-	 * @return void
-	 */
-	public function after($ticket, $res = NULL)
-	{
-		if (!isset($this->tickets[$ticket])) {
-			throw new InvalidArgumentException('Bad ticket number.');
-		}
-
-		list($connection, $event, $sql) = $this->tickets[$ticket];
-
-		if (($event & $this->filter) === 0) return;
-
-		if ($event & self::QUERY) {
-			if ($this->useFirebug) {
-				self::$table[] = array(
-					sprintf('%0.3f', dibi::$elapsedTime * 1000),
-					trim($sql),
-					$res instanceof DibiResult ? count($res) : '-',
-					$connection->getConfig('driver') . '/' . $connection->getConfig('name')
-				);
-
-				header('X-Wf-Protocol-dibi: http://meta.wildfirehq.org/Protocol/JsonStream/0.2');
-				header('X-Wf-dibi-Plugin-1: http://meta.firephp.org/Wildfire/Plugin/FirePHP/Library-FirePHPCore/0.2.0');
-				header('X-Wf-dibi-Structure-1: http://meta.firephp.org/Wildfire/Structure/FirePHP/FirebugConsole/0.1');
-
-				$payload = array(
-					array(
-						'Type' => 'TABLE',
-						'Label' => 'dibi profiler (' . dibi::$numOfQueries . ' SQL queries took ' . sprintf('%0.3f', dibi::$totalTime * 1000) . ' ms)',
-					),
-					self::$table,
-				);
-				$payload = function_exists('json_encode') ? json_encode($payload) : self::json_encode($payload);
-				foreach (str_split($payload, 4990) as $num => $s) {
-					$num++;
-					header("X-Wf-dibi-1-1-d$num: |$s|\\"); // protocol-, structure-, plugin-, message-index
-				}
-				header("X-Wf-dibi-1-1-d$num: |$s|");
-				header("X-Wf-dibi-Index: d$num");
-			}
-
-			if ($this->file) {
-				$this->writeFile(
-					"OK: " . $sql
-					. ($res instanceof DibiResult ? ";\n-- rows: " . count($res) : '')
-					. "\n-- takes: " . sprintf('%0.3f', dibi::$elapsedTime * 1000) . ' ms'
-					. "\n-- driver: " . $connection->getConfig('driver') . '/' . $connection->getConfig('name')
-					. "\n-- " . date('Y-m-d H:i:s')
-					. "\n\n"
-				);
-			}
-		}
-	}
-
-
-
-	/**
-	 * After exception notification.
-	 * @param  DibiDriverException
-	 * @return void
-	 */
-	public function exception(DibiDriverException $exception)
-	{
-		if ((self::EXCEPTION & $this->filter) === 0) return;
-
-		if ($this->useFirebug) {
-			// TODO: implement
-		}
-
-		if ($this->file) {
-			$message = $exception->getMessage();
-			$code = $exception->getCode();
-			if ($code) {
-				$message = "[$code] $message";
-			}
-			$this->writeFile(
-				"ERROR: $message"
-				. "\n-- SQL: " . dibi::$sql
-				. "\n-- driver: " //. $connection->getConfig('driver')
-				. ";\n-- " . date('Y-m-d H:i:s')
-				. "\n\n"
-			);
-		}
-	}
-
-
-
-	private function writeFile($message)
-	{
-		$handle = fopen($this->file, 'a');
-		if (!$handle) return; // or throw exception?
-		flock($handle, LOCK_EX);
-		fwrite($handle, $message);
-		fclose($handle);
-	}
-
-
-
-	public static function json_encode($val)
-	{
-		// indexed array
-		if (is_array($val) && (!$val
-			|| array_keys($val) === range(0, count($val) - 1))) {
-			return '[' . implode(',', array_map(array(__CLASS__, 'json_encode'), $val)) . ']';
-		}
-
-		// associative array
-		if (is_array($val) || is_object($val)) {
-			$tmp = array();
-			foreach ($val as $k => $v) {
-				$tmp[] = self::json_encode((string) $k) . ':' . self::json_encode($v);
-			}
-			return '{' . implode(',', $tmp) . '}';
-		}
-
-		if (is_string($val)) {
-			$val = str_replace(array("\\", "\x00"), array("\\\\", "\\u0000"), $val); // due to bug #40915
-			return '"' . addcslashes($val, "\x8\x9\xA\xC\xD/\"") . '"';
-		}
-
-		if (is_int($val) || is_float($val)) {
-			return rtrim(rtrim(number_format($val, 5, '.', ''), '0'), '.');
-		}
-
-		if (is_bool($val)) {
-			return $val ? 'true' : 'false';
-		}
-
-		return 'null';
-	}
-
-}

dibi/libs/DibiResult.php

@@ -1,27 +1,18 @@
 <?php
 
 /**
- * dibi - tiny'n'smart database abstraction layer
- * ----------------------------------------------
+ * This file is part of the "dibi" - smart database abstraction layer.
  *
- * Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
  *
- * This source file is subject to the "dibi license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://dibiphp.com
- *
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @license    http://dibiphp.com/license  dibi license
- * @link       http://dibiphp.com
- * @package    dibi
- * @version    $Id$
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
  */
 
 
 
 /**
- * dibi result-set.
+ * dibi result set.
  *
  * <code>
  * $result = dibi::query('SELECT * FROM [table]');
@@ -37,85 +28,54 @@
  * </code>
  *
  * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
  * @package    dibi
+ *
+ * @property-read mixed $resource
+ * @property-read IDibiResultDriver $driver
+ * @property-read int $rowCount
+ * @property-read DibiResultIterator $iterator
+ * @property string $rowClass
+ * @property-read DibiResultInfo $info
  */
 class DibiResult extends DibiObject implements IDataSource
 {
-	/** @var array  IDibiDriver */
+	/** @var array  IDibiResultDriver */
 	private $driver;
 
 	/** @var array  Translate table */
-	private $xlat;
+	private $types = array();
 
-	/** @var array  Cache for $driver->getColumnsMeta() */
+	/** @var DibiResultInfo */
 	private $meta;
 
 	/** @var bool  Already fetched? Used for allowance for first seek(0) */
 	private $fetched = FALSE;
 
-	/** @var array|FALSE  Qualifiy each column name with the table name? */
-	private $withTables = FALSE;
+	/** @var string  returned object class */
+	private $rowClass = 'DibiRow';
+
+	/** @var array  format */
+	private $formats = array();
 
 
 
 	/**
-	 * @param  IDibiDriver
-	 * @param  array
+	 * @param  IDibiResultDriver
 	 */
-	public function __construct($driver, $config)
+	public function __construct($driver)
 	{
 		$this->driver = $driver;
-
-		if (!empty($config[dibi::RESULT_WITH_TABLES])) {
-			$this->setWithTables(TRUE);
-		}
+		$this->detectTypes();
 	}
 
 
 
 	/**
-	 * Automatically frees the resources allocated for this result set.
-	 * @return void
-	 */
-	public function __destruct()
-	{
-		@$this->free(); // intentionally @
-	}
-
-
-
-	/**
-	 * Returns the result set resource.
-	 * @return mixed
+	 * @deprecated
 	 */
 	final public function getResource()
 	{
-		return $this->getDriver()->getResultResource();
-	}
-
-
-
-	/**
-	 * Moves cursor position without fetching row.
-	 * @param  int      the 0-based cursor pos to seek to
-	 * @return boolean  TRUE on success, FALSE if unable to seek to specified record
-	 * @throws DibiException
-	 */
-	final public function seek($row)
-	{
-		return ($row !== 0 || $this->fetched) ? (bool) $this->getDriver()->seek($row) : TRUE;
-	}
-
-
-
-	/**
-	 * Returns the number of rows in a result set.
-	 * @return int
-	 */
-	final public function rowCount()
-	{
-		return $this->getDriver()->rowCount();
+		return $this->getResultDriver()->getResultResource();
 	}
 
 
@@ -128,47 +88,117 @@ class DibiResult extends DibiObject implements IDataSource
 	{
 		if ($this->driver !== NULL) {
 			$this->driver->free();
-			$this->driver = NULL;
+			$this->driver = $this->meta = NULL;
 		}
 	}
 
 
 
 	/**
-	 * Qualifiy each column name with the table name?
-	 * @param  bool
-	 * @return void
+	 * Safe access to property $driver.
+	 * @return IDibiResultDriver
+	 * @throws RuntimeException
+	 */
+	final public function getResultDriver()
+	{
+		if ($this->driver === NULL) {
+			throw new RuntimeException('Result-set was released from memory.');
+		}
+
+		return $this->driver;
+	}
+
+
+
+	/********************* rows ****************d*g**/
+
+
+
+	/**
+	 * Moves cursor position without fetching row.
+	 * @param  int      the 0-based cursor pos to seek to
+	 * @return boolean  TRUE on success, FALSE if unable to seek to specified record
 	 * @throws DibiException
 	 */
-	final public function setWithTables($val)
+	final public function seek($row)
 	{
-		if ($val) {
-			$cols = array();
-			foreach ($this->getMeta() as $info) {
-				$name = $info['fullname'];
-				if (isset($cols[$name])) {
-					$fix = 1;
-					while (isset($cols[$name . '#' . $fix])) $fix++;
-					$name .= '#' . $fix;
-				}
-				$cols[$name] = TRUE;
-			}
-			$this->withTables = array_keys($cols);
-
-		} else {
-			$this->withTables = FALSE;
-		}
+		return ($row !== 0 || $this->fetched) ? (bool) $this->getResultDriver()->seek($row) : TRUE;
 	}
 
 
 
 	/**
-	 * Qualifiy each key with the table name?
-	 * @return bool
+	 * Required by the Countable interface.
+	 * @return int
 	 */
-	final public function getWithTables()
+	final public function count()
 	{
-		return (bool) $this->withTables;
+		return $this->getResultDriver()->getRowCount();
+	}
+
+
+
+	/**
+	 * Returns the number of rows in a result set.
+	 * @return int
+	 */
+	final public function getRowCount()
+	{
+		return $this->getResultDriver()->getRowCount();
+	}
+
+
+
+	/**
+	 * Returns the number of rows in a result set. Alias for getRowCount().
+	 * @deprecated
+	 */
+	final public function rowCount()
+	{
+		trigger_error(__METHOD__ . '() is deprecated; use count($res) or $res->getRowCount() instead.', E_USER_WARNING);
+		return $this->getResultDriver()->getRowCount();
+	}
+
+
+
+	/**
+	 * Required by the IteratorAggregate interface.
+	 * @return DibiResultIterator
+	 */
+	final public function getIterator()
+	{
+		if (func_num_args()) {
+			trigger_error(__METHOD__ . ' arguments $offset & $limit have been dropped; use SQL clauses instead.', E_USER_WARNING);
+		}
+		return new DibiResultIterator($this);
+	}
+
+
+
+	/********************* fetching rows ****************d*g**/
+
+
+
+	/**
+	 * Set fetched object class. This class should extend the DibiRow class.
+	 * @param  string
+	 * @return DibiResult  provides a fluent interface
+	 */
+	public function setRowClass($class)
+	{
+		$this->rowClass = $class;
+		return $this;
+	}
+
+
+
+	/**
+	 * Returns fetched object class name.
+	 * @return string
+	 */
+	public function getRowClass()
+	{
+		return $this->rowClass;
 	}
 
 
@@ -180,28 +210,16 @@ class DibiResult extends DibiObject implements IDataSource
 	 */
 	final public function fetch()
 	{
-		if ($this->withTables === FALSE) {
-			$row = $this->getDriver()->fetch(TRUE);
-			if (!is_array($row)) return FALSE;
-
-		} else {
-			$row = $this->getDriver()->fetch(FALSE);
-			if (!is_array($row)) return FALSE;
-			$row = array_combine($this->withTables, $row);
+		$row = $this->getResultDriver()->fetch(TRUE);
+		if (!is_array($row)) {
+			return FALSE;
 		}
-
 		$this->fetched = TRUE;
-
-		// types-converting?
-		if ($this->xlat !== NULL) {
-			foreach ($this->xlat as $col => $type) {
-				if (isset($row[$col])) {
-					$row[$col] = $this->convert($row[$col], $type['type'], $type['format']);
-				}
-			}
+		$this->normalize($row);
+		if ($this->rowClass) {
+			$row = new $this->rowClass($row);
 		}
-
-		return new DibiRow($row, 2);
+		return $row;
 	}
 
 
@@ -212,19 +230,13 @@ class DibiResult extends DibiObject implements IDataSource
 	 */
 	final public function fetchSingle()
 	{
-		$row = $this->getDriver()->fetch(TRUE);
-		if (!is_array($row)) return FALSE;
-		$this->fetched = TRUE;
-		$value = reset($row);
-
-		// types-converting?
-		$key = key($row);
-		if (isset($this->xlat[$key])) {
-			$type = $this->xlat[$key];
-			return $this->convert($value, $type['type'], $type['format']);
+		$row = $this->getResultDriver()->fetch(TRUE);
+		if (!is_array($row)) {
+			return FALSE;
 		}
-
-		return $value;
+		$this->fetched = TRUE;
+		$this->normalize($row);
+		return reset($row);
 	}
 
 
@@ -256,13 +268,87 @@ class DibiResult extends DibiObject implements IDataSource
 
 	/**
 	 * Fetches all records from table and returns associative tree.
-	 * Associative descriptor:  assoc1,#,assoc2,=,assoc3,@
-	 * builds a tree:           $data[assoc1][index][assoc2]['assoc3']->value = {record}
+	 * Examples:
+	 * - associative descriptor: col1[]col2->col3
+	 *   builds a tree:          $tree[$val1][$index][$val2]->col3[$val3] = {record}
+	 * - associative descriptor: col1|col2->col3=col4
+	 *   builds a tree:          $tree[$val1][$val2]->col3[$val3] = val4
 	 * @param  string  associative descriptor
 	 * @return DibiRow
 	 * @throws InvalidArgumentException
 	 */
 	final public function fetchAssoc($assoc)
+	{
+		if (strpos($assoc, ',') !== FALSE) {
+			return $this->oldFetchAssoc($assoc);
+		}
+
+		$this->seek(0);
+		$row = $this->fetch();
+		if (!$row) return array();  // empty result set
+
+		$data = NULL;
+		$assoc = preg_split('#(\[\]|->|=|\|)#', $assoc, NULL, PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY);
+
+		// check columns
+		foreach ($assoc as $as) {
+			// offsetExists ignores NULL in PHP 5.2.1, isset() surprisingly NULL accepts
+			if ($as !== '[]' && $as !== '=' && $as !== '->' && $as !== '|' && !property_exists($row, $as)) {
+				throw new InvalidArgumentException("Unknown column '$as' in associative descriptor.");
+			}
+		}
+
+		if ($as === '->') { // must not be last
+			array_pop($assoc);
+		}
+
+		if (empty($assoc)) {
+			$assoc[] = '[]';
+		}
+
+		// make associative tree
+		do {
+			$x = & $data;
+
+			// iterative deepening
+			foreach ($assoc as $i => $as) {
+				if ($as === '[]') { // indexed-array node
+					$x = & $x[];
+
+				} elseif ($as === '=') { // "value" node
+					$x = $row->{$assoc[$i+1]};
+					continue 2;
+
+				} elseif ($as === '->') { // "object" node
+					if ($x === NULL) {
+						$x = clone $row;
+						$x = & $x->{$assoc[$i+1]};
+						$x = NULL; // prepare child node
+					} else {
+						$x = & $x->{$assoc[$i+1]};
+					}
+
+				} elseif ($as !== '|') { // associative-array node
+					$x = & $x[$row->$as];
+				}
+			}
+
+			if ($x === NULL) { // build leaf
+				$x = $row;
+			}
+
+		} while ($row = $this->fetch());
+
+		unset($x);
+		return $data;
+	}
+
+
+
+	/**
+	 * @deprecated
+	 */
+	private function oldFetchAssoc($assoc)
 	{
 		$this->seek(0);
 		$row = $this->fetch();
@@ -271,14 +357,6 @@ class DibiResult extends DibiObject implements IDataSource
 		$data = NULL;
 		$assoc = explode(',', $assoc);
 
-		// check columns
-		foreach ($assoc as $as) {
-			// offsetExists ignores NULL in PHP 5.2.1, isset() surprisingly NULL accepts
-			if ($as !== '#' && $as !== '=' && $as !== '@' && !isset($row[$as])) {
-				throw new InvalidArgumentException("Unknown column '$as' in associative descriptor.");
-			}
-		}
-
 		// strip leading = and @
 		$leaf = '@';  // gap
 		$last = count($assoc) - 1;
@@ -293,19 +371,16 @@ class DibiResult extends DibiObject implements IDataSource
 			}
 		}
 
-		// make associative tree
 		do {
-			$arr = (array) $row;
 			$x = & $data;
 
-			// iterative deepening
 			foreach ($assoc as $i => $as) {
 				if ($as === '#') { // indexed-array node
 					$x = & $x[];
 
 				} elseif ($as === '=') { // "record" node
 					if ($x === NULL) {
-						$x = $arr;
+						$x = $row->toArray();
 						$x = & $x[ $assoc[$i+1] ];
 						$x = NULL; // prepare child node
 					} else {
@@ -323,13 +398,13 @@ class DibiResult extends DibiObject implements IDataSource
 
 
 				} else { // associative-array node
-					$x = & $x[ $arr[ $as ] ];
+					$x = & $x[$row->$as];
 				}
 			}
 
 			if ($x === NULL) { // build leaf
 				if ($leaf === '=') {
-					$x = $arr;
+					$x = $row->toArray();
 				} else {
 					$x = $row;
 				}
@@ -364,7 +439,7 @@ class DibiResult extends DibiObject implements IDataSource
 			}
 
 			// autodetect
-			$tmp = array_keys((array) $row);
+			$tmp = array_keys($row->toArray());
 			$key = $tmp[0];
 			if (count($row) < 2) { // indexed-array
 				do {
@@ -376,7 +451,7 @@ class DibiResult extends DibiObject implements IDataSource
 			$value = $tmp[1];
 
 		} else {
-			if (!isset($row[$value])) {
+			if (!property_exists($row, $value)) {
 				throw new InvalidArgumentException("Unknown value column '$value'.");
 			}
 
@@ -387,7 +462,7 @@ class DibiResult extends DibiObject implements IDataSource
 				return $data;
 			}
 
-			if (!isset($row[$key])) {
+			if (!property_exists($row, $key)) {
 				throw new InvalidArgumentException("Unknown key column '$key'.");
 			}
 		}
@@ -401,17 +476,7 @@ class DibiResult extends DibiObject implements IDataSource
 
 
 
-	/**
-	 * Define column type.
-	 * @param string  column
-	 * @param string  type (use constant Dibi::FIELD_*)
-	 * @param string  optional format
-	 * @return void
-	 */
-	final public function setType($col, $type, $format = NULL)
-	{
-		$this->xlat[$col] = array('type' => $type, 'format' => $format);
-	}
+	/********************* column types ****************d*g**/
 
 
 
@@ -419,109 +484,159 @@ class DibiResult extends DibiObject implements IDataSource
 	 * Autodetect column types.
 	 * @return void
 	 */
-	final public function detectTypes()
+	private function detectTypes()
 	{
-		foreach ($this->getMeta() as $info) {
-			$this->xlat[$info['name']] = array('type' => $info['type'], 'format' => NULL);
+		$cache = DibiColumnInfo::getTypeCache();
+		try {
+			foreach ($this->getResultDriver()->getResultColumns() as $col) {
+				$this->types[$col['name']] = $cache->{$col['nativetype']};
+			}
+		} catch (DibiNotSupportedException $e) {}
+	}
+
+
+
+	/**
+	 * Converts values to specified type and format.
+	 * @param  array
+	 * @return void
+	 */
+	private function normalize(array & $row)
+	{
+		foreach ($this->types as $key => $type) {
+			if (!isset($row[$key])) { // NULL
+				continue;
+			}
+			$value = $row[$key];
+			if ($value === FALSE || $type === dibi::TEXT) {
+
+			} elseif ($type === dibi::INTEGER) {
+				$row[$key] = is_float($tmp = $value * 1) ? $value : $tmp;
+
+			} elseif ($type === dibi::FLOAT) {
+				$row[$key] = (string) ($tmp = (float) $value) === rtrim(rtrim($value, '0'), '.') ? $tmp : $value;
+
+			} elseif ($type === dibi::BOOL) {
+				$row[$key] = ((bool) $value) && $value !== 'f' && $value !== 'F';
+
+			} elseif ($type === dibi::DATE || $type === dibi::DATETIME) {
+				if ((int) $value === 0) { // '', NULL, FALSE, '0000-00-00', ...
+
+				} elseif (empty($this->formats[$type])) { // return DateTime object (default)
+					$row[$key] = new DibiDateTime(is_numeric($value) ? date('Y-m-d H:i:s', $value) : $value);
+
+				} elseif ($this->formats[$type] === 'U') { // return timestamp
+					$row[$key] = is_numeric($value) ? (int) $value : strtotime($value);
+
+				} elseif (is_numeric($value)) { // formatted date
+					$row[$key] = date($this->formats[$type], $value);
+
+				} else {
+					$value = new DibiDateTime($value);
+					$row[$key] = $value->format($this->formats[$type]);
+				}
+
+			} elseif ($type === dibi::BINARY) {
+				$row[$key] = $this->getResultDriver()->unescape($value, $type);
+			}
 		}
 	}
 
 
 
 	/**
-	 * Define multiple columns types.
-	 * @param array
-	 * @return void
-	 * @internal
+	 * Define column type.
+	 * @param  string  column
+	 * @param  string  type (use constant Dibi::*)
+	 * @return DibiResult  provides a fluent interface
 	 */
-	final public function setTypes(array $types)
+	final public function setType($col, $type)
 	{
-		$this->xlat = $types;
+		$this->types[$col] = $type;
+		return $this;
 	}
 
 
 
 	/**
 	 * Returns column type.
-	 * @return array  ($type, $format)
+	 * @return string
 	 */
 	final public function getType($col)
 	{
-		return isset($this->xlat[$col]) ? $this->xlat[$col] : NULL;
+		return isset($this->types[$col]) ? $this->types[$col] : NULL;
 	}
 
 
 
 	/**
-	 * Converts value to specified type and format
-	 * @return array  ($type, $format)
+	 * Sets data format.
+	 * @param  string  type (use constant Dibi::*)
+	 * @param  string  format
+	 * @return DibiResult  provides a fluent interface
 	 */
-	final public function convert($value, $type, $format = NULL)
+	final public function setFormat($type, $format)
 	{
-		if ($value === NULL || $value === FALSE) {
-			return $value;
-		}
-
-		switch ($type) {
-		case dibi::FIELD_TEXT:
-			return (string) $value;
-
-		case dibi::FIELD_BINARY:
-			return $this->getDriver()->unescape($value, $type);
-
-		case dibi::FIELD_INTEGER:
-			return (int) $value;
-
-		case dibi::FIELD_FLOAT:
-			return (float) $value;
-
-		case dibi::FIELD_DATE:
-		case dibi::FIELD_DATETIME:
-			$value = strtotime($value);
-			return $format === NULL ? $value : date($format, $value);
-
-		case dibi::FIELD_BOOL:
-			return ((bool) $value) && $value !== 'f' && $value !== 'F';
-
-		default:
-			return $value;
-		}
+		$this->formats[$type] = $format;
+		return $this;
 	}
 
 
 
 	/**
-	 * Gets an array of meta informations about columns.
-	 * @return array of DibiColumnInfo
+	 * Returns data format.
+	 * @return string
+	 */
+	final public function getFormat($type)
+	{
+		return isset($this->formats[$type]) ? $this->formats[$type] : NULL;
+	}
+
+
+
+	/********************* meta info ****************d*g**/
+
+
+
+	/**
+	 * Returns a meta information about the current result set.
+	 * @return DibiResultInfo
+	 */
+	public function getInfo()
+	{
+		if ($this->meta === NULL) {
+			$this->meta = new DibiResultInfo($this->getResultDriver());
+		}
+		return $this->meta;
+	}
+
+
+
+	/**
+	 * @deprecated
 	 */
 	final public function getColumns()
 	{
-		$cols = array();
-		foreach ($this->getMeta() as $info) {
-			$cols[] = new DibiColumnInfo($this->driver, $info);
-		}
-		return $cols;
+		return $this->getInfo()->getColumns();
 	}
 
 
 
-	/**
-	 * @param  bool
-	 * @return array of string
-	 */
-	public function getColumnNames($withTables = FALSE)
+	/** @deprecated */
+	public function getColumnNames($fullNames = FALSE)
 	{
-		$cols = array();
-		foreach ($this->getMeta() as $info) {
-			$cols[] = $info[$withTables ? 'fullname' : 'name'];
-		}
-		return $cols;
+		trigger_error(__METHOD__ . '() is deprecated; use $res->getInfo()->getColumnNames() instead.', E_USER_WARNING);
+		return $this->getInfo()->getColumnNames($fullNames);
 	}
 
 
 
+	/********************* misc tools ****************d*g**/
+
+
+
 	/**
-	 * Displays complete result-set as HTML table for debug purposes.
+	 * Displays complete result set as HTML table for debug purposes.
 	 * @return void
 	 */
 	final public function dump()
@@ -555,75 +670,4 @@ class DibiResult extends DibiObject implements IDataSource
 		}
 	}
 
-
-
-	/**
-	 * Required by the IteratorAggregate interface.
-	 * @param  int  offset
-	 * @param  int  limit
-	 * @return ArrayIterator
-	 */
-	final public function getIterator($offset = NULL, $limit = NULL)
-	{
-		return new ArrayIterator($this->fetchAll($offset, $limit));
-	}
-
-
-
-	/**
-	 * Required by the Countable interface.
-	 * @return int
-	 */
-	final public function count()
-	{
-		return $this->rowCount();
-	}
-
-
-
-	/**
-	 * Safe access to property $driver.
-	 * @return IDibiDriver
-	 * @throws InvalidStateException
-	 */
-	private function getDriver()
-	{
-		if ($this->driver === NULL) {
-			throw new InvalidStateException('Resultset was released from memory.');
-		}
-
-		return $this->driver;
-	}
-
-
-
-	/**
-	 * Meta lazy initialization.
-	 * @return array
-	 */
-	private function getMeta()
-	{
-		if ($this->meta === NULL) {
-			$this->meta = $this->getDriver()->getColumnsMeta();
-			foreach ($this->meta as & $row) {
-				$row['type'] = DibiColumnInfo::detectType($row['nativetype']);
-			}
-		}
-		return $this->meta;
-	}
-
-}
-
-
-
-
-/**
- * dibi result-set row
- *
- * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @package    dibi
- */
-class DibiRow extends ArrayObject
-{
 }

dibi/libs/DibiResultIterator.php

@@ -0,0 +1,118 @@
+<?php
+
+/**
+ * This file is part of the "dibi" - smart database abstraction layer.
+ *
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
+ */
+
+
+
+/**
+ * External result set iterator.
+ *
+ * This can be returned by DibiResult::getIterator() method or using foreach
+ * <code>
+ * $result = dibi::query('SELECT * FROM table');
+ * foreach ($result as $row) {
+ *    print_r($row);
+ * }
+ * unset($result);
+ * </code>
+ *
+ * @author     David Grudl
+ * @package    dibi
+ */
+class DibiResultIterator implements Iterator, Countable
+{
+	/** @var DibiResult */
+	private $result;
+
+	/** @var int */
+	private $row;
+
+	/** @var int */
+	private $pointer;
+
+
+	/**
+	 * @param  DibiResult
+	 */
+	public function __construct(DibiResult $result)
+	{
+		$this->result = $result;
+	}
+
+
+
+	/**
+	 * Rewinds the iterator to the first element.
+	 * @return void
+	 */
+	public function rewind()
+	{
+		$this->pointer = 0;
+		$this->result->seek(0);
+		$this->row = $this->result->fetch();
+	}
+
+
+
+	/**
+	 * Returns the key of the current element.
+	 * @return mixed
+	 */
+	public function key()
+	{
+		return $this->pointer;
+	}
+
+
+
+	/**
+	 * Returns the current element.
+	 * @return mixed
+	 */
+	public function current()
+	{
+		return $this->row;
+	}
+
+
+
+	/**
+	 * Moves forward to next element.
+	 * @return void
+	 */
+	public function next()
+	{
+		$this->row = $this->result->fetch();
+		$this->pointer++;
+	}
+
+
+
+	/**
+	 * Checks if there is a current element after calls to rewind() or next().
+	 * @return bool
+	 */
+	public function valid()
+	{
+		return !empty($this->row);
+	}
+
+
+
+	/**
+	 * Required by the Countable interface.
+	 * @return int
+	 */
+	public function count()
+	{
+		return $this->result->getRowCount();
+	}
+
+}

dibi/libs/DibiRow.php

@@ -0,0 +1,143 @@
+<?php
+
+/**
+ * This file is part of the "dibi" - smart database abstraction layer.
+ *
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
+ */
+
+
+
+/**
+ * Result set single row.
+ *
+ * @author     David Grudl
+ * @package    dibi
+ */
+class DibiRow implements ArrayAccess, IteratorAggregate, Countable
+{
+
+	public function __construct($arr)
+	{
+		foreach ($arr as $k => $v) $this->$k = $v;
+	}
+
+
+
+	public function toArray()
+	{
+		return (array) $this;
+	}
+
+
+
+	/**
+	 * Converts value to DateTime object.
+	 * @param  string key
+	 * @param  string format
+	 * @return DateTime
+	 */
+	public function asDateTime($key, $format = NULL)
+	{
+		$time = $this[$key];
+		if (!$time instanceof DibiDateTime) {
+			if ((int) $time === 0) { // '', NULL, FALSE, '0000-00-00', ...
+				return NULL;
+			}
+			$time = new DibiDateTime(is_numeric($time) ? date('Y-m-d H:i:s', $time) : $time);
+		}
+		return $format === NULL ? $time : $time->format($format);
+	}
+
+
+
+	/**
+	 * Converts value to UNIX timestamp.
+	 * @param  string key
+	 * @return int
+	 */
+	public function asTimestamp($key)
+	{
+		trigger_error(__METHOD__ . '() is deprecated.', E_USER_WARNING);
+		$time = $this[$key];
+		return (int) $time === 0 // '', NULL, FALSE, '0000-00-00', ...
+			? NULL
+			: (is_numeric($time) ? (int) $time : strtotime($time));
+	}
+
+
+
+	/**
+	 * Converts value to boolean.
+	 * @param  string key
+	 * @return mixed
+	 */
+	public function asBool($key)
+	{
+		trigger_error(__METHOD__ . '() is deprecated.', E_USER_WARNING);
+		return $this[$key];
+	}
+
+
+
+	/** @deprecated */
+	public function asDate($key, $format = NULL)
+	{
+		trigger_error(__METHOD__ . '() is deprecated.', E_USER_WARNING);
+		if ($format === NULL) {
+			return $this->asTimestamp($key);
+		} else {
+			return $this->asDateTime($key, $format === TRUE ? NULL : $format);
+		}
+	}
+
+
+
+	/********************* interfaces ArrayAccess, Countable & IteratorAggregate ****************d*g**/
+
+
+
+	final public function count()
+	{
+		return count((array) $this);
+	}
+
+
+
+	final public function getIterator()
+	{
+		return new ArrayIterator($this);
+	}
+
+
+
+	final public function offsetSet($nm, $val)
+	{
+		$this->$nm = $val;
+	}
+
+
+
+	final public function offsetGet($nm)
+	{
+		return $this->$nm;
+	}
+
+
+
+	final public function offsetExists($nm)
+	{
+		return isset($this->$nm);
+	}
+
+
+
+	final public function offsetUnset($nm)
+	{
+		unset($this->$nm);
+	}
+
+}

dibi/libs/DibiTableX.php

@@ -1,420 +0,0 @@
-<?php
-
-/**
- * dibi - tiny'n'smart database abstraction layer
- * ----------------------------------------------
- *
- * Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
- *
- * This source file is subject to the "dibi license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://dibiphp.com
- *
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @license    http://dibiphp.com/license  dibi license
- * @link       http://dibiphp.com
- * @package    dibi
- * @version    $Id$
- */
-
-
-/**
- * Experimental object-oriented interface to database tables.
- *
- * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @package    dibi
- */
-abstract class DibiTableX extends DibiObject
-{
-	/** @var string  primary key mask */
-	public static $primaryMask = 'id';
-
-	/** @var bool */
-	public static $lowerCase = TRUE;
-
-	/** @var DibiConnection */
-	private $connection;
-
-	/** @var string  table name */
-	protected $name;
-
-	/** @var string  primary key name */
-	protected $primary;
-
-	/** @var string  primary key type */
-	protected $primaryModifier = '%i';
-
-	/** @var bool  primary key is auto increment */
-	protected $primaryAutoIncrement = TRUE;
-
-	/** @var array */
-	protected $blankRow = array();
-
-	/** @var mixed; TRUE means autodetect, or array of pairs [type, format] */
-	protected $types = array();
-
-
-	/**
-	 * Table constructor.
-	 * @param  DibiConnection
-	 * @return void
-	 */
-	public function __construct(DibiConnection $connection = NULL)
-	{
-		$this->connection = $connection === NULL ? dibi::getConnection() : $connection;
-		$this->setup();
-	}
-
-
-
-	/**
-	 * Returns the table name.
-	 * @return string
-	 */
-	public function getName()
-	{
-		return $this->name;
-	}
-
-
-
-	/**
-	 * Returns the primary key name.
-	 * @return string
-	 */
-	public function getPrimary()
-	{
-		return $this->primary;
-	}
-
-
-
-	/**
-	 * Returns the dibi connection.
-	 * @return DibiConnection
-	 */
-	public function getConnection()
-	{
-		return $this->connection;
-	}
-
-
-
-	/**
-	 * Setup object.
-	 * @return void
-	 */
-	protected function setup()
-	{
-		// autodetect table name
-		if ($this->name === NULL) {
-			$name = $this->getClass();
-			if (FALSE !== ($pos = strrpos($name, ':'))) {
-				$name = substr($name, $pos + 1);
-			}
-			if (self::$lowerCase) {
-				$name = strtolower($name);
-			}
-			$this->name = $name;
-		}
-
-		// autodetect primary key name
-		if ($this->primary === NULL) {
-			$this->primary = str_replace(
-				array('%p', '%s'),
-				array($this->name, trim($this->name, 's')), // the simplest inflector in the world :-))
-				self::$primaryMask
-			);
-		}
-	}
-
-
-
-	/********************* basic commands ****************d*g**/
-
-
-
-	/**
-	 * Inserts row into a table.
-	 * @param  array|object
-	 * @return int  new primary key
-	 */
-	public function insert($data)
-	{
-		$this->connection->query(
-			'INSERT INTO %n', $this->name, '%v', $this->prepare($data)
-		);
-
-		return $this->primaryAutoIncrement ? $this->connection->insertId() : NULL;
-	}
-
-
-
-	/**
-	 * Updates rows in a table.
-	 * @param  mixed  primary key value(s)
-	 * @param  array|object
-	 * @return int    number of updated rows
-	 */
-	public function update($where, $data)
-	{
-		$data = $this->prepare($data);
-		if ($where === NULL && isset($data[$this->primary])) {;
-			$where = $data[$this->primary];
-			unset($data[$this->primary]);
-		}
-
-		$this->connection->query(
-			'UPDATE %n', $this->name,
-			'SET %a', $data,
-			'WHERE %n', $this->primary, 'IN (' . $this->primaryModifier, $where, ')'
-		);
-		return $this->connection->affectedRows();
-	}
-
-
-
-	/**
-	 * Inserts or updates rows in a table.
-	 * @param  array|object
-	 * @return int    (new) primary key
-	 */
-	public function insertOrUpdate($data)
-	{
-		$data = $this->prepare($data);
-		if (!isset($data[$this->primary])) {
-			throw new InvalidArgumentException("Missing primary key '$this->primary' in dataset.");
-		}
-
-		try {
-			$this->connection->query(
-				'INSERT INTO %n', $this->name, '%v', $data
-			);
-
-		} catch (DibiDriverException $e) {
-			$where = $data[$this->primary];
-			unset($data[$this->primary]);
-			$this->connection->query(
-				'UPDATE %n', $this->name,
-				'SET %a', $data,
-				'WHERE %n', $this->primary, 'IN (' . $this->primaryModifier, $where, ')'
-			);
-		}
-	}
-
-
-
-	/**
-	 * Deletes rows from a table by primary key.
-	 * @param  mixed  primary key value(s)
-	 * @return int    number of deleted rows
-	 */
-	public function delete($where)
-	{
-		$this->connection->query(
-			'DELETE FROM %n', $this->name,
-			'WHERE %n', $this->primary, 'IN (' . $this->primaryModifier, $where, ')'
-		);
-		return $this->connection->affectedRows();
-	}
-
-
-
-	/**
-	 * Finds rows by primary key.
-	 * @param  mixed  primary key value(s)
-	 * @return DibiResult
-	 */
-	public function find($what)
-	{
-		if (!is_array($what)) {
-			$what = func_get_args();
-		}
-		return $this->complete($this->connection->query(
-			'SELECT * FROM %n', $this->name,
-			'WHERE %n', $this->primary, 'IN (' . $this->primaryModifier, $what, ')'
-		));
-	}
-
-
-
-	/**
-	 * Selects all rows.
-	 * @param  array  conditions
-	 * @param  string|array  column to order by
-	 * @return DibiResult
-	 */
-	public function findAll($conditions = NULL, $order = NULL)
-	{
-		if (!is_array($order)) {
-			$order = func_get_args();
-			if (is_array($conditions)) {
-				array_shift($order);
-			} else {
-				$conditions = NULL;
-			}
-		}
-		return $this->complete($this->connection->query(
-			'SELECT * FROM %n', $this->name,
-			'%ex', $conditions ? array('WHERE %and', $conditions) : NULL,
-			'%ex', $order ? array('ORDER BY %by', $order) : NULL
-		));
-	}
-
-
-
-	/**
-	 * Fetches single row.
-	 * @param  scalar|array  primary key value
-	 * @return DibiRow
-	 */
-	public function fetch($conditions)
-	{
-		if (is_array($conditions)) {
-			return $this->complete($this->connection->query(
-				'SELECT * FROM %n', $this->name,
-				'WHERE %and', $conditions
-			))->fetch();
-		}
-		return $this->complete($this->connection->query(
-			'SELECT * FROM %n', $this->name,
-			'WHERE %n=' . $this->primaryModifier, $this->primary, $conditions
-		))->fetch();
-	}
-
-
-
-	/**
-	 * Returns a blank row (not fetched from database).
-	 * @return DibiRow
-	 */
-	public function createBlank()
-	{
-		$row = new DibiRow($this->blankRow, 2);
-		$row[$this->primary] = NULL;
-		return $row;
-	}
-
-
-
-	/**
-	 * User data pre-processing.
-	 * @param  array|object
-	 * @return array
-	 */
-	protected function prepare($data)
-	{
-		if (is_object($data)) {
-			return (array) $data;
-
-		} elseif (is_array($data)) {
-			return $data;
-		}
-
-		throw new InvalidArgumentException('Dataset must be array or anonymous object.');
-	}
-
-
-
-	/**
-	 * User DibiResult post-processing.
-	 * @param  DibiResult
-	 * @return DibiResult
-	 */
-	protected function complete($res)
-	{
-		if (is_array($this->types)) {
-			$res->setTypes($this->types);
-
-		} elseif ($this->types === TRUE) {
-			$res->detectTypes();
-		}
-		return $res;
-	}
-
-
-
-	/********************* fluent SQL builders ****************d*g**/
-
-
-
-	/**
-	 * Creates fluent SQL builder.
-	 * @return DibiFluent
-	 */
-	public function command()
-	{
-		return new DibiFluent($this->connection);
-	}
-
-
-
-	/**
-	 * @param  string    column name
-	 * @return DibiFluent
-	 */
-	public function select($args)
-	{
-		$args = func_get_args();
-		return $this->command()->__call('select', $args)->from($this->name);
-	}
-
-
-
-	/********************* magic fetching ****************d*g**/
-
-
-
-	/**
-	 * Magic fetch.
-	 * - $row = $model->fetchByUrl('about-us');
-	 * - $arr = $model->fetchAllByCategoryIdAndVisibility(5, TRUE);
-	 *
-	 * @param  string
-	 * @param  array
-	 * @return DibiRow|array
-	 */
-	public function __call($name, $args)
-	{
-		if (strncmp($name, 'fetchBy', 7) === 0) { // single row
-			$single = TRUE;
-			$name = substr($name, 7);
-
-		} elseif (strncmp($name, 'fetchAllBy', 10) === 0) { // multi row
-			$name = substr($name, 10);
-
-		} else {
-			parent::__call($name, $args);
-		}
-
-		// ProductIdAndTitle -> array('product', 'title')
-		$parts = explode('_and_', strtolower(preg_replace('#(.)(?=[A-Z])#', '$1_', $name)));
-
-		if (count($parts) !== count($args)) {
-			throw new InvalidArgumentException("Magic fetch expects " . count($parts) . " parameters, but " . count($args) . " was given.");
-		}
-
-		if (isset($single)) {
-			return $this->complete($this->connection->query(
-				'SELECT * FROM %n', $this->name,
-				'WHERE %and', array_combine($parts, $args),
-				'LIMIT 1'
-			))->fetch();
-		} else {
-			return $this->complete($this->connection->query(
-				'SELECT * FROM %n', $this->name,
-				'WHERE %and', array_combine($parts, $args)
-			))->fetchAll();
-		}
-	}
-
-}
-
-
-
-
-abstract class DibiTable extends DibiTableX
-{
-}

dibi/libs/DibiTranslator.php

@@ -1,21 +1,12 @@
 <?php
 
 /**
- * dibi - tiny'n'smart database abstraction layer
- * ----------------------------------------------
+ * This file is part of the "dibi" - smart database abstraction layer.
  *
- * Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
  *
- * This source file is subject to the "dibi license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://dibiphp.com
- *
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @license    http://dibiphp.com/license  dibi license
- * @link       http://dibiphp.com
- * @package    dibi
- * @version    $Id$
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
  */
 
 
@@ -24,13 +15,12 @@
  * dibi SQL translator.
  *
  * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
  * @package    dibi
  */
 final class DibiTranslator extends DibiObject
 {
-	/** @var string */
-	public $sql;
+	/** @var DibiConnection */
+	private $connection;
 
 	/** @var IDibiDriver */
 	private $driver;
@@ -59,21 +49,14 @@ final class DibiTranslator extends DibiObject
 	/** @var int */
 	private $offset;
 
+	/** @var DibiHashMap */
+	private $identifiers;
 
 
-	public function __construct(IDibiDriver $driver)
+
+	public function __construct(DibiConnection $connection)
 	{
-		$this->driver = $driver;
-	}
-
-
-
-	/**
-	 * return IDibiDriver.
-	 */
-	public function getDriver()
-	{
-		return $this->driver;
+		$this->connection = $connection;
 	}
 
 
@@ -81,10 +64,20 @@ final class DibiTranslator extends DibiObject
 	/**
 	 * Generates SQL.
 	 * @param  array
-	 * @return bool
+	 * @return string
+	 * @throws DibiException
 	 */
 	public function translate(array $args)
 	{
+		$this->identifiers = new DibiHashMap(array($this, 'delimite'));
+		$this->driver = $this->connection->getDriver();
+
+		$args = array_values($args);
+		while (count($args) === 1 && is_array($args[0])) { // implicit array expansion
+			$args = array_values($args[0]);
+		}
+		$this->args = $args;
+
 		$this->limit = -1;
 		$this->offset = 0;
 		$this->hasError = FALSE;
@@ -93,8 +86,6 @@ final class DibiTranslator extends DibiObject
 		// shortcuts
 		$cursor = & $this->cursor;
 		$cursor = 0;
-		$this->args = array_values($args);
-		$args = & $this->args;
 
 		// conditional sql
 		$this->ifLevel = $this->ifLevelStart = 0;
@@ -103,37 +94,39 @@ final class DibiTranslator extends DibiObject
 
 		// iterate
 		$sql = array();
-		while ($cursor < count($args))
+		while ($cursor < count($this->args))
 		{
-			$arg = $args[$cursor];
+			$arg = $this->args[$cursor];
 			$cursor++;
 
 			// simple string means SQL
 			if (is_string($arg)) {
 				// speed-up - is regexp required?
-				$toSkip = strcspn($arg, '`[\'"%');
+				$toSkip = strcspn($arg, '`[\'":%?');
 
 				if (strlen($arg) === $toSkip) { // needn't be translated
 					$sql[] = $arg;
 				} else {
 					$sql[] = substr($arg, 0, $toSkip)
 /*
-					preg_replace_callback('/
-					(?=`|\[|\'|"|%)                ## speed-up
+					. preg_replace_callback('/
+					(?=[`[\'":%?])                    ## speed-up
 					(?:
 						`(.+?)`|                     ## 1) `identifier`
 						\[(.+?)\]|                   ## 2) [identifier]
-						(\')((?:\'\'|[^\'])*)\'|     ## 3,4) string
+						(\')((?:\'\'|[^\'])*)\'|     ## 3,4) 'string'
 						(")((?:""|[^"])*)"|          ## 5,6) "string"
-						(\'|")                       ## 7) lone-quote
-						%([a-zA-Z]{1,4})(?![a-zA-Z])|## 8) modifier
+						(\'|")|                      ## 7) lone quote
+						:(\S*?:)([a-zA-Z0-9._]?)|    ## 8,9) :substitution:
+						%([a-zA-Z~][a-zA-Z0-9~]{0,5})|## 10) modifier
+						(\?)                         ## 11) placeholder
 					)/xs',
 */                  // note: this can change $this->args & $this->cursor & ...
-					. preg_replace_callback('/(?=`|\[|\'|"|%)(?:`(.+?)`|\[(.+?)\]|(\')((?:\'\'|[^\'])*)\'|(")((?:""|[^"])*)"|(\'|")|%([a-zA-Z]{1,4})(?![a-zA-Z]))/s',
+					. preg_replace_callback('/(?=[`[\'":%?])(?:`(.+?)`|\[(.+?)\]|(\')((?:\'\'|[^\'])*)\'|(")((?:""|[^"])*)"|(\'|")|:(\S*?:)([a-zA-Z0-9._]?)|%([a-zA-Z~][a-zA-Z0-9~]{0,5})|(\?))/s',
 							array($this, 'cb'),
 							substr($arg, $toSkip)
 					);
-
+					if (preg_last_error()) throw new DibiPcreException;
 				}
 				continue;
 			}
@@ -143,11 +136,15 @@ final class DibiTranslator extends DibiObject
 				continue;
 			}
 
+			if ($arg instanceof Traversable) {
+				$arg = iterator_to_array($arg);
+			}
+
 			if (is_array($arg)) {
 				if (is_string(key($arg))) {
 					// associative array -> autoselect between SET or VALUES & LIST
 					if ($commandIns === NULL) {
-						$commandIns = strtoupper(substr(ltrim($args[0]), 0, 6));
+						$commandIns = strtoupper(substr(ltrim($this->args[0]), 0, 6));
 						$commandIns = $commandIns === 'INSERT' || $commandIns === 'REPLAC';
 						$sql[] = $this->formatValue($arg, $commandIns ? 'v' : 'a');
 					} else {
@@ -156,12 +153,6 @@ final class DibiTranslator extends DibiObject
 					}
 					$lastArr = $cursor;
 					continue;
-
-				} elseif ($cursor === 1) {
-					// implicit array expansion
-					$cursor = 0;
-					array_splice($args, 0, 1, $arg);
-					continue;
 				}
 			}
 
@@ -174,13 +165,16 @@ final class DibiTranslator extends DibiObject
 
 		$sql = implode(' ', $sql);
 
+		if ($this->hasError) {
+			throw new DibiException('SQL translate error', 0, $sql);
+		}
+
 		// apply limit
 		if ($this->limit > -1 || $this->offset > 0) {
 			$this->driver->applyLimit($sql, $this->limit, $this->offset);
 		}
 
-		$this->sql = $sql;
-		return !$this->hasError;
+		return $sql;
 	}
 
 
@@ -193,70 +187,138 @@ final class DibiTranslator extends DibiObject
 	 */
 	public function formatValue($value, $modifier)
 	{
-		// array processing (with or without modifier)
-		if (is_array($value) || $value instanceof ArrayObject) {
+		if ($this->comment) {
+			return "...";
+		}
 
+		// array processing (with or without modifier)
+		if ($value instanceof Traversable) {
+			$value = iterator_to_array($value);
+		}
+
+		if (is_array($value)) {
 			$vx = $kx = array();
-			$operator = ', ';
 			switch ($modifier) {
 			case 'and':
 			case 'or':  // key=val AND key IS NULL AND ...
-				$operator = ' ' . strtoupper($modifier) . ' ';
 				if (empty($value)) {
-					return '1';
+					return '1=1';
+				}
 
-				} elseif (!is_string(key($value))) {
-					foreach ($value as $v) {
-						$vx[] = $this->formatValue($v, 'sql');
-					}
-
-				} else {
-					foreach ($value as $k => $v) {
+				foreach ($value as $k => $v) {
+					if (is_string($k)) {
 						$pair = explode('%', $k, 2); // split into identifier & modifier
-						$k = $this->delimite($pair[0]);
-						$v = $this->formatValue($v, isset($pair[1]) ? $pair[1] : FALSE);
-						$op = isset($pair[1]) && $pair[1] === 'l' ? 'IN' : ($v === 'NULL' ? 'IS' : '=');
-						$vx[] = $k . ' ' . $op . ' ' . $v;
+						$k = $this->identifiers->{$pair[0]} . ' ';
+						if (!isset($pair[1])) {
+							$v = $this->formatValue($v, FALSE);
+							$vx[] = $k . ($v === 'NULL' ? 'IS ' : '= ') . $v;
+
+						} elseif ($pair[1] === 'ex') { // TODO: this will be removed
+							$vx[] = $k . $this->formatValue($v, 'ex');
+
+						} else {
+							$v = $this->formatValue($v, $pair[1]);
+							if ($pair[1] === 'l' || $pair[1] === 'in')	{
+								$op = 'IN ';
+							} elseif (strpos($pair[1], 'like') !== FALSE) {
+								$op = 'LIKE ';
+							} elseif ($v === 'NULL') {
+								$op = 'IS ';
+							} else {
+								$op = '= ';
+							}
+							$vx[] = $k . $op . $v;
+						}
+
+					} else {
+						$vx[] = $this->formatValue($v, 'ex');
 					}
 				}
-				return implode($operator, $vx);
+				return '(' . implode(') ' . strtoupper($modifier) . ' (', $vx) . ')';
+
+			case 'n':  // key, key, ... identifier names
+				foreach ($value as $k => $v) {
+					if (is_string($k)) {
+						$vx[] = $this->identifiers->$k . (empty($v) ? '' : ' AS ' . $this->identifiers->$v);
+					} else {
+						$pair = explode('%', $v, 2); // split into identifier & modifier
+						$vx[] = $this->identifiers->{$pair[0]};
+					}
+				}
+				return implode(', ', $vx);
+
 
 			case 'a': // key=val, key=val, ...
 				foreach ($value as $k => $v) {
 					$pair = explode('%', $k, 2); // split into identifier & modifier
-					$vx[] = $this->delimite($pair[0]) . '='
-						. $this->formatValue($v, isset($pair[1]) ? $pair[1] : FALSE);
+					$vx[] = $this->identifiers->{$pair[0]} . '='
+						. $this->formatValue($v, isset($pair[1]) ? $pair[1] : (is_array($v) ? 'ex' : FALSE));
 				}
-				return implode($operator, $vx);
+				return implode(', ', $vx);
 
 
+			case 'in':// replaces scalar %in modifier!
 			case 'l': // (val, val, ...)
 				foreach ($value as $k => $v) {
 					$pair = explode('%', $k, 2); // split into identifier & modifier
-					$vx[] = $this->formatValue($v, isset($pair[1]) ? $pair[1] : FALSE);
+					$vx[] = $this->formatValue($v, isset($pair[1]) ? $pair[1] : (is_array($v) ? 'ex' : FALSE));
 				}
-				return '(' . implode(', ', $vx) . ')';
+				return '(' . (($vx || $modifier === 'l') ? implode(', ', $vx) : 'NULL') . ')';
 
 
 			case 'v': // (key, key, ...) VALUES (val, val, ...)
 				foreach ($value as $k => $v) {
 					$pair = explode('%', $k, 2); // split into identifier & modifier
-					$kx[] = $this->delimite($pair[0]);
-					$vx[] = $this->formatValue($v, isset($pair[1]) ? $pair[1] : FALSE);
+					$kx[] = $this->identifiers->{$pair[0]};
+					$vx[] = $this->formatValue($v, isset($pair[1]) ? $pair[1] : (is_array($v) ? 'ex' : FALSE));
 				}
 				return '(' . implode(', ', $kx) . ') VALUES (' . implode(', ', $vx) . ')';
 
+			case 'm': // (key, key, ...) VALUES (val, val, ...), (val, val, ...), ...
+				foreach ($value as $k => $v) {
+					if (is_array($v)) {
+						if (isset($proto)) {
+							if ($proto !== array_keys($v)) {
+								$this->hasError = TRUE;
+								return '**Multi-insert array "' . $k . '" is different.**';
+							}
+						} else {
+							$proto = array_keys($v);
+						}
+					} else {
+						$this->hasError = TRUE;
+						return '**Unexpected type ' . gettype($v) . '**';
+					}
+
+					$pair = explode('%', $k, 2); // split into identifier & modifier
+					$kx[] = $this->identifiers->{$pair[0]};
+					foreach ($v as $k2 => $v2) {
+						$vx[$k2][] = $this->formatValue($v2, isset($pair[1]) ? $pair[1] : (is_array($v2) ? 'ex' : FALSE));
+					}
+				}
+				foreach ($vx as $k => $v) {
+					$vx[$k] = '(' . implode(', ', $v) . ')';
+				}
+				return '(' . implode(', ', $kx) . ') VALUES ' . implode(', ', $vx);
+
 			case 'by': // key ASC, key DESC
 				foreach ($value as $k => $v) {
-					if (is_string($k)) {
+					if (is_array($v)) {
+						$vx[] = $this->formatValue($v, 'ex');
+					} elseif (is_string($k)) {
 						$v = (is_string($v) && strncasecmp($v, 'd', 1)) || $v > 0 ? 'ASC' : 'DESC';
-						$vx[] = $this->delimite($k) . ' ' . $v;
+						$vx[] = $this->identifiers->$k . ' ' . $v;
 					} else {
-						$vx[] = $this->delimite($v);
+						$vx[] = $this->identifiers->$v;
 					}
 				}
 				return implode(', ', $vx);
 
+			case 'ex':
+			case 'sql':
+				$translator = new self($this->connection);
+				return $translator->translate($value);
+
 			default:  // value, value, value - all with the same modifier
 				foreach ($value as $v) {
 					$vx[] = $this->formatValue($v, $modifier);
@@ -268,15 +330,7 @@ final class DibiTranslator extends DibiObject
 
 		// with modifier procession
 		if ($modifier) {
-			if ($value === NULL) {
-				return 'NULL';
-			}
-
-			if ($value instanceof IDibiVariable) {
-				return $value->toSql($this, $modifier);
-			}
-
-			if (!is_scalar($value)) {  // array is already processed
+			if ($value !== NULL && !is_scalar($value) && !($value instanceof DateTime)) {  // array is already processed
 				$this->hasError = TRUE;
 				return '**Unexpected type ' . gettype($value) . '**';
 			}
@@ -285,47 +339,79 @@ final class DibiTranslator extends DibiObject
 			case 's':  // string
 			case 'bin':// binary
 			case 'b':  // boolean
-				return $this->driver->escape($value, $modifier);
+				return $value === NULL ? 'NULL' : $this->driver->escape($value, $modifier);
 
-			case 'sn': // string or NULL
-				return $value == '' ? 'NULL' : $this->driver->escape($value, dibi::FIELD_TEXT); // notice two equal signs
+			case 'sN': // string or NULL
+			case 'sn':
+				return $value == '' ? 'NULL' : $this->driver->escape($value, dibi::TEXT); // notice two equal signs
+
+			case 'iN': // signed int or NULL
+			case 'in': // deprecated
+				if ($value == '') $value = NULL;
+				// intentionally break omitted
 
 			case 'i':  // signed int
 			case 'u':  // unsigned int, ignored
 				// support for long numbers - keep them unchanged
-				if (is_string($value) && preg_match('#[+-]?\d+(e\d+)?$#A', $value)) {
+				if (is_string($value) && preg_match('#[+-]?\d++(e\d+)?\z#A', $value)) {
 					return $value;
+				} else {
+					return $value === NULL ? 'NULL' : (string) (int) ($value + 0);
 				}
-				return (string) (int) ($value + 0);
 
 			case 'f':  // float
 				// support for extreme numbers - keep them unchanged
 				if (is_string($value) && is_numeric($value) && strpos($value, 'x') === FALSE) {
 					return $value; // something like -9E-005 is accepted by SQL, HEX values are not
+				} else {
+					return $value === NULL ? 'NULL' : rtrim(rtrim(number_format($value + 0, 10, '.', ''), '0'), '.');
 				}
-				return rtrim(rtrim(number_format($value, 5, '.', ''), '0'), '.');
 
 			case 'd':  // date
 			case 't':  // datetime
-				return $this->driver->escape(is_string($value) ? strtotime($value) : $value, $modifier);
+				if ($value === NULL) {
+					return 'NULL';
+				} else {
+					if (is_numeric($value)) {
+						$value = (int) $value; // timestamp
+
+					} elseif (is_string($value)) {
+						$value = new DateTime($value);
+					}
+					return $this->driver->escape($value, $modifier);
+				}
 
 			case 'by':
 			case 'n':  // identifier name
-				return $this->delimite($value);
+				return $this->identifiers->$value;
 
-			case 'sql':// preserve as SQL
+			case 'ex':
+			case 'sql': // preserve as dibi-SQL  (TODO: leave only %ex)
 				$value = (string) $value;
 				// speed-up - is regexp required?
-				$toSkip = strcspn($value, '`[\'"');
-				if (strlen($value) === $toSkip) { // needn't be translated
-					return $value;
-				} else {
-					return substr($value, 0, $toSkip)
-					. preg_replace_callback('/(?=`|\[|\'|")(?:`(.+?)`|\[(.+?)\]|(\')((?:\'\'|[^\'])*)\'|(")((?:""|[^"])*)"(\'|"))/s',
-							array($this, 'cb'),
-							substr($value, $toSkip)
+				$toSkip = strcspn($value, '`[\'":');
+				if (strlen($value) !== $toSkip) {
+					$value = substr($value, 0, $toSkip)
+					. preg_replace_callback(
+						'/(?=[`[\'":])(?:`(.+?)`|\[(.+?)\]|(\')((?:\'\'|[^\'])*)\'|(")((?:""|[^"])*)"|(\'|")|:(\S*?:)([a-zA-Z0-9._]?))/s',
+						array($this, 'cb'),
+						substr($value, $toSkip)
 					);
+					if (preg_last_error()) throw new DibiPcreException;
 				}
+				return $value;
+
+			case 'SQL': // preserve as real SQL (TODO: rename to %sql)
+				return (string) $value;
+
+			case 'like~':  // LIKE string%
+				return $this->driver->escapeLike($value, 1);
+
+			case '~like':  // LIKE %string
+				return $this->driver->escapeLike($value, -1);
+
+			case '~like~': // LIKE %string%
+				return $this->driver->escapeLike($value, 0);
 
 			case 'and':
 			case 'or':
@@ -343,23 +429,31 @@ final class DibiTranslator extends DibiObject
 
 
 		// without modifier procession
-		if (is_string($value))
-			return $this->driver->escape($value, dibi::FIELD_TEXT);
+		if (is_string($value)) {
+			return $this->driver->escape($value, dibi::TEXT);
 
-		if (is_int($value) || is_float($value))
-			return rtrim(rtrim(number_format($value, 5, '.', ''), '0'), '.');
+		} elseif (is_int($value)) {
+			return (string) $value;
 
-		if (is_bool($value))
-			return $this->driver->escape($value, dibi::FIELD_BOOL);
+		} elseif (is_float($value)) {
+			return rtrim(rtrim(number_format($value, 10, '.', ''), '0'), '.');
 
-		if ($value === NULL)
+		} elseif (is_bool($value)) {
+			return $this->driver->escape($value, dibi::BOOL);
+
+		} elseif ($value === NULL) {
 			return 'NULL';
 
-		if ($value instanceof IDibiVariable)
-			return $value->toSql($this, NULL);
+		} elseif ($value instanceof DateTime) {
+			return $this->driver->escape($value, dibi::DATETIME);
 
-		$this->hasError = TRUE;
-		return '**Unexpected ' . gettype($value) . '**';
+		} elseif ($value instanceof DibiLiteral) {
+			return (string) $value;
+
+		} else {
+			$this->hasError = TRUE;
+			return '**Unexpected ' . gettype($value) . '**';
+		}
 	}
 
 
@@ -378,10 +472,26 @@ final class DibiTranslator extends DibiObject
 		//    [5] => "
 		//    [6] => string
 		//    [7] => lone-quote
-		//    [8] => modifier (when called from self::translate())
+		//    [8] => substitution
+		//    [9] => substitution flag
+		//    [10] => modifier (when called from self::translate())
+		//    [11] => placeholder (when called from self::translate())
 
-		if (!empty($matches[8])) { // modifier
-			$mod = $matches[8];
+
+		if (!empty($matches[11])) { // placeholder
+			$cursor = & $this->cursor;
+
+			if ($cursor >= count($this->args)) {
+				$this->hasError = TRUE;
+				return "**Extra placeholder**";
+			}
+
+			$cursor++;
+			return $this->formatValue($this->args[$cursor - 1], FALSE);
+		}
+
+		if (!empty($matches[10])) { // modifier
+			$mod = $matches[10];
 			$cursor = & $this->cursor;
 
 			if ($cursor >= count($this->args) && $mod !== 'else' && $mod !== 'end') {
@@ -444,22 +554,28 @@ final class DibiTranslator extends DibiObject
 		if ($this->comment) return '...';
 
 		if ($matches[1])  // SQL identifiers: `ident`
-			return $this->delimite($matches[1]);
+			return $this->identifiers->{$matches[1]};
 
 		if ($matches[2])  // SQL identifiers: [ident]
-			return $this->delimite($matches[2]);
+			return $this->identifiers->{$matches[2]};
 
 		if ($matches[3])  // SQL strings: '...'
-			return $this->driver->escape( str_replace("''", "'", $matches[4]), dibi::FIELD_TEXT);
+			return $this->driver->escape( str_replace("''", "'", $matches[4]), dibi::TEXT);
 
 		if ($matches[5])  // SQL strings: "..."
-			return $this->driver->escape( str_replace('""', '"', $matches[6]), dibi::FIELD_TEXT);
+			return $this->driver->escape( str_replace('""', '"', $matches[6]), dibi::TEXT);
 
 		if ($matches[7]) { // string quote
 			$this->hasError = TRUE;
 			return '**Alone quote**';
 		}
 
+		if ($matches[8]) { // SQL identifier substitution
+			$m = substr($matches[8], 0, -1);
+			$m = $this->connection->getSubstitutes()->$m;
+			return $matches[9] == '' ? $this->formatValue($m, FALSE) : $m . $matches[9]; // value or identifier
+		}
+
 		die('this should be never executed');
 	}
 
@@ -469,11 +585,16 @@ final class DibiTranslator extends DibiObject
 	 * Apply substitutions to indentifier and delimites it.
 	 * @param  string indentifier
 	 * @return string
+	 * @internal
 	 */
-	private function delimite($value)
+	public function delimite($value)
 	{
-		return $this->driver->escape(dibi::substitute($value), dibi::IDENTIFIER);
+		$value = $this->connection->substitute($value);
+		$parts = explode('.', $value);
+		foreach ($parts as & $v) {
+			if ($v !== '*') $v = $this->driver->escape($v, dibi::IDENTIFIER);
+		}
+		return implode('.', $parts);
 	}
 
-
-} // class DibiTranslator
+}

dibi/libs/DibiVariable.php

@@ -1,49 +0,0 @@
-<?php
-
-/**
- * dibi - tiny'n'smart database abstraction layer
- * ----------------------------------------------
- *
- * Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
- *
- * This source file is subject to the "dibi license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://dibiphp.com
- *
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @license    http://dibiphp.com/license  dibi license
- * @link       http://dibiphp.com
- * @package    dibi
- * @version    $Id$
- */
-
-
-
-/**
- * Default implemenation of IDibiVariable.
- * @package dibi
- */
-class DibiVariable extends DibiObject implements IDibiVariable
-{
-	/** @var mixed */
-	public $value;
-
-	/** @var string */
-	public $modifier;
-
-
-	public function __construct($value, $modifier)
-	{
-		$this->value = $value;
-		$this->modifier = $modifier;
-	}
-
-
-
-	public function toSql(DibiTranslator $translator, $modifier)
-	{
-		return $translator->formatValue($this->value, $this->modifier);
-	}
-
-}

dibi/libs/interfaces.php

@@ -1,47 +1,19 @@
 <?php
 
 /**
- * dibi - tiny'n'smart database abstraction layer
- * ----------------------------------------------
+ * This file is part of the "dibi" - smart database abstraction layer.
  *
- * Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
+ * Copyright (c) 2005 David Grudl (http://davidgrudl.com)
  *
- * This source file is subject to the "dibi license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://dibiphp.com
- *
- * @copyright  Copyright (c) 2005, 2008 David Grudl
- * @license    http://dibiphp.com/license  dibi license
- * @link       http://dibiphp.com
- * @package    dibi
- * @version    $Id$
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code.
  */
 
 
 
-/**
- * Interface for user variable, used for generating SQL.
- * @package dibi
- */
-interface IDibiVariable
-{
-	/**
-	 * Format for SQL.
-	 * @param  DibiTranslator
-	 * @param  string  optional modifier
-	 * @return string  SQL code
-	 */
-	function toSql(DibiTranslator $translator, $modifier);
-}
-
-
-
-
-
 /**
  * Provides an interface between a dataset and data-aware components.
- * @package dibi
+ * @package    dibi
  */
 interface IDataSource extends Countable, IteratorAggregate
 {
@@ -51,64 +23,8 @@ interface IDataSource extends Countable, IteratorAggregate
 
 
 
-
-
-/**
- * Defines method that must profiler implement.
- * @package dibi
- */
-interface IDibiProfiler
-{
-	/**#@+ event type */
-	const CONNECT = 1;
-	const SELECT = 4;
-	const INSERT = 8;
-	const DELETE = 16;
-	const UPDATE = 32;
-	const QUERY = 60;
-	const BEGIN = 64;
-	const COMMIT = 128;
-	const ROLLBACK = 256;
-	const TRANSACTION = 448;
-	const EXCEPTION = 512;
-	const ALL = 1023;
-	/**#@-*/
-
-	/**
-	 * Before event notification.
-	 * @param  DibiConnection
-	 * @param  int     event name
-	 * @param  string  sql
-	 * @return int
-	 */
-	function before(DibiConnection $connection, $event, $sql = NULL);
-
-	/**
-	 * After event notification.
-	 * @param  int
-	 * @param  DibiResult
-	 * @return void
-	 */
-	function after($ticket, $result = NULL);
-
-	/**
-	 * After exception notification.
-	 * @param  DibiDriverException
-	 * @return void
-	 */
-	function exception(DibiDriverException $exception);
-
-}
-
-
-
-
-
 /**
  * dibi driver interface.
- *
- * @author     David Grudl
- * @copyright  Copyright (c) 2005, 2008 David Grudl
  * @package    dibi
  */
 interface IDibiDriver
@@ -122,8 +38,6 @@ interface IDibiDriver
 	 */
 	function connect(array &$config);
 
-
-
 	/**
 	 * Disconnects from a database.
 	 * @return void
@@ -131,60 +45,49 @@ interface IDibiDriver
 	 */
 	function disconnect();
 
-
-
 	/**
 	 * Internal: Executes the SQL query.
 	 * @param  string      SQL statement.
-	 * @return IDibiDriver|NULL
+	 * @return IDibiResultDriver|NULL
 	 * @throws DibiDriverException
 	 */
 	function query($sql);
 
-
-
 	/**
 	 * Gets the number of affected rows by the last INSERT, UPDATE or DELETE query.
 	 * @return int|FALSE  number of rows or FALSE on error
 	 */
-	function affectedRows();
-
-
+	function getAffectedRows();
 
 	/**
 	 * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query.
 	 * @return int|FALSE  int on success or FALSE on failure
 	 */
-	function insertId($sequence);
-
-
+	function getInsertId($sequence);
 
 	/**
 	 * Begins a transaction (if supported).
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	function begin();
-
-
+	function begin($savepoint = NULL);
 
 	/**
 	 * Commits statements in a transaction.
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	function commit();
-
-
+	function commit($savepoint = NULL);
 
 	/**
 	 * Rollback changes in a transaction.
+	 * @param  string  optional savepoint name
 	 * @return void
 	 * @throws DibiDriverException
 	 */
-	function rollback();
-
-
+	function rollback($savepoint = NULL);
 
 	/**
 	 * Returns the connection resource.
@@ -192,33 +95,28 @@ interface IDibiDriver
 	 */
 	function getResource();
 
-
-
-	/********************* SQL ****************d*g**/
-
-
+	/**
+	 * Returns the connection reflector.
+	 * @return IDibiReflector
+	 */
+	function getReflector();
 
 	/**
-	 * Encodes data for use in an SQL statement.
+	 * Encodes data for use in a SQL statement.
 	 * @param  string    value
-	 * @param  string    type (dibi::FIELD_TEXT, dibi::FIELD_BOOL, ...)
+	 * @param  string    type (dibi::TEXT, dibi::BOOL, ...)
 	 * @return string    encoded value
 	 * @throws InvalidArgumentException
 	 */
 	function escape($value, $type);
 
-
-
 	/**
-	 * Decodes data from result set.
-	 * @param  string    value
-	 * @param  string    type (dibi::FIELD_BINARY)
-	 * @return string    decoded value
-	 * @throws InvalidArgumentException
+	 * Encodes string for use in a LIKE statement.
+	 * @param  string
+	 * @param  int
+	 * @return string
 	 */
-	function unescape($value, $type);
-
-
+	function escapeLike($value, $pos);
 
 	/**
 	 * Injects LIMIT/OFFSET to the SQL query.
@@ -229,19 +127,24 @@ interface IDibiDriver
 	 */
 	function applyLimit(&$sql, $limit, $offset);
 
+}
 
 
-	/********************* result set ****************d*g**/
 
 
 
+/**
+ * dibi result set driver interface.
+ * @package    dibi
+ */
+interface IDibiResultDriver
+{
+
 	/**
 	 * Returns the number of rows in a result set.
 	 * @return int
 	 */
-	function rowCount();
-
-
+	function getRowCount();
 
 	/**
 	 * Moves cursor position without fetching row.
@@ -251,8 +154,6 @@ interface IDibiDriver
 	 */
 	function seek($row);
 
-
-
 	/**
 	 * Fetches the row at current position and moves the internal cursor to the next position.
 	 * @param  bool     TRUE for associative array, FALSE for numeric
@@ -261,8 +162,6 @@ interface IDibiDriver
 	 */
 	function fetch($type);
 
-
-
 	/**
 	 * Frees the resources allocated for this result set.
 	 * @param  resource  result set resource
@@ -270,16 +169,11 @@ interface IDibiDriver
 	 */
 	function free();
 
-
-
 	/**
 	 * Returns metadata for all columns in a result set.
-	 * @return array
-	 * @throws DibiException
+	 * @return array of {name, nativetype [, table, fullname, (int) size, (bool) nullable, (mixed) default, (bool) autoincrement, (array) vendor ]}
 	 */
-	function getColumnsMeta();
-
-
+	function getResultColumns();
 
 	/**
 	 * Returns the result set resource.
@@ -287,38 +181,50 @@ interface IDibiDriver
 	 */
 	function getResultResource();
 
+	/**
+	 * Decodes data from result set.
+	 * @param  string    value
+	 * @param  string    type (dibi::BINARY)
+	 * @return string    decoded value
+	 * @throws InvalidArgumentException
+	 */
+	function unescape($value, $type);
+
+}
 
 
-	/********************* reflection ****************d*g**/
 
 
 
+/**
+ * dibi driver reflection.
+ *
+ * @author     David Grudl
+ * @package    dibi
+ */
+interface IDibiReflector
+{
+
 	/**
 	 * Returns list of tables.
-	 * @return array
+	 * @return array of {name [, (bool) view ]}
 	 */
 	function getTables();
 
-
-
 	/**
 	 * Returns metadata for all columns in a table.
 	 * @param  string
-	 * @return array
+	 * @return array of {name, nativetype [, table, fullname, (int) size, (bool) nullable, (mixed) default, (bool) autoincrement, (array) vendor ]}
 	 */
 	function getColumns($table);
 
-
-
 	/**
 	 * Returns metadata for all indexes in a table.
 	 * @param  string
-	 * @return array
+	 * @return array of {name, (array of names) columns [, (bool) unique, (bool) primary ]}
 	 */
 	function getIndexes($table);
 
-
-
 	/**
 	 * Returns metadata for all foreign keys in a table.
 	 * @param  string

dibi/netterobots.txt

@@ -1,2 +0,0 @@
-Disallow: /drivers
-Disallow: /Nette

examples/.gitignore

@@ -0,0 +1,3 @@
+_test.bat
+ref
+output

examples/Nette/Debug.php

@@ -1,608 +0,0 @@
-<?php
-/**
- * Nette Framework
- *
- * Copyright (c) 2004, 2008 David Grudl (http://davidgrudl.com)
- *
- * This source file is subject to the "Nette license" that is bundled
- * with this package in the file license.txt.
- *
- * For more information please see http://nettephp.com
- *
- * @copyright  Copyright (c) 2004, 2008 David Grudl
- * @license    http://nettephp.com/license  Nette license
- * @link       http://nettephp.com
- * @category   Nette
- * @package    Nette
- * @version    $Id$
- */
-
-class
-ArgumentOutOfRangeException
-extends
-InvalidArgumentException{}class
-InvalidStateException
-extends
-RuntimeException{}class
-NotImplementedException
-extends
-LogicException{}class
-NotSupportedException
-extends
-LogicException{}class
-MemberAccessException
-extends
-LogicException{}class
-IOException
-extends
-RuntimeException{}class
-FileNotFoundException
-extends
-IOException{}class
-DirectoryNotFoundException
-extends
-IOException{}class
-FatalErrorException
-extends
-Exception{public
-function
-__construct($message,$code,$severity,$file,$line,$context){parent::__construct($message,$code);$this->file=$file;$this->line=$line;$this->context=$context;}}final
-class
-Framework{const
-VERSION='0.8';const
-REVISION='107 released on 2008/10/29 20:40:23';final
-public
-function
-__construct(){throw
-new
-LogicException("Cannot instantiate static class ".get_class($this));}public
-static
-function
-compareVersion($version){return
-version_compare($version,self::VERSION);}public
-static
-function
-promo($xhtml=TRUE){echo'<a href="http://nettephp.com/" title="Nette Framework - The Most Innovative PHP Framework"><img ','src="http://nettephp.com/images/nette-powered.gif" alt="Powered by Nette Framework" width="80" height="15"',($xhtml?' />':'>'),'</a>';}}final
-class
-Debug{public
-static$counters=array();public
-static$html;public
-static$maxDepth=3;public
-static$maxLen=150;private
-static$enabled=FALSE;public
-static$useFirebug;private
-static$logFile;private
-static$logHandle;private
-static$sendEmails;private
-static$emailHeaders=array('To'=>'','From'=>'noreply@%host%','X-Mailer'=>'Nette Framework','Subject'=>'PHP: An error occurred on the server %host%','Body'=>'[%date%]');public
-static$mailer=array(__CLASS__,'sendEmail');public
-static$emailProbability=0.01;public
-static$keysToHide=array('password','passwd','pass','pwd','creditcard','credit card','cc','pin');private
-static$colophons=array(array(__CLASS__,'getDefaultColophons'));private
-static$keyFilter=array();public
-static$time;const
-LOG='LOG';const
-INFO='INFO';const
-WARN='WARN';const
-ERROR='ERROR';final
-public
-function
-__construct(){throw
-new
-LogicException("Cannot instantiate static class ".get_class($this));}public
-static
-function
-dump($var,$return=FALSE){self::$keyFilter=FALSE;$output="<pre class=\"dump\">".self::_dump($var,0)."</pre>\n";if(!self::$html){$output=htmlspecialchars_decode(strip_tags($output),ENT_NOQUOTES);}if($return){return$output;}else{echo$output;return$var;}}private
-static
-function
-_dump(&$var,$level){if(is_bool($var)){return"<span>bool</span>(".($var?'TRUE':'FALSE').")\n";}elseif($var===NULL){return"<span>NULL</span>\n";}elseif(is_int($var)){return"<span>int</span>($var)\n";}elseif(is_float($var)){return"<span>float</span>($var)\n";}elseif(is_string($var)){if(self::$maxLen&&strlen($var)>self::$maxLen){$s=htmlSpecialChars(substr($var,0,self::$maxLen),ENT_NOQUOTES).' ... ';}else{$s=htmlSpecialChars($var,ENT_NOQUOTES);}return"<span>string</span>(".strlen($var).") \"$s\"\n";}elseif(is_array($var)){$s="<span>array</span>(".count($var).") {\n";$space=str_repeat('  ',$level);static$marker;if($marker===NULL)$marker=uniqid("\x00",TRUE);if(isset($var[$marker])){$s.="$space  *RECURSION*\n";}elseif($level<self::$maxDepth||!self::$maxDepth){$var[$marker]=0;foreach($var
-as$k=>&$v){if($k===$marker)continue;$s.="$space  ".(is_int($k)?$k:"\"$k\"")." => ";if(self::$keyFilter&&is_string($v)&&isset(self::$keyFilter[strtolower($k)])){$s.="<span>string</span>(?) <i>*** hidden ***</i>\n";}else{$s.=self::_dump($v,$level+1);}}unset($var[$marker]);}else{$s.="$space  ...\n";}return$s."$space}\n";}elseif(is_object($var)){$arr=(array)$var;$s="<span>object</span>(".get_class($var).") (".count($arr).") {\n";$space=str_repeat('  ',$level);static$list=array();if(in_array($var,$list,TRUE)){$s.="$space  *RECURSION*\n";}elseif($level<self::$maxDepth||!self::$maxDepth){$list[]=$var;foreach($arr
-as$k=>&$v){$m='';if($k[0]==="\x00"){$m=$k[1]==='*'?' <span>protected</span>':' <span>private</span>';$k=substr($k,strrpos($k,"\x00")+1);}$s.="$space  \"$k\"$m => ";if(self::$keyFilter&&is_string($v)&&isset(self::$keyFilter[strtolower($k)])){$s.="<span>string</span>(?) <i>*** hidden ***</i>\n";}else{$s.=self::_dump($v,$level+1);}}array_pop($list);}else{$s.="$space  ...\n";}return$s."$space}\n";}elseif(is_resource($var)){return"<span>resource of type</span>(".get_resource_type($var).")\n";}else{return"<span>unknown type</span>\n";}}public
-static
-function
-timer(){static$time=0;$now=microtime(TRUE);$delta=$now-$time;$time=$now;return$delta;}public
-static
-function
-enable($level=E_ALL,$logErrors=NULL,$sendEmails=FALSE){if(version_compare(PHP_VERSION,'5.2.1')===0){throw
-new
-NotSupportedException(__METHOD__.' is not supported in PHP 5.2.1');}if($logErrors===NULL&&class_exists('Environment')){$logErrors=Environment::isLive();}if(self::$useFirebug===NULL){self::$useFirebug=function_exists('json_encode')&&!$logErrors&&isset($_SERVER['HTTP_USER_AGENT'])&&strpos($_SERVER['HTTP_USER_AGENT'],'FirePHP/');}if($level!==NULL){error_reporting($level);}if(function_exists('ini_set')){ini_set('display_startup_errors',!$logErrors);ini_set('display_errors',!$logErrors);ini_set('html_errors',self::$html);ini_set('log_errors',(bool)$logErrors);}elseif($logErrors){throw
-new
-NotSupportedException('Function ini_set() is not enabled.');}if($logErrors){if(is_string($logErrors)){self::$logFile=strpos($logErrors,'%')===FALSE?$logErrors:Environment::expand($logErrors);}else{try{self::$logFile=Environment::expand('%logDir%/php_error.log');}catch(InvalidStateException$e){self::$logFile='php_error.log';}}ini_set('error_log',self::$logFile);}self::$sendEmails=$logErrors&&$sendEmails;if(self::$sendEmails){if(is_string($sendEmails)){self::$emailHeaders['To']=$sendEmails;}elseif(is_array($sendEmails)){self::$emailHeaders=$sendEmails+self::$emailHeaders;}if(mt_rand()/mt_getrandmax()<self::$emailProbability){self::observeErrorLog();}}if(!defined('E_RECOVERABLE_ERROR')){define('E_RECOVERABLE_ERROR',4096);}if(!defined('E_DEPRECATED')){define('E_DEPRECATED',8192);}set_exception_handler(array(__CLASS__,'exceptionHandler'));set_error_handler(array(__CLASS__,'errorHandler'));self::$enabled=TRUE;}public
-static
-function
-isEnabled(){return
-self::$enabled;}public
-static
-function
-exceptionHandler(Exception$exception){if(!headers_sent()){header('HTTP/1.1 500 Internal Server Error');}if(self::$logFile){error_log("PHP Fatal error:  Uncaught $exception");$file=@strftime('%d-%b-%Y %H-%M-%S ',Debug::$time).strstr(number_format(Debug::$time,4,'~',''),'~');$file=dirname(self::$logFile)."/exception $file.html";self::$logHandle=@fopen($file,'x');if(self::$logHandle){ob_start(array(__CLASS__,'writeFile'),1);self::paintBlueScreen($exception);ob_end_flush();fclose(self::$logHandle);}self::observeErrorLog();}elseif(!self::$html||isset($_SERVER['HTTP_X_REQUESTED_WITH'])&&$_SERVER['HTTP_X_REQUESTED_WITH']==='XMLHttpRequest'){if(self::$useFirebug&&!headers_sent()){self::fireLog($exception);}else{echo"$exception\n";foreach(self::$colophons
-as$callback){foreach((array)call_user_func($callback,'bluescreen')as$line)echo
-strip_tags($line)."\n";}}}else{while(ob_get_level()&&@ob_end_clean());self::paintBlueScreen($exception);exit;}}public
-static
-function
-errorHandler($severity,$message,$file,$line,$context){static$fatals=array(E_ERROR=>1,E_CORE_ERROR=>1,E_COMPILE_ERROR=>1,E_USER_ERROR=>1,E_PARSE=>1,E_RECOVERABLE_ERROR=>1);if(isset($fatals[$severity])){throw
-new
-FatalErrorException($message,0,$severity,$file,$line,$context);}elseif(($severity&error_reporting())!==$severity){return
-NULL;}elseif(self::$useFirebug&&!headers_sent()){$types=array(E_WARNING=>'Warning',E_USER_WARNING=>'Warning',E_NOTICE=>'Notice',E_USER_NOTICE=>'Notice',E_STRICT=>'Strict standards',E_DEPRECATED=>'Deprecated');$type=isset($types[$severity])?$types[$severity]:'Unknown error';$message=strip_tags($message);self::fireLog("$type: $message in $file on line $line",'WARN');return
-NULL;}return
-FALSE;}public
-static
-function
-paintBlueScreen(Exception$exception){$colophons=self::$colophons;function
-_netteDebugPrintCode($file,$line,$count=15){if(function_exists('ini_set')){ini_set('highlight.comment','#999; font-style: italic');ini_set('highlight.default','#000');ini_set('highlight.html','#06b');ini_set('highlight.keyword','#d24; font-weight: bold');ini_set('highlight.string','#080');}$start=max(1,$line-floor($count/2));$source=explode("\n",@highlight_file($file,TRUE));echo$source[0];$source=explode('<br />',$source[1]);array_unshift($source,NULL);$i=$start;while(--$i>=1){if(preg_match('#.*(</?span[^>]*>)#',$source[$i],$m)){if($m[1]!=='</span>')echo$m[1];break;}}$source=array_slice($source,$start,$count,TRUE);end($source);$numWidth=strlen((string)key($source));foreach($source
-as$n=>$s){$s=str_replace(array("\r","\n"),array('',''),$s);if($n===$line){printf("<span class='highlight'>Line %{$numWidth}s:    %s\n</span>%s",$n,strip_tags($s),preg_replace('#[^>]*(<[^>]+>)[^<]*#','$1',$s));}else{printf("<span class='line'>Line %{$numWidth}s:</span>    %s\n",$n,$s);}}echo'</span></span></code>';}function
-_netteOpenPanel($name,$collaped){static$id;$id++;?>
-	<div class="panel">
-		<h2><a href="#" onclick="return !toggle(this, 'pnl<?php echo$id?>')"><?php echo
-htmlSpecialChars($name)?> <span><?php echo$collaped?'&#x25b6;':'&#x25bc;'?></span></a></h2>
-
-		<div id="pnl<?php echo$id?>" class="<?php echo$collaped?'collapsed ':''?>inner">
-	<?php
-}function
-_netteClosePanel(){?>
-		</div>
-	</div>
-	<?php
-}if(headers_sent()){echo'</pre></xmp></table>';}?><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<html lang="en">
-<head>
-	<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-	<meta name="robots" content="noindex,noarchive">
-	<meta name="generator" content="Nette Framework">
-
-	<title><?php echo
-htmlspecialchars(get_class($exception))?></title>
-
-	<style type="text/css">
-	/* <![CDATA[ */
-		body {
-			font: 78%/1.5 Verdana, sans-serif;
-			background: white;
-			color: #333;
-			margin: 0 0 2em;
-			padding: 0;
-		}
-
-		h1 {
-			font-weight: normal !important;
-			font-size: 18pt;
-			margin: .6em 0;
-		}
-
-		h2 {
-			font-family: sans-serif;
-			font-weight: normal;
-			font-size: 14pt;
-			color: #888;
-			margin: .6em 0;
-		}
-
-		a {
-			text-decoration: none;
-			color: #4197E3;
-		}
-
-		a span {
-			color: #999;
-		}
-
-		h3 {
-			font-size: 110%;
-			font-weight: bold;
-			margin: 1em 0;
-		}
-
-		p { margin: .8em 0 }
-
-		pre, code, table {
-			font-family: Consolas, monospace;
-		}
-
-		pre, table {
-			background: #ffffcc;
-			padding: .4em .7em;
-			border: 1px dotted silver;
-		}
-
-		table pre {
-			padding: 0;
-			margin: 0;
-			border: none;
-			font-size: 100%;
-		}
-
-		pre.dump span {
-			color: #c16549;
-		}
-
-		div.panel {
-			border-bottom: 1px solid #eee;
-			padding: 1px 2em;
-		}
-
-		div.inner {
-			padding: 0.1em 1em 1em;
-			background: #f5f5f5;
-		}
-
-		table {
-			border-collapse: collapse;
-			width: 100%;
-		}
-
-		td, th {
-			vertical-align: top;
-			padding: 2px 3px;
-			border: 1px solid #eeeebb;
-		}
-
-		ul {
-			font-size: 80%;
-		}
-
-		.highlight, #error {
-			background: red;
-			color: white;
-			font-weight: bold;
-			font-style: normal;
-			display: block;
-		}
-
-		.line {
-			color: #9e9e7e;
-			font-weight: normal;
-			font-style: normal;
-		}
-
-	/* ]]> */
-	</style>
-
-
-	<script type="text/javascript">
-	/* <![CDATA[ */
-		document.write('<style> .collapsed { display: none; } </style>');
-
-		function toggle(link, panel)
-		{
-			var span = link.getElementsByTagName('span')[0];
-			var div = document.getElementById(panel);
-			var collapsed = div.currentStyle ? div.currentStyle.display == 'none' : getComputedStyle(div, null).display == 'none';
-
-			span.innerHTML = String.fromCharCode(collapsed ? 0x25bc : 0x25b6);
-			div.style.display = collapsed ? 'block' : 'none';
-
-			return true;
-		}
-	/* ]]> */
-	</script>
-</head>
-
-
-
-<body>
-	<div id="error" class="panel">
-		<h1><?php echo
-htmlspecialchars(get_class($exception)),($exception->getCode()?' #'.$exception->getCode():'')?></h1>
-
-		<p><?php echo
-htmlspecialchars($exception->getMessage())?></p>
-	</div>
-
-
-
-	<?php $ex=$exception;$level=0;?>
-	<?php do{?>
-
-		<?php if($level++):?>
-			<?php _netteOpenPanel('Caused by',TRUE)?>
-			<div class="panel">
-				<h1><?php echo
-htmlspecialchars(get_class($ex)),($ex->getCode()?' #'.$ex->getCode():'')?></h1>
-
-				<p><?php echo
-htmlspecialchars($ex->getMessage())?></p>
-			</div>
-		<?php endif?>
-
-		<?php if(is_file($ex->getFile())):?>
-		<?php _netteOpenPanel('Source file',FALSE)?>
-			<p><strong>File:</strong> <?php echo
-htmlspecialchars($ex->getFile())?> &nbsp; <strong>Line:</strong> <?php echo$ex->getLine()?></p>
-			<pre><?php _netteDebugPrintCode($ex->getFile(),$ex->getLine())?></pre>
-		<?php _netteClosePanel()?>
-		<?php endif?>
-
-
-
-		<?php _netteOpenPanel('Call stack',FALSE)?>
-			<ol>
-				<?php foreach($ex->getTrace()as$key=>$row):?>
-				<li><p>
-
-				<?php if(isset($row['file'])):?>
-					<span title="<?php echo
-htmlSpecialChars($row['file'])?>"><?php echo
-htmlSpecialChars(basename(dirname($row['file']))),'/<b>',htmlSpecialChars(basename($row['file'])),'</b></span> (',$row['line'],')'?>
-				<?php else:?>
-					&lt;PHP inner-code&gt;
-				<?php endif?>
-
-				<?php if(isset($row['file'])&&is_file($row['file'])):?><a href="#" onclick="return !toggle(this, 'src<?php echo"$level-$key"?>')">source <span>&#x25b6;</span></a> &nbsp; <?php endif?>
-
-				<?php if(isset($row['class']))echo$row['class'].$row['type']?>
-				<?php echo$row['function']?>
-
-				(<?php if(!empty($row['args'])):?><a href="#" onclick="return !toggle(this, 'args<?php echo"$level-$key"?>')">arguments <span>&#x25b6;</span></a><?php endif?>)
-				</p>
-
-				<?php if(!empty($row['args'])):?>
-					<div class="collapsed" id="args<?php echo"$level-$key"?>">
-					<table>
-					<?php
-
-try{$r=isset($row['class'])?new
-ReflectionMethod($row['class'],$row['function']):new
-ReflectionFunction($row['function']);$params=$r->getParameters();}catch(Exception$e){$params=array();}foreach($row['args']as$k=>$v){echo'<tr><td>',(isset($params[$k])?'$'.$params[$k]->name:"#$k"),'</td>';echo'<td>',self::safeDump($v,isset($params[$k])?$params[$k]->name:NULL),"</td></tr>\n";}?>
-					</table>
-					</div>
-				<?php endif?>
-
-
-				<?php if(isset($row['file'])&&is_file($row['file'])):?>
-					<pre class="collapsed" id="src<?php echo"$level-$key"?>"><?php _netteDebugPrintCode($row['file'],$row['line'])?></pre>
-				<?php endif?>
-
-				</li>
-				<?php endforeach?>
-			</ol>
-		<?php _netteClosePanel()?>
-
-
-
-		<?php if($ex
-instanceof
-IDebuggable):?>
-		<?php foreach($ex->getPanels()as$name=>$panel):?>
-		<?php _netteOpenPanel($name,empty($panel['expanded']))?>
-			<?php echo$panel['content']?>
-		<?php _netteClosePanel()?>
-		<?php endforeach?>
-		<?php endif?>
-
-
-
-		<?php if(isset($ex->context)&&is_array($ex->context)):?>
-		<?php _netteOpenPanel('Variables',TRUE)?>
-		<table>
-		<?php
-
-foreach($ex->context
-as$k=>$v){echo'<tr><td>$',htmlspecialchars($k),'</td><td>',self::safeDump($v,$k),"</td></tr>\n";}?>
-		</table>
-		<?php _netteClosePanel()?>
-		<?php endif?>
-
-	<?php }while((method_exists($ex,'getPrevious')&&$ex=$ex->getPrevious())||(isset($ex->previous)&&$ex=$ex->previous));?>
-	<?php while(--$level)_netteClosePanel()?>
-
-
-
-
-
-	<?php _netteOpenPanel('Environment',TRUE)?>
-		<?php
-$list=get_defined_constants(TRUE);if(!empty($list['user'])):?>
-		<h3><a href="#" onclick="return !toggle(this, 'pnl-env-const')">Constants <span>&#x25bc;</span></a></h3>
-		<table id="pnl-env-const">
-		<?php
-
-foreach($list['user']as$k=>$v){echo'<tr><td>',htmlspecialchars($k),'</td><td>',self::safeDump($v,$k),"</td></tr>\n";}?>
-		</table>
-		<?php endif?>
-
-
-		<h3><a href="#" onclick="return !toggle(this, 'pnl-env-files')">Included files <span>&#x25b6;</span></a> (<?php echo
-count(get_included_files())?>)</h3>
-		<table id="pnl-env-files" class="collapsed">
-		<?php
-
-foreach(get_included_files()as$v){echo'<tr><td>',htmlspecialchars($v),"</td></tr>\n";}?>
-		</table>
-
-
-		<h3>$_SERVER</h3>
-		<?php if(empty($_SERVER)):?>
-		<p><i>empty</i></p>
-		<?php else:?>
-		<table>
-		<?php
-
-foreach($_SERVER
-as$k=>$v)echo'<tr><td>',htmlspecialchars($k),'</td><td>',self::dump($v,TRUE),"</td></tr>\n";?>
-		</table>
-		<?php endif?>
-	<?php _netteClosePanel()?>
-
-
-
-
-	<?php _netteOpenPanel('HTTP request',TRUE)?>
-		<?php if(function_exists('apache_request_headers')):?>
-		<h3>Headers</h3>
-		<table>
-		<?php
-
-foreach(apache_request_headers()as$k=>$v)echo'<tr><td>',htmlspecialchars($k),'</td><td>',htmlspecialchars($v),"</td></tr>\n";?>
-		</table>
-		<?php endif?>
-
-
-		<?php foreach(array('_GET','_POST','_COOKIE')as$name):?>
-		<h3>$<?php echo$name?></h3>
-		<?php if(empty($GLOBALS[$name])):?>
-		<p><i>empty</i></p>
-		<?php else:?>
-		<table>
-		<?php
-
-foreach($GLOBALS[$name]as$k=>$v)echo'<tr><td>',htmlspecialchars($k),'</td><td>',self::dump($v,TRUE),"</td></tr>\n";?>
-		</table>
-		<?php endif?>
-		<?php endforeach?>
-	<?php _netteClosePanel()?>
-
-
-
-	<?php _netteOpenPanel('HTTP response',TRUE)?>
-		<h3>Headers</h3>
-		<?php if(headers_list()):?>
-		<pre><?php
-
-foreach(headers_list()as$s)echo
-htmlspecialchars($s),'<br>';?></pre>
-		<?php else:?>
-		<p><i>no headers</i></p>
-		<?php endif?>
-	<?php _netteClosePanel()?>
-
-
-	<ul>
-		<?php foreach($colophons
-as$callback):?>
-		<?php foreach((array)call_user_func($callback,'bluescreen')as$line):?><li><?php echo$line,"\n"?></li><?php endforeach?>
-		<?php endforeach?>
-	</ul>
-
-</body>
-</html><?php }public
-static
-function
-writeFile($buffer){fwrite(self::$logHandle,$buffer);}private
-static
-function
-observeErrorLog(){if(!self::$sendEmails)return;$monitorFile=self::$logFile.'.monitor';$saved=@file_get_contents($monitorFile);$actual=(int)@filemtime(self::$logFile);if($saved===FALSE){file_put_contents($monitorFile,$actual);}elseif(is_numeric($saved)&&$saved!=$actual){if(file_put_contents($monitorFile,'e-mail has been sent')){call_user_func(self::$mailer);}}}private
-static
-function
-sendEmail(){$host=isset($_SERVER['HTTP_HOST'])?$_SERVER['HTTP_HOST']:(isset($_SERVER['SERVER_NAME'])?$_SERVER['SERVER_NAME']:'');$headers=str_replace(array('%host%','%date%'),array($host,@date('Y-m-d H:i:s',Debug::$time)),self::$emailHeaders);$subject=$headers['Subject'];$to=$headers['To'];$body=$headers['Body'];unset($headers['Subject'],$headers['To'],$headers['Body']);$header='';foreach($headers
-as$key=>$value){$header.="$key: $value\r\n";}$body=str_replace("\r\n","\n",$body);if(PHP_OS!='Linux')$body=str_replace("\n","\r\n",$body);if($to==='debug'){self::dump(array($to,$subject,$body,$header));}else{mail($to,$subject,$body,$header);}}private
-static
-function
-safeDump($var,$key=NULL){self::$keyFilter=array_change_key_case(array_flip(self::$keysToHide),CASE_LOWER);if($key!==NULL&&isset(self::$keyFilter[strtolower($key)])){return'<i>*** hidden ***</i>';}return"<pre class=\"dump\">".self::_dump($var,0)."</pre>\n";}public
-static
-function
-enableProfiler(){register_shutdown_function(array(__CLASS__,'paintProfiler'));}public
-static
-function
-paintProfiler(){$colophons=self::$colophons;if(self::$useFirebug){foreach(self::$colophons
-as$callback){foreach((array)call_user_func($callback,'profiler')as$line)self::fireLog(strip_tags($line));}}if(!isset($_SERVER['HTTP_X_REQUESTED_WITH'])||$_SERVER['HTTP_X_REQUESTED_WITH']!=='XMLHttpRequest'){?>
-</pre></xmp>
-
-<style type="text/css">
-/* <![CDATA[ */
-	#netteProfilerContainer {
-		position: absolute;
-		right: 5px;
-		bottom: 5px;
-	}
-
-	#netteProfiler {
-		position: relative;
-		margin: 0;
-		padding: 1px;
-		width: 350px;
-		color: black;
-		background: #EEE;
-		border: 1px dotted gray;
-		cursor: move;
-		opacity: .70;
-		=filter: alpha(opacity=70);
-	}
-
-	#netteProfiler:hover {
-		opacity: 1;
-		=filter: none;
-	}
-
-	#netteProfiler li {
-		margin: 0;
-		padding: 1px;
-		font: normal normal 11px/1.4 Consolas, Arial;
-		text-align: left;
-		list-style: none;
-	}
-
-	#netteProfiler span[title] {
-		border-bottom: 1px dotted gray;
-		cursor: help;
-	}
-
-	#netteProfiler strong {
-		color: red;
-	}
-/* ]]> */
-</style>
-
-
-<div id="netteProfilerContainer">
-<ul id="netteProfiler">
-	<?php foreach($colophons
-as$callback):?>
-	<?php foreach((array)call_user_func($callback,'profiler')as$line):?><li><?php echo$line,"\n"?></li><?php endforeach?>
-	<?php endforeach?>
-</ul>
-</div>
-
-
-<script type="text/javascript">
-/* <![CDATA[ */
-document.getElementById('netteProfiler').onmousedown = function(e) {
-	e = e || event;
-	this.posX = parseInt(this.style.left + '0');
-	this.posY = parseInt(this.style.top + '0');
-	this.mouseX = e.clientX;
-	this.mouseY = e.clientY;
-
-	var thisObj = this;
-
-	document.documentElement.onmousemove = function(e) {
-		e = e || event;
-		thisObj.style.left = (e.clientX - thisObj.mouseX + thisObj.posX) + "px";
-		thisObj.style.top = (e.clientY - thisObj.mouseY + thisObj.posY) + "px";
-		return false;
-	};
-
-	document.documentElement.onmouseup = function(e) {
-		document.documentElement.onmousemove = null;
-		document.documentElement.onmouseup = null;
-		return false;
-	};
-};
-/* ]]> */
-</script>
-<?php }}public
-static
-function
-addColophon($callback){if(!in_array($callback,self::$colophons,TRUE)&&is_callable($callback)){self::$colophons[]=$callback;}}public
-static
-function
-getDefaultColophons($sender){if($sender==='profiler'){$arr[]='Elapsed time: '.sprintf('%0.3f',(microtime(TRUE)-Debug::$time)*1000).' ms';foreach((array)self::$counters
-as$name=>$value){if(is_array($value))$value=implode(', ',$value);$arr[]=htmlSpecialChars($name).' = <strong>'.htmlSpecialChars($value).'</strong>';}$autoloaded=class_exists('AutoLoader',FALSE)?AutoLoader::$count:0;$s='<span>'.count(get_included_files()).'/'.$autoloaded.' files</span>, ';$exclude=array('stdClass','Exception','ErrorException','Traversable','IteratorAggregate','Iterator','ArrayAccess','Serializable','Closure');foreach(get_loaded_extensions()as$ext){$ref=new
-ReflectionExtension($ext);$exclude=array_merge($exclude,$ref->getClassNames());}$classes=array_diff(get_declared_classes(),$exclude);$intf=array_diff(get_declared_interfaces(),$exclude);$func=get_defined_functions();$func=(array)@$func['user'];$consts=get_defined_constants(TRUE);$consts=array_keys((array)@$consts['user']);foreach(array('classes','intf','func','consts')as$item){$s.='<span '.($$item?'title="'.implode(", ",$$item).'"':'').'>'.count($$item).' '.$item.'</span>, ';}$arr[]=$s;}if($sender==='bluescreen'){$arr[]='PHP '.PHP_VERSION;if(isset($_SERVER['SERVER_SOFTWARE']))$arr[]=htmlSpecialChars($_SERVER['SERVER_SOFTWARE']);$arr[]='Nette Framework '.Framework::VERSION.' (revision '.Framework::REVISION.')';$arr[]='Report generated at '.@strftime('%c',Debug::$time);}return$arr;}public
-static
-function
-fireDump($var,$key){return
-self::fireSend(2,array((string)$key=>$var));}public
-static
-function
-fireLog($message,$priority=self::LOG,$label=NULL){if($message
-instanceof
-Exception){$priority='TRACE';$message=array('Class'=>get_class($message),'Message'=>$message->getMessage(),'File'=>$message->getFile(),'Line'=>$message->getLine(),'Trace'=>self::replaceObjects($message->getTrace()));}elseif($priority==='GROUP_START'){$label=$message;$message=NULL;}return
-self::fireSend(1,array(array('Type'=>$priority,'Label'=>$label),self::replaceObjects($message)));}private
-static
-function
-fireSend($index,$payload){if(headers_sent())return
-FALSE;header('X-Wf-Protocol-nette: http://meta.wildfirehq.org/Protocol/JsonStream/0.2');header('X-Wf-nette-Plugin-1: http://meta.firephp.org/Wildfire/Plugin/FirePHP/Library-FirePHPCore/0.2.0');if($index===1){header('X-Wf-nette-Structure-1: http://meta.firephp.org/Wildfire/Structure/FirePHP/FirebugConsole/0.1');}elseif($index===2){header('X-Wf-nette-Structure-2: http://meta.firephp.org/Wildfire/Structure/FirePHP/Dump/0.1');}$payload=json_encode($payload);static$counter;foreach(str_split($payload,4990)as$s){$num=++$counter;header("X-Wf-nette-$index-1-n$num: |$s|\\");}header("X-Wf-nette-$index-1-n$num: |$s|");header("X-Wf-nette-Index: n$num");return
-TRUE;}static
-private
-function
-replaceObjects($val){if(is_object($val)){return'object '.get_class($val).'';}elseif(is_array($val)){foreach($val
-as$k=>$v){unset($val[$k]);$val[$k]=self::replaceObjects($v);}}return$val;}}Debug::$html=PHP_SAPI!=='cli';Debug::$time=microtime(TRUE);

examples/Nette/license.txt

@@ -1,62 +1,62 @@
-The Nette License, Version 1
-============================
+Licenses
+========
 
-Copyright (c) 2004, 2008 David Grudl (http://davidgrudl.com)
+Good news! You may use Nette Framework under the terms of either
+the New BSD License or the GNU General Public License (GPL) version 2 or 3.
+
+The BSD License is recommended for most projects. It is easy to understand and it
+places almost no restrictions on what you can do with the framework. If the GPL
+fits better to your project, you can use the framework under this license.
+
+You don't have to notify anyone which license you are using. You can freely
+use Nette Framework in commercial projects as long as the copyright header
+remains intact.
+
+Please be advised that the name "Nette Framework" is a protected trademark and its
+usage has some limitations. So please do not use word "Nette" in the name of your
+project or top-level domain, and choose a name that stands on its own merits.
+If your stuff is good, it will not take long to establish a reputation for yourselves.
+
+
+
+New BSD License
+---------------
+
+Copyright (c) 2004, 2012 David Grudl (http://davidgrudl.com)
 All rights reserved.
 
-This license is a legal agreement between you and David Grudl (the "Author")
-for the use of Nette Framework (the "Software"). By obtaining, using and/or
-copying the Software, you agree that you have read, understood, and will
-comply with the terms and conditions of this license.
+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.
 
-PERMITTED USE
--------------
+	* 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.
 
-You are permitted to use, copy, modify, and distribute the Software and its
-documentation, with or without modification, for any purpose, provided that
-the following conditions are met:
+	* Neither the name of "Nette Framework" nor the names of its contributors
+	may be used to endorse or promote products derived from this software
+	without specific prior written permission.
 
-1. A copy of this license agreement must be included with the distribution.
-
-2. Redistributions of source code must retain the above copyright notice in
-   all source code files.
-
-3. Redistributions in binary form must reproduce the above copyright notice
-   in the documentation and/or other materials provided with the distribution.
-
-4. Products derived from the Software must include an acknowledgment that
-   they are derived from Nette Framework in their documentation and/or other
-   materials provided with the distribution.
-
-5. The name "Nette Framework" must not be used to endorse or promote products
-   derived from the Software without prior written permission from Author.
-
-6. Products derived from the Software may not be called "Nette Framework",
-   nor may "Nette" appear in their name, without prior written
-   permission from Author.
-
-
-INDEMNITY
----------
-
-You agree to indemnify and hold harmless the Author and any contributors
-for any direct, indirect, incidental, or consequential third-party claims,
-actions or suits, as well as any related expenses, liabilities, damages,
-settlements or fees arising from your use or misuse of the Software,
-or a violation of any terms of this license.
-
-
-DISCLAIMER OF WARRANTY
-----------------------
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER "AS IS" AND
+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 COPYRIGHT HOLDER BE LIABLE FOR
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER 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.
+
+
+
+GNU General Public License
+--------------------------
+
+GPL licenses are very very long, so instead of including them here we offer
+you URLs with full text:
+
+- GPL version 2: http://www.gnu.org/licenses/gpl-2.0.html
+- GPL version 3: http://www.gnu.org/licenses/gpl-3.0.html

examples/Nette/readme.txt

@@ -1,3 +1,3 @@
 This file is part of Nette Framework
 
-For more information please see http://nettephp.com
+For more information please see http://nette.org

examples/connecting-to-databases.php

@@ -1,16 +1,36 @@
-<h1>dibi::connect() example</h1>
+<!DOCTYPE html><link rel="stylesheet" href="data/style.css">
+
+<h1>Connecting to Databases | dibi</h1>
+
 <?php
 
-require_once 'Nette/Debug.php';
+require_once 'Nette/Debugger.php';
 require_once '../dibi/dibi.php';
 
 
-// connects to SQlite
+// connects to SQlite using dibi class
 echo '<p>Connecting to Sqlite: ';
 try {
 	dibi::connect(array(
 		'driver'   => 'sqlite',
-		'database' => 'sample.sdb',
+		'database' => 'data/sample.sdb',
+	));
+	echo 'OK';
+
+} catch (DibiException $e) {
+	echo get_class($e), ': ', $e->getMessage(), "\n";
+}
+echo "</p>\n";
+
+
+
+
+// connects to SQlite using DibiConnection object
+echo '<p>Connecting to Sqlite: ';
+try {
+	$connection = new DibiConnection(array(
+		'driver'   => 'sqlite',
+		'database' => 'data/sample.sdb',
 	));
 	echo 'OK';
 
@@ -25,7 +45,7 @@ echo "</p>\n";
 // connects to MySQL using DSN
 echo '<p>Connecting to MySQL: ';
 try {
-	dibi::connect('driver=mysql&host=localhost&username=root&password=xxx&database=test&charset=utf8');
+	dibi::connect('driver=mysql&host=localhost&username=root&password=xxx&database=test&charset=cp1250');
 	echo 'OK';
 
 } catch (DibiException $e) {
@@ -37,7 +57,7 @@ echo "</p>\n";
 
 
 // connects to MySQLi using array
-echo '<p>Connecting to MySQL: ';
+echo '<p>Connecting to MySQLi: ';
 try {
 	dibi::connect(array(
 		'driver'   => 'mysqli',
@@ -45,7 +65,10 @@ try {
 		'username' => 'root',
 		'password' => 'xxx',
 		'database' => 'dibi',
-		'charset'  => 'utf8',
+		'options'  => array(
+			MYSQLI_OPT_CONNECT_TIMEOUT => 30
+		),
+		'flags'    => MYSQLI_CLIENT_COMPRESS,
 	));
 	echo 'OK';
 
@@ -64,7 +87,7 @@ try {
 		'driver'   => 'odbc',
 		'username' => 'root',
 		'password' => '***',
-		'dsn'      => 'Driver={Microsoft Access Driver (*.mdb)};Dbq='.dirname(__FILE__).'/sample.mdb',
+		'dsn'      => 'Driver={Microsoft Access Driver (*.mdb)};Dbq='.dirname(__FILE__).'/data/sample.mdb',
 	));
 	echo 'OK';
 
@@ -128,6 +151,25 @@ echo "</p>\n";
 
 
 
+// connects to MS SQL 2005
+echo '<p>Connecting to MS SQL 2005: ';
+try {
+	dibi::connect(array(
+		'driver'   => 'mssql2005',
+		'host'     => '(local)',
+		'username' => 'Administrator',
+		'password' => 'xxx',
+		'database' => 'main',
+	));
+	echo 'OK';
+
+} catch (DibiException $e) {
+	echo get_class($e), ': ', $e->getMessage(), "\n";
+}
+echo "</p>\n";
+
+
+
 // connects to Oracle
 echo '<p>Connecting to Oracle: ';
 try {
@@ -142,4 +184,4 @@ try {
 } catch (DibiException $e) {
 	echo get_class($e), ': ', $e->getMessage(), "\n";
 }
-echo "</p>\n";
+echo "</p>\n";

examples/data/style.css

@@ -0,0 +1,64 @@
+body {
+	font: 15px/1.5 Tahoma, Verdana, Myriad Web, Syntax, sans-serif;
+	color: #333;
+	background: #fff url('dibi-powered.gif') no-repeat 99% 1em;
+	margin:	1.6em;
+	padding: 0;
+}
+
+h1, h2 {
+	font-size: 210%;
+	font-weight: normal;
+	color: #036;
+}
+
+h2 {
+	font-size: 150%;
+}
+
+a {
+	color: #000080;
+}
+
+table.dump {
+	padding: 0;
+	margin: 0;
+	border-collapse:collapse;
+}
+
+table.dump td, table.dump th {
+	color: #505767;
+	background: #fff;
+	border: 1px solid #d1cdab;
+	padding: 6px 6px 6px 12px;
+	text-align: left;
+}
+
+table.dump th {
+	font-size: 80%;
+	color: #525b37;
+	background: #e3e9ba;
+}
+
+/* dump() */
+pre.nette-dump, pre.dump {
+	color: #444; background: white;
+	border: 1px solid silver;
+	padding: 1em;
+	margin: 1em 0;
+}
+pre.nette-dump .php-array, pre.nette-dump .php-object {
+	color: #C22;
+}
+pre.nette-dump .php-string {
+	color: #080;
+}
+pre.nette-dump .php-int, pre.nette-dump .php-float {
+	color: #37D;
+}
+pre.nette-dump .php-null, pre.nette-dump .php-bool {
+	color: black;
+}
+pre.nette-dump .php-visibility {
+	font-size: 85%; color: #999;
+}

examples/database-reflection.php

@@ -0,0 +1,53 @@
+<!DOCTYPE html><link rel="stylesheet" href="data/style.css">
+
+<h1>Database Reflection | dibi</h1>
+
+<?php
+
+require_once 'Nette/Debugger.php';
+require_once '../dibi/dibi.php';
+
+
+dibi::connect(array(
+	'driver'   => 'sqlite',
+	'database' => 'data/sample.sdb',
+));
+
+
+
+// retrieve database reflection
+$database = dibi::getDatabaseInfo();
+
+echo "<h2>Database '{$database->name}'</h2>\n";
+echo "<ul>\n";
+foreach ($database->getTables() as $table) {
+	echo '<li>', ($table->view ? 'view' : 'table') . " $table->name</li>\n";
+}
+echo "</ul>\n";
+
+
+
+// table reflection
+$table = $database->getTable('products');
+
+echo "<h2>Table '{$table->name}'</h2>\n";
+
+echo "Columns\n";
+echo "<ul>\n";
+foreach ($table->getColumns() as $column) {
+	echo "<li>{$column->name} <i>{$column->nativeType}</i> <code>{$column->default}</code></li>\n";
+}
+echo "</ul>\n";
+
+
+
+echo "Indexes";
+echo "<ul>\n";
+foreach ($table->getIndexes() as $index) {
+	echo "<li>{$index->name} " . ($index->primary ? 'primary ' : '') . ($index->unique ? 'unique' : '') . ' (';
+	foreach ($index->getColumns() as $column) {
+		echo "$column->name, ";
+	}
+	echo ")</li>\n";
+}
+echo "</ul>\n";

examples/dibi.table.php

@@ -1,101 +0,0 @@
-<h1>DibiTableX demo</h1>
-<pre>
-<?php
-
-require_once 'Nette/Debug.php';
-require_once '../dibi/dibi.php';
-
-
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'sample.sdb',
-));
-
-dibi::begin();
-
-
-// autodetection: primary keys are customer_id, order_id, ...
-DibiTableX::$primaryMask = '%s_id';
-
-
-// table products
-class Products extends DibiTableX
-{
-//   rely on autodetection...
-//   protected $name = 'products';
-//   protected $primary = 'product_id';
-
-}
-
-
-
-
-
-// create table object
-$products = new Products;
-
-echo "Table name: $products->name\n";
-echo "Primary key: $products->primary\n";
-
-
-// Finds rows by primary key
-foreach ($products->find(1, 3) as $row) {
-	Debug::dump($row);
-}
-
-
-// select all
-$products->findAll()->dump();
-
-
-// select all, order by title, product_id
-$products->findAll('title', $products->primary)->dump();
-$products->findAll(array('title' => 'Chair'), 'title')->dump();
-
-
-// fetches single row with id 3
-$row = $products->fetch(3);
-
-
-// deletes row from a table
-$count = $products->delete(1);
-
-// deletes multiple rows
-$count = $products->delete(array(1, 2, 3));
-Debug::dump($count); // number of deleted rows
-
-
-// update row #2 in a table
-$data = (object) NULL;
-$data->title = 'New title';
-$count = $products->update(2, $data);
-Debug::dump($count); // number of updated rows
-
-
-// update multiple rows in a table
-$count = $products->update(array(3, 5), $data);
-Debug::dump($count); // number of updated rows
-
-
-// inserts row into a table
-$data = array();
-$data['title'] = 'New product';
-$id = $products->insert($data);
-Debug::dump($id); // generated id
-
-
-// inserts or updates row into a table
-$data = array();
-$data['title'] = 'New product';
-$data[$products->primary] = 5;
-$products->insertOrUpdate($data);
-
-
-// is absolutely SQL injection safe
-$key = '3 OR 1=1';
-$products->delete($key);
-// --> DELETE FROM  [products] WHERE  [product_id] IN ( 3 )
-
-
-// select all using fluent interface
-Debug::dump($products->select('*')->orderBy('title')->fetchAll());

examples/dump.php

@@ -1,33 +0,0 @@
-<h1>dibi dump example</h1>
-<?php
-
-require_once 'Nette/Debug.php';
-require_once '../dibi/dibi.php';
-
-
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'sample.sdb',
-));
-
-
-
-$res = dibi::query('
-SELECT * FROM [products]
-INNER JOIN [orders] USING ([product_id])
-INNER JOIN [customers] USING ([customer_id])
-');
-
-
-echo '<h2>dibi::dump()</h2>';
-
-// dump last query (dibi::$sql)
-dibi::dump();
-// -> SELECT * FROM [products] INNER JOIN [orders] USING ([product_id]) INNER JOIN [customers] USING ([customer_id])
-
-
-// dump result table
-echo '<h2>DibiResult::dump()</h2>';
-
-$res->dump();
-// -> [table]

examples/dumping-sql-and-result-set.php

@@ -0,0 +1,34 @@
+<!DOCTYPE html><link rel="stylesheet" href="data/style.css">
+
+<h1>Dumping SQL and Result Set | dibi</h1>
+
+<?php
+
+require_once 'Nette/Debugger.php';
+require_once '../dibi/dibi.php';
+
+
+dibi::connect(array(
+	'driver'   => 'sqlite',
+	'database' => 'data/sample.sdb',
+));
+
+
+
+$res = dibi::query('
+	SELECT * FROM products
+	INNER JOIN orders USING (product_id)
+	INNER JOIN customers USING (customer_id)
+');
+
+
+echo '<h2>dibi::dump()</h2>';
+
+// dump last query (dibi::$sql)
+dibi::dump();
+
+
+// dump result table
+echo '<h2>DibiResult::dump()</h2>';
+
+$res->dump();

examples/fetch.php

@@ -1,94 +0,0 @@
-<h1>dibi fetch example</h1>
-<pre>
-<?php
-
-require_once 'Nette/Debug.php';
-require_once '../dibi/dibi.php';
-
-
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'sample.sdb',
-));
-
-
-/*
-TABLE products
-
-product_id | title
------------+----------
-	1      | Chair
-	2      | Table
-	3      | Computer
-
-*/
-
-
-// fetch a single row
-$row = dibi::fetch('SELECT title FROM [products]');
-Debug::dump($row); // Chair
-echo '<hr>';
-
-
-// fetch a single value
-$value = dibi::fetchSingle('SELECT [title] FROM [products]');
-Debug::dump($value); // Chair
-echo '<hr>';
-
-
-// fetch complete result set
-$all = dibi::fetchAll('SELECT * FROM [products]');
-Debug::dump($all);
-echo '<hr>';
-
-
-// fetch complete result set like association array
-$res = dibi::query('SELECT * FROM [products]');
-$assoc = $res->fetchAssoc('title'); // key
-Debug::dump($assoc);
-echo '<hr>';
-
-
-// fetch complete result set like pairs key => value
-$pairs = $res->fetchPairs('product_id', 'title');
-Debug::dump($pairs);
-echo '<hr>';
-
-
-// fetch row by row
-foreach ($res as $n => $row) {
-	Debug::dump($row);
-}
-echo '<hr>';
-
-
-// fetch row by row with defined offset
-foreach ($res->getIterator(2) as $n => $row) {
-	Debug::dump($row);
-}
-
-// fetch row by row with defined offset and limit
-foreach ($res->getIterator(2, 1) as $n => $row) {
-	Debug::dump($row);
-}
-
-
-// more complex association array
-$res = dibi::query('
-SELECT *
-FROM [products]
-INNER JOIN [orders] USING ([product_id])
-INNER JOIN [customers] USING ([customer_id])
-');
-
-$assoc = $res->fetchAssoc('customers.name,products.title'); // key
-Debug::dump($assoc);
-echo '<hr>';
-
-$assoc = $res->fetchAssoc('customers.name,#,products.title'); // key
-Debug::dump($assoc);
-echo '<hr>';
-
-$assoc = $res->fetchAssoc('customers.name,=,products.title'); // key
-Debug::dump($assoc);
-echo '<hr>';

examples/fetching-examples.php

@@ -0,0 +1,86 @@
+<!DOCTYPE html><link rel="stylesheet" href="data/style.css">
+
+<h1>Fetching Examples | dibi</h1>
+
+<?php
+
+require_once 'Nette/Debugger.php';
+require_once '../dibi/dibi.php';
+
+ndebug();
+
+dibi::connect(array(
+	'driver'   => 'sqlite',
+	'database' => 'data/sample.sdb',
+));
+
+
+/*
+TABLE products
+
+product_id | title
+-----------+----------
+	1      | Chair
+	2      | Table
+	3      | Computer
+
+*/
+
+
+// fetch a single row
+echo "<h2>fetch()</h2>\n";
+$row = dibi::fetch('SELECT title FROM products');
+dump($row); // Chair
+
+
+// fetch a single value
+echo "<h2>fetchSingle()</h2>\n";
+$value = dibi::fetchSingle('SELECT title FROM products');
+dump($value); // Chair
+
+
+// fetch complete result set
+echo "<h2>fetchAll()</h2>\n";
+$all = dibi::fetchAll('SELECT * FROM products');
+dump($all);
+
+
+// fetch complete result set like association array
+echo "<h2>fetchAssoc('title')</h2>\n";
+$res = dibi::query('SELECT * FROM products');
+$assoc = $res->fetchAssoc('title'); // key
+dump($assoc);
+
+
+// fetch complete result set like pairs key => value
+echo "<h2>fetchPairs('product_id', 'title')</h2>\n";
+$pairs = $res->fetchPairs('product_id', 'title');
+dump($pairs);
+
+
+// fetch row by row
+echo "<h2>using foreach</h2>\n";
+foreach ($res as $n => $row) {
+	dump($row);
+}
+
+
+// more complex association array
+$res = dibi::query('
+	SELECT *
+	FROM products
+	INNER JOIN orders USING (product_id)
+	INNER JOIN customers USING (customer_id)
+');
+
+echo "<h2>fetchAssoc('customers.name|products.title')</h2>\n";
+$assoc = $res->fetchAssoc('customers.name|products.title'); // key
+dump($assoc);
+
+echo "<h2>fetchAssoc('customers.name[]products.title')</h2>\n";
+$assoc = $res->fetchAssoc('customers.name[]products.title'); // key
+dump($assoc);
+
+echo "<h2>fetchAssoc('customers.name->products.title')</h2>\n";
+$assoc = $res->fetchAssoc('customers.name->products.title'); // key
+dump($assoc);

examples/importing-dump-from-file.php

@@ -0,0 +1,19 @@
+<!DOCTYPE html><link rel="stylesheet" href="data/style.css">
+
+<h1>Importing SQL Dump from File | dibi</h1>
+
+<?php
+
+require_once 'Nette/Debugger.php';
+require_once '../dibi/dibi.php';
+
+
+dibi::connect(array(
+	'driver'   => 'sqlite',
+	'database' => 'data/sample.sdb',
+));
+
+
+$count = dibi::loadFile('compress.zlib://data/sample.dump.sql.gz');
+
+echo 'Number of SQL commands:', $count;

examples/load-sql-dump.php

@@ -1,17 +0,0 @@
-<h1>dibi import SQL dump example</h1>
-<pre>
-<?php
-
-require_once 'Nette/Debug.php';
-require_once '../dibi/dibi.php';
-
-
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'sample.sdb',
-));
-
-
-$count = dibi::loadFile('compress.zlib://sample.dump.sql.gz');
-
-echo 'Number of SQL commands:', $count;

examples/logger.php

@@ -1,34 +0,0 @@
-<h1>dibi logger example</h1>
-<?php
-
-require_once 'Nette/Debug.php';
-require_once '../dibi/dibi.php';
-
-
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'sample.sdb',
-	'profiler' => TRUE,
-));
-
-
-// enable log to this file
-dibi::getProfiler()->setFile('log.sql');
-
-
-
-try {
-	$res = dibi::query('SELECT * FROM [customers] WHERE [customer_id] = %i', 1);
-
-	$res = dibi::query('SELECT * FROM [customers] WHERE [customer_id] < %i', 5);
-
-	$res = dibi::query('SELECT FROM [customers] WHERE [customer_id] < %i', 38);
-
-} catch (DibiException $e) {
-	echo '<p>', get_class($e), ': ', $e->getMessage(), '</p>';
-}
-
-
-echo "<h2>File log.sql:</h2>";
-
-echo '<pre>', file_get_contents('log.sql'), '</pre>';

examples/metatypes.php

@@ -1,28 +0,0 @@
-<h1>dibi metatypes example</h1>
-<pre>
-<?php
-
-require_once 'Nette/Debug.php';
-require_once '../dibi/dibi.php';
-
-
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'sample.sdb',
-));
-
-
-$res = dibi::query('SELECT * FROM [customers]');
-
-// auto-converts this column to integer
-$res->setType('customer_id', Dibi::FIELD_INTEGER);
-$res->setType('added', Dibi::FIELD_DATETIME, 'H:i j.n.Y');
-
-$row = $res->fetch();
-Debug::dump($row);
-// outputs:
-// object(DibiRow)#3 (3) {
-//     customer_id => int(1)
-//     name =>  string(11) "Dave Lister"
-//     added =>  string(15) "17:20 11.3.2007"
-// }

examples/nette-debug-and-exceptions.php

@@ -0,0 +1,45 @@
+<!DOCTYPE html><link rel="stylesheet" href="data/style.css">
+
+<h1>Nette Debugger & SQL Exceptions | dibi</h1>
+
+<p>Dibi can display and log exceptions via Nette Debugger, part of Nette Framework.</p>
+
+<ul>
+	<li>Nette Framework: http://nette.org
+</ul>
+
+<?php
+
+require_once 'Nette/Debugger.php';
+require_once '../dibi/dibi.php';
+
+
+// enable Nette Debugger
+ndebug();
+
+
+dibi::connect(array(
+	'driver'   => 'sqlite',
+	'database' => 'data/sample.sdb',
+	'profiler' => array(
+		'run' => TRUE,
+	)
+));
+
+
+// throws error because SQL is bad
+dibi::query('SELECT * FROM customers WHERE customer_id < ?', 38);
+
+
+
+dibi::connect(array(
+	'driver'   => 'sqlite',
+	'database' => 'data/sample.sdb',
+	'profiler' => array(
+		'run' => TRUE,
+	)
+));
+
+
+// throws error because SQL is bad
+dibi::query('SELECT FROM customers WHERE customer_id < ?', 38);

examples/nette-debug-and-variables.php

@@ -0,0 +1,30 @@
+<!DOCTYPE html><link rel="stylesheet" href="data/style.css">
+
+<h1>Nette Debugger & Variables | dibi</h1>
+
+<p>Dibi can dump variables via Nette Debugger, part of Nette Framework.</p>
+
+<ul>
+	<li>Nette Framework: http://nette.org
+</ul>
+
+<?php
+
+require_once 'Nette/Debugger.php';
+require_once '../dibi/dibi.php';
+
+
+// enable Nette Debugger
+NDebugger::enable();
+
+
+dibi::connect(array(
+	'driver'   => 'sqlite',
+	'database' => 'data/sample.sdb',
+	'profiler' => array(
+		'run' => TRUE,
+	)
+));
+
+
+NDebugger::barDump( dibi::fetchAll('SELECT * FROM customers WHERE customer_id < ?', 38), '[customers]' );

examples/nette-debug.php

@@ -1,28 +0,0 @@
-<h1>Nette::Debug & dibi example</h1>
-
-
-<p>Dibi can display and log exceptions via Nette::Debug, part of Nette Framework.</p>
-
-<ul>
-	<li>Nette Framework: http://nettephp.com
-</ul>
-
-<?php
-
-require_once 'Nette/Debug.php';
-require_once '../dibi/dibi.php';
-
-
-// enable Nette::Debug
-Debug::enable();
-
-
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'sample.sdb',
-));
-
-
-
-// throws error
-dibi::query('SELECT FROM [customers] WHERE [customer_id] < %i', 38);

examples/query-language-and-conditions.php

@@ -0,0 +1,58 @@
+<!DOCTYPE html><link rel="stylesheet" href="data/style.css">
+
+<h1>Query Language & Conditions | dibi</h1>
+
+<?php
+
+require_once 'Nette/Debugger.php';
+require_once '../dibi/dibi.php';
+
+
+dibi::connect(array(
+	'driver'   => 'sqlite',
+	'database' => 'data/sample.sdb',
+));
+
+
+// some variables
+$cond1 = TRUE;
+$cond2 = FALSE;
+$foo = -1;
+$bar = 2;
+
+// conditional variable
+$name = $cond1 ? 'K%' : NULL;
+
+// if & end
+dibi::test('
+	SELECT *
+	FROM customers
+	%if', isset($name), 'WHERE name LIKE ?', $name, '%end'
+);
+// -> SELECT * FROM customers WHERE name LIKE 'K%'
+
+
+
+
+// if & else & (optional) end
+dibi::test("
+	SELECT *
+	FROM people
+	WHERE id > 0
+		%if", ($foo > 0), "AND foo=?", $foo, "
+		%else %if", ($bar > 0), "AND bar=?", $bar, "
+");
+// -> SELECT * FROM people WHERE id > 0 AND bar=2
+
+
+
+// nested condition
+dibi::test('
+	SELECT *
+	FROM customers
+	WHERE
+		%if', isset($name), 'name LIKE ?', $name, '
+			%if', $cond2, 'AND admin=1 %end
+		%else 1 LIMIT 10 %end'
+);
+// -> SELECT * FROM customers WHERE LIMIT 10

examples/query-language-basic-examples.php

@@ -0,0 +1,94 @@
+<!DOCTYPE html><link rel="stylesheet" href="data/style.css">
+
+<h1>Query Language Basic Examples | dibi</h1>
+
+<?php
+
+require_once 'Nette/Debugger.php';
+require_once '../dibi/dibi.php';
+
+date_default_timezone_set('Europe/Prague');
+
+
+dibi::connect(array(
+	'driver'   => 'sqlite',
+	'database' => 'data/sample.sdb',
+));
+
+
+// SELECT
+$ipMask = '192.168.%';
+$timestamp = mktime(0, 0, 0, 10, 13, 1997);
+
+dibi::test('
+	SELECT COUNT(*) as [count]
+	FROM [comments]
+	WHERE [ip] LIKE ?', $ipMask, '
+	AND [date] > ', new DibiDateTime($timestamp)
+);
+// -> SELECT COUNT(*) as [count] FROM [comments] WHERE [ip] LIKE '192.168.%' AND [date] > 876693600
+
+
+
+// dibi detects INSERT or REPLACE command
+dibi::test('
+	REPLACE INTO products', array(
+		'title' => 'Super product',
+		'price' => 318,
+		'active' => TRUE,
+));
+// -> REPLACE INTO products ([title], [price], [active]) VALUES ('Super product', 318, 1)
+
+
+
+// multiple INSERT command
+$array = array(
+	'title' => 'Super Product',
+	'price' => 12,
+	'brand' => NULL,
+	'created' => new DateTime,
+);
+dibi::test("INSERT INTO products", $array, $array, $array);
+// -> INSERT INTO products ([title], [price], [brand], [created]) VALUES ('Super Product', ...) , (...) , (...)
+
+
+
+// dibi detects UPDATE command
+dibi::test("
+	UPDATE colors SET", array(
+		'color' => 'blue',
+		'order' => 12,
+	), "
+	WHERE id=?", 123);
+// -> UPDATE colors SET [color]='blue', [order]=12 WHERE id=123
+
+
+
+// modifier applied to array
+$array = array(1, 2, 3);
+dibi::test("
+	SELECT *
+	FROM people
+	WHERE id IN (?)", $array
+);
+// -> SELECT * FROM people WHERE id IN ( 1, 2, 3 )
+
+
+
+// modifier %by for ORDER BY
+$order = array(
+	'field1' => 'asc',
+	'field2' => 'desc',
+);
+dibi::test("
+	SELECT *
+	FROM people
+	ORDER BY %by", $order, "
+");
+// -> SELECT * FROM people ORDER BY [field1] ASC, [field2] DESC
+
+
+
+// indentifiers and strings syntax mix
+dibi::test('UPDATE [table] SET `item` = "5 1/4"" diskette"');
+// -> UPDATE [table] SET [item] = '5 1/4" diskette'

examples/result-set-data-types.php

@@ -0,0 +1,47 @@
+<!DOCTYPE html><link rel="stylesheet" href="data/style.css">
+
+<h1>Result Set Data Types  | dibi</h1>
+
+<?php
+
+require_once 'Nette/Debugger.php';
+require_once '../dibi/dibi.php';
+
+ndebug();
+date_default_timezone_set('Europe/Prague');
+
+
+dibi::connect(array(
+	'driver'   => 'sqlite',
+	'database' => 'data/sample.sdb',
+));
+
+
+// using manual hints
+$res = dibi::query('SELECT * FROM [customers]');
+
+$res->setType('customer_id', Dibi::INTEGER)
+	->setType('added', Dibi::DATETIME)
+	->setFormat(dibi::DATETIME, 'Y-m-d H:i:s');
+
+
+dump( $res->fetch() );
+// outputs:
+// object(DibiRow)#3 (3) {
+//     customer_id => int(1)
+//     name =>  string(11) "Dave Lister"
+//     added =>  object(DateTime53) {}
+// }
+
+
+
+// using auto-detection (works well with MySQL or other strictly typed databases)
+$res = dibi::query('SELECT * FROM [customers]');
+
+dump( $res->fetch() );
+// outputs:
+// object(DibiRow)#3 (3) {
+//     customer_id => int(1)
+//     name =>  string(11) "Dave Lister"
+//     added =>  string(15) "17:20 11.3.2007"
+// }

examples/sql-builder.php

@@ -1,90 +0,0 @@
-<style>
-pre.dibi { padding-bottom: 10px; }
-</style>
-<h1>dibi SQL builder example</h1>
-<pre>
-<?php
-
-require_once 'Nette/Debug.php';
-require_once '../dibi/dibi.php';
-
-// required since PHP 5.1.0
-date_default_timezone_set('Europe/Prague');
-
-
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'sample.sdb',
-));
-
-
-// dibi detects INSERT or REPLACE command
-dibi::test('
-	REPLACE INTO [products]', array(
-		'title'  => 'Super product',
-		'price'  => 318,
-		'active' => TRUE,
-));
-// -> REPLACE INTO [products] ([title], [price], [active]) VALUES ('Super product', 318, 1)
-
-
-
-// multiple INSERT command
-$array = array(
-	'title'   => 'Super Product',
-	'price'   => 12,
-	'brand'   => NULL,
-	'created' => dibi::datetime(),
-);
-dibi::test("INSERT INTO [products]", $array, $array, $array);
-// -> INSERT INTO [products] ([title], [price], [brand], [created]) VALUES ('Super Product', ...) , (...) , (...)
-
-
-
-// dibi detects UPDATE command
-dibi::test("
-	UPDATE [colors] SET", array(
-		'color' => 'blue',
-		'order' => 12,
-	), "
-	WHERE [id]=%i", 123);
-// -> UPDATE [colors] SET [color]='blue', [order]=12 WHERE [id]=123
-
-
-
-// SELECT
-$ipMask = '192.168.%';
-$timestamp = mktime(0, 0, 0, 10, 13, 1997);
-
-dibi::test('
-	SELECT COUNT(*) as [count]
-	FROM [comments]
-	WHERE [ip] LIKE %s', $ipMask, '
-	AND [date] > ', dibi::date($timestamp)
-);
-// -> SELECT COUNT(*) as [count] FROM [comments] WHERE [ip] LIKE '192.168.%' AND [date] > 876693600
-
-
-
-// IN array
-$array = array(1, 2, 3);
-dibi::test("
-	SELECT *
-	FROM [people]
-	WHERE [id] IN (", $array, ")
-");
-// -> SELECT * FROM [people] WHERE [id] IN ( 1, 2, 3 )
-
-
-
-// ORDER BY array
-$order = array(
-	'field1' => 'asc',
-	'field2' => 'desc',
-);
-dibi::test("
-SELECT *
-FROM [people]
-ORDER BY %by", $order, "
-");
-// -> SELECT * FROM [people] ORDER BY [field1] ASC, [field2] DESC

examples/sql-condition.php

@@ -1,58 +0,0 @@
-<style>
-pre.dibi { padding-bottom: 10px; }
-</style>
-<h1>dibi conditional SQL example</h1>
-<pre>
-<?php
-
-require_once 'Nette/Debug.php';
-require_once '../dibi/dibi.php';
-
-
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'sample.sdb',
-));
-
-
-$cond1 = TRUE;
-$cond2 = FALSE;
-$foo = -1;
-$bar = 2;
-
-
-$name = $cond1 ? 'K%' : NULL;
-
-// if & end
-dibi::test('
-SELECT *
-FROM [customers]
-%if', isset($name), 'WHERE [name] LIKE %s', $name, '%end'
-);
-// -> SELECT * FROM [customers] WHERE [name] LIKE 'K%'
-
-
-
-
-// if & else & (optional) end
-dibi::test("
-SELECT *
-FROM [people]
-WHERE [id] > 0
-	%if", ($foo > 0), "AND [foo]=%i", $foo, "
-	%else %if", ($bar > 0), "AND [bar]=%i", $bar, "
-");
-// -> SELECT * FROM [people] WHERE [id] > 0 AND [bar]=2
-
-
-
-// nested condition
-dibi::test('
-SELECT *
-FROM [customers]
-WHERE
-	%if', isset($name), '[name] LIKE %s', $name, '
-		%if', $cond2, 'AND [admin]=1 %end
-	%else 1 LIMIT 10 %end'
-);
-// -> SELECT * FROM [customers] WHERE LIMIT 10

examples/table-prefix.php

@@ -1,45 +0,0 @@
-<h1>dibi prefix & substitute example</h1>
-<?php
-
-require_once 'Nette/Debug.php';
-require_once '../dibi/dibi.php';
-
-
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'sample.sdb',
-));
-
-
-
-
-// create new substitution :blog:  ==>  wp_
-dibi::addSubst('blog', 'wp_');
-
-dibi::test("UPDATE [:blog:items] SET [text]='Hello World'");
-// -> UPDATE [wp_items] SET [text]='Hello World'
-
-
-
-
-
-// create new substitution :: (empty)  ==>  my_
-dibi::addSubst('', 'my_');
-
-dibi::test("UPDATE [database.::table] SET [text]='Hello World'");
-// -> UPDATE [database].[my_table] SET [text]='Hello World'
-
-
-
-
-
-// create substitution fallback
-function substFallBack($expr)
-{
-	return 'the_' . $expr;
-}
-
-dibi::setSubstFallBack('substFallBack');
-
-dibi::test("UPDATE [:account:user] SET [name]='John Doe'");
-// -> UPDATE [the_accountuser] SET [name]='John Doe'

examples/using-datetime.php

@@ -1,11 +1,12 @@
-<h1>IDibiVariable example</h1>
+<!DOCTYPE html><link rel="stylesheet" href="data/style.css">
+
+<h1>Using DateTime | dibi</h1>
+
 <?php
 
-require_once 'Nette/Debug.php';
+require_once 'Nette/Debugger.php';
 require_once '../dibi/dibi.php';
 
-
-// required since PHP 5.1.0
 date_default_timezone_set('Europe/Prague');
 
 
@@ -13,7 +14,7 @@ date_default_timezone_set('Europe/Prague');
 // CHANGE TO REAL PARAMETERS!
 dibi::connect(array(
 	'driver'   => 'sqlite',
-	'database' => 'sample.sdb',
+	'database' => 'data/sample.sdb',
 	'formatDate' => "'Y-m-d'",
 	'formatDateTime' => "'Y-m-d H-i-s'",
 ));
@@ -22,9 +23,10 @@ dibi::connect(array(
 
 // generate and dump SQL
 dibi::test("
-INSERT INTO [mytable]", array(
-	'id'    => 123,
-	'date'  => dibi::date('12.3.2007'),
-	'stamp' => dibi::dateTime('23.1.2007 10:23'),
-));
+	INSERT INTO [mytable]", array(
+		'id'    => 123,
+		'date'  => new DateTime('12.3.2007'),
+		'stamp' => new DateTime('23.1.2007 10:23'),
+	)
+);
 // -> INSERT INTO [mytable] ([id], [date], [stamp]) VALUES (123, '2007-03-12', '2007-01-23 10-23-00')

examples/using-extension-methods.php

@@ -1,14 +1,17 @@
-<h1>dibi extension method example</h1>
-<pre>
+<!DOCTYPE html><link rel="stylesheet" href="data/style.css">
+
+<h1>Using Extension Methods | dibi</h1>
+
 <?php
 
-require_once 'Nette/Debug.php';
+require_once 'Nette/Debugger.php';
 require_once '../dibi/dibi.php';
 
+ndebug();
 
 dibi::connect(array(
 	'driver'   => 'sqlite',
-	'database' => 'sample.sdb',
+	'database' => 'data/sample.sdb',
 ));
 
 
@@ -25,4 +28,4 @@ function DibiResult_prototype_fetchShuffle(DibiResult $obj)
 // fetch complete result set shuffled
 $res = dibi::query('SELECT * FROM [customers]');
 $all = $res->fetchShuffle();
-Debug::dump($all);
+dump($all);

examples/using-fluent-syntax.php

@@ -1,13 +1,18 @@
-<h1>dibi dump example</h1>
+<!DOCTYPE html><link rel="stylesheet" href="data/style.css">
+
+<h1>Using Fluent Syntax | dibi</h1>
+
 <?php
 
-require_once 'Nette/Debug.php';
+require_once 'Nette/Debugger.php';
 require_once '../dibi/dibi.php';
 
+date_default_timezone_set('Europe/Prague');
+
 
 dibi::connect(array(
 	'driver'   => 'sqlite',
-	'database' => 'sample.sdb',
+	'database' => 'data/sample.sdb',
 ));
 
 
@@ -31,8 +36,6 @@ dibi::select('product_id')->as('id')
 
 
 
-echo "\n";
-
 // SELECT ...
 echo dibi::select('title')->as('id')
 	->from('products')
@@ -41,8 +44,6 @@ echo dibi::select('title')->as('id')
 
 
 
-echo "\n";
-
 // INSERT ...
 dibi::insert('products', $record)
 	->setFlag('IGNORE')
@@ -51,40 +52,32 @@ dibi::insert('products', $record)
 
 
 
-echo "\n";
-
 // UPDATE ...
 dibi::update('products', $record)
-	->where('product_id = %d', $id)
+	->where('product_id = ?', $id)
 	->test();
 // -> UPDATE [products] SET [title]='Super product', [price]=318, [active]=1 WHERE product_id = 10
 
 
 
-echo "\n";
-
 // DELETE ...
 dibi::delete('products')
-	->where('product_id = %d', $id)
+	->where('product_id = ?', $id)
 	->test();
 // -> DELETE FROM [products] WHERE product_id = 10
 
 
 
-echo "\n";
-
 // custom commands
 dibi::command()
 	->update('products')
-	->where('product_id = %d', $id)
+	->where('product_id = ?', $id)
 	->set($record)
 	->test();
 // -> UPDATE [products] SET [title]='Super product', [price]=318, [active]=1 WHERE product_id = 10
 
 
 
-echo "\n";
-
 dibi::command()
 	->truncate('products')
 	->test();

examples/using-limit-and-offset.php

@@ -1,14 +1,16 @@
-<h1>dibi apply limit/offset example</h1>
-<pre>
+<!DOCTYPE html><link rel="stylesheet" href="data/style.css">
+
+<h1>Using Limit & Offset | dibi</h1>
+
 <?php
 
-require_once 'Nette/Debug.php';
+require_once 'Nette/Debugger.php';
 require_once '../dibi/dibi.php';
 
 
 dibi::connect(array(
 	'driver'   => 'sqlite',
-	'database' => 'sample.sdb',
+	'database' => 'data/sample.sdb',
 ));
 
 
@@ -17,14 +19,12 @@ dibi::test('SELECT * FROM [products]');
 // -> SELECT * FROM [products]
 
 
-echo '<hr>';
 
 // with limit = 2
 dibi::test('SELECT * FROM [products] %lmt', 2);
 // -> SELECT * FROM [products] LIMIT 2
 
 
-echo '<hr>';
 
 // with limit = 2, offset = 1
 dibi::test('SELECT * FROM [products] %lmt %ofs', 2, 1);

examples/using-logger.php

@@ -0,0 +1,40 @@
+<!DOCTYPE html><link rel="stylesheet" href="data/style.css">
+
+<h1>Using Logger | dibi</h1>
+
+<?php
+
+require_once 'Nette/Debugger.php';
+require_once '../dibi/dibi.php';
+
+date_default_timezone_set('Europe/Prague');
+
+
+dibi::connect(array(
+	'driver'   => 'sqlite',
+	'database' => 'data/sample.sdb',
+	// enable query logging to this file
+	'profiler' => array(
+		'run' => TRUE,
+		'file' => 'data/log.sql',
+	),
+));
+
+
+
+try {
+	$res = dibi::query('SELECT * FROM [customers] WHERE [customer_id] = ?', 1);
+
+	$res = dibi::query('SELECT * FROM [customers] WHERE [customer_id] < ?', 5);
+
+	$res = dibi::query('SELECT FROM [customers] WHERE [customer_id] < ?', 38);
+
+} catch (DibiException $e) {
+	echo '<p>', get_class($e), ': ', $e->getMessage(), '</p>';
+}
+
+
+// outputs a log file
+echo "<h2>File data/log.sql:</h2>";
+
+echo '<pre>', file_get_contents('data/log.sql'), '</pre>';

examples/using-profiler.php

@@ -1,23 +1,31 @@
+<?php ob_start(1) // needed by FirePHP ?>
+
+<!DOCTYPE html><link rel="stylesheet" href="data/style.css">
+
+<h1>Using Profiler | dibi</h1>
+
 <?php
 
-require_once 'Nette/Debug.php';
+require_once 'Nette/Debugger.php';
 require_once '../dibi/dibi.php';
 
 
 dibi::connect(array(
 	'driver'   => 'sqlite',
-	'database' => 'sample.sdb',
-	'profiler' => TRUE,
+	'database' => 'data/sample.sdb',
+	'profiler' => array(
+		'run' => TRUE,
+	)
 ));
 
 
+// execute some queries...
 for ($i=0; $i<20; $i++) {
-	$res = dibi::query('SELECT * FROM [customers] WHERE [customer_id] < %i', $i);
+	$res = dibi::query('SELECT * FROM [customers] WHERE [customer_id] < ?', $i);
 }
 
+// display output
 ?>
-<h1>Dibi profiler example</h1>
-
 <p>Last query: <strong><?php echo dibi::$sql; ?></strong></p>
 
 <p>Number of queries: <strong><?php echo dibi::$numOfQueries; ?></strong></p>
@@ -33,4 +41,4 @@ for ($i=0; $i<20; $i++) {
 <ul>
 	<li>Firebug: https://addons.mozilla.org/en-US/firefox/addon/1843
 	<li>FirePHP: http://www.firephp.org/
-</ul>
+</ul>

examples/using-substitutions.php

@@ -0,0 +1,62 @@
+<!DOCTYPE html><link rel="stylesheet" href="data/style.css">
+
+<h1>Using Substitutions | dibi</h1>
+
+<?php
+
+require_once 'Nette/Debugger.php';
+require_once '../dibi/dibi.php';
+
+
+dibi::connect(array(
+	'driver'   => 'sqlite',
+	'database' => 'data/sample.sdb',
+));
+
+
+
+
+// create new substitution :blog:  ==>  wp_
+dibi::getSubstitutes()->blog = 'wp_';
+
+dibi::test("SELECT * FROM [:blog:items]");
+// -> SELECT * FROM [wp_items]
+
+
+
+
+
+// create new substitution :: (empty)  ==>  my_
+dibi::getSubstitutes()->{''} = 'my_';
+
+dibi::test("UPDATE ::table SET [text]='Hello World'");
+// -> UPDATE my_table SET [text]='Hello World'
+
+
+
+
+
+// create substitutions using fallback callback
+function substFallBack($expr)
+{
+	$const = 'SUBST_' . strtoupper($expr);
+	if (defined($const)) {
+		return constant($const);
+	} else {
+		throw new Exception("Undefined substitution :$expr:");
+	}
+}
+
+// define callback
+dibi::getSubstitutes()->setCallback('substFallBack');
+
+// define substitutes as constants
+define('SUBST_ACCOUNT', 'eshop_');
+define('SUBST_ACTIVE', 7);
+
+dibi::test("
+	UPDATE :account:user
+	SET name='John Doe', status=:active:
+	WHERE id=", 7
+);
+// -> UPDATE eshop_user SET name='John Doe', status=7 WHERE id= 7

examples/using-transactions.php

@@ -1,18 +1,20 @@
-<h1>dibi transaction example</h1>
-<pre>
+<!DOCTYPE html><link rel="stylesheet" href="data/style.css">
+
+<h1>Using Transactions | dibi</h1>
+
 <?php
 
-require_once 'Nette/Debug.php';
+require_once 'Nette/Debugger.php';
 require_once '../dibi/dibi.php';
 
 
 dibi::connect(array(
 	'driver'   => 'sqlite',
-	'database' => 'sample.sdb',
+	'database' => 'data/sample.sdb',
 ));
 
 
-echo "<h2>Before:</h2>\n";
+echo "<h2>Before</h2>\n";
 dibi::query('SELECT * FROM [products]')->dump();
 // -> 3 rows
 
@@ -21,10 +23,13 @@ dibi::begin();
 dibi::query('INSERT INTO [products]', array(
 	'title' => 'Test product',
 ));
+
+echo "<h2>After INSERT</h2>\n";
+dibi::query('SELECT * FROM [products]')->dump();
+
+
 dibi::rollback(); // or dibi::commit();
 
-
-
-echo "<h2>After:</h2>\n";
+echo "<h2>After rollback</h2>\n";
 dibi::query('SELECT * FROM [products]')->dump();
-// -> 3 rows
+// -> 3 rows again

icons/example.html

@@ -1,16 +0,0 @@
-<style>
-h1 {
-	font-family: Trebuchet MS,"Geneva CE", lucida, sans-serif;
-	color: #1e5eb6;
-}
-img {
-	border: none;
-}
-</style>
-
-
-<h1>Icon for your website</h1>
-
-
-<a href="http://dibiphp.com" title="dibi - tiny 'n' smart database abstraction layer"
-><img src="dibi-powered.gif" width="80" height="15" alt="dibi powered" /></a>

license.cs.txt

@@ -1,69 +0,0 @@
-----------------------------------------------------------------------------------
-Tento text je NEOFICI<43>LN<4C>M p<>ekladem "Dibi license". Nevyjad<61>uje pr<70>vn<76> podstatu
-podm<EFBFBD>nek pro <20><><EFBFBD>en<65> tohoto softwaru - k tomuto <20><>elu slou<6F><75> v<>hradn<64> p<>vodn<64>
-anglick<EFBFBD> verze licence.
-----------------------------------------------------------------------------------
-
-
-Dibi Licence, verze 1
-======================
-
-Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
-V<EFBFBD>echna pr<70>va vyhrazena.
-
-Tato licence je pr<70>vn<76> ujedn<64>n<EFBFBD> mezi v<>mi a Davidem Grudlem (d<>le Author)
-pro pot<6F>eby pou<6F>it<69> "dibi" (d<>le "Software"). Z<>sk<73>n<EFBFBD>m, pou<6F>it<69>m
-a/nebo zkop<6F>rov<6F>n<EFBFBD>m Software projevujete souhlas s t<>m, <20>e jste p<>e<EFBFBD>etli,
-porozum<EFBFBD>li a budete jednat v souladu s podm<64>nkami t<>to licence.
-
-
-POVOLEN<EFBFBD> POU<4F>IT<49>
-----------------
-
-Je povoleno pou<6F><75>vat, kop<6F>rovat, modifikovat a distribuovat Software
-a jeho dokumentaci, v p<>vodn<64>m i upravovan<61>m tvaru, pro jak<61>koliv <20><>el,
-za p<>edpokladu, <20>e jsou spln<6C>ny tyto podm<64>nky:
-
-1. Kopie t<>to licen<65>n<EFBFBD> smlouvy mus<75> b<>t sou<6F><75>st<73> distribuce.
-
-2. <20><><EFBFBD>en<65> zdrojov<6F> k<>d mus<75> zachovat v<><76>e uvedenou informaci o autorsk<73>ch
-   pr<70>vech ve v<>ech souborech zdrojov<6F>ho k<>du.
-
-3. <20><><EFBFBD>en<65> bin<69>rn<72> tvar mus<75> reprodukovat v<><76>e uvedenou informaci o autorsk<73>ch
-   pr<70>vech v dokumentaci a/nebo jin<69>ch materi<72>lech poskytovan<61>ch s distribuc<75>.
-
-4. Produkty odvozen<65> od Software mus<75> obsahovat potvrzen<65>, <20>e jsou odvozen<65>
-   od "dibi", ve sv<73> dokumentaci a/nebo jin<69>ch materi<72>lech
-   poskytovan<61>ch s distribuc<75>.
-
-5. N<>zev "dibi" nesm<73> b<>t pou<6F>it p<>i podpo<70>e nebo propagaci produkt<6B>
-   odvozen<65>mi ze Software bez p<>edchoz<6F>ho p<>semn<6D>ho souhlasu Autora.
-
-6. Produkty odvozen<65> od Software nesm<73> b<>t nazv<7A>ny "dibi",
-   ani se nesm<73> "dibi" objevit v jejich n<>zvu bez p<>edchoz<6F>ho
-   p<>semn<6D>ho souhlasu Autora.
-
-
-ZBAVEN<EFBFBD> ZODPOV<4F>DNOSTI
----------------------
-
-Souhlas<EFBFBD>te se zbaven<65>m zodpov<6F>dnosti a kryt<79>m Autora a p<>isp<73>vatel<65> v<><76>i
-jak<EFBFBD>mkoliv p<><70>m<EFBFBD>m, nep<65><70>m<EFBFBD>m, n<>hodn<64>m nebo n<>sledn<64>m odjinud poch<63>zej<65>c<EFBFBD>m <20>kod<6F>m,
-<EFBFBD>alob<EFBFBD>m nebo spor<6F>m, jako<6B> i p<>ed v<>emi souvisej<65>c<EFBFBD>mi n<>klady, z<>vazky,
-od<EFBFBD>kodn<EFBFBD>n<EFBFBD>mi, <20>hradami nebo poplatky vypl<70>vaj<61>c<EFBFBD>ch z pou<6F><75>v<EFBFBD>n<EFBFBD> nebo
-nespr<EFBFBD>vn<EFBFBD>ho u<>it<69> Software, nebo z poru<72>en<65> podm<64>nek t<>to licence.
-
-
-Z<EFBFBD>RUKA SE NEPOSKYTUJE
----------------------
-
-TENTO SOFTWARE JE POSKYTOV<4F>N DR<44>ITELEM LICENCE A JEHO P<>ISP<53>VATELI "JAK STOJ<4F> A LE<4C><45>"
-A JAK<41>KOLIV V<>SLOVN<56> NEBO P<>EDPOKL<4B>DAN<41> Z<>RUKY V<>ETN<54>, ALE NEJEN, P<>EDPOKL<4B>DAN<41>CH
-OBCHODN<EFBFBD>CH Z<>RUK A Z<>RUKY VHODNOSTI PRO JAK<41>KOLIV <20><>EL JSOU POP<4F>ENY.
-DR<EFBFBD>ITEL, ANI P<>ISP<53>VATEL<45> NEBUDOU V <20><>DN<44>M P<><50>PAD<41> ODPOV<4F>DNI ZA JAK<41>KOLIV P<><50>M<EFBFBD>,
-NEP<EFBFBD><EFBFBD>M<EFBFBD>, N<>HODN<44>, ZVL<56><4C>TN<54>, P<><50>KLADN<44> NEBO VYPL<50>VAJ<41>C<EFBFBD> <20>KODY (V<>ETN<54>, ALE NEJEN,
-<EFBFBD>KOD VZNIKL<4B>CH NARU<52>EN<45>M DOD<4F>VEK ZBO<42><4F> NEBO SLU<4C>EB; ZTR<54>TOU POU<4F>ITELNOSTI,
-DAT NEBO ZISK<53>; NEBO P<>ERU<52>EN<45>M OBCHODN<44> <20>INNOSTI) JAKKOLIV ZP<5A>SOBEN<45> NA Z<>KLAD<41>
-JAK<EFBFBD>KOLIV TEORIE O ZODPOV<4F>DNOSTI, A<> U<> PLYNOUC<55> Z JIN<49>HO SMLUVN<56>HO VZTAHU,
-UR<EFBFBD>IT<EFBFBD> ZODPOV<4F>DNOSTI NEBO P<>E<EFBFBD>INU (V<>ETN<54> NEDBALOSTI) NA JAK<41>MKOLIV ZP<5A>SOBU POU<4F>IT<49>
-TOHOTO SOFTWARE, I V P<><50>PAD<41>, <20>E DR<44>ITEL PR<50>V BYL UPOZORN<52>N NA MO<4D>NOST TAKOV<4F>CH <20>KOD.

license.txt

@@ -1,62 +1,61 @@
-The Dibi License, Version 1
-============================
+Licenses
+========
 
-Copyright (c) 2005, 2008 David Grudl (http://davidgrudl.com)
+Good news! You may use Dibi under the terms of either the New BSD License
+or the GNU General Public License (GPL) version 2 or 3.
+
+The BSD License is recommended for most projects. It is easy to understand and it
+places almost no restrictions on what you can do with the library. If the GPL
+fits better to your project, you can use the Dibi under this license.
+
+You don't have to notify anyone which license you are using. You can freely
+use Dibi in commercial projects as long as the copyright header
+remains intact.
+
+Please do not use word "Dibi" in the name of your project or top-level domain,
+and choose a name that stands on its own merits. If your stuff is good,
+it will not take long to establish a reputation for yourselves.
+
+
+
+New BSD License
+---------------
+
+Copyright (c) 2005, 2012 David Grudl (http://davidgrudl.com)
 All rights reserved.
 
-This license is a legal agreement between you and David Grudl (the "Author")
-for the use of "dibi" (the "Software"). By obtaining, using and/or
-copying the Software, you agree that you have read, understood, and will
-comply with the terms and conditions of this license.
+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.
 
-PERMITTED USE
--------------
+	* 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.
 
-You are permitted to use, copy, modify, and distribute the Software and its
-documentation, with or without modification, for any purpose, provided that
-the following conditions are met:
+	* Neither the name of "Dibi" nor the names of its contributors
+	may be used to endorse or promote products derived from this software
+	without specific prior written permission.
 
-1. A copy of this license agreement must be included with the distribution.
-
-2. Redistributions of source code must retain the above copyright notice in
-   all source code files.
-
-3. Redistributions in binary form must reproduce the above copyright notice
-   in the documentation and/or other materials provided with the distribution.
-
-4. Products derived from the Software must include an acknowledgment that
-   they are derived from "dibi" in their documentation and/or other
-   materials provided with the distribution.
-
-5. The name "dibi" must not be used to endorse or promote products
-   derived from the Software without prior written permission from Author.
-
-6. Products derived from the Software may not be called "dibi",
-   nor may "dibi" appear in their name, without prior written
-   permission from Author.
-
-
-INDEMNITY
----------
-
-You agree to indemnify and hold harmless the Author and any contributors
-for any direct, indirect, incidental, or consequential third-party claims,
-actions or suits, as well as any related expenses, liabilities, damages,
-settlements or fees arising from your use or misuse of the Software,
-or a violation of any terms of this license.
-
-
-DISCLAIMER OF WARRANTY
-----------------------
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER "AS IS" AND
+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 COPYRIGHT HOLDER BE LIABLE FOR
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER 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.
+
+
+
+GNU General Public License
+--------------------------
+
+GPL licenses are very very long, so instead of including them here we offer
+you URLs with full text:
+
+- GPL version 2: http://www.gnu.org/licenses/gpl-2.0.html
+- GPL version 3: http://www.gnu.org/licenses/gpl-3.0.html

readme.txt

@@ -1,7 +1,3 @@
-Dibi (c) David Grudl, 2005-2008 (http://davidgrudl.com)
-
-
-
 Introduction
 ------------
 
@@ -10,10 +6,6 @@ Thank you for downloading Dibi!
 Database access functions in PHP are not standardised. This is class library
 to hide the differences between the different databases access.
 
-The files in this archive are released under the Dibi license.
-See license.txt in this directory for a copy of the license.
-
-
 
 Documentation and Examples
 --------------------------
@@ -24,9 +16,8 @@ available on the homepage:
 http://dibiphp.com
 
 
-
-Dibi.compact
-------------
+Dibi.minified
+-------------
 
 This is shrinked single-file version of whole Dibi, useful when you don't
 want to modify library, but just use it.
@@ -35,7 +26,6 @@ This is exactly the same as normal version, just only comments and
 whitespaces are removed.
 
 
-
 -----
 For more information, visit the author's weblog (in czech language):
 http://phpfashion.com

tests/DibiFluent.cloning.phpt

@@ -0,0 +1,72 @@
+<?php
+
+/**
+ * Test: Cloning of DibiFluent
+ *
+ * @author     David Grudl
+ * @category   Dibi
+ * @subpackage UnitTests
+ */
+
+
+
+require dirname(__FILE__) . '/initialize.php';
+
+
+
+dibi::connect($config['sqlite']);
+
+
+$fluent = new DibiFluent(dibi::getConnection());
+$fluent->select('*')->from('table')->where('x=1');
+$dolly = clone $fluent;
+$dolly->where('y=1');
+$dolly->clause('FOO');
+
+$fluent->test();
+$dolly->test();
+
+
+
+$fluent = dibi::select('id')->from('table')->where('id = %i',1);
+$dolly = clone $fluent;
+$dolly->where('cd = %i',5);
+
+$fluent->test();
+$dolly->test();
+
+
+
+$fluent = dibi::select("*")->from("table");
+$dolly = clone $fluent;
+$dolly->removeClause("select")->select("count(*)");
+
+$fluent->test();
+$dolly->test();
+
+
+
+__halt_compiler() ?>
+
+------EXPECT------
+SELECT *
+FROM [table]
+WHERE x=1
+
+SELECT *
+FROM [table]
+WHERE x=1 AND y=1 FOO
+
+SELECT [id]
+FROM [table]
+WHERE id = 1
+
+SELECT [id]
+FROM [table]
+WHERE id = 1 AND cd = 5
+
+SELECT *
+FROM [table]
+
+SELECT count(*)
+FROM [table]

tests/NetteTest/Assert.php

@@ -0,0 +1,138 @@
+<?php
+
+/**
+ * Nette Framework
+ *
+ * @copyright  Copyright (c) 2004 David Grudl
+ * @license    http://nette.org/license  Nette license
+ * @link       http://nette.org
+ * @category   Nette
+ * @package    Nette\Test
+ */
+
+
+
+/**
+ * Asseratation test helpers.
+ *
+ * @author     David Grudl
+ * @package    Nette\Test
+ */
+class Assert
+{
+
+	/**
+	 * Checks assertation.
+	 * @param  mixed  expected
+	 * @param  mixed  actual
+	 * @return void
+	 */
+	public static function same($expected, $actual)
+	{
+		if ($actual !== $expected) {
+			self::note('Failed asserting that ' . self::dump($actual) . ' is not identical to ' . self::dump($expected));
+		}
+	}
+
+
+
+	/**
+	 * Checks TRUE assertation.
+	 * @param  mixed  actual
+	 * @return void
+	 */
+	public static function true($actual)
+	{
+		if ($actual !== TRUE) {
+			self::note('Failed asserting that ' . self::dump($actual) . ' is not TRUE');
+		}
+	}
+
+
+
+	/**
+	 * Checks FALSE assertation.
+	 * @param  mixed  actual
+	 * @return void
+	 */
+	public static function false($actual)
+	{
+		if ($actual !== FALSE) {
+			self::note('Failed asserting that ' . self::dump($actual) . ' is not FALSE');
+		}
+	}
+
+
+
+	/**
+	 * Checks NULL assertation.
+	 * @param  mixed  actual
+	 * @return void
+	 */
+	public static function null($actual)
+	{
+		if ($actual !== NULL) {
+			self::note('Failed asserting that ' . self::dump($actual) . ' is not NULL');
+		}
+	}
+
+
+
+	/**
+	 * Dumps information about a variable in readable format.
+	 * @param  mixed  variable to dump
+	 * @return void
+	 */
+	private static function dump($var)
+	{
+		if (is_bool($var)) {
+			return $var ? 'TRUE' : 'FALSE';
+
+		} elseif ($var === NULL) {
+			return "NULL";
+
+		} elseif (is_int($var)) {
+			return "$var";
+
+		} elseif (is_float($var)) {
+			return "$var";
+
+		} elseif (is_string($var)) {
+			return var_export($var, TRUE);
+
+		} elseif (is_array($var)) {
+			return "array(" . count($var) . ")";
+
+		} elseif ($var instanceof Exception) {
+			return 'Exception ' . get_class($var) . ': ' . ($var->getCode() ? '#' . $var->getCode() . ' ' : '') . $var->getMessage();
+
+		} elseif (is_object($var)) {
+			$arr = (array) $var;
+			return "object(" . get_class($var) . ") (" . count($arr) . ")";
+
+		} elseif (is_resource($var)) {
+			return "resource(" . get_resource_type($var) . ")";
+
+		} else {
+			return "unknown type";
+		}
+	}
+
+
+
+	/**
+	 * Returns message and file and line from call stack.
+	 * @param  string
+	 * @return void
+	 */
+	private static function note($message)
+	{
+		echo $message;
+		$trace = debug_backtrace();
+		if (isset($trace[1]['file'], $trace[1]['line'])) {
+			echo ' in file ' . $trace[1]['file'] . ' on line ' . $trace[1]['line'];
+		}
+		echo "\n\n";
+	}
+
+}

tests/NetteTest/RunTests.php

@@ -0,0 +1,43 @@
+
+Nette Test Framework (v0.3)
+---------------------------
+<?php
+
+require_once dirname(__FILE__) . '/TestRunner.php';
+
+/**
+ * Help
+ */
+if (!isset($_SERVER['argv'][1])) { ?>
+Usage:
+	php RunTests.php [options] [file or directory]
+
+Options:
+	-p <php>    Specify PHP-CGI executable to run.
+	-c <path>   Look for php.ini in directory <path> or use <path> as php.ini.
+	-d key=val  Define INI entry 'key' with value 'val'.
+	-l <path>   Specify path to shared library files (LD_LIBRARY_PATH)
+	-e <name>   Load php environment <name>
+	-s          Show information about skipped tests
+
+<?php
+}
+
+
+
+/**
+ * Execute tests
+ */
+try {
+	@unlink(dirname(__FILE__) . '/coverage.tmp'); // @ - file may not exist
+
+	$manager = new TestRunner;
+	$manager->parseConfigFile();
+	$manager->parseArguments();
+	$res = $manager->run();
+	die($res ? 0 : 1);
+
+} catch (Exception $e) {
+	echo 'Error: ', $e->getMessage(), "\n";
+	die(2);
+}

tests/NetteTest/TestCase.php

@@ -0,0 +1,400 @@
+<?php
+
+/**
+ * Nette Framework
+ *
+ * @copyright  Copyright (c) 2004 David Grudl
+ * @license    http://nette.org/license  Nette license
+ * @link       http://nette.org
+ * @category   Nette
+ * @package    Nette\Test
+ */
+
+
+
+/**
+ * Single test case.
+ *
+ * @author     David Grudl
+ * @package    Nette\Test
+ */
+class TestCase
+{
+	/** @var string  test file */
+	private $file;
+
+	/** @var array   test file multiparts */
+	private $sections;
+
+	/** @var string  test output */
+	private $output;
+
+	/** @var string  output headers in raw format */
+	private $headers;
+
+	/** @var string  PHP command line */
+	private $cmdLine;
+
+	/** @var string  PHP command line */
+	private $phpVersion;
+
+	/** @var array */
+	private static $cachedPhp;
+
+
+
+	/**
+	 * @param  string  test file name
+	 * @param  string  PHP command line
+	 * @return void
+	 */
+	public function __construct($testFile)
+	{
+		$this->file = (string) $testFile;
+		$this->sections = self::parseSections($this->file);
+	}
+
+
+
+	/**
+	 * Runs single test.
+	 * @return void
+	 */
+	public function run()
+	{
+		// pre-skip?
+		$options = $this->sections['options'];
+		if (isset($options['skip'])) {
+			$message = $options['skip'] ? $options['skip'] : 'No message.';
+			throw new TestCaseException($message, TestCaseException::SKIPPED);
+
+		} elseif (isset($options['phpversion'])) {
+			$operator = '>=';
+			if (preg_match('#^(<=|le|<|lt|==|=|eq|!=|<>|ne|>=|ge|>|gt)#', $options['phpversion'], $matches)) {
+				$options['phpversion'] = trim(substr($options['phpversion'], strlen($matches[1])));
+				$operator = $matches[1];
+			}
+			if (version_compare($options['phpversion'], $this->phpVersion, $operator)) {
+				throw new TestCaseException("Requires PHP $operator $options[phpversion].", TestCaseException::SKIPPED);
+			}
+		}
+
+		$this->execute();
+		$output = $this->output;
+		$headers = array_change_key_case(self::parseLines($this->headers, ':'), CASE_LOWER);
+		$tests = 0;
+
+		// post-skip?
+		if (isset($headers['x-nette-test-skip'])) {
+			throw new TestCaseException($headers['x-nette-test-skip'], TestCaseException::SKIPPED);
+		}
+
+		// compare output
+		$expectedOutput = $this->getExpectedOutput();
+		if ($expectedOutput !== NULL) {
+			$tests++;
+			$binary = (bool) preg_match('#[\x00-\x08\x0B\x0C\x0E-\x1F]#', $expectedOutput);
+			if ($binary) {
+				if ($expectedOutput !== $output) {
+					throw new TestCaseException("Binary output doesn't match.");
+				}
+			} else {
+				$output = self::normalize($output, isset($options['keeptrailingspaces']));
+				$expectedOutput = self::normalize($expectedOutput, isset($options['keeptrailingspaces']));
+				if (!$this->compare($output, $expectedOutput)) {
+					throw new TestCaseException("Output doesn't match.");
+				}
+			}
+		}
+
+		// compare headers
+		$expectedHeaders = $this->getExpectedHeaders();
+		if ($expectedHeaders !== NULL) {
+			$tests++;
+			$expectedHeaders = self::normalize($expectedHeaders, FALSE);
+			$expectedHeaders = array_change_key_case(self::parseLines($expectedHeaders, ':'), CASE_LOWER);
+			foreach ($expectedHeaders as $name => $header) {
+				if (!isset($headers[$name])) {
+					throw new TestCaseException("Missing header '$name'.");
+
+				} elseif (!$this->compare($headers[$name], $header)) {
+					throw new TestCaseException("Header '$name' doesn't match.");
+				}
+			}
+		}
+
+		if (!$tests) { // expecting no output
+			if (trim($output) !== '') {
+				throw new TestCaseException("Empty output doesn't match.");
+			}
+		}
+	}
+
+
+
+	/**
+	 * Sets PHP command line.
+	 * @param  string
+	 * @param  string
+	 * @param  string
+	 * @return TestCase  provides a fluent interface
+	 */
+	public function setPhp($binary, $args, $environment)
+	{
+		if (isset(self::$cachedPhp[$binary])) {
+			$this->phpVersion = self::$cachedPhp[$binary];
+
+		} else {
+			exec($environment . escapeshellarg($binary) . ' -v', $output, $res);
+			if ($res !== 0 && $res !== 255) {
+				throw new Exception("Unable to execute '$binary -v'.");
+			}
+
+			if (!preg_match('#^PHP (\S+).*cli#i', $output[0], $matches)) {
+				throw new Exception("Unable to detect PHP version (output: $output[0]).");
+			}
+
+			$this->phpVersion = self::$cachedPhp[$binary] = $matches[1];
+		}
+
+		$this->cmdLine = $environment . escapeshellarg($binary) . $args;
+		return $this;
+	}
+
+
+
+	/**
+	 * Execute test.
+	 * @return array
+	 */
+	private function execute()
+	{
+		$this->headers = $this->output = NULL;
+
+		$tempFile = tempnam('', 'tmp');
+		if (!$tempFile) {
+			throw new Exception("Unable to create temporary file.");
+		}
+
+		$command = $this->cmdLine;
+		if (isset($this->sections['options']['phpini'])) {
+			foreach (explode(';', $this->sections['options']['phpini']) as $item) {
+				$command .= " -d " . escapeshellarg(trim($item));
+			}
+		}
+		$command .= ' ' . escapeshellarg($this->file) . ' > ' . escapeshellarg($tempFile);
+
+		chdir(dirname($this->file));
+		exec($command, $foo, $res);
+		if ($res === 255) {
+			// exit_status 255 => parse or fatal error
+
+		} elseif ($res !== 0) {
+			throw new Exception("Unable to execute '$command'.");
+
+		}
+
+		$this->output = file_get_contents($tempFile);
+		unlink($tempFile);
+	}
+
+
+
+	/**
+	 * Returns test file section.
+	 * @return string
+	 */
+	public function getSection($name)
+	{
+		return isset($this->sections[$name]) ? $this->sections[$name] : NULL;
+	}
+
+
+
+	/**
+	 * Returns test name.
+	 * @return string
+	 */
+	public function getName()
+	{
+		return $this->sections['options']['name'];
+	}
+
+
+
+	/**
+	 * Returns test output.
+	 * @return string
+	 */
+	public function getOutput()
+	{
+		return $this->output;
+	}
+
+
+
+	/**
+	 * Returns output headers.
+	 * @return string
+	 */
+	public function getHeaders()
+	{
+		return $this->headers;
+	}
+
+
+
+	/**
+	 * Returns expected output.
+	 * @return string
+	 */
+	public function getExpectedOutput()
+	{
+		if (isset($this->sections['expect'])) {
+			return $this->sections['expect'];
+
+		} elseif (is_file($expFile = str_replace('.phpt', '', $this->file) . '.expect')) {
+			return file_get_contents($expFile);
+
+		} else {
+			return NULL;
+		}
+	}
+
+
+
+	/**
+	 * Returns expected headers.
+	 * @return string
+	 */
+	public function getExpectedHeaders()
+	{
+		return $this->getSection('expectheaders');
+	}
+
+
+
+	/********************* helpers ****************d*g**/
+
+
+
+	/**
+	 * Splits file into sections.
+	 * @param  string  file
+	 * @return array
+	 */
+	public static function parseSections($testFile)
+	{
+		$content = file_get_contents($testFile);
+		$sections = array(
+			'options' => array(),
+		);
+
+		// phpDoc
+		$phpDoc = preg_match('#^/\*\*(.*?)\*/#ms', $content, $matches) ? trim($matches[1]) : '';
+		preg_match_all('#^\s*\*\s*@(\S+)(.*)#mi', $phpDoc, $matches, PREG_SET_ORDER);
+		foreach ($matches as $match) {
+			$sections['options'][strtolower($match[1])] = isset($match[2]) ? trim($match[2]) : TRUE;
+		}
+		$sections['options']['name'] = preg_match('#^\s*\*\s*TEST:(.*)#mi', $phpDoc, $matches) ? trim($matches[1]) : $testFile;
+
+		// file parts
+		$tmp = preg_split('#^-{3,}([^\s-]+)-{1,}(?:\r?\n|$)#m', $content, -1, PREG_SPLIT_DELIM_CAPTURE);
+		$i = 1;
+		while (isset($tmp[$i])) {
+			$sections[strtolower($tmp[$i])] = $tmp[$i+1];
+			$i += 2;
+		}
+		return $sections;
+	}
+
+
+
+	/**
+	 * Splits HTTP headers into array.
+	 * @param  string
+	 * @param  string
+	 * @return array
+	 */
+	public static function parseLines($raw, $separator)
+	{
+		$headers = array();
+		foreach (explode("\r\n", $raw) as $header) {
+			$a = strpos($header, $separator);
+			if ($a !== FALSE) {
+				$headers[trim(substr($header, 0, $a))] = (string) trim(substr($header, $a + 1));
+			}
+		}
+		return $headers;
+	}
+
+
+
+	/**
+	 * Compares results.
+	 * @param  string
+	 * @param  string
+	 * @return bool
+	 */
+	public static function compare($left, $right)
+	{
+		$right = strtr($right, array(
+			'%a%' => '[^\r\n]+',    // one or more of anything except the end of line characters
+			'%a?%'=> '[^\r\n]*',    // zero or more of anything except the end of line characters
+			'%A%' => '.+',          // one or more of anything including the end of line characters
+			'%A?%'=> '.*',          // zero or more of anything including the end of line characters
+			'%s%' => '[\t ]+',      // one or more white space characters except the end of line characters
+			'%s?%'=> '[\t ]*',      // zero or more white space characters except the end of line characters
+			'%S%' => '\S+',         // one or more of characters except the white space
+			'%S?%'=> '\S*',         // zero or more of characters except the white space
+			'%c%' => '[^\r\n]',     // a single character of any sort (except the end of line)
+			'%d%' => '[0-9]+',      // one or more digits
+			'%d?%'=> '[0-9]*',      // zero or more digits
+			'%i%' => '[+-]?[0-9]+', // signed integer value
+			'%f%' => '[+-]?\.?\d+\.?\d*(?:[Ee][+-]?\d+)?', // floating point number
+			'%h%' => '[0-9a-fA-F]+',// one or more HEX digits
+			'%ns%'=> '(?:[_0-9a-zA-Z\\\\]+\\\\|N)?',// PHP namespace
+			'%[^' => '[^',          // reg-exp
+			'%['  => '[',           // reg-exp
+			']%'  => ']+',          // reg-exp
+
+			'.' => '\.', '\\' => '\\\\', '+' => '\+', '*' => '\*', '?' => '\?', '[' => '\[', '^' => '\^', ']' => '\]', '$' => '\$', '(' => '\(', ')' => '\)', // preg quote
+			'{' => '\{', '}' => '\}', '=' => '\=', '!' => '\!', '>' => '\>', '<' => '\<', '|' => '\|', ':' => '\:', '-' => '\-', "\x00" => '\000', '#' => '\#', // preg quote
+		));
+
+		return (bool) preg_match("#^$right$#s", $left);
+	}
+
+
+
+	/**
+	 * Normalizes whitespace
+	 * @param  string
+	 * @param  bool
+	 * @return string
+	 */
+	public static function normalize($s, $keepTrailingSpaces)
+	{
+		$s = str_replace("\n", PHP_EOL, str_replace("\r\n", "\n", $s));  // normalize EOL
+		if (!$keepTrailingSpaces) {
+			$s = preg_replace("#[\t ]+(\r?\n)#", '$1', $s); // multiline right trim
+			$s = rtrim($s); // ending trim
+		}
+		return $s;
+	}
+
+}
+
+
+
+/**
+ * Single test exception.
+ *
+ * @author     David Grudl
+ * @package    Nette\Test
+ */
+class TestCaseException extends Exception
+{
+	const SKIPPED = 1;
+
+}

tests/NetteTest/TestHelpers.php

@@ -0,0 +1,312 @@
+<?php
+
+/**
+ * Nette Framework
+ *
+ * @copyright  Copyright (c) 2004 David Grudl
+ * @license    http://nette.org/license  Nette license
+ * @link       http://nette.org
+ * @category   Nette
+ * @package    Nette\Test
+ */
+
+require dirname(__FILE__) . '/TestCase.php';
+
+
+/**
+ * Test helpers.
+ *
+ * @author     David Grudl
+ * @package    Nette\Test
+ */
+class TestHelpers
+{
+	/** @var int */
+	static public $maxDepth = 5;
+
+	/** @var array */
+	private static $sections;
+
+
+
+	/**
+	 * Configures PHP and environment.
+	 * @return void
+	 */
+	public static function startup()
+	{
+		error_reporting(E_ALL | E_STRICT);
+		ini_set('display_errors', TRUE);
+		ini_set('html_errors', FALSE);
+		ini_set('log_errors', FALSE);
+
+
+		$_SERVER = array_intersect_key($_SERVER, array_flip(array('PHP_SELF', 'SCRIPT_NAME', 'SERVER_ADDR', 'SERVER_SOFTWARE', 'HTTP_HOST', 'DOCUMENT_ROOT', 'OS')));
+		$_SERVER['REQUEST_TIME'] = 1234567890;
+		$_ENV = array();
+
+		if (PHP_SAPI !== 'cli') {
+			header('Content-Type: text/plain; charset=utf-8');
+		}
+
+		if (extension_loaded('xdebug')) {
+			xdebug_disable();
+			xdebug_start_code_coverage(XDEBUG_CC_UNUSED | XDEBUG_CC_DEAD_CODE);
+			register_shutdown_function(array(__CLASS__, 'prepareSaveCoverage'));
+		}
+
+		set_exception_handler(array(__CLASS__, 'exceptionHandler'));
+	}
+
+
+
+	/**
+	 * Purges directory.
+	 * @param  string
+	 * @return void
+	 */
+	public static function purge($dir)
+	{
+		@mkdir($dir); // @ - directory may already exist
+		foreach (new RecursiveIteratorIterator(new RecursiveDirectoryIterator($dir), RecursiveIteratorIterator::CHILD_FIRST) as $entry) {
+			if ($entry->getBasename() === '.gitignore') {
+				// ignore
+			} elseif ($entry->isDir()) {
+				rmdir($entry);
+			} else {
+				unlink($entry);
+			}
+		}
+	}
+
+
+
+	/**
+	 * Returns current test section.
+	 * @param  string
+	 * @param  string
+	 * @return mixed
+	 */
+	public static function getSection($file, $section)
+	{
+		if (!isset(self::$sections[$file])) {
+			self::$sections[$file] = TestCase::parseSections($file);
+		}
+
+		$lowerSection = strtolower($section);
+		if (!isset(self::$sections[$file][$lowerSection])) {
+			throw new Exception("Missing section '$section' in file '$file'.");
+		}
+
+		if (in_array($section, array('GET', 'POST', 'SERVER'), TRUE)) {
+			return TestCase::parseLines(self::$sections[$file][$lowerSection], '=');
+		} else {
+			return self::$sections[$file][$lowerSection];
+		}
+	}
+
+
+
+	/**
+	 * Writes new message.
+	 * @param  string
+	 * @return void
+	 */
+	public static function note($message = NULL)
+	{
+		echo $message ? "$message\n\n" : "===\n\n";
+	}
+
+
+
+	/**
+	 * Dumps information about a variable in readable format.
+	 * @param  mixed  variable to dump
+	 * @param  string
+	 * @return mixed  variable itself or dump
+	 */
+	public static function dump($var, $message = NULL)
+	{
+		if ($message) {
+			echo $message . (preg_match('#[.:?]$#', $message) ? ' ' : ': ');
+		}
+
+		self::_dump($var, 0);
+		echo "\n";
+		return $var;
+	}
+
+
+
+	private static function _dump(& $var, $level = 0)
+	{
+		static $tableUtf, $tableBin, $reBinary = '#[^\x09\x0A\x0D\x20-\x7E\xA0-\x{10FFFF}]#u';
+		if ($tableUtf === NULL) {
+			foreach (range("\x00", "\xFF") as $ch) {
+				if (ord($ch) < 32 && strpos("\r\n\t", $ch) === FALSE) $tableUtf[$ch] = $tableBin[$ch] = '\\x' . str_pad(dechex(ord($ch)), 2, '0', STR_PAD_LEFT);
+				elseif (ord($ch) < 127) $tableUtf[$ch] = $tableBin[$ch] = $ch;
+				else { $tableUtf[$ch] = $ch; $tableBin[$ch] = '\\x' . dechex(ord($ch)); }
+			}
+			$tableBin["\\"] = '\\\\';
+			$tableBin["\r"] = '\\r';
+			$tableBin["\n"] = '\\n';
+			$tableBin["\t"] = '\\t';
+			$tableUtf['\\x'] = $tableBin['\\x'] = '\\\\x';
+		}
+
+		if (is_bool($var)) {
+			echo ($var ? 'TRUE' : 'FALSE') . "\n";
+
+		} elseif ($var === NULL) {
+			echo "NULL\n";
+
+		} elseif (is_int($var)) {
+			echo "$var\n";
+
+		} elseif (is_float($var)) {
+			$var = (string) $var;
+			if (strpos($var, '.') === FALSE) $var .= '.0';
+			echo "$var\n";
+
+		} elseif (is_string($var)) {
+			$s = strtr($var, preg_match($reBinary, $var) || preg_last_error() ? $tableBin : $tableUtf);
+			echo "\"$s\"\n";
+
+		} elseif (is_array($var)) {
+			echo "array(";
+			$space = str_repeat("\t", $level);
+
+			static $marker;
+			if ($marker === NULL) $marker = uniqid("\x00", TRUE);
+			if (empty($var)) {
+
+			} elseif (isset($var[$marker])) {
+				echo " *RECURSION* ";
+
+			} elseif ($level < self::$maxDepth) {
+				echo "\n";
+				$vector = range(0, count($var) - 1) === array_keys($var);
+				$var[$marker] = 0;
+				foreach ($var as $k => &$v) {
+					if ($k === $marker) continue;
+					if ($vector) {
+						echo "$space\t";
+					} else {
+						$k = is_int($k) ? $k : '"' . strtr($k, preg_match($reBinary, $k) || preg_last_error() ? $tableBin : $tableUtf) . '"';
+						echo "$space\t$k => ";
+					}
+					self::_dump($v, $level + 1);
+				}
+				unset($var[$marker]);
+				echo "$space";
+
+			} else {
+				echo " ... ";
+			}
+			echo ")\n";
+
+		} elseif ($var instanceof Exception) {
+			echo 'Exception ', get_class($var), ': ', ($var->getCode() ? '#' . $var->getCode() . ' ' : '') . $var->getMessage(), "\n";
+
+		} elseif (is_object($var)) {
+			$arr = (array) $var;
+			echo get_class($var) . "(";
+			$space = str_repeat("\t", $level);
+
+			static $list = array();
+			if (empty($arr)) {
+
+			} elseif (in_array($var, $list, TRUE)) {
+				echo " *RECURSION* ";
+
+			} elseif ($level < self::$maxDepth) {
+				echo "\n";
+				$list[] = $var;
+				foreach ($arr as $k => &$v) {
+					$m = '';
+					if ($k[0] === "\x00") {
+						$m = $k[1] === '*' ? ' protected' : ' private';
+						$k = substr($k, strrpos($k, "\x00") + 1);
+					}
+					$k = strtr($k, preg_match($reBinary, $k) || preg_last_error() ? $tableBin : $tableUtf);
+					echo "$space\t\"$k\"$m => ";
+					echo self::_dump($v, $level + 1);
+				}
+				array_pop($list);
+				echo "$space";
+
+			} else {
+				echo " ... ";
+			}
+			echo ")\n";
+
+		} elseif (is_resource($var)) {
+			echo get_resource_type($var) . " resource\n";
+
+		} else {
+			echo "unknown type\n";
+		}
+	}
+
+
+
+	/**
+	 * Custom exception handler.
+	 * @param  Exception
+	 * @return void
+	 */
+	public static function exceptionHandler(Exception $exception)
+	{
+		echo 'Error: Uncaught ';
+		echo $exception;
+	}
+
+
+
+	/**
+	 * Coverage saving helper.
+	 * @return void
+	 */
+	public static function prepareSaveCoverage()
+	{
+		register_shutdown_function(array(__CLASS__, 'saveCoverage'));
+	}
+
+
+
+	/**
+	 * Saves information about code coverage.
+	 * @return void
+	 */
+	public static function saveCoverage()
+	{
+		$file = dirname(__FILE__) . '/coverage.tmp';
+		$coverage = @unserialize(file_get_contents($file));
+		$root = realpath(dirname(__FILE__) . '/../../Nette') . DIRECTORY_SEPARATOR;
+
+		foreach (xdebug_get_code_coverage() as $filename => $lines) {
+			if (strncmp($root, $filename, strlen($root))) continue;
+
+			foreach ($lines as $num => $val) {
+				if (empty($coverage[$filename][$num]) || $val > 0) {
+					$coverage[$filename][$num] = $val; // -1 => untested; -2 => dead code
+				}
+			}
+		}
+
+		file_put_contents($file, serialize($coverage));
+	}
+
+
+
+	/**
+	 * Skips this test.
+	 * @return void
+	 */
+	public static function skip($message = 'No message.')
+	{
+		header('X-Nette-Test-Skip: '. $message);
+		exit;
+	}
+
+}

tests/NetteTest/TestRunner.php

@@ -0,0 +1,230 @@
+<?php
+
+/**
+ * Nette Framework
+ *
+ * @copyright  Copyright (c) 2004 David Grudl
+ * @license    http://nette.org/license  Nette license
+ * @link       http://nette.org
+ * @category   Nette
+ * @package    Nette\Test
+ */
+
+require dirname(__FILE__) . '/TestCase.php';
+
+
+
+/**
+ * Test runner.
+ *
+ * @author     David Grudl
+ * @package    Nette\Test
+ */
+class TestRunner
+{
+	const OUTPUT = 'output';
+	const EXPECTED = 'expect';
+	const HEADERS = 'headers';
+
+	/** @var string  path to test file/directory */
+	public $path;
+
+	/** @var string  php-cgi binary */
+	public $phpBinary;
+
+	/** @var string  php-cgi command-line arguments */
+	public $phpArgs;
+
+	/** @var string  php-cgi environment variables */
+	public $phpEnvironment;
+
+	/** @var bool  display skipped tests information? */
+	public $displaySkipped = FALSE;
+
+
+
+	/**
+	 * Runs all tests.
+	 * @return void
+	 */
+	public function run()
+	{
+		$count = 0;
+		$failed = $passed = $skipped = array();
+
+		if (is_file($this->path)) {
+			$files = array($this->path);
+		} else {
+			$files = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($this->path));
+		}
+
+		foreach ($files as $entry) {
+			$entry = (string) $entry;
+			$info = pathinfo($entry);
+			if (!isset($info['extension']) || $info['extension'] !== 'phpt') {
+				continue;
+			}
+
+			$count++;
+			$testCase = new TestCase($entry);
+			$testCase->setPhp($this->phpBinary, $this->phpArgs, $this->phpEnvironment);
+
+			try {
+				$testCase->run();
+				echo '.';
+				$passed[] = array($testCase->getName(), $entry);
+
+			} catch (TestCaseException $e) {
+				if ($e->getCode() === TestCaseException::SKIPPED) {
+					echo 's';
+					$skipped[] = array($testCase->getName(), $entry, $e->getMessage());
+
+				} else {
+					echo 'F';
+					$failed[] = array($testCase->getName(), $entry, $e->getMessage());
+
+					$this->log($entry, $testCase->getOutput(), self::OUTPUT);
+					$this->log($entry, $testCase->getExpectedOutput(), self::EXPECTED);
+
+					if ($testCase->getExpectedHeaders() !== NULL) {
+						$this->log($entry, $testCase->getHeaders(), self::OUTPUT, self::HEADERS);
+						$this->log($entry, $testCase->getExpectedHeaders(), self::EXPECTED, self::HEADERS);
+					}
+				}
+			}
+		}
+
+		$failedCount = count($failed);
+		$skippedCount = count($skipped);
+
+		if ($this->displaySkipped && $skippedCount) {
+			echo "\n\nSkipped:\n";
+			foreach ($skipped as $i => $item) {
+				list($name, $file, $message) = $item;
+				echo "\n", ($i + 1), ") $name\n   $message\n   $file\n";
+			}
+		}
+
+		if (!$count) {
+			echo "No tests found\n";
+
+		} elseif ($failedCount) {
+			echo "\n\nFailures:\n";
+			foreach ($failed as $i => $item) {
+				list($name, $file, $message) = $item;
+				echo "\n", ($i + 1), ") $name\n   $message\n   $file\n";
+			}
+			echo "\nFAILURES! ($count tests, $failedCount failures, $skippedCount skipped)\n";
+			return FALSE;
+
+		} else {
+			echo "\n\nOK ($count tests, $skippedCount skipped)\n";
+		}
+		return TRUE;
+	}
+
+
+
+	/**
+	 * Returns output file for logging.
+	 * @param  string
+	 * @param  string
+	 * @param  string
+	 * @param  string
+	 * @return void
+	 */
+	public function log($testFile, $content, $type, $section = '')
+	{
+		$file = dirname($testFile) . '/' . $type . '/' . basename($testFile, '.phpt') . ($section ? ".$section" : '') . '.raw';
+		@mkdir(dirname($file)); // @ - directory may already exist
+		file_put_contents($file, $content);
+	}
+
+
+
+	/**
+	 * Parses configuration file.
+	 * @return void
+	 */
+	public function parseConfigFile()
+	{
+		$configFile = dirname(__FILE__) . '/config.ini';
+		if (file_exists($configFile)) {
+			$this->config = parse_ini_file($configFile, TRUE);
+			if ($this->config === FALSE) {
+				throw new Exception('Config file parsing failed.');
+			}
+			foreach ($this->config as & $environment) {
+				$environment += array(
+					'binary' => 'php-cgi',
+					'args' => '',
+					'environment' => '',
+				);
+				// shorthand options
+				if (isset($environment['php.ini'])) {
+					$environment['args'] .= ' -c '. escapeshellarg($environment['php.ini']);
+				}
+				if (isset($environment['libraries'])) {
+					$environment['environment'] .= 'LD_LIBRARY_PATH='. escapeshellarg($environment['libraries']) .' ';
+				}
+			}
+		}
+	}
+
+
+
+	/**
+	 * Parses command line arguments.
+	 * @return void
+	 */
+	public function parseArguments()
+	{
+		$this->phpBinary = 'php-cgi';
+		$this->phpArgs = '';
+		$this->phpEnvironment = '';
+		$this->path = getcwd(); // current directory
+
+		$args = new ArrayIterator(array_slice(isset($_SERVER['argv']) ? $_SERVER['argv'] : array(), 1));
+		foreach ($args as $arg) {
+			if (!preg_match('#^[-/][a-z]$#', $arg)) {
+				if ($path = realpath($arg)) {
+					$this->path = $path;
+				} else {
+					throw new Exception("Invalid path '$arg'.");
+				}
+
+			} else switch ($arg[1]) {
+				case 'p':
+					$args->next();
+					$this->phpBinary = $args->current();
+					break;
+				case 'c':
+				case 'd':
+					$args->next();
+					$this->phpArgs .= " -$arg[1] " . escapeshellarg($args->current());
+					break;
+				case 'l':
+					$args->next();
+					$this->phpEnvironment .= 'LD_LIBRARY_PATH='. escapeshellarg($args->current()) . ' ';
+					break;
+				case 'e':
+					$args->next();
+					$name = $args->current();
+					if (!isset($this->config[$name])) {
+						throw new Exception("Unknown environment name '$name'.");
+					}
+					$this->phpBinary = $this->config[$name]['binary'];
+					$this->phpArgs = $this->config[$name]['args'];
+					$this->phpEnvironment = $this->config[$name]['environment'];
+					break;
+				case 's':
+					$this->displaySkipped = TRUE;
+					break;
+				default:
+					throw new Exception("Unknown option -$arg[1].");
+					exit;
+			}
+		}
+	}
+
+}

tests/config.ini

@@ -0,0 +1,67 @@
+[mysql]
+driver = mysql
+host = localhost
+username = dibi
+password = dibi
+database = dibi_test
+charset = utf8
+
+[mysqli]
+driver = mysqli
+host = localhost
+username = dibi
+password = dibi
+database = dibi_test
+charset = utf8
+
+[sqlite]
+driver = sqlite
+database = DIR "/data/sample.sdb"
+
+[sqlite3]
+driver = sqlite3
+database = DIR "/data/sample.sdb3"
+
+[odbc]
+driver = odbc
+username = dibi
+password = dibi
+dsn = "Driver={Microsoft Access Driver (*.mdb)};Dbq=" DIR "/data/sample.mdb"
+
+[postgresql]
+driver = postgre
+host = localhost
+port = 5432
+username = dibi
+password = dibi
+database = dibi_test
+persistent = TRUE
+
+[sqlite-pdo]
+driver = pdo
+dsn = "sqlite2::" DIR "/data/sample.sdb"
+
+[mysql-pdo]
+driver = pdo
+dsn = "mysql:dbname=dibi_test;host=localhost"
+username = dibi
+password = dibi
+
+[mssql]
+driver = mssql
+host = localhost
+username = dibi
+password = dibi
+
+[mssql2005]
+driver = mssql2005
+host = "(local)"
+username = dibi
+password = dibi
+database = dibi_test
+
+[oracle]
+driver = oracle
+username = dibi
+password = dibi
+database = dibi_test

tests/data/sample.mysql

@@ -0,0 +1,149 @@
+-- phpMyAdmin SQL Dump
+-- version 2.11.1.2
+-- http://www.phpmyadmin.net
+--
+-- Po<50><6F>ta<74>: localhost
+-- Vygenerov<6F>no: Ned<65>le 02. prosince 2007, 19:49
+-- Verze MySQL: 5.0.45
+-- Verze PHP: 5.2.1
+
+SET FOREIGN_KEY_CHECKS=0;
+
+SET SQL_MODE="NO_AUTO_VALUE_ON_ZERO";
+
+--
+-- Datab<61>ze: `dibi`
+--
+
+-- --------------------------------------------------------
+
+--
+-- Struktura tabulky `customers`
+--
+
+DROP TABLE IF EXISTS `customers`;
+CREATE TABLE IF NOT EXISTS `customers` (
+  `customer_id` int(11) NOT NULL auto_increment,
+  `name` varchar(100) default NULL,
+  PRIMARY KEY  (`customer_id`)
+) ENGINE=MyISAM  DEFAULT CHARSET=utf8 AUTO_INCREMENT=7 ;
+
+--
+-- Vypisuji data pro tabulku `customers`
+--
+
+INSERT INTO `customers` (`customer_id`, `name`) VALUES
+(1, 'Dave Lister'),
+(2, 'Arnold Rimmer'),
+(3, 'The Cat'),
+(4, 'Holly'),
+(5, 'Kryten'),
+(6, 'Kristine Kochanski');
+
+-- --------------------------------------------------------
+
+--
+-- Struktura tabulky `enumtest`
+--
+
+DROP TABLE IF EXISTS `enumtest`;
+CREATE TABLE IF NOT EXISTS `enumtest` (
+  `id` int(11) NOT NULL auto_increment,
+  `test` enum('a','b','c') NOT NULL,
+  PRIMARY KEY  (`id`)
+) ENGINE=MyISAM DEFAULT CHARSET=utf8 AUTO_INCREMENT=1 ;
+
+--
+-- Vypisuji data pro tabulku `enumtest`
+--
+
+
+-- --------------------------------------------------------
+
+--
+-- Struktura tabulky `orders`
+--
+
+DROP TABLE IF EXISTS `orders`;
+CREATE TABLE IF NOT EXISTS `orders` (
+  `order_id` int(11) NOT NULL,
+  `customer_id` int(11) NOT NULL,
+  `product_id` int(11) NOT NULL,
+  `amount` float NOT NULL
+) ENGINE=MyISAM DEFAULT CHARSET=utf8;
+
+--
+-- Vypisuji data pro tabulku `orders`
+--
+
+INSERT INTO `orders` (`order_id`, `customer_id`, `product_id`, `amount`) VALUES
+(1, 2, 1, 7),
+(2, 2, 3, 2),
+(3, 1, 2, 3),
+(4, 6, 3, 5);
+
+-- --------------------------------------------------------
+
+--
+-- Struktura tabulky `products`
+--
+
+DROP TABLE IF EXISTS `products`;
+CREATE TABLE IF NOT EXISTS `products` (
+  `product_id` int(11) NOT NULL auto_increment,
+  `title` varchar(100) default NULL,
+  PRIMARY KEY  (`product_id`)
+) ENGINE=MyISAM  DEFAULT CHARSET=utf8 AUTO_INCREMENT=1 ;
+
+--
+-- Vypisuji data pro tabulku `products`
+--
+
+INSERT INTO `products` (`product_id`, `title`) VALUES
+(1, 'Chair'),
+(2, 'Table'),
+(3, 'Computer');
+
+-- --------------------------------------------------------
+
+--
+-- Struktura tabulky `settest`
+--
+
+DROP TABLE IF EXISTS `settest`;
+CREATE TABLE IF NOT EXISTS `settest` (
+  `id` int(11) NOT NULL auto_increment,
+  `test` set('a','b','c') NOT NULL,
+  PRIMARY KEY  (`id`)
+) ENGINE=MyISAM DEFAULT CHARSET=utf8 AUTO_INCREMENT=1 ;
+
+--
+-- Vypisuji data pro tabulku `settest`
+--
+
+
+-- --------------------------------------------------------
+
+--
+-- Struktura tabulky `where`
+--
+
+DROP TABLE IF EXISTS `where`;
+CREATE TABLE IF NOT EXISTS `where` (
+  `select` int(11) NOT NULL,
+  `dot.dot` int(11) NOT NULL,
+  `is` int(11) NOT NULL,
+  `quot'n' space` int(11) NOT NULL
+) ENGINE=MyISAM DEFAULT CHARSET=utf8;
+
+--
+-- Vypisuji data pro tabulku `where`
+--
+
+INSERT INTO `where` (`select`, `dot.dot`, `is`, `quot'n' space`) VALUES
+(1, 2, 3, 4);
+
+SET FOREIGN_KEY_CHECKS=1;
+
+SET SQL_MODE="STRICT_TRANS_TABLES,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION";
+

tests/initialize.php

@@ -0,0 +1,26 @@
+<?php
+
+/**
+ * Test initialization and helpers.
+ *
+ * @author     David Grudl
+ * @package    Nette\Test
+ */
+
+require dirname(__FILE__) . '/NetteTest/TestHelpers.php';
+require dirname(__FILE__) . '/NetteTest/Assert.php';
+require dirname(__FILE__) . '/../dibi/dibi.php';
+
+date_default_timezone_set('Europe/Prague');
+
+TestHelpers::startup();
+
+if (function_exists('class_alias')) {
+	class_alias('TestHelpers', 'T');
+} else {
+	class T extends TestHelpers {}
+}
+
+// load connections
+define('DIR', dirname(__FILE__));
+$config = parse_ini_file('config.ini', TRUE);

version.txt

@@ -1 +1 @@
-Dibi 1.0 (revision $WCREV$ released on $WCDATE$)
+Dibi 2.0.3 (revision $WCREV$ released on $WCDATE$)