Released version 3.2.4

Nette DI 3.x require $container->setFactory() usage except of $container->setClass()

.gitattributes

@@ -0,0 +1,6 @@
+.gitattributes export-ignore
+.gitignore export-ignore
+.github export-ignore
+.travis.yml export-ignore
+appveyor.yml export-ignore
+tests/ export-ignore

.github/issue_template.md

@@ -0,0 +1,16 @@
+- bug report? yes/no
+- feature request? yes/no
+- version: ?.?.? <!-- exact release version, for bug reports -->
+
+### Description
+...
+
+### Steps To Reproduce
+... If possible a minimal demo of the problem ...
+
+<!--
+REMEMBER, AN ISSUE IS NOT THE PLACE TO ASK QUESTIONS. We will be happy to help you on Gitter https://gitter.im/nette/nette
+
+A good bug report shouldn't leave others needing to chase you up for more information. Please try to be as detailed as possible in your report.
+Feature requests are welcome. Explain your intentions. It's up to you to make a strong case to convince the project's developers of the merits of this feature.
+-->

.github/pull_request_template.md

@@ -0,0 +1,11 @@
+- bug fix? yes/no   <!-- #issue numbers, if any -->
+- new feature? yes/no
+- BC break? yes/no
+
+<!--
+Describe your changes here to communicate to the maintainers why we should accept this pull request.
+
+Please add new tests to show the fix or feature works.
+
+Thanks for contributing!
+-->

.travis.yml

@@ -0,0 +1,72 @@
+language: php
+php:
+    - 5.4
+    - 5.5
+    - 5.6
+    - 7.0
+    - 7.1
+    - 7.2
+    - 7.3
+
+services:
+    - mysql
+    - postgresql
+
+before_install:
+    # turn off XDebug
+    - phpenv config-rm xdebug.ini || return 0
+
+    # Create databases.ini
+    - cp ./tests/databases.travis.ini ./tests/databases.ini
+
+    # Create Postgre database
+    - psql -c 'CREATE DATABASE dibi_test' -U postgres
+
+install:
+    - travis_retry composer install --no-progress --prefer-dist
+
+script:
+    - vendor/bin/tester tests -s
+
+after_failure:
+    # Print *.actual content
+    - for i in $(find tests -name \*.actual); do echo "--- $i"; cat $i; echo; echo; done
+
+jobs:
+    include:
+        -   stage: Code Standard Checker
+            php: 7.1
+            install:
+                # Install Nette Code Checker
+                - travis_retry composer create-project nette/code-checker temp/code-checker ^3 --no-progress
+                # Install Nette Coding Standard
+                - travis_retry composer create-project nette/coding-standard temp/coding-standard ^2 --no-progress
+            script:
+                - php temp/code-checker/code-checker
+                - php temp/coding-standard/ecs check src tests examples --config temp/coding-standard/coding-standard-php56.yml
+
+
+        -   stage: Code Coverage
+            php: 7.1
+            script:
+                - vendor/bin/tester -p phpdbg tests -s --coverage ./coverage.xml --coverage-src ./src
+            after_script:
+                - wget https://github.com/satooshi/php-coveralls/releases/download/v1.0.1/coveralls.phar
+                - php coveralls.phar --verbose --config tests/.coveralls.yml
+
+
+    allow_failures:
+        -   php: 7.2
+        -   stage: Code Coverage
+
+
+sudo: false
+
+cache:
+    directories:
+        - $HOME/.composer/cache
+
+notifications:
+    email: false
+
+dist: trusty

appveyor.yml

@@ -0,0 +1,59 @@
+build: off
+cache:
+    - c:\php5 -> appveyor.yml
+    - c:\php7 -> appveyor.yml
+    - '%LOCALAPPDATA%\Composer\files -> appveyor.yml'
+
+clone_folder: c:\projects\dibi
+
+services:
+    - mssql2012sp1
+#    - mssql2014
+    - mysql
+
+init:
+    - SET PATH=c:\php5;%PATH%
+    - SET ANSICON=121x90 (121x90)
+
+install:
+    # Install PHP 5
+    - IF EXIST c:\php5 (SET PHP=0) ELSE (SET PHP=1)
+    - IF %PHP%==1 mkdir c:\php5
+    - IF %PHP%==1 cd c:\php5
+    - IF %PHP%==1 curl https://windows.php.net/downloads/releases/archives/php-5.6.14-Win32-VC11-x86.zip --output php.zip
+    - IF %PHP%==1 7z x php.zip >nul
+    - IF %PHP%==1 echo extension_dir=ext >> php.ini
+    - IF %PHP%==1 echo extension=php_openssl.dll >> php.ini
+    - IF %PHP%==1 appveyor DownloadFile https://files.nette.org/misc/php-sqlsrv.zip
+    - IF %PHP%==1 7z x php-sqlsrv.zip >nul
+    - IF %PHP%==1 copy SQLSRV\php_sqlsrv_56_ts.dll ext\php_sqlsrv_ts.dll
+    - IF %PHP%==1 copy SQLSRV\php_pdo_sqlsrv_56_ts.dll ext\php_pdo_sqlsrv_ts.dll
+    - IF %PHP%==1 del /Q *.zip
+
+    # Install PHP 7
+    - IF EXIST c:\php7 (SET PHP=0) ELSE (SET PHP=1)
+    - IF %PHP%==1 mkdir c:\php7
+    - IF %PHP%==1 cd c:\php7
+    - IF %PHP%==1 curl https://windows.php.net/downloads/releases/archives/php-7.0.3-Win32-VC14-x86.zip --output php.zip
+    - IF %PHP%==1 7z x php.zip >nul
+    - IF %PHP%==1 echo extension_dir=ext >> php.ini
+    - IF %PHP%==1 appveyor DownloadFile https://files.nette.org/misc/php-sqlsrv.zip
+    - IF %PHP%==1 7z x php-sqlsrv.zip >nul
+    - IF %PHP%==1 copy SQLSRV\php_sqlsrv_7_ts.dll ext\php_sqlsrv_ts.dll
+    - IF %PHP%==1 del /Q *.zip
+
+    # Install Nette Tester
+    - cd c:\projects\dibi
+    - appveyor DownloadFile https://getcomposer.org/composer.phar
+    - php composer.phar install --prefer-dist --no-interaction --no-progress
+
+    # Create databases.ini
+    - copy tests\databases.appveyor.ini tests\databases.ini
+
+test_script:
+    - vendor\bin\tester tests -s -p c:\php5\php -c tests\php5-win.ini
+    - vendor\bin\tester tests -s -p c:\php7\php -c tests\php7-win.ini
+
+on_failure:
+    # Print *.actual content
+    - for /r %%x in (*.actual) do ( type "%%x" )

composer.json

@@ -1,19 +1,32 @@
 {
 	"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"],
+	"description": "Dibi is Database Abstraction Library for PHP",
+	"keywords": ["database", "dbal", "mysql", "postgresql", "sqlite", "mssql", "sqlsrv", "oracle", "access", "pdo", "odbc"],
+	"homepage": "https://dibiphp.com",
+	"license": ["BSD-3-Clause", "GPL-2.0", "GPL-3.0"],
 	"authors": [
 		{
 			"name": "David Grudl",
-			"homepage": "http://davidgrudl.com"
+			"homepage": "https://davidgrudl.com"
 		}
 	],
+	"require": {
+		"php": ">=5.4.4"
+	},
 	"require-dev": {
-		"nette/tester": "@dev"
+		"tracy/tracy": "~2.2",
+		"nette/tester": "~1.7"
+	},
+	"replace": {
+		"dg/dibi": "*"
 	},
 	"autoload": {
-		"classmap": ["dibi/"]
+		"classmap": ["src/"],
+		"files": ["src/loader.php"]
+	},
+	"extra": {
+		"branch-alias": {
+			"dev-master": "3.2-dev"
+		}
 	}
 }

contributing.md

@@ -0,0 +1,31 @@
+How to contribute & use the issue tracker
+=========================================
+
+Dibi welcomes your contributions. There are several ways to help out:
+
+* Create an issue on GitHub, if you have found a bug
+* Write test cases for open bug issues
+* Write fixes for open bug/feature issues, preferably with test cases included
+* Contribute to the documentation
+
+Issues
+------
+
+Please **do not use the issue tracker to ask questions**. We will be happy to help you
+on [Dibi forum](https://forum.dibiphp.com).
+
+A good bug report shouldn't leave others needing to chase you up for more
+information. Please try to be as detailed as possible in your report.
+
+**Feature requests** are welcome. But take a moment to find out whether your idea
+fits with the scope and aims of the project. It's up to *you* to make a strong
+case to convince the project's developers of the merits of this feature.
+
+Contributing
+------------
+
+The best way to propose a feature is to discuss your ideas on [Dibi forum](https://forum.dibiphp.com) before implementing them.
+
+Please do not fix whitespace, format code, or make a purely cosmetic patch.
+
+Thanks! :heart:

dibi/bridges/Nette/DibiNette20Extension.php

@@ -1,56 +0,0 @@
-<?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 2.0. Creates 'connection' service.
- *
- * @author     David Grudl
- * @package    dibi\nette
- * @phpversion 5.3
- */
-class DibiNette20Extension 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('DibiNettePanel::renderException'));
-
-			$connection->addSetup('$service->onEvent[] = ?', array(array($panel, 'logEvent')));
-		}
-	}
-
-}

dibi/bridges/Nette/DibiNette21Extension.php

@@ -1,56 +0,0 @@
-<?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 2.1. Creates 'connection' service.
- *
- * @author     David Grudl
- * @package    dibi\nette
- * @phpversion 5.3
- */
-class DibiNette21Extension extends Nette\DI\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::getBar()->addPanel(?)', array('@self'))
-				->addSetup('Nette\Diagnostics\Debugger::getBlueScreen()->addPanel(?)', array('DibiNettePanel::renderException'));
-
-			$connection->addSetup('$service->onEvent[] = ?', array(array($panel, 'logEvent')));
-		}
-	}
-
-}

dibi/bridges/Nette/DibiNettePanel.php

@@ -1,177 +0,0 @@
-<?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') && is_callable('NDebugger::getBlueScreen')) { // Nette Framework 2.1
-			NDebugger::getBar()->addPanel($this);
-			NDebugger::getBlueScreen()->addPanel(array(__CLASS__, 'renderException'));
-			$connection->onEvent[] = array($this, 'logEvent');
-
-		} elseif (is_callable('NDebugger::enable')) { // Nette Framework 2.0 (for PHP 5.3 or PHP 5.2 prefixed)
-			NDebugger::$bar && NDebugger::$bar->addPanel($this);
-			NDebugger::$blueScreen && NDebugger::$blueScreen->addPanel(array(__CLASS__, 'renderException'), __CLASS__);
-			$connection->onEvent[] = array($this, 'logEvent');
-
-		} elseif (is_callable('Debugger::enable') && !is_callable('Debugger::getBlueScreen')) { // Nette Framework 2.0 for PHP 5.2 non-prefixed
-			Debugger::$bar && Debugger::$bar->addPanel($this);
-			Debugger::$blueScreen && Debugger::$blueScreen->addPanel(array(__CLASS__, '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 static 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='#nette-debug-DibiProfiler-row-$counter' class='nette-toggler nette-toggle-collapsed' rel='#nette-debug-DibiProfiler-row-$counter'>explain</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/bridges/Nette/examples/config.nette-2.0.neon

@@ -1,17 +0,0 @@
-#    Requires Nette Framework 2.0 for PHP 5.3
-#
-#    In bootstrap.php append these lines after line $configurator = new Nette\Config\Configurator;
-#
-#        $configurator->onCompile[] = function($configurator, $compiler) {
-#            $compiler->addExtension('dibi', new DibiNette20Extension);
-#        };
-#
-#    This will create service named 'dibi.connection'.
-
-common:
-	dibi:
-		host: localhost
-		username: root
-		password: ***
-		database: foo
-		lazy: TRUE

dibi/dibi.php

@@ -1,681 +0,0 @@
-<?php
-
-/**
- * dibi - smart database abstraction layer (http://dibiphp.com)
- *
- * Copyright (c) 2005, 2012 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.
- */
-
-
-/**
- * Check PHP configuration.
- */
-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 @
-
-
-
-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/DibiDataSource.php';
-require_once dirname(__FILE__) . '/libs/DibiFluent.php';
-require_once dirname(__FILE__) . '/libs/DibiDatabaseInfo.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__) . '/bridges/Nette/DibiNettePanel.php';
-}
-
-
-
-
-
-/**
- * Interface for database drivers.
- *
- * This class is static container class for creating DB objects and
- * store connections info.
- *
- * @author     David Grudl
- * @package    dibi
- */
-class dibi
-{
-	/** column type */
-	const TEXT = 's', // as 'string'
-		BINARY = 'bin',
-		BOOL = 'b',
-		INTEGER = 'i',
-		FLOAT = 'f',
-		DATE = 'd',
-		DATETIME = 't',
-		TIME = 't';
-
-	const IDENTIFIER = 'n';
-
-	/** @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;
-
-	/** version */
-	const VERSION = '2.1.0',
-		REVISION = '$WCREV$ released on $WCDATE$';
-
-	/** sorting order */
-	const ASC = 'ASC',
-		DESC = 'DESC';
-
-	/** @var DibiConnection[]  Connection registry storage for DibiConnection objects */
-	private static $registry = array();
-
-	/** @var DibiConnection  Current connection */
-	private static $connection;
-
-	/** @var array  @see addHandler */
-	private static $handlers = array();
-
-	/** @var string  Last SQL command @see dibi::query() */
-	public static $sql;
-
-	/** @var int  Elapsed time for last query */
-	public static $elapsedTime;
-
-	/** @var int  Elapsed time for all queries */
-	public static $totalTime;
-
-	/** @var int  Number or queries */
-	public static $numOfQueries = 0;
-
-	/** @var string  Default dibi driver */
-	public static $defaultDriver = 'mysql';
-
-
-
-	/**
-	 * Static class - cannot be instantiated.
-	 */
-	final public function __construct()
-	{
-		throw new LogicException("Cannot instantiate static class " . get_class($this));
-	}
-
-
-
-	/********************* connections handling ****************d*g**/
-
-
-
-	/**
-	 * Creates a new DibiConnection object and connects it to specified database.
-	 * @param  mixed   connection parameters
-	 * @param  string  connection name
-	 * @return DibiConnection
-	 * @throws DibiException
-	 */
-	public static function connect($config = array(), $name = 0)
-	{
-		return self::$connection = self::$registry[$name] = new DibiConnection($config, $name);
-	}
-
-
-
-	/**
-	 * Disconnects from database (doesn't destroy DibiConnection object).
-	 * @return void
-	 */
-	public static function disconnect()
-	{
-		self::getConnection()->disconnect();
-	}
-
-
-
-	/**
-	 * Returns TRUE when connection was established.
-	 * @return bool
-	 */
-	public static function isConnected()
-	{
-		return (self::$connection !== NULL) && self::$connection->isConnected();
-	}
-
-
-
-	/**
-	 * Retrieve active connection.
-	 * @param  string   connection registy name
-	 * @return DibiConnection
-	 * @throws DibiException
-	 */
-	public static function getConnection($name = NULL)
-	{
-		if ($name === NULL) {
-			if (self::$connection === NULL) {
-				throw new DibiException('Dibi is not connected to database.');
-			}
-
-			return self::$connection;
-		}
-
-		if (!isset(self::$registry[$name])) {
-			throw new DibiException("There is no connection named '$name'.");
-		}
-
-		return self::$registry[$name];
-	}
-
-
-
-	/**
-	 * Sets connection.
-	 * @param  DibiConnection
-	 * @return DibiConnection
-	 */
-	public static function setConnection(DibiConnection $connection)
-	{
-		return self::$connection = $connection;
-	}
-
-
-
-	/**
-	 * Change active connection.
-	 * @param  string   connection registy name
-	 * @return void
-	 * @throws DibiException
-	 */
-	public static function activate($name)
-	{
-		self::$connection = self::getConnection($name);
-	}
-
-
-
-	/********************* monostate for active connection ****************d*g**/
-
-
-
-	/**
-	 * Generates and executes SQL query - Monostate for DibiConnection::query().
-	 * @param  array|mixed      one or more arguments
-	 * @return DibiResult|int   result set object (if any)
-	 * @throws DibiException
-	 */
-	public static function query($args)
-	{
-		$args = func_get_args();
-		return self::getConnection()->query($args);
-	}
-
-
-
-	/**
-	 * Executes the SQL query - Monostate for DibiConnection::nativeQuery().
-	 * @param  string           SQL statement.
-	 * @return DibiResult|int   result set object (if any)
-	 */
-	public static function nativeQuery($sql)
-	{
-		return self::getConnection()->nativeQuery($sql);
-	}
-
-
-
-	/**
-	 * Generates and prints SQL query - Monostate for DibiConnection::test().
-	 * @param  array|mixed  one or more arguments
-	 * @return bool
-	 */
-	public static function test($args)
-	{
-		$args = func_get_args();
-		return self::getConnection()->test($args);
-	}
-
-
-
-	/**
-	 * 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
-	 * @return DibiRow
-	 * @throws DibiException
-	 */
-	public static function fetch($args)
-	{
-		$args = func_get_args();
-		return self::getConnection()->query($args)->fetch();
-	}
-
-
-
-	/**
-	 * Executes SQL query and fetch results - Monostate for DibiConnection::query() & fetchAll().
-	 * @param  array|mixed    one or more arguments
-	 * @return array of DibiRow
-	 * @throws DibiException
-	 */
-	public static function fetchAll($args)
-	{
-		$args = func_get_args();
-		return self::getConnection()->query($args)->fetchAll();
-	}
-
-
-
-	/**
-	 * Executes SQL query and fetch first column - Monostate for DibiConnection::query() & fetchSingle().
-	 * @param  array|mixed    one or more arguments
-	 * @return string
-	 * @throws DibiException
-	 */
-	public static function fetchSingle($args)
-	{
-		$args = func_get_args();
-		return self::getConnection()->query($args)->fetchSingle();
-	}
-
-
-
-	/**
-	 * Executes SQL query and fetch pairs - Monostate for DibiConnection::query() & fetchPairs().
-	 * @param  array|mixed    one or more arguments
-	 * @return string
-	 * @throws DibiException
-	 */
-	public static function fetchPairs($args)
-	{
-		$args = func_get_args();
-		return self::getConnection()->query($args)->fetchPairs();
-	}
-
-
-
-	/**
-	 * Gets the number of affected rows.
-	 * 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()->getAffectedRows();
-	}
-
-
-
-	/**
-	 * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query.
-	 * 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()->getInsertId($sequence);
-	}
-
-
-
-	/**
-	 * Begins a transaction - Monostate for DibiConnection::begin().
-	 * @param  string  optional savepoint name
-	 * @return void
-	 * @throws DibiException
-	 */
-	public static function begin($savepoint = NULL)
-	{
-		self::getConnection()->begin($savepoint);
-	}
-
-
-
-	/**
-	 * Commits statements in a transaction - Monostate for DibiConnection::commit($savepoint = NULL).
-	 * @param  string  optional savepoint name
-	 * @return void
-	 * @throws DibiException
-	 */
-	public static function commit($savepoint = NULL)
-	{
-		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($savepoint = NULL)
-	{
-		self::getConnection()->rollback($savepoint);
-	}
-
-
-
-	/**
-	 * Gets a information about the current database - Monostate for DibiConnection::getDatabaseInfo().
-	 * @return DibiDatabaseInfo
-	 */
-	public static function getDatabaseInfo()
-	{
-		return self::getConnection()->getDatabaseInfo();
-	}
-
-
-
-	/**
-	 * Import SQL dump from file - extreme fast!
-	 * @param  string  filename
-	 * @return int  count of sql commands
-	 */
-	public static function loadFile($file)
-	{
-		return self::getConnection()->loadFile($file);
-	}
-
-
-
-	/**
-	 * Replacement for majority of dibi::methods() in future.
-	 */
-	public static function __callStatic($name, $args)
-	{
-		//if ($name = 'select', 'update', ...') {
-		//	return self::command()->$name($args);
-		//}
-		return call_user_func_array(array(self::getConnection(), $name), $args);
-	}
-
-
-
-	/********************* fluent SQL builders ****************d*g**/
-
-
-
-	/**
-	 * @return DibiFluent
-	 */
-	public static function command()
-	{
-		return self::getConnection()->command();
-	}
-
-
-
-	/**
-	 * @param  string    column name
-	 * @return DibiFluent
-	 */
-	public static function select($args)
-	{
-		$args = func_get_args();
-		return call_user_func_array(array(self::getConnection(), 'select'), $args);
-	}
-
-
-
-	/**
-	 * @param  string   table
-	 * @param  array
-	 * @return DibiFluent
-	 */
-	public static function update($table, $args)
-	{
-		return self::getConnection()->update($table, $args);
-	}
-
-
-
-	/**
-	 * @param  string   table
-	 * @param  array
-	 * @return DibiFluent
-	 */
-	public static function insert($table, $args)
-	{
-		return self::getConnection()->insert($table, $args);
-	}
-
-
-
-	/**
-	 * @param  string   table
-	 * @return DibiFluent
-	 */
-	public static function delete($table)
-	{
-		return self::getConnection()->delete($table);
-	}
-
-
-
-	/********************* data types ****************d*g**/
-
-
-
-	/**
-	 * @return DibiDateTime
-	 */
-	public static function datetime($time = NULL)
-	{
-		trigger_error(__METHOD__ . '() is deprecated; create DibiDateTime object instead.', E_USER_WARNING);
-		return new DibiDateTime($time);
-	}
-
-
-
-	/**
-	 * @deprecated
-	 */
-	public static function date($date = NULL)
-	{
-		trigger_error(__METHOD__ . '() is deprecated; create DibiDateTime object instead.', E_USER_WARNING);
-		return new DibiDateTime($date);
-	}
-
-
-
-	/********************* substitutions ****************d*g**/
-
-
-
-	/**
-	 * Returns substitution hashmap - Monostate for DibiConnection::getSubstitutes().
-	 * @return DibiHashMap
-	 */
-	public static function getSubstitutes()
-	{
-		return self::getConnection()->getSubstitutes();
-	}
-
-
-
-	/** @deprecated */
-	public static function addSubst($expr, $subst)
-	{
-		trigger_error(__METHOD__ . '() is deprecated; use dibi::getSubstitutes()->expr = val; instead.', E_USER_WARNING);
-		self::getSubstitutes()->$expr = $subst;
-	}
-
-
-
-	/** @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) {
-			foreach ($substitutes as $expr => $foo) {
-				unset($substitutes->$expr);
-			}
-		} else {
-			unset($substitutes->$expr);
-		}
-	}
-
-
-
-	/** @deprecated */
-	public static function setSubstFallback($callback)
-	{
-		trigger_error(__METHOD__ . '() is deprecated; use dibi::getSubstitutes()->setCallback() instead.', E_USER_WARNING);
-		self::getSubstitutes()->setCallback($callback);
-	}
-
-
-
-	/********************* misc tools ****************d*g**/
-
-
-
-	/**
-	 * Prints out a syntax highlighted version of the SQL command or DibiResult.
-	 * @param  string|DibiResult
-	 * @param  bool  return output instead of printing it?
-	 * @return string
-	 */
-	public static function dump($sql = NULL, $return = FALSE)
-	{
-		ob_start();
-		if ($sql instanceof DibiResult) {
-			$sql->dump();
-
-		} else {
-			if ($sql === NULL) $sql = self::$sql;
-
-			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 = preg_replace("#(?<=[\\s,(])($keywords1)(?=[\\s,)])#i", "\n\$1", $sql);
-
-			// reduce spaces
-			$sql = preg_replace('#[ \t]{2,}#', " ", $sql);
-
-			$sql = wordwrap($sql, 100);
-			$sql = preg_replace("#([ \t]*\r?\n){2,}#", "\n", $sql);
-
-			// syntax highlight
-			$highlighter = "#(/\\*.+?\\*/)|(\\*\\*.+?\\*\\*)|(?<=[\\s,(])($keywords1)(?=[\\s,)])|(?<=[\\s,(=])($keywords2)(?=[\\s,)=])#is";
-			if (PHP_SAPI === 'cli') {
-				if (substr(getenv('TERM'), 0, 5) === 'xterm') {
-					$sql = preg_replace_callback($highlighter, array('dibi', 'cliHighlightCallback'), $sql);
-				}
-				echo trim($sql) . "\n\n";
-
-			} else {
-				$sql = htmlSpecialChars($sql);
-				$sql = preg_replace_callback($highlighter, array('dibi', 'highlightCallback'), $sql);
-				echo '<pre class="dump">', trim($sql), "</pre>\n\n";
-			}
-		}
-
-		if ($return) {
-			return ob_get_clean();
-		} else {
-			ob_end_flush();
-		}
-	}
-
-
-
-	private static function highlightCallback($matches)
-	{
-		if (!empty($matches[1])) { // comment
-			return '<em style="color:gray">' . $matches[1] . '</em>';
-
-		} elseif (!empty($matches[2])) { // error
-			return '<strong style="color:red">' . $matches[2] . '</strong>';
-
-		} elseif (!empty($matches[3])) { // most important keywords
-			return '<strong style="color:blue">' . $matches[3] . '</strong>';
-
-		} elseif (!empty($matches[4])) { // other keywords
-			return '<strong style="color:green">' . $matches[4] . '</strong>';
-		}
-	}
-
-
-
-	private static function cliHighlightCallback($matches)
-	{
-		if (!empty($matches[1])) { // comment
-			return "\033[1;30m" . $matches[1] . "\033[0m";
-
-		} elseif (!empty($matches[2])) { // error
-			return "\033[1;31m" . $matches[2] . "\033[0m";
-
-		} elseif (!empty($matches[3])) { // most important keywords
-			return "\033[1;34m" . $matches[3] . "\033[0m";
-
-		} elseif (!empty($matches[4])) { // other keywords
-			return "\033[1;32m" . $matches[4] . "\033[0m";
-		}
-	}
-
-}

dibi/drivers/DibiMsSql2005Driver.php

@@ -1,407 +0,0 @@
-<?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__) . '/DibiMsSql2005Reflector.php';
-
-
-/**
- * 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 {
-			// Default values
-			if (!isset($config['options']['CharacterSet'])) $config['options']['CharacterSet'] = 'UTF-8';
-
-			$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()
-	{
-		return new DibiMssql2005Reflector($this);
-	}
-
-
-
-	/**
-	 * 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(']', ']]', $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 . ') AS T ';
-		}
-
-		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/DibiMySqlReflector.php

@@ -1,129 +0,0 @@
-<?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/DibiOracleDriver.php

@@ -1,474 +0,0 @@
-<?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 Oracle database.
- *
- * 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
- *   - persistent => Creates persistent connections with oci_pconnect instead of oci_new_connect
- *   - lazy, profiler, result, substitutes, ... => see DibiConnection options
- *
- * @author     David Grudl
- * @package    dibi\drivers
- */
-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 DibiNotSupportedException
-	 */
-	public function __construct()
-	{
-		if (!extension_loaded('oci8')) {
-			throw new DibiNotSupportedException("PHP extension 'oci8' is not loaded.");
-		}
-	}
-
-
-
-	/**
-	 * Connects to a database.
-	 * @return void
-	 * @throws DibiException
-	 */
-	public function connect(array &$config)
-	{
-		$foo = & $config['charset'];
-		$this->fmtDate = isset($config['formatDate']) ? $config['formatDate'] : 'U';
-		$this->fmtDateTime = isset($config['formatDateTime']) ? $config['formatDateTime'] : 'U';
-
-		if (isset($config['resource'])) {
-			$this->connection = $config['resource'];
-		} elseif (empty($config['persistent'])) {
-			$this->connection = @oci_new_connect($config['username'], $config['password'], $config['database'], $config['charset']); // intentionally @
-		} else {
-			$this->connection = @oci_pconnect($config['username'], $config['password'], $config['database'], $config['charset']); // intentionally @
-		}
-
-		if (!$this->connection) {
-			$err = oci_error();
-			throw new DibiDriverException($err['message'], $err['code']);
-		}
-	}
-
-
-
-	/**
-	 * Disconnects from a database.
-	 * @return void
-	 */
-	public function disconnect()
-	{
-		oci_close($this->connection);
-	}
-
-
-
-	/**
-	 * Executes the SQL query.
-	 * @param  string      SQL statement.
-	 * @return IDibiResultDriver|NULL
-	 * @throws DibiDriverException
-	 */
-	public function query($sql)
-	{
-		$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);
-		}
-	}
-
-
-
-	/**
-	 * 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()
-	{
-		throw new DibiNotImplementedException;
-	}
-
-
-
-	/**
-	 * 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)
-	{
-		$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
-	 */
-	public function begin($savepoint = NULL)
-	{
-		$this->autocommit = FALSE;
-	}
-
-
-
-	/**
-	 * Commits statements in a transaction.
-	 * @param  string  optional savepoint name
-	 * @return void
-	 * @throws DibiDriverException
-	 */
-	public function commit($savepoint = NULL)
-	{
-		if (!oci_commit($this->connection)) {
-			$err = oci_error($this->connection);
-			throw new DibiDriverException($err['message'], $err['code']);
-		}
-		$this->autocommit = TRUE;
-	}
-
-
-
-	/**
-	 * Rollback changes in a transaction.
-	 * @param  string  optional savepoint name
-	 * @return void
-	 * @throws DibiDriverException
-	 */
-	public function rollback($savepoint = NULL)
-	{
-		if (!oci_rollback($this->connection)) {
-			$err = oci_error($this->connection);
-			throw new DibiDriverException($err['message'], $err['code']);
-		}
-		$this->autocommit = TRUE;
-	}
-
-
-
-	/**
-	 * 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()
-	{
-		return $this;
-	}
-
-
-
-	/**
-	 * 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) . "'"; // TODO: not tested
-
-		case dibi::IDENTIFIER:
-			// @see http://download.oracle.com/docs/cd/B10500_01/server.920/a96540/sql_elements9a.htm
-			return '"' . str_replace('"', '""', $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(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::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 ($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;
-		}
-	}
-
-
-
-	/********************* 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 oci_fetch_array($this->resultSet, ($assoc ? OCI_ASSOC : OCI_NUM) | OCI_RETURN_NULLS);
-	}
-
-
-
-	/**
-	 * 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 DibiNotImplementedException;
-	}
-
-
-
-	/**
-	 * Frees the resources allocated for this result set.
-	 * @return void
-	 */
-	public function free()
-	{
-		oci_free_statement($this->resultSet);
-		$this->resultSet = NULL;
-	}
-
-
-
-	/**
-	 * Returns metadata for all columns in a result set.
-	 * @return array
-	 */
-	public function getResultColumns()
-	{
-		$count = oci_num_fields($this->resultSet);
-		$columns = array();
-		for ($i = 1; $i <= $count; $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 $columns;
-	}
-
-
-
-	/**
-	 * Returns the result set resource.
-	 * @return mixed
-	 */
-	public function getResultResource()
-	{
-		$this->autoFree = FALSE;
-		return is_resource($this->resultSet) ? $this->resultSet : NULL;
-	}
-
-
-
-	/********************* IDibiReflector ****************d*g**/
-
-
-
-	/**
-	 * Returns list of tables.
-	 * @return array
-	 */
-	public function getTables()
-	{
-		$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;
-	}
-
-
-
-	/**
-	 * Returns metadata for all columns in a table.
-	 * @param  string
-	 * @return array
-	 */
-	public function getColumns($table)
-	{
-		throw new DibiNotImplementedException;
-	}
-
-
-
-	/**
-	 * Returns metadata for all indexes in a table.
-	 * @param  string
-	 * @return array
-	 */
-	public function getIndexes($table)
-	{
-		throw new DibiNotImplementedException;
-	}
-
-
-
-	/**
-	 * Returns metadata for all foreign keys in a table.
-	 * @param  string
-	 * @return array
-	 */
-	public function getForeignKeys($table)
-	{
-		throw new DibiNotImplementedException;
-	}
-
-}

dibi/drivers/DibiPdoDriver.php

@@ -1,485 +0,0 @@
-<?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__) . '/DibiMySqlReflector.php';
-require_once dirname(__FILE__) . '/DibiSqliteReflector.php';
-
-
-/**
- * The dibi driver for PDO.
- *
- * 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
- * @package    dibi\drivers
- */
-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 DibiNotSupportedException
-	 */
-	public function __construct()
-	{
-		if (!extension_loaded('pdo')) {
-			throw new DibiNotSupportedException("PHP extension 'pdo' is not loaded.");
-		}
-	}
-
-
-
-	/**
-	 * Connects to a database.
-	 * @return void
-	 * @throws DibiException
-	 */
-	public function connect(array &$config)
-	{
-		$foo = & $config['dsn'];
-		$foo = & $config['options'];
-		DibiConnection::alias($config, 'resource', 'pdo');
-
-		if ($config['resource'] instanceof PDO) {
-			$this->connection = $config['resource'];
-
-		} else try {
-			$this->connection = new PDO($config['dsn'], $config['username'], $config['password'], $config['options']);
-
-		} catch (PDOException $e) {
-			throw new DibiDriverException($e->getMessage(), $e->getCode());
-		}
-
-		if (!$this->connection) {
-			throw new DibiDriverException('Connecting error.');
-		}
-
-		$this->driverName = $this->connection->getAttribute(PDO::ATTR_DRIVER_NAME);
-	}
-
-
-
-	/**
-	 * Disconnects from a database.
-	 * @return void
-	 */
-	public function disconnect()
-	{
-		$this->connection = NULL;
-	}
-
-
-
-	/**
-	 * Executes the SQL query.
-	 * @param  string      SQL statement.
-	 * @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));
-		static $list = array('UPDATE'=>1, 'DELETE'=>1, 'INSERT'=>1, 'REPLAC'=>1);
-		$this->affectedRows = FALSE;
-
-		if (isset($list[$cmd])) {
-			$this->affectedRows = $this->connection->exec($sql);
-
-			if ($this->affectedRows === FALSE) {
-				$err = $this->connection->errorInfo();
-				throw new DibiDriverException("SQLSTATE[$err[0]]: $err[2]", $err[1], $sql);
-			}
-
-		} else {
-			$res = $this->connection->query($sql);
-
-			if ($res === FALSE) {
-				$err = $this->connection->errorInfo();
-				throw new DibiDriverException("SQLSTATE[$err[0]]: $err[2]", $err[1], $sql);
-			} else {
-				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)
-	{
-		return $this->connection->lastInsertId();
-	}
-
-
-
-	/**
-	 * Begins a transaction (if supported).
-	 * @param  string  optional savepoint name
-	 * @return void
-	 * @throws DibiDriverException
-	 */
-	public function begin($savepoint = NULL)
-	{
-		if (!$this->connection->beginTransaction()) {
-			$err = $this->connection->errorInfo();
-			throw new DibiDriverException("SQLSTATE[$err[0]]: $err[2]", $err[1]);
-		}
-	}
-
-
-
-	/**
-	 * Commits statements in a transaction.
-	 * @param  string  optional savepoint name
-	 * @return void
-	 * @throws DibiDriverException
-	 */
-	public function commit($savepoint = NULL)
-	{
-		if (!$this->connection->commit()) {
-			$err = $this->connection->errorInfo();
-			throw new DibiDriverException("SQLSTATE[$err[0]]: $err[2]", $err[1]);
-		}
-	}
-
-
-
-	/**
-	 * Rollback changes in a transaction.
-	 * @param  string  optional savepoint name
-	 * @return void
-	 * @throws DibiDriverException
-	 */
-	public function rollback($savepoint = NULL)
-	{
-		if (!$this->connection->rollBack()) {
-			$err = $this->connection->errorInfo();
-			throw new DibiDriverException("SQLSTATE[$err[0]]: $err[2]", $err[1]);
-		}
-	}
-
-
-
-	/**
-	 * Returns the connection resource.
-	 * @return PDO
-	 */
-	public function getResource()
-	{
-		return $this->connection;
-	}
-
-
-
-	/**
-	 * 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 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->quote($value, PDO::PARAM_STR);
-
-		case dibi::BINARY:
-			return $this->connection->quote($value, PDO::PARAM_LOB);
-
-		case dibi::IDENTIFIER:
-			switch ($this->driverName) {
-			case 'mysql':
-				return '`' . str_replace('`', '``', $value) . '`';
-
-			case 'pgsql':
-				return '"' . str_replace('"', '""', $value) . '"';
-
-			case 'sqlite':
-			case 'sqlite2':
-				return '[' . strtr($value, '[]', '  ') . ']';
-
-			case 'odbc':
-			case 'oci': // TODO: not tested
-			case 'mssql':
-				return '[' . str_replace(array('[', ']'), array('[[', ']]'), $value) . ']';
-
-			case 'sqlsrv':
-				return '[' . str_replace(']', ']]', $value) . ']';
-
-			default:
-				return $value;
-			}
-
-		case dibi::BOOL:
-			return $this->connection->quote($value, PDO::PARAM_BOOL);
-
-		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;
-
-		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':
-		case 'sqlsrv':
-			if ($offset < 1) {
-				$sql = 'SELECT TOP ' . (int) $limit . ' * FROM (' . $sql . ') t';
-				break;
-			}
-			// intentionally break omitted
-
-		default:
-			throw new DibiNotSupportedException('PDO or driver does not support applying limit or offset.');
-		}
-	}
-
-
-
-	/********************* result set ****************d*g**/
-
-
-
-	/**
-	 * Returns the number of rows in a result set.
-	 * @return int
-	 */
-	public function getRowCount()
-	{
-		return $this->resultSet->rowCount();
-	}
-
-
-
-	/**
-	 * 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 $this->resultSet->fetch($assoc ? PDO::FETCH_ASSOC : PDO::FETCH_NUM);
-	}
-
-
-
-	/**
-	 * 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()
-	{
-		$this->resultSet = NULL;
-	}
-
-
-
-	/**
-	 * Returns metadata for all columns in a result set.
-	 * @return array
-	 * @throws DibiException
-	 */
-	public function getResultColumns()
-	{
-		$count = $this->resultSet->columnCount();
-		$columns = array();
-		for ($i = 0; $i < $count; $i++) {
-			$row = @$this->resultSet->getColumnMeta($i); // intentionally @
-			if ($row === FALSE) {
-				throw new DibiNotSupportedException('Driver does not support meta data.');
-			}
-			// 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'],
-				'fullname' => $row['table'] ? $row['table'] . '.' . $row['name'] : $row['name'],
-				'vendor' => $row,
-			);
-		}
-		return $columns;
-	}
-
-
-
-	/**
-	 * Returns the result set resource.
-	 * @return PDOStatement
-	 */
-	public function getResultResource()
-	{
-		return $this->resultSet;
-	}
-
-}

dibi/drivers/DibiPostgreDriver.php

@@ -1,664 +0,0 @@
-<?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 PostgreSQL database.
- *
- * 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
- * @package    dibi\drivers
- */
-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;
-
-
-
-	/**
-	 * @throws DibiNotSupportedException
-	 */
-	public function __construct()
-	{
-		if (!extension_loaded('pgsql')) {
-			throw new DibiNotSupportedException("PHP extension 'pgsql' is not loaded.");
-		}
-	}
-
-
-
-	/**
-	 * Connects to a database.
-	 * @return void
-	 * @throws DibiException
-	 */
-	public function connect(array &$config)
-	{
-		if (isset($config['resource'])) {
-			$this->connection = $config['resource'];
-
-		} else {
-			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)) {
-			throw new DibiDriverException('Connecting error.');
-		}
-
-		if (isset($config['charset'])) {
-			DibiDriverException::tryError();
-			pg_set_client_encoding($this->connection, $config['charset']);
-			if (DibiDriverException::catchError($msg)) {
-				throw new DibiDriverException($msg, 0);
-			}
-		}
-
-		if (isset($config['schema'])) {
-			$this->query('SET search_path TO "' . $config['schema'] . '"');
-		}
-
-		$this->escMethod = version_compare(PHP_VERSION , '5.2.0', '>=');
-	}
-
-
-
-	/**
-	 * Disconnects from a database.
-	 * @return void
-	 */
-	public function disconnect()
-	{
-		pg_close($this->connection);
-	}
-
-
-
-	/**
-	 * Executes the SQL query.
-	 * @param  string      SQL statement.
-	 * @return IDibiResultDriver|NULL
-	 * @throws DibiDriverException
-	 */
-	public function query($sql)
-	{
-		$this->affectedRows = FALSE;
-		$res = @pg_query($this->connection, $sql); // intentionally @
-
-		if ($res === FALSE) {
-			throw new DibiDriverException(pg_last_error($this->connection), 0, $sql);
-
-		} elseif (is_resource($res)) {
-			$this->affectedRows = pg_affected_rows($res);
-			if (pg_num_fields($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)
-	{
-		if ($sequence === NULL) {
-			// PostgreSQL 8.1 is needed
-			$res = $this->query("SELECT LASTVAL()");
-		} else {
-			$res = $this->query("SELECT CURRVAL('$sequence')");
-		}
-
-		if (!$res) return FALSE;
-
-		$row = $res->fetch(FALSE);
-		return is_array($row) ? $row[0] : FALSE;
-	}
-
-
-
-	/**
-	 * Begins a transaction (if supported).
-	 * @param  string  optional savepoint name
-	 * @return void
-	 * @throws DibiDriverException
-	 */
-	public function begin($savepoint = NULL)
-	{
-		$this->query($savepoint ? "SAVEPOINT $savepoint" : 'START TRANSACTION');
-	}
-
-
-
-	/**
-	 * 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');
-	}
-
-
-
-	/**
-	 * Is in transaction?
-	 * @return bool
-	 */
-	public function inTransaction()
-	{
-		return !in_array(pg_transaction_status($this->connection), array(PGSQL_TRANSACTION_UNKNOWN, PGSQL_TRANSACTION_IDLE), TRUE);
-	}
-
-
-
-	/**
-	 * 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()
-	{
-		return $this;
-	}
-
-
-
-	/**
-	 * 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:
-			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::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) . "'";
-			}
-
-		case dibi::IDENTIFIER:
-			// @see http://www.postgresql.org/docs/8.2/static/sql-syntax-lexical.html#SQL-SYNTAX-IDENTIFIERS
-			return '"' . str_replace('"', '""', $value) . '"';
-
-		case dibi::BOOL:
-			return $value ? 'TRUE' : 'FALSE';
-
-		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)
-	{
-		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::BINARY)
-	 * @return string    decoded value
-	 * @throws InvalidArgumentException
-	 */
-	public function unescape($value, $type)
-	{
-		if ($type === dibi::BINARY) {
-			return pg_unescape_bytea($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)
-			$sql .= ' LIMIT ' . (int) $limit;
-
-		if ($offset > 0)
-			$sql .= ' OFFSET ' . (int) $offset;
-	}
-
-
-
-	/********************* 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()
-	{
-		return pg_num_rows($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)
-	{
-		return pg_fetch_array($this->resultSet, NULL, $assoc ? PGSQL_ASSOC : PGSQL_NUM);
-	}
-
-
-
-	/**
-	 * 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)
-	{
-		return pg_result_seek($this->resultSet, $row);
-	}
-
-
-
-	/**
-	 * Frees the resources allocated for this result set.
-	 * @return void
-	 */
-	public function free()
-	{
-		pg_free_result($this->resultSet);
-		$this->resultSet = NULL;
-	}
-
-
-
-	/**
-	 * Returns metadata for all columns in a result set.
-	 * @return array
-	 */
-	public function getResultColumns()
-	{
-		$hasTable = version_compare(PHP_VERSION , '5.2.0', '>=');
-		$count = pg_num_fields($this->resultSet);
-		$columns = array();
-		for ($i = 0; $i < $count; $i++) {
-			$row = array(
-				'name'      => pg_field_name($this->resultSet, $i),
-				'table'     => $hasTable ? pg_field_table($this->resultSet, $i) : NULL,
-				'nativetype'=> pg_field_type($this->resultSet, $i),
-			);
-			$row['fullname'] = $row['table'] ? $row['table'] . '.' . $row['name'] : $row['name'];
-			$columns[] = $row;
-		}
-		return $columns;
-	}
-
-
-
-	/**
-	 * Returns the result set resource.
-	 * @return mixed
-	 */
-	public function getResultResource()
-	{
-		$this->autoFree = FALSE;
-		return is_resource($this->resultSet) ? $this->resultSet : NULL;
-	}
-
-
-
-	/********************* IDibiReflector ****************d*g**/
-
-
-
-	/**
-	 * Returns list of tables.
-	 * @return array
-	 */
-	public function getTables()
-	{
-		$version = pg_parameter_status($this->resource, 'server_version');
-		if ($version < 7.4) {
-			throw new DibiDriverException('Reflection requires PostgreSQL 7.4 and newer.');
-		}
-
-		$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()
-		");
-		$tables = pg_fetch_all($res->resultSet);
-		return $tables ? $tables : array();
-	}
-
-
-
-	/**
-	 * Returns metadata for all columns in a table.
-	 * @param  string
-	 * @return array
-	 */
-	public function getColumns($table)
-	{
-		$_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($res->resultSet)->indkey;
-
-		$res = $this->query("
-			SELECT *
-			FROM information_schema.columns
-			WHERE table_name = $_table AND table_schema = current_schema()
-			ORDER BY ordinal_position
-		");
-		$columns = array();
-		while ($row = $res->fetch(TRUE)) {
-			$size = (int) max($row['character_maximum_length'], $row['numeric_precision']);
-			$columns[] = array(
-				'name' => $row['column_name'],
-				'table' => $table,
-				'nativetype' => strtoupper($row['udt_name']),
-				'size' => $size ? $size : NULL,
-				'nullable' => $row['is_nullable'] === 'YES',
-				'default' => $row['column_default'],
-				'autoincrement' => (int) $row['ordinal_position'] === $primary && substr($row['column_default'], 0, 7) === 'nextval',
-				'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);
-		$res = $this->query("
-			SELECT ordinal_position, column_name
-			FROM information_schema.columns
-			WHERE table_name = $_table AND table_schema = current_schema()
-			ORDER BY ordinal_position
-		");
-
-		$columns = array();
-		while ($row = $res->fetch(TRUE)) {
-			$columns[$row['ordinal_position']] = $row['column_name'];
-		}
-
-		$res = $this->query("
-			SELECT pg_class2.relname, indisunique, indisprimary, indkey
-			FROM pg_class
-			LEFT JOIN pg_index on pg_class.oid = pg_index.indrelid
-			INNER JOIN pg_class as pg_class2 on pg_class2.oid = pg_index.indexrelid
-			WHERE pg_class.relname = $_table
-		");
-
-		$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) {
-				$indexes[$row['relname']]['columns'][] = $columns[$index];
-			}
-		}
-		return array_values($indexes);
-	}
-
-
-
-	/**
-	 * Returns metadata for all foreign keys in a table.
-	 * @param  string
-	 * @return array
-	 */
-	public function getForeignKeys($table)
-	{
-		$_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/DibiSqliteDriver.php

@@ -1,451 +0,0 @@
-<?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__) . '/DibiSqliteReflector.php';
-
-
-/**
- * The dibi driver for SQLite database.
- *
- * 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
- * @package    dibi\drivers
- */
-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 DibiNotSupportedException
-	 */
-	public function __construct()
-	{
-		if (!extension_loaded('sqlite')) {
-			throw new DibiNotSupportedException("PHP extension 'sqlite' 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';
-
-		$errorMsg = '';
-		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 @
-		}
-
-		if (!$this->connection) {
-			throw new DibiDriverException($errorMsg);
-		}
-
-		$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;
-		}
-	}
-
-
-
-	/**
-	 * Disconnects from a database.
-	 * @return void
-	 */
-	public function disconnect()
-	{
-		sqlite_close($this->connection);
-	}
-
-
-
-	/**
-	 * 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);
-		}
-
-		DibiDriverException::tryError();
-		if ($this->buffered) {
-			$res = sqlite_query($this->connection, $sql);
-		} else {
-			$res = sqlite_unbuffered_query($this->connection, $sql);
-		}
-		if (DibiDriverException::catchError($msg)) {
-			throw new DibiDriverException($msg, sqlite_last_error($this->connection), $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 sqlite_changes($this->connection);
-	}
-
-
-
-	/**
-	 * 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 sqlite_last_insert_rowid($this->connection);
-	}
-
-
-
-	/**
-	 * Begins a transaction (if supported).
-	 * @param  string  optional savepoint name
-	 * @return void
-	 * @throws DibiDriverException
-	 */
-	public function begin($savepoint = NULL)
-	{
-		$this->query('BEGIN');
-	}
-
-
-
-	/**
-	 * Commits statements in a transaction.
-	 * @param  string  optional savepoint name
-	 * @return void
-	 * @throws DibiDriverException
-	 */
-	public function commit($savepoint = NULL)
-	{
-		$this->query('COMMIT');
-	}
-
-
-
-	/**
-	 * Rollback changes in a transaction.
-	 * @param  string  optional savepoint name
-	 * @return void
-	 * @throws DibiDriverException
-	 */
-	public function rollback($savepoint = NULL)
-	{
-		$this->query('ROLLBACK');
-	}
-
-
-
-	/**
-	 * 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()
-	{
-		return new DibiSqliteReflector($this);
-	}
-
-
-
-	/**
-	 * 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 "'" . sqlite_escape_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)
-	{
-		throw new DibiNotSupportedException;
-	}
-
-
-
-	/**
-	 * 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**/
-
-
-
-	/**
-	 * Returns the number of rows in a result set.
-	 * @return int
-	 */
-	public function getRowCount()
-	{
-		if (!$this->buffered) {
-			throw new DibiNotSupportedException('Row count is not available for unbuffered queries.');
-		}
-		return sqlite_num_rows($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)
-	{
-		$row = sqlite_fetch_array($this->resultSet, $assoc ? SQLITE_ASSOC : SQLITE_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 DibiException
-	 */
-	public function seek($row)
-	{
-		if (!$this->buffered) {
-			throw new DibiNotSupportedException('Cannot seek an unbuffered result set.');
-		}
-		return sqlite_seek($this->resultSet, $row);
-	}
-
-
-
-	/**
-	 * Frees the resources allocated for this result set.
-	 * @return void
-	 */
-	public function free()
-	{
-		$this->resultSet = NULL;
-	}
-
-
-
-	/**
-	 * Returns metadata for all columns in a result set.
-	 * @return array
-	 */
-	public function getResultColumns()
-	{
-		$count = sqlite_num_fields($this->resultSet);
-		$columns = array();
-		for ($i = 0; $i < $count; $i++) {
-			$name = str_replace(array('[', ']'), '', sqlite_field_name($this->resultSet, $i));
-			$pair = explode('.', $name);
-			$columns[] = array(
-				'name'  => isset($pair[1]) ? $pair[1] : $pair[0],
-				'table' => isset($pair[1]) ? $pair[0] : NULL,
-				'fullname' => $name,
-				'nativetype' => NULL,
-			);
-		}
-		return $columns;
-	}
-
-
-
-	/**
-	 * Returns the result set resource.
-	 * @return mixed
-	 */
-	public function getResultResource()
-	{
-		return is_resource($this->resultSet) ? $this->resultSet : NULL;
-	}
-
-
-
-	/********************* 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)
-	{
-		sqlite_create_function($this->connection, $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)
-	{
-		sqlite_create_aggregate($this->connection, $name, $rowCallback, $agrCallback, $numArgs);
-	}
-
-}

dibi/libs/DibiConnection.php

@@ -1,732 +0,0 @@
-<?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 connection.
- *
- * @author     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 */
-	private $driver;
-
-	/** @var DibiTranslator */
-	private $translator;
-
-	/** @var bool  Is connected? */
-	private $connected = FALSE;
-
-	/** @var DibiHashMap Substitutes for identifiers */
-	private $substitutes;
-
-
-
-	/**
-	 * 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)
-	{
-		class_exists('dibi'); // ensure class dibi is loaded
-
-		// DSN string
-		if (is_string($config)) {
-			parse_str($config, $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 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;
-		}
-
-		$class = preg_replace(array('#\W#', '#sql#'), array('_', 'Sql'), ucfirst(strtolower($config['driver'])));
-		$class = "Dibi{$class}Driver";
-		if (!class_exists($class, FALSE)) {
-			include_once dirname(__FILE__) . "/../drivers/$class.php";
-
-			if (!class_exists($class, FALSE)) {
-				throw new DibiException("Unable to create instance of dibi driver '$class'.");
-			}
-		}
-
-		$config['name'] = $name;
-		$this->config = $config;
-		$this->driver = new $class;
-		$this->translator = new DibiTranslator($this);
-
-		// 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 (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;
-			}
-		}
-
-		if (empty($config['lazy'])) {
-			$this->connect();
-		}
-	}
-
-
-
-	/**
-	 * Automatically frees the resources allocated for this result set.
-	 * @return void
-	 */
-	public function __destruct()
-	{
-		// disconnects and rolls back transaction - do not rely on auto-disconnect and rollback!
-		$this->connected && $this->driver->getResource() && $this->disconnect();
-	}
-
-
-
-	/**
-	 * Connects to a database.
-	 * @return void
-	 */
-	final public function connect()
-	{
-		$event = $this->onEvent ? new DibiEvent($this, DibiEvent::CONNECT) : NULL;
-		try {
-			$this->driver->connect($this->config);
-			$this->connected = TRUE;
-			$event && $this->onEvent($event->done());
-
-		} catch (DibiException $e) {
-			$event && $this->onEvent($event->done($e));
-			throw $e;
-		}
-	}
-
-
-
-	/**
-	 * Disconnects from a database.
-	 * @return void
-	 */
-	final public function disconnect()
-	{
-		$this->driver->disconnect();
-		$this->connected = FALSE;
-	}
-
-
-
-	/**
-	 * Returns TRUE when connection was established.
-	 * @return bool
-	 */
-	final public function isConnected()
-	{
-		return $this->connected;
-	}
-
-
-
-	/**
-	 * Returns configuration variable. If no $key is passed, returns the entire array.
-	 * @see self::__construct
-	 * @param  string
-	 * @param  mixed  default value to use if key not found
-	 * @return mixed
-	 */
-	final public function getConfig($key = NULL, $default = NULL)
-	{
-		if ($key === NULL) {
-			return $this->config;
-
-		} elseif (isset($this->config[$key])) {
-			return $this->config[$key];
-
-		} else {
-			return $default;
-		}
-	}
-
-
-
-	/**
-	 * Apply configuration alias or default values.
-	 * @param  array  connect configuration
-	 * @param  string key
-	 * @param  string alias key
-	 * @return void
-	 */
-	public static function alias(&$config, $key, $alias)
-	{
-		$foo = & $config;
-		foreach (explode('|', $key) as $key) $foo = & $foo[$key];
-
-		if (!isset($foo) && isset($config[$alias])) {
-			$foo = $config[$alias];
-			unset($config[$alias]);
-		}
-	}
-
-
-
-	/**
-	 * Returns the driver and connects to a database in lazy mode.
-	 * @return IDibiDriver
-	 */
-	final public function getDriver()
-	{
-		$this->connected || $this->connect();
-		return $this->driver;
-	}
-
-
-
-	/**
-	 * Generates (translates) and executes SQL query.
-	 * @param  array|mixed      one or more arguments
-	 * @return DibiResult|int   result set object (if any)
-	 * @throws DibiException
-	 */
-	final public function query($args)
-	{
-		$args = func_get_args();
-		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);
-	}
-
-
-
-	/**
-	 * Generates and prints SQL query.
-	 * @param  array|mixed  one or more arguments
-	 * @return bool
-	 */
-	final public function test($args)
-	{
-		$args = func_get_args();
-		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);
-	}
-
-
-
-	/**
-	 * Executes the SQL query.
-	 * @param  string           SQL statement.
-	 * @return DibiResult|int   result set object (if any)
-	 * @throws DibiException
-	 */
-	final public function nativeQuery($sql)
-	{
-		$this->connected || $this->connect();
-
-		dibi::$sql = $sql;
-		$event = $this->onEvent ? new DibiEvent($this, DibiEvent::QUERY, $sql) : NULL;
-		try {
-			$res = $this->driver->query($sql);
-
-		} catch (DibiException $e) {
-			$event && $this->onEvent($event->done($e));
-			throw $e;
-		}
-
-		if ($res) {
-			$res = $this->createResultSet($res);
-		} else {
-			$res = $this->driver->getAffectedRows();
-		}
-
-		$event && $this->onEvent($event->done($res));
-		return $res;
-	}
-
-
-
-	/**
-	 * Gets the number of affected rows by the last INSERT, UPDATE or DELETE query.
-	 * @return int  number of rows
-	 * @throws DibiException
-	 */
-	public function getAffectedRows()
-	{
-		$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 getInsertId($sequence = NULL)
-	{
-		$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($savepoint = NULL)
-	{
-		$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;
-		}
-	}
-
-
-
-	/**
-	 * Commits statements in a transaction.
-	 * @param  string  optional savepoint name
-	 * @return void
-	 */
-	public function commit($savepoint = NULL)
-	{
-		$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;
-		}
-	}
-
-
-
-	/**
-	 * Rollback changes in a transaction.
-	 * @param  string  optional savepoint name
-	 * @return void
-	 */
-	public function rollback($savepoint = NULL)
-	{
-		$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;
-		}
-	}
-
-
-
-	/**
-	 * Result set factory.
-	 * @param  IDibiResultDriver
-	 * @return DibiResult
-	 */
-	public function createResultSet(IDibiResultDriver $resultDriver)
-	{
-		$res = new DibiResult($resultDriver);
-		return $res->setFormat(dibi::DATE, $this->config['result']['formatDate'])
-			->setFormat(dibi::DATETIME, $this->config['result']['formatDateTime']);
-	}
-
-
-
-	/********************* fluent SQL builders ****************d*g**/
-
-
-
-	/**
-	 * @return DibiFluent
-	 */
-	public function command()
-	{
-		return new DibiFluent($this);
-	}
-
-
-
-	/**
-	 * @param  string    column name
-	 * @return DibiFluent
-	 */
-	public function select($args)
-	{
-		$args = func_get_args();
-		return $this->command()->__call('select', $args);
-	}
-
-
-
-	/**
-	 * @param  string   table
-	 * @param  array
-	 * @return DibiFluent
-	 */
-	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);
-	}
-
-
-
-	/**
-	 * @param  string   table
-	 * @param  array
-	 * @return DibiFluent
-	 */
-	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', $args);
-	}
-
-
-
-	/**
-	 * @param  string   table
-	 * @return DibiFluent
-	 */
-	public function delete($table)
-	{
-		return $this->command()->delete()->from('%n', $table);
-	}
-
-
-
-	/********************* substitutions ****************d*g**/
-
-
-
-	/**
-	 * Returns substitution hashmap.
-	 * @return DibiHashMap
-	 */
-	public function getSubstitutes()
-	{
-		return $this->substitutes;
-	}
-
-
-
-	/**
-	 * Provides substitution.
-	 * @return string
-	 */
-	public function substitute($value)
-	{
-		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();
-	}
-
-
-
-	/********************* misc ****************d*g**/
-
-
-
-	/**
-	 * Import SQL dump from file - extreme fast!
-	 * @param  string  filename
-	 * @return int  count of sql commands
-	 */
-	public function loadFile($file)
-	{
-		$this->connected || $this->connect();
-		@set_time_limit(0); // intentionally @
-
-		$handle = @fopen($file, 'r'); // intentionally @
-		if (!$handle) {
-			throw new RuntimeException("Cannot open file '$file'.");
-		}
-
-		$count = 0;
-		$sql = '';
-		while (!feof($handle)) {
-			$s = fgets($handle);
-			$sql .= $s;
-			if (substr(rtrim($s), -1) === ';') {
-				$this->driver->query($sql);
-				$sql = '';
-				$count++;
-			}
-		}
-		if (trim($sql) !== '') {
-			$this->driver->query($sql);
-			$count++;
-		}
-		fclose($handle);
-		return $count;
-	}
-
-
-
-	/**
-	 * Gets a information about the current database.
-	 * @return DibiDatabaseInfo
-	 */
-	public function getDatabaseInfo()
-	{
-		$this->connected || $this->connect();
-		return new DibiDatabaseInfo($this->driver->getReflector(), isset($this->config['database']) ? $this->config['database'] : NULL);
-	}
-
-
-
-	/**
-	 * Prevents unserialization.
-	 */
-	public function __wakeup()
-	{
-		throw new DibiNotSupportedException('You cannot serialize or unserialize ' . $this->getClass() . ' instances.');
-	}
-
-
-
-	/**
-	 * Prevents serialization.
-	 */
-	public function __sleep()
-	{
-		throw new DibiNotSupportedException('You cannot serialize or unserialize ' . $this->getClass() . ' instances.');
-	}
-
-}

dibi/libs/DibiDatabaseInfo.php

@@ -1,772 +0,0 @@
-<?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.
- */
-
-
-
-/**
- * Reflection metadata class for a database.
- *
- * @author     David Grudl
- * @package    dibi\reflection
- *
- * @property-read string $name
- * @property-read array $tables
- * @property-read array $tableNames
- */
-class DibiDatabaseInfo extends DibiObject
-{
-	/** @var IDibiReflector */
-	private $reflector;
-
-	/** @var string */
-	private $name;
-
-	/** @var array */
-	private $tables;
-
-
-
-	public function __construct(IDibiReflector $reflector, $name)
-	{
-		$this->reflector = $reflector;
-		$this->name = $name;
-	}
-
-
-
-	/**
-	 * @return string
-	 */
-	public function getName()
-	{
-		return $this->name;
-	}
-
-
-
-	/**
-	 * @return array of DibiTableInfo
-	 */
-	public function getTables()
-	{
-		$this->init();
-		return array_values($this->tables);
-	}
-
-
-
-	/**
-	 * @return array of string
-	 */
-	public function getTableNames()
-	{
-		$this->init();
-		$res = array();
-		foreach ($this->tables as $table) {
-			$res[] = $table->getName();
-		}
-		return $res;
-	}
-
-
-
-	/**
-	 * @param  string
-	 * @return DibiTableInfo
-	 */
-	public function getTable($name)
-	{
-		$this->init();
-		$l = strtolower($name);
-		if (isset($this->tables[$l])) {
-			return $this->tables[$l];
-
-		} else {
-			throw new DibiException("Database '$this->name' has no table '$name'.");
-		}
-	}
-
-
-
-	/**
-	 * @param  string
-	 * @return bool
-	 */
-	public function hasTable($name)
-	{
-		$this->init();
-		return isset($this->tables[strtolower($name)]);
-	}
-
-
-
-	/**
-	 * @return void
-	 */
-	protected function init()
-	{
-		if ($this->tables === NULL) {
-			$this->tables = array();
-			foreach ($this->reflector->getTables() as $info) {
-				$this->tables[strtolower($info['name'])] = new DibiTableInfo($this->reflector, $info);
-			}
-		}
-	}
-
-}
-
-
-
-
-/**
- * Reflection metadata class for a database table.
- *
- * @author     David Grudl
- * @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 IDibiReflector */
-	private $reflector;
-
-	/** @var string */
-	private $name;
-
-	/** @var bool */
-	private $view;
-
-	/** @var array */
-	private $columns;
-
-	/** @var array */
-	private $foreignKeys;
-
-	/** @var array */
-	private $indexes;
-
-	/** @var DibiIndexInfo */
-	private $primaryKey;
-
-
-
-	public function __construct(IDibiReflector $reflector, array $info)
-	{
-		$this->reflector = $reflector;
-		$this->name = $info['name'];
-		$this->view = !empty($info['view']);
-	}
-
-
-
-	/**
-	 * @return string
-	 */
-	public function getName()
-	{
-		return $this->name;
-	}
-
-
-
-	/**
-	 * @return bool
-	 */
-	public function isView()
-	{
-		return $this->view;
-	}
-
-
-
-	/**
-	 * @return array of DibiColumnInfo
-	 */
-	public function getColumns()
-	{
-		$this->initColumns();
-		return array_values($this->columns);
-	}
-
-
-
-	/**
-	 * @return array of string
-	 */
-	public function getColumnNames()
-	{
-		$this->initColumns();
-		$res = array();
-		foreach ($this->columns as $column) {
-			$res[] = $column->getName();
-		}
-		return $res;
-	}
-
-
-
-	/**
-	 * @param  string
-	 * @return DibiColumnInfo
-	 */
-	public function getColumn($name)
-	{
-		$this->initColumns();
-		$l = strtolower($name);
-		if (isset($this->columns[$l])) {
-			return $this->columns[$l];
-
-		} else {
-			throw new DibiException("Table '$this->name' has no column '$name'.");
-		}
-	}
-
-
-
-	/**
-	 * @param  string
-	 * @return bool
-	 */
-	public function hasColumn($name)
-	{
-		$this->initColumns();
-		return isset($this->columns[strtolower($name)]);
-	}
-
-
-
-	/**
-	 * @return array of DibiForeignKeyInfo
-	 */
-	public function getForeignKeys()
-	{
-		$this->initForeignKeys();
-		return $this->foreignKeys;
-	}
-
-
-
-	/**
-	 * @return array of DibiIndexInfo
-	 */
-	public function getIndexes()
-	{
-		$this->initIndexes();
-		return $this->indexes;
-	}
-
-
-
-	/**
-	 * @return DibiIndexInfo
-	 */
-	public function getPrimaryKey()
-	{
-		$this->initIndexes();
-		return $this->primaryKey;
-	}
-
-
-
-	/**
-	 * @return void
-	 */
-	protected function initColumns()
-	{
-		if ($this->columns === NULL) {
-			$this->columns = array();
-			foreach ($this->reflector->getColumns($this->name) as $info) {
-				$this->columns[strtolower($info['name'])] = new DibiColumnInfo($this->reflector, $info);
-			}
-		}
-	}
-
-
-
-	/**
-	 * @return void
-	 */
-	protected function initIndexes()
-	{
-		if ($this->indexes === NULL) {
-			$this->initColumns();
-			$this->indexes = array();
-			foreach ($this->reflector->getIndexes($this->name) as $info) {
-				foreach ($info['columns'] as $key => $name) {
-					$info['columns'][$key] = $this->columns[strtolower($name)];
-				}
-				$this->indexes[strtolower($info['name'])] = new DibiIndexInfo($info);
-				if (!empty($info['primary'])) {
-					$this->primaryKey = $this->indexes[strtolower($info['name'])];
-				}
-			}
-		}
-	}
-
-
-
-	/**
-	 * @return void
-	 */
-	protected function initForeignKeys()
-	{
-		throw new DibiNotImplementedException;
-	}
-
-}
-
-
-
-
-/**
- * Reflection metadata class for a result set.
- *
- * @author     David Grudl
- * @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 IDibiReflector|NULL when created by DibiResultInfo */
-	private $reflector;
-
-	/** @var array (name, nativetype, [table], [fullname], [size], [nullable], [default], [autoincrement], [vendor]) */
-	private $info;
-
-
-
-	public function __construct(IDibiReflector $reflector = NULL, array $info)
-	{
-		$this->reflector = $reflector;
-		$this->info = $info;
-	}
-
-
-
-	/**
-	 * @return string
-	 */
-	public function getName()
-	{
-		return $this->info['name'];
-	}
-
-
-
-	/**
-	 * @return string
-	 */
-	public function getFullName()
-	{
-		return isset($this->info['fullname']) ? $this->info['fullname'] : NULL;
-	}
-
-
-
-	/**
-	 * @return bool
-	 */
-	public function hasTable()
-	{
-		return !empty($this->info['table']);
-	}
-
-
-
-	/**
-	 * @return DibiTableInfo
-	 */
-	public function getTable()
-	{
-		if (empty($this->info['table']) || !$this->reflector) {
-			throw new DibiException("Table is unknown or not available.");
-		}
-		return new DibiTableInfo($this->reflector, array('name' => $this->info['table']));
-	}
-
-
-
-	/**
-	 * @return string
-	 */
-	public function getTableName()
-	{
-		return isset($this->info['table']) ? $this->info['table'] : NULL;
-	}
-
-
-
-	/**
-	 * @return string
-	 */
-	public function getType()
-	{
-		return self::getTypeCache()->{$this->info['nativetype']};
-	}
-
-
-
-	/**
-	 * @return mixed
-	 */
-	public function getNativeType()
-	{
-		return $this->info['nativetype'];
-	}
-
-
-
-	/**
-	 * @return int
-	 */
-	public function getSize()
-	{
-		return isset($this->info['size']) ? (int) $this->info['size'] : NULL;
-	}
-
-
-
-	/**
-	 * @return bool
-	 */
-	public function isUnsigned()
-	{
-		return isset($this->info['unsigned']) ? (bool) $this->info['unsigned'] : NULL;
-	}
-
-
-
-	/**
-	 * @return bool
-	 */
-	public function isNullable()
-	{
-		return isset($this->info['nullable']) ? (bool) $this->info['nullable'] : NULL;
-	}
-
-
-
-	/**
-	 * @return bool
-	 */
-	public function isAutoIncrement()
-	{
-		return isset($this->info['autoincrement']) ? (bool) $this->info['autoincrement'] : NULL;
-	}
-
-
-
-	/**
-	 * @return mixed
-	 */
-	public function getDefault()
-	{
-		return isset($this->info['default']) ? $this->info['default'] : NULL;
-	}
-
-
-
-	/**
-	 * @param  string
-	 * @return mixed
-	 */
-	public function getVendorInfo($key)
-	{
-		return isset($this->info['vendor'][$key]) ? $this->info['vendor'][$key] : NULL;
-	}
-
-
-
-	/**
-	 * Heuristic type detection.
-	 * @param  string
-	 * @return string
-	 * @internal
-	 */
-	public static function detectType($type)
-	{
-		static $patterns = array(
-			'^_' => dibi::TEXT, // PostgreSQL arrays
-			'BYTEA|BLOB|BIN' => dibi::BINARY,
-			'TEXT|CHAR|POINT|INTERVAL' => dibi::TEXT,
-			'YEAR|BYTE|COUNTER|SERIAL|INT|LONG|SHORT' => dibi::INTEGER,
-			'CURRENCY|REAL|MONEY|FLOAT|DOUBLE|DECIMAL|NUMERIC|NUMBER' => dibi::FLOAT,
-			'^TIME$' => dibi::TIME,
-			'TIME' => dibi::DATETIME, // DATETIME, TIMESTAMP
-			'DATE' => dibi::DATE,
-			'BOOL' => dibi::BOOL,
-		);
-
-		foreach ($patterns as $s => $val) {
-			if (preg_match("#$s#i", $type)) {
-				return $val;
-			}
-		}
-		return dibi::TEXT;
-	}
-
-
-
-	/**
-	 * @internal
-	 */
-	public static function getTypeCache()
-	{
-		if (self::$types === NULL) {
-			self::$types = new DibiHashMap(array(__CLASS__, 'detectType'));
-		}
-		return self::$types;
-	}
-
-}
-
-
-
-
-/**
- * Reflection metadata class for a foreign key.
- *
- * @author     David Grudl
- * @package    dibi\reflection
- * @todo
- *
- * @property-read string $name
- * @property-read array $references
- */
-class DibiForeignKeyInfo extends DibiObject
-{
-	/** @var string */
-	private $name;
-
-	/** @var array of array(local, foreign, onDelete, onUpdate) */
-	private $references;
-
-
-
-	public function __construct($name, array $references)
-	{
-		$this->name = $name;
-		$this->references = $references;
-	}
-
-
-
-	/**
-	 * @return string
-	 */
-	public function getName()
-	{
-		return $this->name;
-	}
-
-
-
-	/**
-	 * @return array
-	 */
-	public function getReferences()
-	{
-		return $this->references;
-	}
-
-}
-
-
-
-
-/**
- * Reflection metadata class for a index or primary key.
- *
- * @author     David Grudl
- * @package    dibi\reflection
- *
- * @property-read string $name
- * @property-read array $columns
- * @property-read bool $unique
- * @property-read bool $primary
- */
-class DibiIndexInfo extends DibiObject
-{
-	/** @var array (name, columns, [unique], [primary]) */
-	private $info;
-
-
-	public function __construct(array $info)
-	{
-		$this->info = $info;
-	}
-
-
-
-	/**
-	 * @return string
-	 */
-	public function getName()
-	{
-		return $this->info['name'];
-	}
-
-
-
-	/**
-	 * @return array
-	 */
-	public function getColumns()
-	{
-		return $this->info['columns'];
-	}
-
-
-
-	/**
-	 * @return bool
-	 */
-	public function isUnique()
-	{
-		return !empty($this->info['unique']);
-	}
-
-
-
-	/**
-	 * @return bool
-	 */
-	public function isPrimary()
-	{
-		return !empty($this->info['primary']);
-	}
-
-}

dibi/libs/DibiDateTime.php

@@ -1,88 +0,0 @@
-<?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/DibiException.php

@@ -1,165 +0,0 @@
-<?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 common exception.
- *
- * @author     David Grudl
- * @package    dibi
- */
-class DibiException extends Exception
-{
-	/** @var string */
-	private $sql;
-
-
-	/**
-	 * 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;
-	}
-
-
-
-	/**
-	 * @return string  The SQL passed to the constructor
-	 */
-	final public function getSql()
-	{
-		return $this->sql;
-	}
-
-
-
-	/**
-	 * @return string  string represenation of exception with SQL command
-	 */
-	public function __toString()
-	{
-		return parent::__toString() . ($this->sql ? "\nSQL: " . $this->sql : '');
-	}
-
-}
-
-
-
-
-/**
- * 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.
-	 * @return void
-	 */
-	public static function tryError()
-	{
-		set_error_handler(array(__CLASS__, '_errorHandler'), E_ALL);
-		self::$errorMsg = NULL;
-	}
-
-
-
-	/**
-	 * Returns catched error/warning message.
-	 * @param  string  catched message
-	 * @return bool
-	 */
-	public static function catchError(& $message)
-	{
-		restore_error_handler();
-		$message = self::$errorMsg;
-		self::$errorMsg = NULL;
-		return $message !== NULL;
-	}
-
-
-
-	/**
-	 * Internal error handler. Do not call directly.
-	 * @internal
-	 */
-	public static function _errorHandler($code, $message)
-	{
-		restore_error_handler();
-
-		if (ini_get('html_errors')) {
-			$message = strip_tags($message);
-			$message = html_entity_decode($message);
-		}
-
-		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/DibiFirePhpLogger.php

@@ -1,96 +0,0 @@
-<?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/DibiHashMap.php

@@ -1,82 +0,0 @@
-<?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

@@ -1,40 +0,0 @@
-<?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,325 +0,0 @@
-<?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.
- */
-
-
-
-/**
- * DibiObject is the ultimate ancestor of all instantiable classes.
- *
- * 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
- *   - support for conventional properties with getters and setters
- *   - support for event raising functionality
- *   - ability to add new methods to class (extension methods)
- *
- * Properties is a syntactic sugar which allows access public getter and setter
- * methods as normal object variables. A property is defined by a getter method
- * and optional setter method (no setter method means read-only property).
- * <code>
- * $val = $obj->label;     // equivalent to $val = $obj->getLabel();
- * $obj->label = 'Nette';  // equivalent to $obj->setLabel('Nette');
- * </code>
- * Property names are case-sensitive, and they are written in the camelCaps
- * or PascalCaps.
- *
- * Event functionality is provided by declaration of property named 'on{Something}'
- * Multiple handlers are allowed.
- * <code>
- * public $onClick;                // declaration in class
- * $this->onClick[] = 'callback';  // attaching event handler
- * if (!empty($this->onClick)) ... // are there any handlers?
- * $this->onClick($sender, $arg);  // raises the event with arguments
- * </code>
- *
- * Adding method to class (i.e. to all instances) works similar to JavaScript
- * prototype property. The syntax for adding a new method is:
- * <code>
- * MyClass::extensionMethod('newMethod', function(MyClass $obj, $arg, ...) { ... });
- * $obj = new MyClass;
- * $obj->newMethod($x);
- * </code>
- *
- * @author     David Grudl
- * @package    dibi
- */
-abstract class DibiObject
-{
-	/** @var array (method => array(type => callback)) */
-	private static $extMethods;
-
-
-
-	/**
-	 * Returns the name of the class of this object.
-	 * @return string
-	 */
-	final public /*static*/ function getClass()
-	{
-		return /*get_called_class()*/ /**/get_class($this)/**/;
-	}
-
-
-
-	/**
-	 * Access to reflection.
-	 * @return \ReflectionObject
-	 */
-	final public function getReflection()
-	{
-		return new ReflectionObject($this);
-	}
-
-
-
-	/**
-	 * Call to undefined method.
-	 * @param  string  method name
-	 * @param  array   arguments
-	 * @return mixed
-	 * @throws \LogicException
-	 */
-	public function __call($name, $args)
-	{
-		$class = get_class($this);
-
-		if ($name === '') {
-			throw new LogicException("Call to class '$class' method without name.");
-		}
-
-		// event functionality
-		if (preg_match('#^on[A-Z]#', $name)) {
-			$rp = new ReflectionProperty($class, $name);
-			if ($rp->isPublic() && !$rp->isStatic()) {
-				$list = $this->$name;
-				if (is_array($list) || $list instanceof Traversable) {
-					foreach ($list as $handler) {
-						/**/if (is_object($handler)) {
-							call_user_func_array(array($handler, '__invoke'), $args);
-
-						} else /**/{
-							call_user_func_array($handler, $args);
-						}
-					}
-				}
-				return NULL;
-			}
-		}
-
-		// extension methods
-		if ($cb = self::extensionMethod("$class::$name")) {
-			array_unshift($args, $this);
-			return call_user_func_array($cb, $args);
-		}
-
-		throw new LogicException("Call to undefined method $class::$name().");
-	}
-
-
-
-	/**
-	 * Call to undefined static method.
-	 * @param  string  method name (in lower case!)
-	 * @param  array   arguments
-	 * @return mixed
-	 * @throws \LogicException
-	 */
-	public static function __callStatic($name, $args)
-	{
-		$class = get_called_class();
-		throw new LogicException("Call to undefined static method $class::$name().");
-	}
-
-
-
-	/**
-	 * Adding method to class.
-	 * @param  string  method name
-	 * @param  mixed   callback or closure
-	 * @return mixed
-	 */
-	public static function extensionMethod($name, $callback = NULL)
-	{
-		if (self::$extMethods === NULL || $name === NULL) { // for backwards compatibility
-			$list = get_defined_functions();
-			foreach ($list['user'] as $fce) {
-				$pair = explode('_prototype_', $fce);
-				if (count($pair) === 2) {
-					self::$extMethods[$pair[1]][$pair[0]] = $fce;
-					self::$extMethods[$pair[1]][''] = NULL;
-				}
-			}
-			if ($name === NULL) return NULL;
-		}
-
-		$name = strtolower($name);
-		$a = strrpos($name, ':'); // search ::
-		if ($a === FALSE) {
-			$class = strtolower(get_called_class());
-			$l = & self::$extMethods[$name];
-		} else {
-			$class = substr($name, 0, $a - 1);
-			$l = & self::$extMethods[substr($name, $a + 1)];
-		}
-
-		if ($callback !== NULL) { // works as setter
-			$l[$class] = $callback;
-			$l[''] = NULL;
-			return NULL;
-		}
-
-		// works as getter
-		if (empty($l)) {
-			return FALSE;
-
-		} elseif (isset($l[''][$class])) { // cached value
-			return $l[''][$class];
-		}
-		$cl = $class;
-		do {
-			$cl = strtolower($cl);
-			if (isset($l[$cl])) {
-				return $l[''][$class] = $l[$cl];
-			}
-		} while (($cl = get_parent_class($cl)) !== FALSE);
-
-		foreach (class_implements($class) as $cl) {
-			$cl = strtolower($cl);
-			if (isset($l[$cl])) {
-				return $l[''][$class] = $l[$cl];
-			}
-		}
-		return $l[''][$class] = FALSE;
-	}
-
-
-
-	/**
-	 * Returns property value. Do not call directly.
-	 * @param  string  property name
-	 * @return mixed   property value
-	 * @throws \LogicException if the property is not defined.
-	 */
-	public function &__get($name)
-	{
-		$class = get_class($this);
-
-		if ($name === '') {
-			throw new LogicException("Cannot read a class '$class' property without name.");
-		}
-
-		// property getter support
-		$name[0] = $name[0] & "\xDF"; // case-sensitive checking, capitalize first character
-		$m = 'get' . $name;
-		if (self::hasAccessor($class, $m)) {
-			// ampersands:
-			// - 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;
-		}
-
-		$m = 'is' . $name;
-		if (self::hasAccessor($class, $m)) {
-			$val = $this->$m();
-			return $val;
-		}
-
-		$name = func_get_arg(0);
-		throw new LogicException("Cannot read an undeclared property $class::\$$name.");
-	}
-
-
-
-	/**
-	 * Sets value of a property. Do not call directly.
-	 * @param  string  property name
-	 * @param  mixed   property value
-	 * @return void
-	 * @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 LogicException("Cannot assign to a class '$class' property without name.");
-		}
-
-		// property setter support
-		$name[0] = $name[0] & "\xDF"; // case-sensitive checking, capitalize first character
-		if (self::hasAccessor($class, 'get' . $name) || self::hasAccessor($class, 'is' . $name)) {
-			$m = 'set' . $name;
-			if (self::hasAccessor($class, $m)) {
-				$this->$m($value);
-				return;
-
-			} else {
-				$name = func_get_arg(0);
-				throw new LogicException("Cannot assign to a read-only property $class::\$$name.");
-			}
-		}
-
-		$name = func_get_arg(0);
-		throw new LogicException("Cannot assign to an undeclared property $class::\$$name.");
-	}
-
-
-
-	/**
-	 * Is property defined?
-	 * @param  string  property name
-	 * @return bool
-	 */
-	public function __isset($name)
-	{
-		$name[0] = $name[0] & "\xDF";
-		return $name !== '' && self::hasAccessor(get_class($this), 'get' . $name);
-	}
-
-
-
-	/**
-	 * Access to undeclared property.
-	 * @param  string  property name
-	 * @return void
-	 * @throws \LogicException
-	 */
-	public function __unset($name)
-	{
-		$class = get_class($this);
-		throw new LogicException("Cannot unset the property $class::\$$name.");
-	}
-
-
-
-	/**
-	 * Has property an accessor?
-	 * @param  string  class name
-	 * @param  string  method name
-	 * @return bool
-	 */
-	private static function hasAccessor($c, $m)
-	{
-		static $cache;
-		if (!isset($cache[$c])) {
-			// get_class_methods returns private, protected and public methods of Object (doesn't matter)
-			// and ONLY PUBLIC methods of descendants (perfect!)
-			// but returns static methods too (nothing doing...)
-			// and is much faster than reflection
-			// (works good since 5.0.4)
-			$cache[$c] = array_flip(get_class_methods($c));
-		}
-		return isset($cache[$c][$m]);
-	}
-
-}

dibi/libs/DibiResult.php

@@ -1,722 +0,0 @@
-<?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 result set.
- *
- * <code>
- * $result = dibi::query('SELECT * FROM [table]');
- *
- * $row   = $result->fetch();
- * $value = $result->fetchSingle();
- * $table = $result->fetchAll();
- * $pairs = $result->fetchPairs();
- * $assoc = $result->fetchAssoc('id');
- * $assoc = $result->fetchAssoc('active,#,id');
- *
- * unset($result);
- * </code>
- *
- * @author     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  IDibiResultDriver */
-	private $driver;
-
-	/** @var array  Translate table */
-	private $types = array();
-
-	/** @var DibiResultInfo */
-	private $meta;
-
-	/** @var bool  Already fetched? Used for allowance for first seek(0) */
-	private $fetched = FALSE;
-
-	/** @var string  returned object class */
-	private $rowClass = 'DibiRow';
-
-	/** @var Callback  returned object factory*/
-	private $rowFactory;
-
-	/** @var array  format */
-	private $formats = array();
-
-
-
-	/**
-	 * @param  IDibiResultDriver
-	 */
-	public function __construct($driver)
-	{
-		$this->driver = $driver;
-		$this->detectTypes();
-	}
-
-
-
-	/**
-	 * @deprecated
-	 */
-	final public function getResource()
-	{
-		return $this->getResultDriver()->getResultResource();
-	}
-
-
-
-	/**
-	 * Frees the resources allocated for this result set.
-	 * @return void
-	 */
-	final public function free()
-	{
-		if ($this->driver !== NULL) {
-			$this->driver->free();
-			$this->driver = $this->meta = NULL;
-		}
-	}
-
-
-
-	/**
-	 * 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 seek($row)
-	{
-		return ($row !== 0 || $this->fetched) ? (bool) $this->getResultDriver()->seek($row) : TRUE;
-	}
-
-
-
-	/**
-	 * Required by the Countable interface.
-	 * @return int
-	 */
-	final public function count()
-	{
-		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;
-	}
-
-
-
-	/**
-	 * Set a factory to create fetched object instances. These should extend the DibiRow class.
-	 * @param  callback
-	 * @return DibiResult  provides a fluent interface
-	 */
-	public function setRowFactory($callback)
-	{
-		$this->rowFactory = $callback;
-		return $this;
-	}
-
-
-
-	/**
-	 * Fetches the row at current position, process optional type conversion.
-	 * and moves the internal cursor to the next position
-	 * @return DibiRow|FALSE  array on success, FALSE if no next record
-	 */
-	final public function fetch()
-	{
-		$row = $this->getResultDriver()->fetch(TRUE);
-		if (!is_array($row)) {
-			return FALSE;
-		}
-		$this->fetched = TRUE;
-		$this->normalize($row);
-		if ($this->rowFactory) {
-			return call_user_func($this->rowFactory, $row);
-		} elseif ($this->rowClass) {
-			$row = new $this->rowClass($row);
-		}
-		return $row;
-	}
-
-
-
-	/**
-	 * Like fetch(), but returns only first field.
-	 * @return mixed  value on success, FALSE if no next record
-	 */
-	final public function fetchSingle()
-	{
-		$row = $this->getResultDriver()->fetch(TRUE);
-		if (!is_array($row)) {
-			return FALSE;
-		}
-		$this->fetched = TRUE;
-		$this->normalize($row);
-		return reset($row);
-	}
-
-
-
-	/**
-	 * Fetches all records from table.
-	 * @param  int  offset
-	 * @param  int  limit
-	 * @return array of DibiRow
-	 */
-	final public function fetchAll($offset = NULL, $limit = NULL)
-	{
-		$limit = $limit === NULL ? -1 : (int) $limit;
-		$this->seek((int) $offset);
-		$row = $this->fetch();
-		if (!$row) return array();  // empty result set
-
-		$data = array();
-		do {
-			if ($limit === 0) break;
-			$limit--;
-			$data[] = $row;
-		} while ($row = $this->fetch());
-
-		return $data;
-	}
-
-
-
-	/**
-	 * Fetches all records from table and returns associative tree.
-	 * 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();
-		if (!$row) return array();  // empty result set
-
-		$data = NULL;
-		$assoc = explode(',', $assoc);
-
-		// strip leading = and @
-		$leaf = '@';  // gap
-		$last = count($assoc) - 1;
-		while ($assoc[$last] === '=' || $assoc[$last] === '@') {
-			$leaf = $assoc[$last];
-			unset($assoc[$last]);
-			$last--;
-
-			if ($last < 0) {
-				$assoc[] = '#';
-				break;
-			}
-		}
-
-		do {
-			$x = & $data;
-
-			foreach ($assoc as $i => $as) {
-				if ($as === '#') { // indexed-array node
-					$x = & $x[];
-
-				} elseif ($as === '=') { // "record" node
-					if ($x === NULL) {
-						$x = $row->toArray();
-						$x = & $x[ $assoc[$i+1] ];
-						$x = NULL; // prepare child node
-					} else {
-						$x = & $x[ $assoc[$i+1] ];
-					}
-
-				} 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]};
-					}
-
-
-				} else { // associative-array node
-					$x = & $x[$row->$as];
-				}
-			}
-
-			if ($x === NULL) { // build leaf
-				if ($leaf === '=') {
-					$x = $row->toArray();
-				} else {
-					$x = $row;
-				}
-			}
-
-		} while ($row = $this->fetch());
-
-		unset($x);
-		return $data;
-	}
-
-
-
-	/**
-	 * Fetches all records from table like $key => $value pairs.
-	 * @param  string  associative key
-	 * @param  string  value
-	 * @return array
-	 * @throws InvalidArgumentException
-	 */
-	final public function fetchPairs($key = NULL, $value = NULL)
-	{
-		$this->seek(0);
-		$row = $this->fetch();
-		if (!$row) return array();  // empty result set
-
-		$data = array();
-
-		if ($value === NULL) {
-			if ($key !== NULL) {
-				throw new InvalidArgumentException("Either none or both columns must be specified.");
-			}
-
-			// autodetect
-			$tmp = array_keys($row->toArray());
-			$key = $tmp[0];
-			if (count($row) < 2) { // indexed-array
-				do {
-					$data[] = $row[$key];
-				} while ($row = $this->fetch());
-				return $data;
-			}
-
-			$value = $tmp[1];
-
-		} else {
-			if (!property_exists($row, $value)) {
-				throw new InvalidArgumentException("Unknown value column '$value'.");
-			}
-
-			if ($key === NULL) { // indexed-array
-				do {
-					$data[] = $row[$value];
-				} while ($row = $this->fetch());
-				return $data;
-			}
-
-			if (!property_exists($row, $key)) {
-				throw new InvalidArgumentException("Unknown key column '$key'.");
-			}
-		}
-
-		do {
-			$data[ $row[$key] ] = $row[$value];
-		} while ($row = $this->fetch());
-
-		return $data;
-	}
-
-
-
-	/********************* column types ****************d*g**/
-
-
-
-	/**
-	 * Autodetect column types.
-	 * @return void
-	 */
-	private function detectTypes()
-	{
-		$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 column type.
-	 * @param  string  column
-	 * @param  string  type (use constant Dibi::*)
-	 * @return DibiResult  provides a fluent interface
-	 */
-	final public function setType($col, $type)
-	{
-		$this->types[$col] = $type;
-		return $this;
-	}
-
-
-
-	/**
-	 * Returns column type.
-	 * @return string
-	 */
-	final public function getType($col)
-	{
-		return isset($this->types[$col]) ? $this->types[$col] : NULL;
-	}
-
-
-
-	/**
-	 * Sets data format.
-	 * @param  string  type (use constant Dibi::*)
-	 * @param  string  format
-	 * @return DibiResult  provides a fluent interface
-	 */
-	final public function setFormat($type, $format)
-	{
-		$this->formats[$type] = $format;
-		return $this;
-	}
-
-
-
-	/**
-	 * 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()
-	{
-		return $this->getInfo()->getColumns();
-	}
-
-
-
-	/** @deprecated */
-	public function getColumnNames($fullNames = FALSE)
-	{
-		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 or text table for debug purposes.
-	 * @return void
-	 */
-	final public function dump()
-	{
-		$i = 0;
-		$this->seek(0);
-		if (PHP_SAPI === 'cli') {
-			$hasColors = (substr(getenv('TERM'), 0, 5) === 'xterm');
-			$maxLen = 0;
-			while ($row = $this->fetch()) {
-				if ($i === 0) {
-					foreach ($row as $col => $foo) {
-						$len = mb_strlen($col);
-						if ($len > $maxLen) $maxLen = $len;
-					}
-				}
-
-				if ($hasColors) {
-					echo "\033[1;37m#row: $i\033[0m\n";
-				} else {
-					echo "#row: $i\n";
-				}
-
-				foreach ($row as $col => $val) {
-					$spaces = $maxLen - mb_strlen($col) + 2;
-					echo "$col" . str_repeat(" ", $spaces) .  "$val\n";
-				}
-
-				echo "\n";
-				$i++;
-			}
-
-			if ($i === 0) echo "empty result set\n";
-			echo "\n";
-
-		} else {
-			while ($row = $this->fetch()) {
-				if ($i === 0) {
-					echo "\n<table class=\"dump\">\n<thead>\n\t<tr>\n\t\t<th>#row</th>\n";
-
-					foreach ($row as $col => $foo) {
-						echo "\t\t<th>" . htmlSpecialChars($col) . "</th>\n";
-					}
-
-					echo "\t</tr>\n</thead>\n<tbody>\n";
-				}
-
-				echo "\t<tr>\n\t\t<th>", $i, "</th>\n";
-				foreach ($row as $col) {
-					//if (is_object($col)) $col = $col->__toString();
-					echo "\t\t<td>", htmlSpecialChars($col), "</td>\n";
-				}
-				echo "\t</tr>\n";
-				$i++;
-			}
-
-			if ($i === 0) {
-				echo '<p><em>empty result set</em></p>';
-			} else {
-				echo "</tbody>\n</table>\n";
-			}
-		}
-	}
-
-}

dibi/libs/DibiRow.php

@@ -1,143 +0,0 @@
-<?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/DibiTranslator.php

@@ -1,600 +0,0 @@
-<?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 SQL translator.
- *
- * @author     David Grudl
- * @package    dibi
- */
-final class DibiTranslator extends DibiObject
-{
-	/** @var DibiConnection */
-	private $connection;
-
-	/** @var IDibiDriver */
-	private $driver;
-
-	/** @var int */
-	private $cursor;
-
-	/** @var array */
-	private $args;
-
-	/** @var bool */
-	private $hasError;
-
-	/** @var bool */
-	private $comment;
-
-	/** @var int */
-	private $ifLevel;
-
-	/** @var int */
-	private $ifLevelStart;
-
-	/** @var int */
-	private $limit;
-
-	/** @var int */
-	private $offset;
-
-	/** @var DibiHashMap */
-	private $identifiers;
-
-
-
-	public function __construct(DibiConnection $connection)
-	{
-		$this->connection = $connection;
-	}
-
-
-
-	/**
-	 * Generates SQL.
-	 * @param  array
-	 * @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;
-		$commandIns = NULL;
-		$lastArr = NULL;
-		// shortcuts
-		$cursor = & $this->cursor;
-		$cursor = 0;
-
-		// conditional sql
-		$this->ifLevel = $this->ifLevelStart = 0;
-		$comment = & $this->comment;
-		$comment = FALSE;
-
-		// iterate
-		$sql = array();
-		while ($cursor < count($this->args))
-		{
-			$arg = $this->args[$cursor];
-			$cursor++;
-
-			// simple string means SQL
-			if (is_string($arg)) {
-				// speed-up - is regexp required?
-				$toSkip = strcspn($arg, '`[\'":%?');
-
-				if (strlen($arg) === $toSkip) { // needn't be translated
-					$sql[] = $arg;
-				} else {
-					$sql[] = substr($arg, 0, $toSkip)
-/*
-					. preg_replace_callback('/
-					(?=[`[\'":%?])                    ## speed-up
-					(?:
-						`(.+?)`|                     ## 1) `identifier`
-						\[(.+?)\]|                   ## 2) [identifier]
-						(\')((?:\'\'|[^\'])*)\'|     ## 3,4) 'string'
-						(")((?:""|[^"])*)"|          ## 5,6) "string"
-						(\'|")|                      ## 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('/(?=[`[\'":%?])(?:`(.+?)`|\[(.+?)\]|(\')((?:\'\'|[^\'])*)\'|(")((?:""|[^"])*)"|(\'|")|:(\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;
-			}
-
-			if ($comment) {
-				$sql[] = '...';
-				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($this->args[0]), 0, 6));
-						$commandIns = $commandIns === 'INSERT' || $commandIns === 'REPLAC';
-						$sql[] = $this->formatValue($arg, $commandIns ? 'v' : 'a');
-					} else {
-						if ($lastArr === $cursor - 1) $sql[] = ',';
-						$sql[] = $this->formatValue($arg, $commandIns ? 'l' : 'a');
-					}
-					$lastArr = $cursor;
-					continue;
-				}
-			}
-
-			// default processing
-			$sql[] = $this->formatValue($arg, FALSE);
-		} // while
-
-
-		if ($comment) $sql[] = "*/";
-
-		$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);
-		}
-
-		return $sql;
-	}
-
-
-
-	/**
-	 * Apply modifier to single value.
-	 * @param  mixed
-	 * @param  string
-	 * @return string
-	 */
-	public function formatValue($value, $modifier)
-	{
-		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();
-			switch ($modifier) {
-			case 'and':
-			case 'or':  // key=val AND key IS NULL AND ...
-				if (empty($value)) {
-					return '1=1';
-				}
-
-				foreach ($value as $k => $v) {
-					if (is_string($k)) {
-						$pair = explode('%', $k, 2); // split into identifier & modifier
-						$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(') ' . 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->identifiers->{$pair[0]} . '='
-						. $this->formatValue($v, isset($pair[1]) ? $pair[1] : (is_array($v) ? 'ex' : FALSE));
-				}
-				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] : (is_array($v) ? 'ex' : FALSE));
-				}
-				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->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_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->identifiers->$k . ' ' . $v;
-					} else {
-						$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);
-				}
-				return implode(', ', $vx);
-			}
-		}
-
-
-		// with modifier procession
-		if ($modifier) {
-			if ($value !== NULL && !is_scalar($value) && !($value instanceof DateTime)) {  // array is already processed
-				$this->hasError = TRUE;
-				return '**Unexpected type ' . gettype($value) . '**';
-			}
-
-			switch ($modifier) {
-			case 's':  // string
-			case 'bin':// binary
-			case 'b':  // boolean
-				return $value === NULL ? 'NULL' : $this->driver->escape($value, $modifier);
-
-			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+)?\z#A', $value)) {
-					return $value;
-				} else {
-					return $value === NULL ? 'NULL' : (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'), '.');
-				}
-
-			case 'd':  // date
-			case 't':  // datetime
-				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->identifiers->$value;
-
-			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) {
-					$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':
-			case 'a':
-			case 'l':
-			case 'v':
-				$this->hasError = TRUE;
-				return '**Unexpected type ' . gettype($value) . '**';
-
-			default:
-				$this->hasError = TRUE;
-				return "**Unknown or invalid modifier %$modifier**";
-			}
-		}
-
-
-		// without modifier procession
-		if (is_string($value)) {
-			return $this->driver->escape($value, dibi::TEXT);
-
-		} elseif (is_int($value)) {
-			return (string) $value;
-
-		} elseif (is_float($value)) {
-			return rtrim(rtrim(number_format($value, 10, '.', ''), '0'), '.');
-
-		} elseif (is_bool($value)) {
-			return $this->driver->escape($value, dibi::BOOL);
-
-		} elseif ($value === NULL) {
-			return 'NULL';
-
-		} elseif ($value instanceof DateTime) {
-			return $this->driver->escape($value, dibi::DATETIME);
-
-		} elseif ($value instanceof DibiLiteral) {
-			return (string) $value;
-
-		} else {
-			$this->hasError = TRUE;
-			return '**Unexpected ' . gettype($value) . '**';
-		}
-	}
-
-
-
-	/**
-	 * PREG callback from translate() or formatValue().
-	 * @param  array
-	 * @return string
-	 */
-	private function cb($matches)
-	{
-		//    [1] => `ident`
-		//    [2] => [ident]
-		//    [3] => '
-		//    [4] => string
-		//    [5] => "
-		//    [6] => string
-		//    [7] => lone-quote
-		//    [8] => substitution
-		//    [9] => substitution flag
-		//    [10] => modifier (when called from self::translate())
-		//    [11] => placeholder (when called from self::translate())
-
-
-		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') {
-				$this->hasError = TRUE;
-				return "**Extra modifier %$mod**";
-			}
-
-			if ($mod === 'if') {
-				$this->ifLevel++;
-				$cursor++;
-				if (!$this->comment && !$this->args[$cursor - 1]) {
-					// open comment
-					$this->ifLevelStart = $this->ifLevel;
-					$this->comment = TRUE;
-					return "/*";
-				}
-				return '';
-
-			} elseif ($mod === 'else') {
-				if ($this->ifLevelStart === $this->ifLevel) {
-					$this->ifLevelStart = 0;
-					$this->comment = FALSE;
-					return "*/";
-				} elseif (!$this->comment) {
-					$this->ifLevelStart = $this->ifLevel;
-					$this->comment = TRUE;
-					return "/*";
-				}
-
-			} elseif ($mod === 'end') {
-				$this->ifLevel--;
-				if ($this->ifLevelStart === $this->ifLevel + 1) {
-					// close comment
-					$this->ifLevelStart = 0;
-					$this->comment = FALSE;
-					return "*/";
-				}
-				return '';
-
-			} elseif ($mod === 'ex') { // array expansion
-				array_splice($this->args, $cursor, 1, $this->args[$cursor]);
-				return '';
-
-			} elseif ($mod === 'lmt') { // apply limit
-				if ($this->args[$cursor] !== NULL) $this->limit = (int) $this->args[$cursor];
-				$cursor++;
-				return '';
-
-			} elseif ($mod === 'ofs') { // apply offset
-				if ($this->args[$cursor] !== NULL) $this->offset = (int) $this->args[$cursor];
-				$cursor++;
-				return '';
-
-			} else { // default processing
-				$cursor++;
-				return $this->formatValue($this->args[$cursor - 1], $mod);
-			}
-		}
-
-		if ($this->comment) return '...';
-
-		if ($matches[1])  // SQL identifiers: `ident`
-			return $this->identifiers->{$matches[1]};
-
-		if ($matches[2])  // SQL identifiers: [ident]
-			return $this->identifiers->{$matches[2]};
-
-		if ($matches[3])  // SQL strings: '...'
-			return $this->driver->escape( str_replace("''", "'", $matches[4]), dibi::TEXT);
-
-		if ($matches[5])  // SQL strings: "..."
-			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');
-	}
-
-
-
-	/**
-	 * Apply substitutions to indentifier and delimites it.
-	 * @param  string indentifier
-	 * @return string
-	 * @internal
-	 */
-	public function delimite($value)
-	{
-		$value = $this->connection->substitute($value);
-		$parts = explode('.', $value);
-		foreach ($parts as & $v) {
-			if ($v !== '*') $v = $this->driver->escape($v, dibi::IDENTIFIER);
-		}
-		return implode('.', $parts);
-	}
-
-}

examples/.gitignore

@@ -1,3 +1,4 @@
 _test.bat
 ref
 output
+log

examples/Nette/license.txt

@@ -1,62 +0,0 @@
-Licenses
-========
-
-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.
-
-Redistribution and use in source and binary forms, with or without modification,
-are permitted provided that the following conditions are met:
-
-	* Redistributions of source code must retain the above copyright notice,
-	this list of conditions and the following disclaimer.
-
-	* Redistributions in binary form must reproduce the above copyright notice,
-	this list of conditions and the following disclaimer in the documentation
-	and/or other materials provided with the distribution.
-
-	* Neither the name of "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.
-
-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 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 +0,0 @@
-This file is part of Nette Framework
-
-For more information please see http://nette.org

examples/connecting-to-databases.php

@@ -1,187 +1,163 @@
 <!DOCTYPE html><link rel="stylesheet" href="data/style.css">
 
-<h1>Connecting to Databases | dibi</h1>
+<h1>Connecting to Databases | Dibi</h1>
 
 <?php
 
-require dirname(__FILE__) . '/Nette/Debugger.php';
-require dirname(__FILE__) . '/../dibi/dibi.php';
+if (@!include __DIR__ . '/../vendor/autoload.php') {
+	die('Install packages using `composer install`');
+}
 
 
-// connects to SQlite using dibi class
+// connects to SQlite using Dibi class
 echo '<p>Connecting to Sqlite: ';
 try {
-	dibi::connect(array(
-		'driver'   => 'sqlite',
-		'database' => 'data/sample.sdb',
-	));
+	dibi::connect([
+		'driver' => 'sqlite3',
+		'database' => 'data/sample.s3db',
+	]);
 	echo 'OK';
-
-} catch (DibiException $e) {
+} catch (Dibi\Exception $e) {
 	echo get_class($e), ': ', $e->getMessage(), "\n";
 }
 echo "</p>\n";
 
 
-
-
-// connects to SQlite using DibiConnection object
+// connects to SQlite using Dibi\Connection object
 echo '<p>Connecting to Sqlite: ';
 try {
-	$connection = new DibiConnection(array(
-		'driver'   => 'sqlite',
-		'database' => 'data/sample.sdb',
-	));
+	$connection = new Dibi\Connection([
+		'driver' => 'sqlite3',
+		'database' => 'data/sample.s3db',
+	]);
 	echo 'OK';
-
-} catch (DibiException $e) {
+} catch (Dibi\Exception $e) {
 	echo get_class($e), ': ', $e->getMessage(), "\n";
 }
 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=cp1250');
 	echo 'OK';
-
-} catch (DibiException $e) {
+} catch (Dibi\Exception $e) {
 	echo get_class($e), ': ', $e->getMessage(), "\n";
 }
 echo "</p>\n";
 
 
-
-
 // connects to MySQLi using array
 echo '<p>Connecting to MySQLi: ';
 try {
-	dibi::connect(array(
-		'driver'   => 'mysqli',
-		'host'     => 'localhost',
+	dibi::connect([
+		'driver' => 'mysqli',
+		'host' => 'localhost',
 		'username' => 'root',
 		'password' => 'xxx',
 		'database' => 'dibi',
-		'options'  => array(
-			MYSQLI_OPT_CONNECT_TIMEOUT => 30
-		),
-		'flags'    => MYSQLI_CLIENT_COMPRESS,
-	));
+		'options' => [
+			MYSQLI_OPT_CONNECT_TIMEOUT => 30,
+		],
+		'flags' => MYSQLI_CLIENT_COMPRESS,
+	]);
 	echo 'OK';
-
-} catch (DibiException $e) {
+} catch (Dibi\Exception $e) {
 	echo get_class($e), ': ', $e->getMessage(), "\n";
 }
 echo "</p>\n";
 
 
-
-
 // connects to ODBC
 echo '<p>Connecting to ODBC: ';
 try {
-	dibi::connect(array(
-		'driver'   => 'odbc',
+	dibi::connect([
+		'driver' => 'odbc',
 		'username' => 'root',
 		'password' => '***',
-		'dsn'      => 'Driver={Microsoft Access Driver (*.mdb)};Dbq='.dirname(__FILE__).'/data/sample.mdb',
-	));
+		'dsn' => 'Driver={Microsoft Access Driver (*.mdb)};Dbq=' . __DIR__ . '/data/sample.mdb',
+	]);
 	echo 'OK';
-
-} catch (DibiException $e) {
+} catch (Dibi\Exception $e) {
 	echo get_class($e), ': ', $e->getMessage(), "\n";
 }
 echo "</p>\n";
 
 
-
-
 // connects to PostgreSql
 echo '<p>Connecting to PostgreSql: ';
 try {
-	dibi::connect(array(
-		'driver'     => 'postgre',
-		'string'     => 'host=localhost port=5432 dbname=mary',
-		'persistent' => TRUE,
-	));
+	dibi::connect([
+		'driver' => 'postgre',
+		'string' => 'host=localhost port=5432 dbname=mary',
+		'persistent' => true,
+	]);
 	echo 'OK';
-
-} catch (DibiException $e) {
+} catch (Dibi\Exception $e) {
 	echo get_class($e), ': ', $e->getMessage(), "\n";
 }
 echo "</p>\n";
 
 
-
-
 // connects to PDO
 echo '<p>Connecting to Sqlite via PDO: ';
 try {
-	dibi::connect(array(
-		'driver'  => 'pdo',
-		'dsn'     => 'sqlite2::memory:',
-	));
+	dibi::connect([
+		'driver' => 'pdo',
+		'dsn' => 'sqlite::memory:',
+	]);
 	echo 'OK';
-
-} catch (DibiException $e) {
+} catch (Dibi\Exception $e) {
 	echo get_class($e), ': ', $e->getMessage(), "\n";
 }
 echo "</p>\n";
 
 
-
 // connects to MS SQL
 echo '<p>Connecting to MS SQL: ';
 try {
-	dibi::connect(array(
-		'driver'   => 'mssql',
-		'host'     => 'localhost',
+	dibi::connect([
+		'driver' => 'mssql',
+		'host' => 'localhost',
 		'username' => 'root',
 		'password' => 'xxx',
-	));
+	]);
 	echo 'OK';
-
-} catch (DibiException $e) {
+} catch (Dibi\Exception $e) {
 	echo get_class($e), ': ', $e->getMessage(), "\n";
 }
 echo "</p>\n";
 
 
-
-// connects to MS SQL 2005
-echo '<p>Connecting to MS SQL 2005: ';
+// connects to SQLSRV
+echo '<p>Connecting to Microsoft SQL Server: ';
 try {
-	dibi::connect(array(
-		'driver'   => 'mssql2005',
-		'host'     => '(local)',
+	dibi::connect([
+		'driver' => 'sqlsrv',
+		'host' => '(local)',
 		'username' => 'Administrator',
 		'password' => 'xxx',
 		'database' => 'main',
-	));
+	]);
 	echo 'OK';
-
-} catch (DibiException $e) {
+} catch (Dibi\Exception $e) {
 	echo get_class($e), ': ', $e->getMessage(), "\n";
 }
 echo "</p>\n";
 
 
-
 // connects to Oracle
 echo '<p>Connecting to Oracle: ';
 try {
-	dibi::connect(array(
-		'driver'   => 'oracle',
+	dibi::connect([
+		'driver' => 'oracle',
 		'username' => 'root',
 		'password' => 'xxx',
 		'database' => 'db',
-	));
+	]);
 	echo 'OK';
-
-} catch (DibiException $e) {
+} catch (Dibi\Exception $e) {
 	echo get_class($e), ': ', $e->getMessage(), "\n";
 }
 echo "</p>\n";

examples/data/style.css

@@ -2,7 +2,7 @@ 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;
+	margin: 1.6em;
 	padding: 0;
 }
 
@@ -41,24 +41,24 @@ table.dump th {
 }
 
 /* dump() */
-pre.nette-dump, pre.dump {
+pre.tracy-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 {
+pre.tracy-dump .php-array, pre.tracy-dump .php-object {
 	color: #C22;
 }
-pre.nette-dump .php-string {
+pre.tracy-dump .php-string {
 	color: #080;
 }
-pre.nette-dump .php-int, pre.nette-dump .php-float {
+pre.tracy-dump .php-int, pre.tracy-dump .php-float {
 	color: #37D;
 }
-pre.nette-dump .php-null, pre.nette-dump .php-bool {
+pre.tracy-dump .php-null, pre.tracy-dump .php-bool {
 	color: black;
 }
-pre.nette-dump .php-visibility {
+pre.tracy-dump .php-visibility {
 	font-size: 85%; color: #999;
 }

examples/database-reflection.php

@@ -1,52 +1,50 @@
 <!DOCTYPE html><link rel="stylesheet" href="data/style.css">
 
-<h1>Database Reflection | dibi</h1>
+<h1>Database Reflection | Dibi</h1>
 
 <?php
 
-require dirname(__FILE__) . '/Nette/Debugger.php';
-require dirname(__FILE__) . '/../dibi/dibi.php';
+if (@!include __DIR__ . '/../vendor/autoload.php') {
+	die('Install packages using `composer install`');
+}
 
 
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'data/sample.sdb',
-));
-
+$dibi = new Dibi\Connection([
+	'driver' => 'sqlite3',
+	'database' => 'data/sample.s3db',
+]);
 
 
 // retrieve database reflection
-$database = dibi::getDatabaseInfo();
+$database = $dibi->getDatabaseInfo();
 
-echo "<h2>Database '{$database->name}'</h2>\n";
+echo "<h2>Database '{$database->getName()}'</h2>\n";
 echo "<ul>\n";
 foreach ($database->getTables() as $table) {
-	echo '<li>', ($table->view ? 'view' : 'table') . " $table->name</li>\n";
+	echo '<li>', ($table->isView() ? 'view' : 'table') . " {$table->getName()}</li>\n";
 }
 echo "</ul>\n";
 
 
-
 // table reflection
 $table = $database->getTable('products');
 
-echo "<h2>Table '{$table->name}'</h2>\n";
+echo "<h2>Table '{$table->getName()}'</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 "<li>{$column->getName()} <i>{$column->getNativeType()}</i> <code>{$column->getDefault()}</code></li>\n";
 }
 echo "</ul>\n";
 
 
-
-echo "Indexes";
+echo 'Indexes';
 echo "<ul>\n";
 foreach ($table->getIndexes() as $index) {
-	echo "<li>{$index->name} " . ($index->primary ? 'primary ' : '') . ($index->unique ? 'unique' : '') . ' (';
+	echo "<li>{$index->getName()} " . ($index->isPrimary() ? 'primary ' : '') . ($index->isUnique() ? 'unique' : '') . ' (';
 	foreach ($index->getColumns() as $column) {
-		echo "$column->name, ";
+		echo $column->getName(), ', ';
 	}
 	echo ")</li>\n";
 }

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

@@ -1,21 +1,21 @@
 <!DOCTYPE html><link rel="stylesheet" href="data/style.css">
 
-<h1>Dumping SQL and Result Set | dibi</h1>
+<h1>Dumping SQL and Result Set | Dibi</h1>
 
 <?php
 
-require dirname(__FILE__) . '/Nette/Debugger.php';
-require dirname(__FILE__) . '/../dibi/dibi.php';
+if (@!include __DIR__ . '/../vendor/autoload.php') {
+	die('Install packages using `composer install`');
+}
 
 
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'data/sample.sdb',
-));
+$dibi = new Dibi\Connection([
+	'driver' => 'sqlite3',
+	'database' => 'data/sample.s3db',
+]);
 
 
-
-$res = dibi::query('
+$res = $dibi->query('
 	SELECT * FROM products
 	INNER JOIN orders USING (product_id)
 	INNER JOIN customers USING (customer_id)
@@ -29,6 +29,6 @@ dibi::dump();
 
 
 // dump result table
-echo '<h2>DibiResult::dump()</h2>';
+echo '<h2>Dibi\Result::dump()</h2>';
 
 $res->dump();

examples/fetching-examples.php

@@ -1,18 +1,22 @@
+<?php
+
+if (@!include __DIR__ . '/../vendor/autoload.php') {
+	die('Install dependencies using `composer install --dev`');
+}
+
+Tracy\Debugger::enable();
+
+?>
 <!DOCTYPE html><link rel="stylesheet" href="data/style.css">
 
-<h1>Fetching Examples | dibi</h1>
+<h1>Fetching Examples | Dibi</h1>
 
 <?php
 
-require dirname(__FILE__) . '/Nette/Debugger.php';
-require dirname(__FILE__) . '/../dibi/dibi.php';
-
-ndebug();
-
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'data/sample.sdb',
-));
+$dibi = new Dibi\Connection([
+	'driver' => 'sqlite3',
+	'database' => 'data/sample.s3db',
+]);
 
 
 /*
@@ -29,58 +33,62 @@ product_id | title
 
 // fetch a single row
 echo "<h2>fetch()</h2>\n";
-$row = dibi::fetch('SELECT title FROM products');
-dump($row); // Chair
+$row = $dibi->fetch('SELECT title FROM products');
+Tracy\Dumper::dump($row); // Chair
 
 
 // fetch a single value
 echo "<h2>fetchSingle()</h2>\n";
-$value = dibi::fetchSingle('SELECT title FROM products');
-dump($value); // Chair
+$value = $dibi->fetchSingle('SELECT title FROM products');
+Tracy\Dumper::dump($value); // Chair
 
 
 // fetch complete result set
 echo "<h2>fetchAll()</h2>\n";
-$all = dibi::fetchAll('SELECT * FROM products');
-dump($all);
+$all = $dibi->fetchAll('SELECT * FROM products');
+Tracy\Dumper::dump($all);
 
 
 // fetch complete result set like association array
 echo "<h2>fetchAssoc('title')</h2>\n";
-$res = dibi::query('SELECT * FROM products');
+$res = $dibi->query('SELECT * FROM products');
 $assoc = $res->fetchAssoc('title'); // key
-dump($assoc);
+Tracy\Dumper::dump($assoc);
 
 
 // fetch complete result set like pairs key => value
 echo "<h2>fetchPairs('product_id', 'title')</h2>\n";
+$res = $dibi->query('SELECT * FROM products');
 $pairs = $res->fetchPairs('product_id', 'title');
-dump($pairs);
+Tracy\Dumper::dump($pairs);
 
 
 // fetch row by row
 echo "<h2>using foreach</h2>\n";
+$res = $dibi->query('SELECT * FROM products');
 foreach ($res as $n => $row) {
-	dump($row);
+	Tracy\Dumper::dump($row);
 }
 
 
 // more complex association array
-$res = dibi::query('
+$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('name|title')</h2>\n";
+$assoc = $res->fetchAssoc('name|title'); // key
+Tracy\Dumper::dump($assoc);
 
-echo "<h2>fetchAssoc('customers.name[]products.title')</h2>\n";
-$assoc = $res->fetchAssoc('customers.name[]products.title'); // key
-dump($assoc);
+echo "<h2>fetchAssoc('name[]title')</h2>\n";
+$res = $dibi->query('SELECT * FROM products INNER JOIN orders USING (product_id) INNER JOIN customers USING (customer_id)');
+$assoc = $res->fetchAssoc('name[]title'); // key
+Tracy\Dumper::dump($assoc);
 
-echo "<h2>fetchAssoc('customers.name->products.title')</h2>\n";
-$assoc = $res->fetchAssoc('customers.name->products.title'); // key
-dump($assoc);
+echo "<h2>fetchAssoc('name->title')</h2>\n";
+$res = $dibi->query('SELECT * FROM products INNER JOIN orders USING (product_id) INNER JOIN customers USING (customer_id)');
+$assoc = $res->fetchAssoc('name->title'); // key
+Tracy\Dumper::dump($assoc);

examples/importing-dump-from-file.php

@@ -1,19 +1,20 @@
 <!DOCTYPE html><link rel="stylesheet" href="data/style.css">
 
-<h1>Importing SQL Dump from File | dibi</h1>
+<h1>Importing SQL Dump from File | Dibi</h1>
 
 <?php
 
-require dirname(__FILE__) . '/Nette/Debugger.php';
-require dirname(__FILE__) . '/../dibi/dibi.php';
+if (@!include __DIR__ . '/../vendor/autoload.php') {
+	die('Install packages using `composer install`');
+}
 
 
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'data/sample.sdb',
-));
+$dibi = new Dibi\Connection([
+	'driver' => 'sqlite3',
+	'database' => 'data/sample.s3db',
+]);
 
 
-$count = dibi::loadFile('compress.zlib://data/sample.dump.sql.gz');
+$count = $dibi->loadFile('compress.zlib://data/sample.dump.sql.gz');
 
 echo 'Number of SQL commands:', $count;

examples/nette-debug-and-exceptions.php

@@ -1,45 +0,0 @@
-<!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 dirname(__FILE__) . '/Nette/Debugger.php';
-require dirname(__FILE__) . '/../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

@@ -1,32 +0,0 @@
-<!DOCTYPE html><link rel="stylesheet" href="data/style.css">
-
-<style> html { background: url(data/arrow.png) no-repeat bottom right; height: 100%; } </style>
-
-<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 dirname(__FILE__) . '/Nette/Debugger.php';
-require dirname(__FILE__) . '/../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/query-language-and-conditions.php

@@ -1,30 +1,31 @@
 <!DOCTYPE html><link rel="stylesheet" href="data/style.css">
 
-<h1>Query Language & Conditions | dibi</h1>
+<h1>Query Language & Conditions | Dibi</h1>
 
 <?php
 
-require dirname(__FILE__) . '/Nette/Debugger.php';
-require dirname(__FILE__) . '/../dibi/dibi.php';
+if (@!include __DIR__ . '/../vendor/autoload.php') {
+	die('Install packages using `composer install`');
+}
 
 
-dibi::connect(array(
-	'driver'   => 'sqlite3',
+$dibi = new Dibi\Connection([
+	'driver' => 'sqlite3',
 	'database' => 'data/sample.s3db',
-));
+]);
 
 
 // some variables
-$cond1 = TRUE;
-$cond2 = FALSE;
+$cond1 = true;
+$cond2 = false;
 $foo = -1;
 $bar = 2;
 
 // conditional variable
-$name = $cond1 ? 'K%' : NULL;
+$name = $cond1 ? 'K%' : null;
 
 // if & end
-dibi::test('
+$dibi->test('
 	SELECT *
 	FROM customers
 	%if', isset($name), 'WHERE name LIKE ?', $name, '%end'
@@ -32,22 +33,19 @@ dibi::test('
 // -> SELECT * FROM customers WHERE name LIKE 'K%'
 
 
-
-
 // if & else & (optional) end
-dibi::test("
+$dibi->test('
 	SELECT *
 	FROM people
 	WHERE id > 0
-		%if", ($foo > 0), "AND foo=?", $foo, "
-		%else %if", ($bar > 0), "AND bar=?", $bar, "
-");
+		%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('
+$dibi->test('
 	SELECT *
 	FROM customers
 	WHERE
@@ -58,9 +56,8 @@ dibi::test('
 // -> SELECT * FROM customers WHERE LIMIT 10
 
 
-
 // IF()
-dibi::test('UPDATE products SET', array(
-	'price' => array('IF(price_fixed, price, ?)', 123),
-));
+$dibi->test('UPDATE products SET', [
+	'price' => $dibi->expression('IF(price_fixed, price, ?)', 123),
+]);
 // -> SELECT * FROM customers WHERE LIMIT 10

examples/query-language-basic-examples.php

@@ -1,94 +1,89 @@
 <!DOCTYPE html><link rel="stylesheet" href="data/style.css">
 
-<h1>Query Language Basic Examples | dibi</h1>
+<h1>Query Language Basic Examples | Dibi</h1>
 
 <?php
 
-require dirname(__FILE__) . '/Nette/Debugger.php';
-require dirname(__FILE__) . '/../dibi/dibi.php';
+if (@!include __DIR__ . '/../vendor/autoload.php') {
+	die('Install packages using `composer install`');
+}
 
 date_default_timezone_set('Europe/Prague');
 
 
-dibi::connect(array(
-	'driver'   => 'sqlite3',
+$dibi = new Dibi\Connection([
+	'driver' => 'sqlite3',
 	'database' => 'data/sample.s3db',
-));
+]);
 
 
 // SELECT
 $ipMask = '192.168.%';
 $timestamp = mktime(0, 0, 0, 10, 13, 1997);
 
-dibi::test('
+$dibi->test('
 	SELECT COUNT(*) as [count]
 	FROM [comments]
 	WHERE [ip] LIKE ?', $ipMask, '
-	AND [date] > ', new DibiDateTime($timestamp)
+	AND [date] > ', new Dibi\DateTime($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(
+$dibi->test('
+	REPLACE INTO products', [
 		'title' => 'Super product',
 		'price' => 318,
-		'active' => TRUE,
-));
+		'active' => true,
+]);
 // -> REPLACE INTO products ([title], [price], [active]) VALUES ('Super product', 318, 1)
 
 
-
 // multiple INSERT command
-$array = array(
+$array = [
 	'title' => 'Super Product',
 	'price' => 12,
-	'brand' => NULL,
+	'brand' => null,
 	'created' => new DateTime,
-);
-dibi::test("INSERT INTO products", $array, $array, $array);
+];
+$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(
+$dibi->test('
+	UPDATE colors SET', [
 		'color' => 'blue',
 		'order' => 12,
-	), "
-	WHERE id=?", 123);
+	], '
+	WHERE id=?', 123);
 // -> UPDATE colors SET [color]='blue', [order]=12 WHERE id=123
 
 
-
 // modifier applied to array
-$array = array(1, 2, 3);
-dibi::test("
+$array = [1, 2, 3];
+$dibi->test('
 	SELECT *
 	FROM people
-	WHERE id IN (?)", $array
+	WHERE id IN (?)', $array
 );
 // -> SELECT * FROM people WHERE id IN ( 1, 2, 3 )
 
 
-
 // modifier %by for ORDER BY
-$order = array(
+$order = [
 	'field1' => 'asc',
 	'field2' => 'desc',
-);
-dibi::test("
+];
+$dibi->test('
 	SELECT *
 	FROM people
-	ORDER BY %by", $order, "
-");
+	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"');
+$dibi->test('UPDATE [table] SET `item` = "5 1/4"" diskette"');
 // -> UPDATE [table] SET [item] = '5 1/4" diskette'

examples/result-set-data-types.php

@@ -1,45 +1,50 @@
+<?php
+
+use Dibi\Type;
+
+if (@!include __DIR__ . '/../vendor/autoload.php') {
+	die('Install dependencies using `composer install --dev`');
+}
+
+Tracy\Debugger::enable();
+
+date_default_timezone_set('Europe/Prague');
+
+?>
 <!DOCTYPE html><link rel="stylesheet" href="data/style.css">
 
-<h1>Result Set Data Types  | dibi</h1>
+<h1>Result Set Data Types | Dibi</h1>
 
 <?php
 
-require dirname(__FILE__) . '/Nette/Debugger.php';
-require dirname(__FILE__) . '/../dibi/dibi.php';
-
-ndebug();
-date_default_timezone_set('Europe/Prague');
-
-
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'data/sample.sdb',
-));
+$dibi = new Dibi\Connection([
+	'driver' => 'sqlite3',
+	'database' => 'data/sample.s3db',
+]);
 
 
 // using manual hints
-$res = dibi::query('SELECT * FROM [customers]');
+$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');
+$res->setType('customer_id', Type::INTEGER)
+	->setType('added', Type::DATETIME)
+	->setFormat(Type::DATETIME, 'Y-m-d H:i:s');
 
 
-dump( $res->fetch() );
+Tracy\Dumper::dump($res->fetch());
 // outputs:
-// DibiRow(3) {
+// Dibi\Row(3) {
 //    customer_id => 1
 //    name => "Dave Lister" (11)
 //    added => "2007-03-11 17:20:03" (19)
 
 
-
 // using auto-detection (works well with MySQL or other strictly typed databases)
-$res = dibi::query('SELECT * FROM [customers]');
+$res = $dibi->query('SELECT * FROM [customers]');
 
-dump( $res->fetch() );
+Tracy\Dumper::dump($res->fetch());
 // outputs:
-// DibiRow(3) {
+// Dibi\Row(3) {
 //    customer_id => 1
 //    name => "Dave Lister" (11)
 //    added => "2007-03-11 17:20:03" (19)

examples/tracy-and-exceptions.php

@@ -0,0 +1,33 @@
+<?php
+
+if (@!include __DIR__ . '/../vendor/autoload.php') {
+	die('Install dependencies using `composer install --dev`');
+}
+
+
+// enable Tracy
+Tracy\Debugger::enable();
+
+
+$dibi = new Dibi\Connection([
+	'driver' => 'sqlite3',
+	'database' => 'data/sample.s3db',
+	'profiler' => [
+		'run' => true,
+	],
+]);
+
+
+// add panel to debug bar
+$panel = new Dibi\Bridges\Tracy\Panel;
+$panel->register($dibi);
+
+
+// throws error because SQL is bad
+$dibi->query('SELECT FROM customers WHERE customer_id < ?', 38);
+
+?><!DOCTYPE html><link rel="stylesheet" href="data/style.css">
+
+<h1>Tracy & SQL Exceptions | dibi</h1>
+
+<p>Dibi can display and log exceptions via <a href="https://tracy.nette.org">Tracy</a>.</p>

examples/tracy.php

@@ -0,0 +1,40 @@
+<?php
+
+if (@!include __DIR__ . '/../vendor/autoload.php') {
+	die('Install dependencies using `composer install --dev`');
+}
+
+
+// enable Tracy
+Tracy\Debugger::enable();
+
+
+$dibi = new Dibi\Connection([
+	'driver' => 'sqlite3',
+	'database' => 'data/sample.s3db',
+	'profiler' => [
+		'run' => true,
+	],
+]);
+
+
+// add panel to debug bar
+$panel = new Dibi\Bridges\Tracy\Panel;
+$panel->register($dibi);
+
+
+// query will be logged
+$dibi->query('SELECT 123');
+
+// result set will be dumped
+Tracy\Debugger::barDump($dibi->fetchAll('SELECT * FROM customers WHERE customer_id < ?', 38), '[customers]');
+
+
+?>
+<!DOCTYPE html><link rel="stylesheet" href="data/style.css">
+
+<style> html { background: url(data/arrow.png) no-repeat bottom right; height: 100%; } </style>
+
+<h1>Tracy | dibi</h1>
+
+<p>Dibi can log queries and dump variables to the <a href="https://tracy.nette.org">Tracy</a>.</p>

examples/using-datetime.php

@@ -1,32 +1,31 @@
 <!DOCTYPE html><link rel="stylesheet" href="data/style.css">
 
-<h1>Using DateTime | dibi</h1>
+<h1>Using DateTime | Dibi</h1>
 
 <?php
 
-require dirname(__FILE__) . '/Nette/Debugger.php';
-require dirname(__FILE__) . '/../dibi/dibi.php';
+if (@!include __DIR__ . '/../vendor/autoload.php') {
+	die('Install packages using `composer install`');
+}
 
 date_default_timezone_set('Europe/Prague');
 
 
-
 // CHANGE TO REAL PARAMETERS!
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'data/sample.sdb',
+$dibi = new Dibi\Connection([
+	'driver' => 'sqlite3',
+	'database' => 'data/sample.s3db',
 	'formatDate' => "'Y-m-d'",
 	'formatDateTime' => "'Y-m-d H-i-s'",
-));
-
+]);
 
 
 // generate and dump SQL
-dibi::test("
-	INSERT INTO [mytable]", array(
-		'id'    => 123,
-		'date'  => new DateTime('12.3.2007'),
+$dibi->test('
+	INSERT INTO [mytable]', [
+		'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,31 +1,33 @@
+<?php
+
+if (@!include __DIR__ . '/../vendor/autoload.php') {
+	die('Install dependencies using `composer install --dev`');
+}
+
+Tracy\Debugger::enable();
+
+?>
 <!DOCTYPE html><link rel="stylesheet" href="data/style.css">
 
-<h1>Using Extension Methods | dibi</h1>
+<h1>Using Extension Methods | Dibi</h1>
 
 <?php
 
-require dirname(__FILE__) . '/Nette/Debugger.php';
-require dirname(__FILE__) . '/../dibi/dibi.php';
-
-ndebug();
-
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'data/sample.sdb',
-));
+$dibi = new Dibi\Connection([
+	'driver' => 'sqlite3',
+	'database' => 'data/sample.s3db',
+]);
 
 
-
-// using the "prototype" to add custom method to class DibiResult
-function DibiResult_prototype_fetchShuffle(DibiResult $obj)
-{
+// using the "prototype" to add custom method to class Dibi\Result
+Dibi\Result::extensionMethod('fetchShuffle', function (Dibi\Result $obj) {
 	$all = $obj->fetchAll();
 	shuffle($all);
 	return $all;
-}
+});
 
 
 // fetch complete result set shuffled
-$res = dibi::query('SELECT * FROM [customers]');
+$res = $dibi->query('SELECT * FROM [customers]');
 $all = $res->fetchShuffle();
-dump($all);
+Tracy\Dumper::dump($all);

examples/using-fluent-syntax.php

@@ -1,30 +1,31 @@
 <!DOCTYPE html><link rel="stylesheet" href="data/style.css">
 
-<h1>Using Fluent Syntax | dibi</h1>
+<h1>Using Fluent Syntax | Dibi</h1>
 
 <?php
 
-require dirname(__FILE__) . '/Nette/Debugger.php';
-require dirname(__FILE__) . '/../dibi/dibi.php';
+if (@!include __DIR__ . '/../vendor/autoload.php') {
+	die('Install packages using `composer install`');
+}
 
 date_default_timezone_set('Europe/Prague');
 
 
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'data/sample.sdb',
-));
+$dibi = new Dibi\Connection([
+	'driver' => 'sqlite3',
+	'database' => 'data/sample.s3db',
+]);
 
 
 $id = 10;
-$record = array(
-	'title'  => 'Super product',
-	'price'  => 318,
-	'active' => TRUE,
-);
+$record = [
+	'title' => 'Super product',
+	'price' => 318,
+	'active' => true,
+];
 
 // SELECT ...
-dibi::select('product_id')->as('id')
+$dibi->select('product_id')->as('id')
 	->select('title')
 	->from('products')
 	->innerJoin('orders')->using('(product_id)')
@@ -35,41 +36,36 @@ dibi::select('product_id')->as('id')
 //    USING (product_id) INNER JOIN customers USING (customer_id) ORDER BY [title]
 
 
-
 // SELECT ...
-echo dibi::select('title')->as('id')
+echo $dibi->select('title')->as('id')
 	->from('products')
 	->fetchSingle();
 // -> Chair (as result of query: SELECT [title] AS [id] FROM [products])
 
 
-
 // INSERT ...
-dibi::insert('products', $record)
+$dibi->insert('products', $record)
 	->setFlag('IGNORE')
 	->test();
 // -> INSERT IGNORE INTO [products] ([title], [price], [active]) VALUES ('Super product', 318, 1)
 
 
-
 // UPDATE ...
-dibi::update('products', $record)
+$dibi->update('products', $record)
 	->where('product_id = ?', $id)
 	->test();
 // -> UPDATE [products] SET [title]='Super product', [price]=318, [active]=1 WHERE product_id = 10
 
 
-
 // DELETE ...
-dibi::delete('products')
+$dibi->delete('products')
 	->where('product_id = ?', $id)
 	->test();
 // -> DELETE FROM [products] WHERE product_id = 10
 
 
-
 // custom commands
-dibi::command()
+$dibi->command()
 	->update('products')
 	->where('product_id = ?', $id)
 	->set($record)
@@ -77,8 +73,7 @@ dibi::command()
 // -> UPDATE [products] SET [title]='Super product', [price]=318, [active]=1 WHERE product_id = 10
 
 
-
-dibi::command()
+$dibi->command()
 	->truncate('products')
 	->test();
 // -> TRUNCATE [products]

examples/using-limit-and-offset.php

@@ -1,31 +1,30 @@
 <!DOCTYPE html><link rel="stylesheet" href="data/style.css">
 
-<h1>Using Limit & Offset | dibi</h1>
+<h1>Using Limit & Offset | Dibi</h1>
 
 <?php
 
-require dirname(__FILE__) . '/Nette/Debugger.php';
-require dirname(__FILE__) . '/../dibi/dibi.php';
+if (@!include __DIR__ . '/../vendor/autoload.php') {
+	die('Install packages using `composer install`');
+}
 
 
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'data/sample.sdb',
-));
+$dibi = new Dibi\Connection([
+	'driver' => 'sqlite3',
+	'database' => 'data/sample.s3db',
+]);
 
 
 // no limit
-dibi::test('SELECT * FROM [products]');
+$dibi->test('SELECT * FROM [products]');
 // -> SELECT * FROM [products]
 
 
-
 // with limit = 2
-dibi::test('SELECT * FROM [products] %lmt', 2);
+$dibi->test('SELECT * FROM [products] %lmt', 2);
 // -> SELECT * FROM [products] LIMIT 2
 
 
-
 // with limit = 2, offset = 1
-dibi::test('SELECT * FROM [products] %lmt %ofs', 2, 1);
+$dibi->test('SELECT * FROM [products] %lmt %ofs', 2, 1);
 // -> SELECT * FROM [products] LIMIT 2 OFFSET 1

examples/using-logger.php

@@ -1,40 +1,39 @@
 <!DOCTYPE html><link rel="stylesheet" href="data/style.css">
 
-<h1>Using Logger | dibi</h1>
+<h1>Using Logger | Dibi</h1>
 
 <?php
 
-require dirname(__FILE__) . '/Nette/Debugger.php';
-require dirname(__FILE__) . '/../dibi/dibi.php';
+if (@!include __DIR__ . '/../vendor/autoload.php') {
+	die('Install packages using `composer install`');
+}
 
 date_default_timezone_set('Europe/Prague');
 
 
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'data/sample.sdb',
+$dibi = new Dibi\Connection([
+	'driver' => 'sqlite3',
+	'database' => 'data/sample.s3db',
 	// enable query logging to this file
-	'profiler' => array(
-		'run' => TRUE,
+	'profiler' => [
+		'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] = ?', 1);
 
-	$res = dibi::query('SELECT * FROM [customers] WHERE [customer_id] < ?', 5);
+	$res = $dibi->query('SELECT * FROM [customers] WHERE [customer_id] < ?', 5);
 
-	$res = dibi::query('SELECT FROM [customers] WHERE [customer_id] < ?', 38);
-
-} catch (DibiException $e) {
+	$res = $dibi->query('SELECT FROM [customers] WHERE [customer_id] < ?', 38);
+} catch (Dibi\Exception $e) {
 	echo '<p>', get_class($e), ': ', $e->getMessage(), '</p>';
 }
 
 
 // outputs a log file
-echo "<h2>File data/log.sql:</h2>";
+echo '<h2>File data/log.sql:</h2>';
 
 echo '<pre>', file_get_contents('data/log.sql'), '</pre>';

examples/using-profiler.php

@@ -1,27 +1,28 @@
-<?php ob_start(1) // needed by FirePHP ?>
+<?php ob_start() // needed by FirePHP ?>
 
 <!DOCTYPE html><link rel="stylesheet" href="data/style.css">
 
-<h1>Using Profiler | dibi</h1>
+<h1>Using Profiler | Dibi</h1>
 
 <?php
 
-require dirname(__FILE__) . '/Nette/Debugger.php';
-require dirname(__FILE__) . '/../dibi/dibi.php';
+if (@!include __DIR__ . '/../vendor/autoload.php') {
+	die('Install packages using `composer install`');
+}
 
 
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'data/sample.sdb',
-	'profiler' => array(
-		'run' => TRUE,
-	)
-));
+$dibi = new Dibi\Connection([
+	'driver' => 'sqlite3',
+	'database' => 'data/sample.s3db',
+	'profiler' => [
+		'run' => true,
+	],
+]);
 
 
 // execute some queries...
-for ($i=0; $i<20; $i++) {
-	$res = dibi::query('SELECT * FROM [customers] WHERE [customer_id] < ?', $i);
+for ($i = 0; $i < 20; $i++) {
+	$res = $dibi->query('SELECT * FROM [customers] WHERE [customer_id] < ?', $i);
 }
 
 // display output

examples/using-substitutions.php

@@ -1,41 +1,34 @@
 <!DOCTYPE html><link rel="stylesheet" href="data/style.css">
 
-<h1>Using Substitutions | dibi</h1>
+<h1>Using Substitutions | Dibi</h1>
 
 <?php
 
-require dirname(__FILE__) . '/Nette/Debugger.php';
-require dirname(__FILE__) . '/../dibi/dibi.php';
-
-
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'data/sample.sdb',
-));
+if (@!include __DIR__ . '/../vendor/autoload.php') {
+	die('Install packages using `composer install`');
+}
 
 
+$dibi = new Dibi\Connection([
+	'driver' => 'sqlite3',
+	'database' => 'data/sample.s3db',
+]);
 
 
 // create new substitution :blog:  ==>  wp_
-dibi::getSubstitutes()->blog = 'wp_';
+$dibi->getSubstitutes()->blog = 'wp_';
 
-dibi::test("SELECT * FROM [:blog:items]");
+$dibi->test('SELECT * FROM [:blog:items]');
 // -> SELECT * FROM [wp_items]
 
 
-
-
-
 // create new substitution :: (empty)  ==>  my_
-dibi::getSubstitutes()->{''} = 'my_';
+$dibi->getSubstitutes()->{''} = 'my_';
 
-dibi::test("UPDATE ::table SET [text]='Hello World'");
+$dibi->test("UPDATE ::table SET [text]='Hello World'");
 // -> UPDATE my_table SET [text]='Hello World'
 
 
-
-
-
 // create substitutions using fallback callback
 function substFallBack($expr)
 {
@@ -47,14 +40,15 @@ function substFallBack($expr)
 	}
 }
 
+
 // define callback
-dibi::getSubstitutes()->setCallback('substFallBack');
+$dibi->getSubstitutes()->setCallback('substFallBack');
 
 // define substitutes as constants
 define('SUBST_ACCOUNT', 'eshop_');
 define('SUBST_ACTIVE', 7);
 
-dibi::test("
+$dibi->test("
 	UPDATE :account:user
 	SET name='John Doe', status=:active:
 	WHERE id=", 7

examples/using-transactions.php

@@ -1,35 +1,36 @@
 <!DOCTYPE html><link rel="stylesheet" href="data/style.css">
 
-<h1>Using Transactions | dibi</h1>
+<h1>Using Transactions | Dibi</h1>
 
 <?php
 
-require dirname(__FILE__) . '/Nette/Debugger.php';
-require dirname(__FILE__) . '/../dibi/dibi.php';
+if (@!include __DIR__ . '/../vendor/autoload.php') {
+	die('Install packages using `composer install`');
+}
 
 
-dibi::connect(array(
-	'driver'   => 'sqlite',
-	'database' => 'data/sample.sdb',
-));
+$dibi = new Dibi\Connection([
+	'driver' => 'sqlite3',
+	'database' => 'data/sample.s3db',
+]);
 
 
 echo "<h2>Before</h2>\n";
-dibi::query('SELECT * FROM [products]')->dump();
+$dibi->query('SELECT * FROM [products]')->dump();
 // -> 3 rows
 
 
-dibi::begin();
-dibi::query('INSERT INTO [products]', array(
+$dibi->begin();
+$dibi->query('INSERT INTO [products]', [
 	'title' => 'Test product',
-));
+]);
 
 echo "<h2>After INSERT</h2>\n";
-dibi::query('SELECT * FROM [products]')->dump();
+$dibi->query('SELECT * FROM [products]')->dump();
 
 
-dibi::rollback(); // or dibi::commit();
+$dibi->rollback(); // or $dibi->commit();
 
 echo "<h2>After rollback</h2>\n";
-dibi::query('SELECT * FROM [products]')->dump();
+$dibi->query('SELECT * FROM [products]')->dump();
 // -> 3 rows again

license.md

@@ -13,11 +13,10 @@ use Dibi in commercial projects as long as the copyright header
 remains intact.
 
 
-
 New BSD License
 ---------------
 
-Copyright (c) 2004, 2013 David Grudl (http://davidgrudl.com)
+Copyright (c) 2004, 2014 David Grudl (https://davidgrudl.com)
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without modification,
@@ -46,7 +45,6 @@ any theory of liability, whether in contract, strict liability, or tort
 software, even if advised of the possibility of such damage.
 
 
-
 GNU General Public License
 --------------------------
 

readme.md

@@ -1,18 +1,141 @@
-[Dibi](http://dibiphp.com) - smart database layer for PHP
+[Dibi](https://dibiphp.com) - smart database layer for PHP  [![Buy me a coffee](https://files.nette.org/images/coffee1s.png)](https://nette.org/make-donation?to=dibi)
 =========================================================
 
+[![Downloads this Month](https://img.shields.io/packagist/dm/dibi/dibi.svg)](https://packagist.org/packages/dibi/dibi)
+[![Build Status](https://travis-ci.org/dg/dibi.svg?branch=master)](https://travis-ci.org/dg/dibi)
+[![Build Status Windows](https://ci.appveyor.com/api/projects/status/github/dg/dibi?branch=master&svg=true)](https://ci.appveyor.com/project/dg/dibi/branch/master)
+[![Latest Stable Version](https://poser.pugx.org/dibi/dibi/v/stable)](https://github.com/dg/dibi/releases)
+[![License](https://img.shields.io/badge/license-New%20BSD-blue.svg)](https://github.com/dg/dibi/blob/master/license.md)
+
+
+Introduction
+------------
+
 Database access functions in PHP are not standardised. This library
-hides the differences between them, a above all, it gives you a very handy interface.
+hides the differences between them, and above all, it gives you a very handy interface.
 
-The best way how to install Dibi is to use a [Composer](http://getcomposer.org/download):
+If you like Dibi, **[please make a donation now](https://nette.org/make-donation?to=dibi)**. Thank you!
 
-    php composer.phar require dibi/dibi
 
-Or you can download a latest package from http://dibiphp.com. In this
-package is also `Dibi.minified`, shrinked single-file version of whole Dibi,
-useful when you don't want to modify library, but just use it.
+Installation
+------------
+
+The recommended way to install Dibi is via Composer (alternatively you can [download package](https://github.com/dg/dibi/releases)):
+
+```bash
+composer require dibi/dibi
+```
+
+The Dibi 3.x requires PHP version 5.4.4 and supports PHP up to 7.2.
+
+
+Usage
+-----
 
 Refer to the `examples` directory for examples. Dibi documentation is
-available on the [homepage](http://dibiphp.com).
+available on the [homepage](https://dibiphp.com).
 
-Dibi requires PHP 5.2.0 or later. It has been tested with PHP 5.5 too.
+Connect to database:
+
+```php
+$dibi = new Dibi\Connection([
+    'driver'   => 'mysqli',
+    'host'     => 'localhost',
+    'username' => 'root',
+    'password' => '***',
+]);
+
+
+// or static way; in all other examples use dibi:: instead of $dibi->
+dibi::connect($options);
+```
+
+SELECT, INSERT, UPDATE
+
+```php
+$dibi->query('SELECT * FROM users WHERE id = ?', $id);
+
+$arr = [
+    'name' => 'John',
+    'is_admin'  => true,
+];
+$dibi->query('INSERT INTO users', $arr);
+// INSERT INTO users (`name`, `is_admin`) VALUES ('John', 1)
+
+$dibi->query('UPDATE users SET', $arr, 'WHERE `id`=?', $x);
+// UPDATE users SET `name`='John', `is_admin`=1 WHERE `id` = 123
+
+$dibi->query('UPDATE users SET', [
+	'title' => array('SHA1(?)', 'tajneheslo'),
+]);
+// UPDATE users SET 'title' = SHA1('tajneheslo')
+```
+
+Getting results
+
+```php
+$result = $dibi->query('SELECT * FROM users');
+
+$value = $result->fetchSingle(); // single value
+$all = $result->fetchAll(); // all rows
+$assoc = $result->fetchAssoc('id'); // all rows as associative array
+$pairs = $result->fetchPairs('customerID', 'name'); // all rows as key => value pairs
+
+// iterating
+foreach ($result as $n => $row) {
+    print_r($row);
+}
+```
+
+Modifiers for arrays:
+
+```php
+$dibi->query('SELECT * FROM users WHERE %and', [
+	array('number > ?', 10),
+	array('number < ?', 100),
+]);
+// SELECT * FROM users WHERE (number > 10) AND (number < 100)
+```
+
+<table>
+<tr><td> %and </td><td>  </td><td> `[key]=val AND [key2]="val2" AND ...` </td></tr>
+<tr><td> %or </td><td>  </td><td> `[key]=val OR [key2]="val2" OR ...` </td></tr>
+<tr><td> %a </td><td> assoc </td><td> `[key]=val, [key2]="val2", ...` </td></tr>
+<tr><td> %l %in </td><td> list </td><td> `(val, "val2", ...)` </td></tr>
+<tr><td> %v </td><td> values </td><td> `([key], [key2], ...) VALUES (val, "val2", ...)` </td></tr>
+<tr><td> %m </td><td> multivalues </td><td> `([key], [key2], ...) VALUES (val, "val2", ...), (val, "val2", ...), ...` </td></tr>
+<tr><td> %by </td><td> ordering </td><td> `[key] ASC, [key2] DESC ...` </td></tr>
+<tr><td> %n </td><td> identifiers </td><td> `[key], [key2] AS alias, ...` </td></tr>
+<tr><td> other  </td><td> - </td><td> `val, val2, ...` </td></tr>
+</table>
+
+
+Modifiers for LIKE
+
+```php
+$dibi->query("SELECT * FROM table WHERE name LIKE %like~", $query);
+```
+
+<table>
+<tr><td> %like~	</td><td> begins with </td></tr>
+<tr><td> %~like	</td><td> ends with </td></tr>
+<tr><td> %~like~ </td><td> contains </td></tr>
+</table>
+
+DateTime:
+
+```php
+$dibi->query('UPDATE users SET', [
+    'time' => new DateTime,
+]);
+// UPDATE users SET ('2008-01-01 01:08:10')
+```
+
+Testing:
+
+```php
+echo dibi::$sql; // last SQL query
+echo dibi::$elapsedTime;
+echo dibi::$numOfQueries;
+echo dibi::$totalTime;
+```

src/Dibi/Bridges/Nette/DibiExtension22.php

@@ -0,0 +1,71 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi\Bridges\Nette;
+
+use Dibi;
+use Nette;
+
+
+/**
+ * Dibi extension for Nette Framework 2.2. Creates 'connection' & 'panel' services.
+ */
+class DibiExtension22 extends Nette\DI\CompilerExtension
+{
+	/** @var bool */
+	private $debugMode;
+
+
+	public function __construct($debugMode = null)
+	{
+		$this->debugMode = $debugMode;
+	}
+
+
+	public function loadConfiguration()
+	{
+		$container = $this->getContainerBuilder();
+		$config = $this->getConfig();
+
+		if ($this->debugMode === null) {
+			$this->debugMode = $container->parameters['debugMode'];
+		}
+
+		$useProfiler = isset($config['profiler'])
+			? $config['profiler']
+			: class_exists('Tracy\Debugger') && $this->debugMode;
+
+		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'))
+			->setFactory('Dibi\Connection', [$config])
+			->setAutowired(isset($config['autowired']) ? $config['autowired'] : true);
+
+		if (class_exists('Tracy\Debugger')) {
+			$connection->addSetup(
+				[new Nette\DI\Statement('Tracy\Debugger::getBlueScreen'), 'addPanel'],
+				[['Dibi\Bridges\Tracy\Panel', 'renderException']]
+			);
+		}
+		if ($useProfiler) {
+			$panel = $container->addDefinition($this->prefix('panel'))
+				->setFactory('Dibi\Bridges\Tracy\Panel', [
+					isset($config['explain']) ? $config['explain'] : true,
+					isset($config['filter']) && $config['filter'] === false ? Dibi\Event::ALL : Dibi\Event::QUERY,
+				]);
+			$connection->addSetup([$panel, 'register'], [$connection]);
+		}
+	}
+}

src/Dibi/Bridges/Nette/config.sample.neon

@@ -1,12 +1,12 @@
 # This will create service named 'dibi.connection'.
-# Requires Nette Framework 2.1
+# Requires Nette Framework 2.2 or later
 
 extensions:
-	dibi: DibiNette21Extension
+	dibi: Dibi\Bridges\Nette\DibiExtension22
 
 dibi:
 	host: localhost
 	username: root
 	password: ***
 	database: foo
-	lazy: TRUE
+	lazy: true

src/Dibi/Bridges/Tracy/Panel.php

@@ -0,0 +1,154 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi\Bridges\Tracy;
+
+use Dibi;
+use Dibi\Event;
+use Dibi\Helpers;
+use Tracy;
+
+
+/**
+ * Dibi panel for Tracy.
+ */
+class Panel implements Tracy\IBarPanel
+{
+	use Dibi\Strict;
+
+	/** @var int maximum SQL length */
+	public static $maxLength = 1000;
+
+	/** @var bool|string  explain queries? */
+	public $explain;
+
+	/** @var int */
+	public $filter;
+
+	/** @var array */
+	private $events = [];
+
+
+	public function __construct($explain = true, $filter = null)
+	{
+		$this->filter = $filter ? (int) $filter : Event::QUERY;
+		$this->explain = $explain;
+	}
+
+
+	public function register(Dibi\Connection $connection)
+	{
+		Tracy\Debugger::getBar()->addPanel($this);
+		Tracy\Debugger::getBlueScreen()->addPanel([__CLASS__, 'renderException']);
+		$connection->onEvent[] = [$this, 'logEvent'];
+	}
+
+
+	/**
+	 * After event notification.
+	 * @return void
+	 */
+	public function logEvent(Event $event)
+	{
+		if (($event->type & $this->filter) === 0) {
+			return;
+		}
+		$this->events[] = $event;
+	}
+
+
+	/**
+	 * Returns blue-screen custom tab.
+	 * @return array|null
+	 */
+	public static function renderException($e)
+	{
+		if ($e instanceof Dibi\Exception && $e->getSql()) {
+			return [
+				'tab' => 'SQL',
+				'panel' => Helpers::dump($e->getSql(), true),
+			];
+		}
+	}
+
+
+	/**
+	 * Returns HTML code for custom tab. (Tracy\IBarPanel)
+	 * @return string
+	 */
+	public function getTab()
+	{
+		$totalTime = 0;
+		$count = count($this->events);
+		foreach ($this->events as $event) {
+			$totalTime += $event->time;
+		}
+		return '<span title="dibi"><svg viewBox="0 0 2048 2048" style="vertical-align: bottom; width:1.23em; height:1.55em"><path fill="' . ($count ? '#b079d6' : '#aaa') . '" d="M1024 896q237 0 443-43t325-127v170q0 69-103 128t-280 93.5-385 34.5-385-34.5-280-93.5-103-128v-170q119 84 325 127t443 43zm0 768q237 0 443-43t325-127v170q0 69-103 128t-280 93.5-385 34.5-385-34.5-280-93.5-103-128v-170q119 84 325 127t443 43zm0-384q237 0 443-43t325-127v170q0 69-103 128t-280 93.5-385 34.5-385-34.5-280-93.5-103-128v-170q119 84 325 127t443 43zm0-1152q208 0 385 34.5t280 93.5 103 128v128q0 69-103 128t-280 93.5-385 34.5-385-34.5-280-93.5-103-128v-128q0-69 103-128t280-93.5 385-34.5z"/></svg><span class="tracy-label">'
+			. $count . ' queries'
+			. ($totalTime ? ' / ' . number_format($totalTime * 1000, 1, '.', ' ') . ' ms' : '')
+			. '</span></span>';
+	}
+
+
+	/**
+	 * Returns HTML code for custom panel. (Tracy\IBarPanel)
+	 * @return string|null
+	 */
+	public function getPanel()
+	{
+		if (!$this->events) {
+			return null;
+		}
+
+		$totalTime = $s = null;
+		foreach ($this->events as $event) {
+			$totalTime += $event->time;
+			$connection = $event->connection;
+			$explain = null; // EXPLAIN is called here to work SELECT FOUND_ROWS()
+			if ($this->explain && $event->type === Event::SELECT) {
+				$backup = [$connection->onEvent, \dibi::$numOfQueries, \dibi::$totalTime];
+				$connection->onEvent = null;
+				$cmd = is_string($this->explain) ? $this->explain : ($connection->getConfig('driver') === 'oracle' ? 'EXPLAIN PLAN FOR' : 'EXPLAIN');
+				try {
+					$explain = @Helpers::dump($connection->nativeQuery("$cmd $event->sql"), true);
+				} catch (Dibi\Exception $e) {
+				}
+				list($connection->onEvent, \dibi::$numOfQueries, \dibi::$totalTime) = $backup;
+			}
+
+			$s .= '<tr><td>' . number_format($event->time * 1000, 3, '.', ' ');
+			if ($explain) {
+				static $counter;
+				$counter++;
+				$s .= "<br /><a href='#tracy-debug-DibiProfiler-row-$counter' class='tracy-toggle tracy-collapsed' rel='#tracy-debug-DibiProfiler-row-$counter'>explain</a>";
+			}
+
+			$s .= '</td><td class="tracy-DibiProfiler-sql">' . Helpers::dump(strlen($event->sql) > self::$maxLength ? substr($event->sql, 0, self::$maxLength) . '...' : $event->sql, true);
+			if ($explain) {
+				$s .= "<div id='tracy-debug-DibiProfiler-row-$counter' class='tracy-collapsed'>{$explain}</div>";
+			}
+			if ($event->source) {
+				$s .= Tracy\Helpers::editorLink($event->source[0], $event->source[1]);//->class('tracy-DibiProfiler-source');
+			}
+
+			$s .= "</td><td>{$event->count}</td></tr>";
+		}
+
+		return '<style> #tracy-debug td.tracy-DibiProfiler-sql { background: white !important }
+			#tracy-debug .tracy-DibiProfiler-source { color: #999 !important }
+			#tracy-debug tracy-DibiProfiler tr table { margin: 8px 0; max-height: 150px; overflow:auto } </style>
+			<h1>Queries: ' . count($this->events)
+				. ($totalTime === null ? '' : ', time: ' . number_format($totalTime * 1000, 1, '.', ' ') . ' ms') . ', '
+				. htmlspecialchars($connection->getConfig('driver') . ($connection->getConfig('name') ? '/' . $connection->getConfig('name') : '')
+				. ($connection->getConfig('host') ? ' @ ' . $connection->getConfig('host') : '')) . '</h1>
+			<div class="tracy-inner tracy-DibiProfiler">
+			<table>
+				<tr><th>Time&nbsp;ms</th><th>SQL Statement</th><th>Rows</th></tr>' . $s . '
+			</table>
+			</div>';
+	}
+}

src/Dibi/Connection.php

@@ -0,0 +1,696 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi;
+
+use Traversable;
+
+
+/**
+ * Dibi connection.
+ *
+ * @property-read int $affectedRows
+ * @property-read int $insertId
+ */
+class Connection
+{
+	use Strict;
+
+	/** @var array of function (Event $event); Occurs after query is executed */
+	public $onEvent;
+
+	/** @var array  Current connection configuration */
+	private $config;
+
+	/** @var Driver */
+	private $driver;
+
+	/** @var Translator|null */
+	private $translator;
+
+	/** @var bool  Is connected? */
+	private $connected = false;
+
+	/** @var HashMap Substitutes for identifiers */
+	private $substitutes;
+
+
+	/**
+	 * 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 Exception
+	 */
+	public function __construct($config, $name = null)
+	{
+		if (is_string($config)) {
+			parse_str($config, $config);
+
+		} elseif ($config instanceof Traversable) {
+			$tmp = [];
+			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 object.');
+		}
+
+		Helpers::alias($config, 'username', 'user');
+		Helpers::alias($config, 'password', 'pass');
+		Helpers::alias($config, 'host', 'hostname');
+		Helpers::alias($config, 'result|formatDate', 'resultDate');
+		Helpers::alias($config, 'result|formatDateTime', 'resultDateTime');
+
+		if (!isset($config['driver'])) {
+			$config['driver'] = \dibi::$defaultDriver;
+		}
+
+		if ($config['driver'] instanceof Driver) {
+			$this->driver = $config['driver'];
+			$config['driver'] = get_class($this->driver);
+		} elseif (is_subclass_of($config['driver'], 'Dibi\Driver')) {
+			$this->driver = new $config['driver'];
+		} else {
+			$class = preg_replace(['#\W#', '#sql#'], ['_', 'Sql'], ucfirst(strtolower($config['driver'])));
+			$class = "Dibi\\Drivers\\{$class}Driver";
+			if (!class_exists($class)) {
+				throw new Exception("Unable to create instance of dibi driver '$class'.");
+			}
+			$this->driver = new $class;
+		}
+
+		$config['name'] = $name;
+		$this->config = $config;
+
+		// profiler
+		$profilerCfg = &$config['profiler'];
+		if (is_scalar($profilerCfg)) {
+			$profilerCfg = ['run' => (bool) $profilerCfg];
+		}
+		if (!empty($profilerCfg['run'])) {
+			$filter = isset($profilerCfg['filter']) ? $profilerCfg['filter'] : Event::QUERY;
+
+			if (isset($profilerCfg['file'])) {
+				$this->onEvent[] = [new Loggers\FileLogger($profilerCfg['file'], $filter), 'logEvent'];
+			}
+
+			if (Loggers\FirePhpLogger::isAvailable()) {
+				$this->onEvent[] = [new Loggers\FirePhpLogger($filter), 'logEvent'];
+			}
+		}
+
+		$this->substitutes = new HashMap(function ($expr) { return ":$expr:"; });
+		if (!empty($config['substitutes'])) {
+			foreach ($config['substitutes'] as $key => $value) {
+				$this->substitutes->$key = $value;
+			}
+		}
+
+		if (empty($config['lazy'])) {
+			$this->connect();
+		}
+	}
+
+
+	/**
+	 * Automatically frees the resources allocated for this result set.
+	 * @return void
+	 */
+	public function __destruct()
+	{
+		if ($this->connected && $this->driver->getResource()) {
+			$this->disconnect();
+		}
+	}
+
+
+	/**
+	 * Connects to a database.
+	 * @return void
+	 */
+	final public function connect()
+	{
+		$event = $this->onEvent ? new Event($this, Event::CONNECT) : null;
+		try {
+			$this->driver->connect($this->config);
+			$this->connected = true;
+			if ($event) {
+				$this->onEvent($event->done());
+			}
+
+		} catch (Exception $e) {
+			if ($event) {
+				$this->onEvent($event->done($e));
+			}
+			throw $e;
+		}
+	}
+
+
+	/**
+	 * Disconnects from a database.
+	 * @return void
+	 */
+	final public function disconnect()
+	{
+		$this->driver->disconnect();
+		$this->connected = false;
+	}
+
+
+	/**
+	 * Returns true when connection was established.
+	 * @return bool
+	 */
+	final public function isConnected()
+	{
+		return $this->connected;
+	}
+
+
+	/**
+	 * Returns configuration variable. If no $key is passed, returns the entire array.
+	 * @see self::__construct
+	 * @param  string
+	 * @param  mixed  default value to use if key not found
+	 * @return mixed
+	 */
+	final public function getConfig($key = null, $default = null)
+	{
+		if ($key === null) {
+			return $this->config;
+
+		} elseif (isset($this->config[$key])) {
+			return $this->config[$key];
+
+		} else {
+			return $default;
+		}
+	}
+
+
+	/** @deprecated */
+	public static function alias(&$config, $key, $alias)
+	{
+		trigger_error(__METHOD__ . '() is deprecated, use Helpers::alias().', E_USER_DEPRECATED);
+		Helpers::alias($config, $key, $alias);
+	}
+
+
+	/**
+	 * Returns the driver and connects to a database in lazy mode.
+	 * @return Driver
+	 */
+	final public function getDriver()
+	{
+		if (!$this->connected) {
+			$this->connect();
+		}
+		return $this->driver;
+	}
+
+
+	/**
+	 * Generates (translates) and executes SQL query.
+	 * @param  array|mixed      one or more arguments
+	 * @return Result|int   result set or number of affected rows
+	 * @throws Exception
+	 */
+	final public function query($args)
+	{
+		$args = func_get_args();
+		return $this->nativeQuery($this->translateArgs($args));
+	}
+
+
+	/**
+	 * Generates SQL query.
+	 * @param  array|mixed      one or more arguments
+	 * @return string
+	 * @throws Exception
+	 */
+	final public function translate($args)
+	{
+		$args = func_get_args();
+		return $this->translateArgs($args);
+	}
+
+
+	/**
+	 * Generates and prints SQL query.
+	 * @param  array|mixed  one or more arguments
+	 * @return bool
+	 */
+	final public function test($args)
+	{
+		$args = func_get_args();
+		try {
+			Helpers::dump($this->translateArgs($args));
+			return true;
+
+		} catch (Exception $e) {
+			if ($e->getSql()) {
+				Helpers::dump($e->getSql());
+			} else {
+				echo get_class($e) . ': ' . $e->getMessage() . (PHP_SAPI === 'cli' ? "\n" : '<br>');
+			}
+			return false;
+		}
+	}
+
+
+	/**
+	 * Generates (translates) and returns SQL query as DataSource.
+	 * @param  array|mixed      one or more arguments
+	 * @return DataSource
+	 * @throws Exception
+	 */
+	final public function dataSource($args)
+	{
+		$args = func_get_args();
+		return new DataSource($this->translateArgs($args), $this);
+	}
+
+
+	/**
+	 * Generates SQL query.
+	 * @param  array
+	 * @return string
+	 */
+	protected function translateArgs($args)
+	{
+		if (!$this->connected) {
+			$this->connect();
+		}
+		if (!$this->translator) {
+			$this->translator = new Translator($this);
+		}
+		$translator = clone $this->translator;
+		return $translator->translate($args);
+	}
+
+
+	/**
+	 * Executes the SQL query.
+	 * @param  string           SQL statement.
+	 * @return Result|int   result set or number of affected rows
+	 * @throws Exception
+	 */
+	final public function nativeQuery($sql)
+	{
+		if (!$this->connected) {
+			$this->connect();
+		}
+
+		\dibi::$sql = $sql;
+		$event = $this->onEvent ? new Event($this, Event::QUERY, $sql) : null;
+		try {
+			$res = $this->driver->query($sql);
+
+		} catch (Exception $e) {
+			if ($event) {
+				$this->onEvent($event->done($e));
+			}
+			throw $e;
+		}
+
+		if ($res) {
+			$res = $this->createResultSet($res);
+		} else {
+			$res = $this->driver->getAffectedRows();
+		}
+
+		if ($event) {
+			$this->onEvent($event->done($res));
+		}
+		return $res;
+	}
+
+
+	/**
+	 * Gets the number of affected rows by the last INSERT, UPDATE or DELETE query.
+	 * @return int  number of rows
+	 * @throws Exception
+	 */
+	public function getAffectedRows()
+	{
+		if (!$this->connected) {
+			$this->connect();
+		}
+		$rows = $this->driver->getAffectedRows();
+		if (!is_int($rows) || $rows < 0) {
+			throw new Exception('Cannot retrieve number of affected rows.');
+		}
+		return $rows;
+	}
+
+
+	/**
+	 * @deprecated
+	 */
+	public function affectedRows()
+	{
+		trigger_error(__METHOD__ . '() is deprecated, use getAffectedRows()', E_USER_DEPRECATED);
+		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 Exception
+	 */
+	public function getInsertId($sequence = null)
+	{
+		if (!$this->connected) {
+			$this->connect();
+		}
+		$id = $this->driver->getInsertId($sequence);
+		if ($id < 1) {
+			throw new Exception('Cannot retrieve last generated ID.');
+		}
+		return Helpers::intVal($id);
+	}
+
+
+	/**
+	 * @deprecated
+	 */
+	public function insertId($sequence = null)
+	{
+		trigger_error(__METHOD__ . '() is deprecated, use getInsertId()', E_USER_DEPRECATED);
+		return $this->getInsertId($sequence);
+	}
+
+
+	/**
+	 * Begins a transaction (if supported).
+	 * @param  string  optional savepoint name
+	 * @return void
+	 */
+	public function begin($savepoint = null)
+	{
+		if (!$this->connected) {
+			$this->connect();
+		}
+		$event = $this->onEvent ? new Event($this, Event::BEGIN, $savepoint) : null;
+		try {
+			$this->driver->begin($savepoint);
+			if ($event) {
+				$this->onEvent($event->done());
+			}
+
+		} catch (Exception $e) {
+			if ($event) {
+				$this->onEvent($event->done($e));
+			}
+			throw $e;
+		}
+	}
+
+
+	/**
+	 * Commits statements in a transaction.
+	 * @param  string  optional savepoint name
+	 * @return void
+	 */
+	public function commit($savepoint = null)
+	{
+		if (!$this->connected) {
+			$this->connect();
+		}
+		$event = $this->onEvent ? new Event($this, Event::COMMIT, $savepoint) : null;
+		try {
+			$this->driver->commit($savepoint);
+			if ($event) {
+				$this->onEvent($event->done());
+			}
+
+		} catch (Exception $e) {
+			if ($event) {
+				$this->onEvent($event->done($e));
+			}
+			throw $e;
+		}
+	}
+
+
+	/**
+	 * Rollback changes in a transaction.
+	 * @param  string  optional savepoint name
+	 * @return void
+	 */
+	public function rollback($savepoint = null)
+	{
+		if (!$this->connected) {
+			$this->connect();
+		}
+		$event = $this->onEvent ? new Event($this, Event::ROLLBACK, $savepoint) : null;
+		try {
+			$this->driver->rollback($savepoint);
+			if ($event) {
+				$this->onEvent($event->done());
+			}
+
+		} catch (Exception $e) {
+			if ($event) {
+				$this->onEvent($event->done($e));
+			}
+			throw $e;
+		}
+	}
+
+
+	/**
+	 * Result set factory.
+	 * @param  ResultDriver
+	 * @return Result
+	 */
+	public function createResultSet(ResultDriver $resultDriver)
+	{
+		$res = new Result($resultDriver);
+		return $res->setFormat(Type::DATE, $this->config['result']['formatDate'])
+			->setFormat(Type::DATETIME, $this->config['result']['formatDateTime']);
+	}
+
+
+	/********************* fluent SQL builders ****************d*g**/
+
+
+	/**
+	 * @return Fluent
+	 */
+	public function command()
+	{
+		return new Fluent($this);
+	}
+
+
+	/**
+	 * @param  mixed    column name
+	 * @return Fluent
+	 */
+	public function select($args)
+	{
+		$args = func_get_args();
+		return $this->command()->__call('select', $args);
+	}
+
+
+	/**
+	 * @param  string   table
+	 * @param  array
+	 * @return Fluent
+	 */
+	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);
+	}
+
+
+	/**
+	 * @param  string   table
+	 * @param  array
+	 * @return Fluent
+	 */
+	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', $args);
+	}
+
+
+	/**
+	 * @param  string   table
+	 * @return Fluent
+	 */
+	public function delete($table)
+	{
+		return $this->command()->delete()->from('%n', $table);
+	}
+
+
+	/********************* substitutions ****************d*g**/
+
+
+	/**
+	 * Returns substitution hashmap.
+	 * @return HashMap
+	 */
+	public function getSubstitutes()
+	{
+		return $this->substitutes;
+	}
+
+
+	/**
+	 * Provides substitution.
+	 * @return string
+	 */
+	public function substitute($value)
+	{
+		return strpos($value, ':') === false
+			? $value
+			: preg_replace_callback('#:([^:\s]*):#', function ($m) { return $this->substitutes->{$m[1]}; }, $value);
+	}
+
+
+	/********************* shortcuts ****************d*g**/
+
+
+	/**
+	 * Executes SQL query and fetch result - shortcut for query() & fetch().
+	 * @param  array|mixed    one or more arguments
+	 * @return Row|false
+	 * @throws Exception
+	 */
+	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 Row[]|array[]
+	 * @throws Exception
+	 */
+	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 mixed
+	 * @throws Exception
+	 */
+	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 array
+	 * @throws Exception
+	 */
+	public function fetchPairs($args)
+	{
+		$args = func_get_args();
+		return $this->query($args)->fetchPairs();
+	}
+
+
+	/**
+	 * @return Literal
+	 */
+	public static function literal($value)
+	{
+		return new Literal($value);
+	}
+
+
+	/********************* misc ****************d*g**/
+
+
+	/**
+	 * Import SQL dump from file.
+	 * @param  string  filename
+	 * @param  callable  function (int $count, ?float $percent): void
+	 * @return int  count of sql commands
+	 */
+	public function loadFile($file, callable $onProgress = null)
+	{
+		return Helpers::loadFromFile($this, $file, $onProgress);
+	}
+
+
+	/**
+	 * Gets a information about the current database.
+	 * @return Reflection\Database
+	 */
+	public function getDatabaseInfo()
+	{
+		if (!$this->connected) {
+			$this->connect();
+		}
+		return new Reflection\Database($this->driver->getReflector(), isset($this->config['database']) ? $this->config['database'] : null);
+	}
+
+
+	/**
+	 * Prevents unserialization.
+	 */
+	public function __wakeup()
+	{
+		throw new NotSupportedException('You cannot serialize or unserialize ' . get_class($this) . ' instances.');
+	}
+
+
+	/**
+	 * Prevents serialization.
+	 */
+	public function __sleep()
+	{
+		throw new NotSupportedException('You cannot serialize or unserialize ' . get_class($this) . ' instances.');
+	}
+
+
+	protected function onEvent($arg)
+	{
+		foreach ($this->onEvent ?: [] as $handler) {
+			call_user_func($handler, $arg);
+		}
+	}
+}

src/Dibi/DataSource.php

@@ -1,69 +1,59 @@
 <?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.
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
  */
 
+namespace Dibi;
 
 
 /**
- * Default implementation of IDataSource for dibi.
- *
- * @author     David Grudl
- * @package    dibi
- *
- * @property-read DibiConnection $connection
- * @property-read DibiResult $result
- * @property-read DibiResultIterator $iterator
- * @property-read int $totalCount
+ * Default implementation of IDataSource.
  */
-class DibiDataSource extends DibiObject implements IDataSource
+class DataSource implements IDataSource
 {
-	/** @var DibiConnection */
+	use Strict;
+
+	/** @var Connection */
 	private $connection;
 
 	/** @var string */
 	private $sql;
 
-	/** @var DibiResult */
+	/** @var Result|null */
 	private $result;
 
-	/** @var int */
+	/** @var int|null */
 	private $count;
 
-	/** @var int */
+	/** @var int|null */
 	private $totalCount;
 
 	/** @var array */
-	private $cols = array();
+	private $cols = [];
 
 	/** @var array */
-	private $sorting = array();
+	private $sorting = [];
 
 	/** @var array */
-	private $conds = array();
+	private $conds = [];
 
-	/** @var int */
+	/** @var int|null */
 	private $offset;
 
-	/** @var int */
+	/** @var int|null */
 	private $limit;
 
 
-
 	/**
 	 * @param  string  SQL command or table or view name, as data source
-	 * @param  DibiConnection  connection
+	 * @param  Connection  connection
 	 */
-	public function __construct($sql, DibiConnection $connection)
+	public function __construct($sql, Connection $connection)
 	{
-		if (strpbrk($sql, " \t\r\n") === FALSE) {
-			$this->sql = $connection->getDriver()->escape($sql, dibi::IDENTIFIER); // table name
+		if (strpbrk($sql, " \t\r\n") === false) {
+			$this->sql = $connection->getDriver()->escapeIdentifier($sql); // table name
 		} else {
 			$this->sql = '(' . $sql . ') t'; // SQL command
 		}
@@ -71,30 +61,28 @@ class DibiDataSource extends DibiObject implements IDataSource
 	}
 
 
-
 	/**
 	 * Selects columns to query.
 	 * @param  string|array  column name or array of column names
 	 * @param  string        column alias
-	 * @return DibiDataSource  provides a fluent interface
+	 * @return self
 	 */
-	public function select($col, $as = NULL)
+	public function select($col, $as = null)
 	{
 		if (is_array($col)) {
 			$this->cols = $col;
 		} else {
 			$this->cols[$col] = $as;
 		}
-		$this->result = NULL;
+		$this->result = null;
 		return $this;
 	}
 
 
-
 	/**
 	 * Adds conditions to query.
 	 * @param  mixed  conditions
-	 * @return DibiDataSource  provides a fluent interface
+	 * @return self
 	 */
 	public function where($cond)
 	{
@@ -104,17 +92,16 @@ class DibiDataSource extends DibiObject implements IDataSource
 		} else {
 			$this->conds[] = func_get_args();
 		}
-		$this->result = $this->count = NULL;
+		$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
+	 * @return self
 	 */
 	public function orderBy($row, $sorting = 'ASC')
 	{
@@ -123,31 +110,28 @@ class DibiDataSource extends DibiObject implements IDataSource
 		} else {
 			$this->sorting[$row] = $sorting;
 		}
-		$this->result = NULL;
+		$this->result = null;
 		return $this;
 	}
 
 
-
 	/**
 	 * Limits number of rows.
-	 * @param  int limit
+	 * @param  int|null limit
 	 * @param  int offset
-	 * @return DibiDataSource  provides a fluent interface
+	 * @return self
 	 */
-	public function applyLimit($limit, $offset = NULL)
+	public function applyLimit($limit, $offset = null)
 	{
 		$this->limit = $limit;
 		$this->offset = $offset;
-		$this->result = $this->count = NULL;
+		$this->result = $this->count = null;
 		return $this;
 	}
 
 
-
 	/**
-	 * Returns the dibi connection.
-	 * @return DibiConnection
+	 * @return Connection
 	 */
 	final public function getConnection()
 	{
@@ -155,27 +139,24 @@ class DibiDataSource extends DibiObject implements IDataSource
 	}
 
 
-
 	/********************* executing ****************d*g**/
 
 
-
 	/**
-	 * Returns (and queries) DibiResult.
-	 * @return DibiResult
+	 * Returns (and queries) Result.
+	 * @return Result
 	 */
 	public function getResult()
 	{
-		if ($this->result === NULL) {
+		if ($this->result === null) {
 			$this->result = $this->connection->nativeQuery($this->__toString());
 		}
 		return $this->result;
 	}
 
 
-
 	/**
-	 * @return DibiResultIterator
+	 * @return ResultIterator
 	 */
 	public function getIterator()
 	{
@@ -183,10 +164,9 @@ class DibiDataSource extends DibiObject implements IDataSource
 	}
 
 
-
 	/**
 	 * Generates, executes SQL query and fetches the single row.
-	 * @return DibiRow|FALSE  array on success, FALSE if no next record
+	 * @return Row|false
 	 */
 	public function fetch()
 	{
@@ -194,10 +174,9 @@ class DibiDataSource extends DibiObject implements IDataSource
 	}
 
 
-
 	/**
 	 * Like fetch(), but returns only first field.
-	 * @return mixed  value on success, FALSE if no next record
+	 * @return mixed  value on success, false if no next record
 	 */
 	public function fetchSingle()
 	{
@@ -205,7 +184,6 @@ class DibiDataSource extends DibiObject implements IDataSource
 	}
 
 
-
 	/**
 	 * Fetches all records from table.
 	 * @return array
@@ -216,7 +194,6 @@ class DibiDataSource extends DibiObject implements IDataSource
 	}
 
 
-
 	/**
 	 * Fetches all records from table and returns associative tree.
 	 * @param  string  associative descriptor
@@ -228,38 +205,34 @@ class DibiDataSource extends DibiObject implements IDataSource
 	}
 
 
-
 	/**
 	 * 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)
+	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;
+		$this->result = $this->count = $this->totalCount = null;
 	}
 
 
-
 	/********************* exporting ****************d*g**/
 
 
-
 	/**
-	 * Returns this data source wrapped in DibiFluent object.
-	 * @return DibiFluent
+	 * Returns this data source wrapped in Fluent object.
+	 * @return Fluent
 	 */
 	public function toFluent()
 	{
@@ -267,10 +240,9 @@ class DibiDataSource extends DibiObject implements IDataSource
 	}
 
 
-
 	/**
-	 * Returns this data source wrapped in DibiDataSource object.
-	 * @return DibiDataSource
+	 * Returns this data source wrapped in DataSource object.
+	 * @return DataSource
 	 */
 	public function toDataSource()
 	{
@@ -278,7 +250,6 @@ class DibiDataSource extends DibiObject implements IDataSource
 	}
 
 
-
 	/**
 	 * Returns SQL query.
 	 * @return string
@@ -289,51 +260,48 @@ class DibiDataSource extends DibiObject implements IDataSource
 			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, '
+%ex', $this->conds ? ['WHERE %and', $this->conds] : null, '
+%ex', $this->sorting ? ['ORDER BY %by', $this->sorting] : null, '
 %ofs %lmt', $this->offset, $this->limit
 			);
-		} catch (Exception $e) {
+		} catch (\Exception $e) {
 			trigger_error($e->getMessage(), E_USER_ERROR);
+			return '';
 		}
 	}
 
 
-
 	/********************* counting ****************d*g**/
 
 
-
 	/**
 	 * Returns the number of rows in a given data source.
 	 * @return int
 	 */
 	public function count()
 	{
-		if ($this->count === NULL) {
+		if ($this->count === null) {
 			$this->count = $this->conds || $this->offset || $this->limit
-				? (int) $this->connection->nativeQuery(
+				? Helpers::intVal($this->connection->nativeQuery(
 					'SELECT COUNT(*) FROM (' . $this->__toString() . ') t'
-				)->fetchSingle()
+				)->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(
+		if ($this->totalCount === null) {
+			$this->totalCount = Helpers::intVal($this->connection->nativeQuery(
 				'SELECT COUNT(*) FROM ' . $this->sql
-			)->fetchSingle();
+			)->fetchSingle());
 		}
 		return $this->totalCount;
 	}
-
 }

src/Dibi/DateTime.php

@@ -0,0 +1,74 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi;
+
+
+/**
+ * DateTime.
+ */
+class DateTime extends \DateTime
+{
+	use Strict;
+
+	/**
+	 * @param  string|int
+	 */
+	public function __construct($time = 'now', \DateTimeZone $timezone = null)
+	{
+		if (is_numeric($time)) {
+			parent::__construct('@' . $time);
+			$this->setTimeZone($timezone ?: new \DateTimeZone(date_default_timezone_get()));
+		} elseif ($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 setTimestamp($timestamp)
+	{
+		$zone = $this->getTimezone();
+		$this->__construct('@' . $timestamp);
+		return $this->setTimeZone($zone);
+	}
+
+
+	public function getTimestamp()
+	{
+		$ts = $this->format('U');
+		return is_float($tmp = $ts * 1) ? $ts : $tmp;
+	}
+
+
+	public function __toString()
+	{
+		return $this->format('Y-m-d H:i:s.u');
+	}
+
+
+	public function __wakeup()
+	{
+		if (isset($this->fix, $this->fix[1])) {
+			$this->__construct($this->fix[0], new \DateTimeZone($this->fix[1]));
+			unset($this->fix);
+		} elseif (isset($this->fix)) {
+			$this->__construct($this->fix[0]);
+			unset($this->fix);
+		} else {
+			parent::__wakeup();
+		}
+	}
+}

src/Dibi/Drivers/FirebirdDriver.php

@@ -1,17 +1,17 @@
 <?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.
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
  */
 
+namespace Dibi\Drivers;
+
+use Dibi;
+
 
 /**
- * The dibi driver for Firebird/InterBase database.
+ * The driver for Firebird/InterBase database.
  *
  * Driver options:
  *   - database => the path to database file (server:/path/database.fdb)
@@ -20,128 +20,115 @@
  *   - 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
+class FirebirdDriver implements Dibi\Driver, Dibi\ResultDriver, Dibi\Reflector
 {
+	use Dibi\Strict;
+
 	const ERROR_EXCEPTION_THROWN = -836;
 
-	/** @var resource  Connection resource */
+	/** @var resource|null */
 	private $connection;
 
-	/** @var resource  Resultset resource */
+	/** @var resource|null */
 	private $resultSet;
 
 	/** @var bool */
-	private $autoFree = TRUE;
+	private $autoFree = true;
 
-	/** @var resource  Resultset resource */
+	/** @var resource|null */
 	private $transaction;
 
 	/** @var bool */
-	private $inTransaction = FALSE;
+	private $inTransaction = false;
 
 
 	/**
-	 * @throws DibiNotSupportedException
+	 * @throws Dibi\NotSupportedException
 	 */
 	public function __construct()
 	{
 		if (!extension_loaded('interbase')) {
-			throw new DibiNotSupportedException("PHP extension 'interbase' is not loaded.");
+			throw new Dibi\NotSupportedException("PHP extension 'interbase' is not loaded.");
 		}
 	}
 
 
-
 	/**
 	 * Connects to a database.
 	 * @return void
-	 * @throws DibiException
+	 * @throws Dibi\Exception
 	 */
 	public function connect(array &$config)
 	{
-		DibiConnection::alias($config, 'database', 'db');
+		Dibi\Helpers::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;
+			$config += [
+				'username' => ini_get('ibase.default_password'),
+				'password' => ini_get('ibase.default_user'),
+				'database' => ini_get('ibase.default_db'),
+				'charset' => ini_get('ibase.default_charset'),
+				'buffers' => 0,
+			];
 
-			DibiDriverException::tryError();
 			if (empty($config['persistent'])) {
-				$this->connection = ibase_connect($config['database'], $config['username'], $config['password'], $config['charset'], $config['buffers']); // intentionally @
+				$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());
+				$this->connection = @ibase_pconnect($config['database'], $config['username'], $config['password'], $config['charset'], $config['buffers']); // intentionally @
 			}
 
 			if (!is_resource($this->connection)) {
-				throw new DibiDriverException(ibase_errmsg(), ibase_errcode());
+				throw new Dibi\DriverException(ibase_errmsg(), ibase_errcode());
 			}
 		}
-
 	}
 
 
-
 	/**
 	 * Disconnects from a database.
 	 * @return void
 	 */
 	public function disconnect()
 	{
-		ibase_close($this->connection);
+		@ibase_close($this->connection); // @ - connection can be already disconnected
 	}
 
 
-
 	/**
 	 * Executes the SQL query.
 	 * @param  string      SQL statement.
-	 * @return IDibiResultDriver|NULL
-	 * @throws DibiDriverException|DibiException
+	 * @return Dibi\ResultDriver|null
+	 * @throws Dibi\DriverException|Dibi\Exception
 	 */
 	public function query($sql)
 	{
-		DibiDriverException::tryError();
 		$resource = $this->inTransaction ? $this->transaction : $this->connection;
 		$res = ibase_query($resource, $sql);
 
-		if (DibiDriverException::catchError($msg)) {
+		if ($res === false) {
 			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);
+				throw new Dibi\ProcedureException($match[3], $match[1], $match[2], $sql);
 
 			} else {
-				throw new DibiDriverException(ibase_errmsg(), ibase_errcode(), dibi::$sql);
+				throw new Dibi\DriverException(ibase_errmsg(), ibase_errcode(), $sql);
 			}
-		}
-
-		if ($res === FALSE) {
-			throw new DibiDriverException(ibase_errmsg(), ibase_errcode(), $sql);
 
 		} elseif (is_resource($res)) {
 			return $this->createResultDriver($res);
 		}
+		return null;
 	}
 
 
-
 	/**
 	 * Gets the number of affected rows by the last INSERT, UPDATE or DELETE query.
-	 * @return int|FALSE  number of rows or FALSE on error
+	 * @return int|false  number of rows or false on error
 	 */
 	public function getAffectedRows()
 	{
@@ -149,11 +136,10 @@ class DibiFirebirdDriver extends DibiObject implements IDibiDriver, IDibiResultD
 	}
 
 
-
 	/**
 	 * 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
+	 * @return int|false  int on success or false on failure
 	 */
 	public function getInsertId($sequence)
 	{
@@ -161,66 +147,62 @@ class DibiFirebirdDriver extends DibiObject implements IDibiDriver, IDibiResultD
 	}
 
 
-
 	/**
 	 * Begins a transaction (if supported).
 	 * @param  string  optional savepoint name
 	 * @return void
-	 * @throws DibiDriverException
+	 * @throws Dibi\DriverException
 	 */
-	public function begin($savepoint = NULL)
+	public function begin($savepoint = null)
 	{
-		if ($savepoint !== NULL) {
-			throw new DibiNotSupportedException('Savepoints are not supported in Firebird/Interbase.');
+		if ($savepoint !== null) {
+			throw new Dibi\NotSupportedException('Savepoints are not supported in Firebird/Interbase.');
 		}
-		$this->transaction = ibase_trans($this->resource);
-		$this->inTransaction = TRUE;
+		$this->transaction = ibase_trans($this->getResource());
+		$this->inTransaction = true;
 	}
 
 
-
 	/**
 	 * Commits statements in a transaction.
 	 * @param  string  optional savepoint name
 	 * @return void
-	 * @throws DibiDriverException
+	 * @throws Dibi\DriverException
 	 */
-	public function commit($savepoint = NULL)
+	public function commit($savepoint = null)
 	{
-		if ($savepoint !== NULL) {
-			throw new DibiNotSupportedException('Savepoints are not supported in Firebird/Interbase.');
+		if ($savepoint !== null) {
+			throw new Dibi\NotSupportedException('Savepoints are not supported in Firebird/Interbase.');
 		}
 
 		if (!ibase_commit($this->transaction)) {
-			throw new DibiDriverException('Unable to handle operation - failure when commiting transaction.');
+			throw new Dibi\DriverException('Unable to handle operation - failure when commiting transaction.');
 		}
 
-		$this->inTransaction = FALSE;
+		$this->inTransaction = false;
 	}
 
 
-
 	/**
 	 * Rollback changes in a transaction.
 	 * @param  string  optional savepoint name
 	 * @return void
-	 * @throws DibiDriverException
+	 * @throws Dibi\DriverException
 	 */
-	public function rollback($savepoint = NULL)
+	public function rollback($savepoint = null)
 	{
-		if ($savepoint !== NULL) {
-			throw new DibiNotSupportedException('Savepoints are not supported in Firebird/Interbase.');
+		if ($savepoint !== null) {
+			throw new Dibi\NotSupportedException('Savepoints are not supported in Firebird/Interbase.');
 		}
 
 		if (!ibase_rollback($this->transaction)) {
-			throw new DibiDriverException('Unable to handle operation - failure when rolbacking transaction.');
+			throw new Dibi\DriverException('Unable to handle operation - failure when rolbacking transaction.');
 		}
 
-		$this->inTransaction = FALSE;
+		$this->inTransaction = false;
 	}
 
 
-
 	/**
 	 * Is in transaction?
 	 * @return bool
@@ -231,21 +213,19 @@ class DibiFirebirdDriver extends DibiObject implements IDibiDriver, IDibiResultD
 	}
 
 
-
 	/**
 	 * Returns the connection resource.
-	 * @return resource
+	 * @return resource|null
 	 */
 	public function getResource()
 	{
-		return is_resource($this->connection) ? $this->connection : NULL;
+		return is_resource($this->connection) ? $this->connection : null;
 	}
 
 
-
 	/**
 	 * Returns the connection reflector.
-	 * @return IDibiReflector
+	 * @return Dibi\Reflector
 	 */
 	public function getReflector()
 	{
@@ -253,11 +233,10 @@ class DibiFirebirdDriver extends DibiObject implements IDibiDriver, IDibiResultD
 	}
 
 
-
 	/**
 	 * Result set driver factory.
 	 * @param  resource
-	 * @return IDibiResultDriver
+	 * @return Dibi\ResultDriver
 	 */
 	public function createResultDriver($resource)
 	{
@@ -267,43 +246,75 @@ class DibiFirebirdDriver extends DibiObject implements IDibiDriver, IDibiResultD
 	}
 
 
-
 	/********************* 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
+	 * @param  string
+	 * @return string
 	 */
-	public function escape($value, $type)
+	public function escapeText($value)
 	{
-		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.');
-		}
+		return "'" . str_replace("'", "''", $value) . "'";
 	}
 
 
+	/**
+	 * @param  string
+	 * @return string
+	 */
+	public function escapeBinary($value)
+	{
+		return "'" . str_replace("'", "''", $value) . "'";
+	}
+
+
+	/**
+	 * @param  string
+	 * @return string
+	 */
+	public function escapeIdentifier($value)
+	{
+		return '"' . str_replace('"', '""', $value) . '"';
+	}
+
+
+	/**
+	 * @param  bool
+	 * @return string
+	 */
+	public function escapeBool($value)
+	{
+		return $value ? '1' : '0';
+	}
+
+
+	/**
+	 * @param  \DateTime|\DateTimeInterface|string|int
+	 * @return string
+	 */
+	public function escapeDate($value)
+	{
+		if (!$value instanceof \DateTime && !$value instanceof \DateTimeInterface) {
+			$value = new Dibi\DateTime($value);
+		}
+		return $value->format("'Y-m-d'");
+	}
+
+
+	/**
+	 * @param  \DateTime|\DateTimeInterface|string|int
+	 * @return string
+	 */
+	public function escapeDateTime($value)
+	{
+		if (!$value instanceof \DateTime && !$value instanceof \DateTimeInterface) {
+			$value = new Dibi\DateTime($value);
+		}
+		return "'" . substr($value->format('Y-m-d H:i:s.u'), 0, -2) . "'";
+	}
+
 
 	/**
 	 * Encodes string for use in a LIKE statement.
@@ -313,88 +324,88 @@ class DibiFirebirdDriver extends DibiObject implements IDibiDriver, IDibiResultD
 	 */
 	public function escapeLike($value, $pos)
 	{
-		throw new DibiNotImplementedException;
+		throw new Dibi\NotImplementedException;
 	}
 
 
-
 	/**
 	 * Decodes data from result set.
-	 * @param  string    value
-	 * @param  string    type (dibi::BINARY)
-	 * @return string    decoded value
-	 * @throws InvalidArgumentException
+	 * @param  string
+	 * @return string
 	 */
-	public function unescape($value, $type)
+	public function unescapeBinary($value)
 	{
-		if ($type === dibi::BINARY) {
-			return $value;
-		}
-		throw new InvalidArgumentException('Unsupported type.');
+		return $value;
 	}
 
 
+	/** @deprecated */
+	public function escape($value, $type)
+	{
+		trigger_error(__METHOD__ . '() is deprecated.', E_USER_DEPRECATED);
+		return Dibi\Helpers::escape($this, $value, $type);
+	}
+
 
 	/**
 	 * Injects LIMIT/OFFSET to the SQL query.
-	 * @param  string &$sql  The SQL query that will be modified.
-	 * @param  int $limit
-	 * @param  int $offset
+	 * @param  string
+	 * @param  int|null
+	 * @param  int|null
 	 * @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 . ')';
+		if ($limit > 0 || $offset > 0) {
+			// http://www.firebirdsql.org/refdocs/langrefupd20-select.html
+			$sql = 'SELECT ' . ($limit > 0 ? 'FIRST ' . Dibi\Helpers::intVal($limit) : '')
+				. ($offset > 0 ? ' SKIP ' . Dibi\Helpers::intVal($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();
+		if ($this->autoFree && $this->getResultResource()) {
+			$this->free();
+		}
 	}
 
 
-
 	/**
 	 * Returns the number of rows in a result set.
 	 * @return int
 	 */
 	public function getRowCount()
 	{
-		throw new DibiNotSupportedException("Firebird/Interbase do not support returning number of rows in result set.");
+		throw new Dibi\NotSupportedException('Firebird/Interbase do not support returning number of rows in result set.');
 	}
 
 
-
 	/**
 	 * Fetches the row at current position and moves the internal cursor to the next position.
-	 * @param  bool     TRUE for associative array, FALSE for numeric
+	 * @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 @
+		$result = $assoc ? @ibase_fetch_assoc($this->resultSet, IBASE_TEXT) : @ibase_fetch_row($this->resultSet, IBASE_TEXT); // intentionally @
 
-		if (DibiDriverException::catchError($msg)) {
+		if (ibase_errcode()) {
 			if (ibase_errcode() == self::ERROR_EXCEPTION_THROWN) {
 				preg_match('/exception (\d+) (\w+) (.*)/is', ibase_errmsg(), $match);
-				throw new DibiProcedureException($match[3], $match[1], $match[2], dibi::$sql);
+				throw new Dibi\ProcedureException($match[3], $match[1], $match[2]);
 
 			} else {
-				throw new DibiDriverException($msg, ibase_errcode(), dibi::$sql);
+				throw new Dibi\DriverException(ibase_errmsg(), ibase_errcode());
 			}
 		}
 
@@ -402,20 +413,18 @@ class DibiFirebirdDriver extends DibiObject implements IDibiDriver, IDibiResultD
 	}
 
 
-
 	/**
 	 * 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
+	 * @param  int   the 0-based cursor pos to seek to
+	 * @return bool  true on success, false if unable to seek to specified record
+	 * @throws Dibi\Exception
 	 */
 	public function seek($row)
 	{
-		throw new DibiNotSupportedException("Firebird/Interbase do not support seek in result set.");
+		throw new Dibi\NotSupportedException('Firebird/Interbase do not support seek in result set.');
 	}
 
 
-
 	/**
 	 * Frees the resources allocated for this result set.
 	 * @return void
@@ -423,23 +432,21 @@ class DibiFirebirdDriver extends DibiObject implements IDibiDriver, IDibiResultD
 	public function free()
 	{
 		ibase_free_result($this->resultSet);
-		$this->resultSet = NULL;
+		$this->resultSet = null;
 	}
 
 
-
 	/**
 	 * Returns the result set resource.
-	 * @return mysqli_result
+	 * @return resource|null
 	 */
 	public function getResultResource()
 	{
-		$this->autoFree = FALSE;
-		return is_resource($this->resultSet) ? $this->resultSet : NULL;
+		$this->autoFree = false;
+		return is_resource($this->resultSet) ? $this->resultSet : null;
 	}
 
 
-
 	/**
 	 * Returns metadata for all columns in a result set.
 	 * @return array
@@ -447,23 +454,21 @@ class DibiFirebirdDriver extends DibiObject implements IDibiDriver, IDibiResultD
 	public function getResultColumns()
 	{
 		$count = ibase_num_fields($this->resultSet);
-		$columns = array();
+		$columns = [];
 		for ($i = 0; $i < $count; $i++) {
 			$row = (array) ibase_field_info($this->resultSet, $i);
-			$columns[] = array(
+			$columns[] = [
 				'name' => $row['name'],
 				'fullname' => $row['name'],
 				'table' => $row['relation'],
 				'nativetype' => $row['type'],
-			);
+			];
 		}
 		return $columns;
 	}
 
 
-
-	/********************* IDibiReflector ********************/
-
+	/********************* Dibi\Reflector ********************/
 
 
 	/**
@@ -478,18 +483,17 @@ class DibiFirebirdDriver extends DibiObject implements IDibiDriver, IDibiResultD
 			FROM RDB\$RELATIONS
 			WHERE RDB\$SYSTEM_FLAG = 0;"
 		);
-		$tables = array();
-		while ($row = $res->fetch(FALSE)) {
-			$tables[] = array(
+		$tables = [];
+		while ($row = $res->fetch(false)) {
+			$tables[] = [
 				'name' => $row[0],
 				'view' => $row[1] === 'TRUE',
-			);
+			];
 		}
 		return $tables;
 	}
 
 
-
 	/**
 	 * Returns metadata for all columns in a table.
 	 * @param  string
@@ -528,24 +532,23 @@ class DibiFirebirdDriver extends DibiObject implements IDibiDriver, IDibiResultD
 			ORDER BY r.RDB\$FIELD_POSITION;"
 
 		);
-		$columns = array();
-		while ($row = $res->fetch(TRUE)) {
+		$columns = [];
+		while ($row = $res->fetch(true)) {
 			$key = $row['FIELD_NAME'];
-			$columns[$key] = array(
+			$columns[$key] = [
 				'name' => $key,
 				'table' => $table,
 				'nativetype' => trim($row['FIELD_TYPE']),
 				'size' => $row['FIELD_LENGTH'],
 				'nullable' => $row['NULLABLE'] === 'TRUE',
 				'default' => $row['DEFAULT_VALUE'],
-				'autoincrement' => FALSE,
-			);
+				'autoincrement' => false,
+			];
 		}
 		return $columns;
 	}
 
 
-
 	/**
 	 * Returns metadata for all indexes in a table (the constraints are included).
 	 * @param  string
@@ -567,8 +570,8 @@ class DibiFirebirdDriver extends DibiObject implements IDibiDriver, IDibiResultD
 			WHERE UPPER(i.RDB\$RELATION_NAME) = '$table'
 			ORDER BY s.RDB\$FIELD_POSITION"
 		);
-		$indexes = array();
-		while ($row = $res->fetch(TRUE)) {
+		$indexes = [];
+		while ($row = $res->fetch(true)) {
 			$key = $row['INDEX_NAME'];
 			$indexes[$key]['name'] = $key;
 			$indexes[$key]['unique'] = $row['UNIQUE_FLAG'] === 1;
@@ -580,7 +583,6 @@ class DibiFirebirdDriver extends DibiObject implements IDibiDriver, IDibiResultD
 	}
 
 
-
 	/**
 	 * Returns metadata for all foreign keys in a table.
 	 * @param  string
@@ -598,20 +600,19 @@ class DibiFirebirdDriver extends DibiObject implements IDibiDriver, IDibiResultD
 				AND r.RDB\$CONSTRAINT_TYPE = 'FOREIGN KEY'
 			ORDER BY s.RDB\$FIELD_POSITION"
 		);
-		$keys = array();
-		while ($row = $res->fetch(TRUE)) {
+		$keys = [];
+		while ($row = $res->fetch(true)) {
 			$key = $row['INDEX_NAME'];
-			$keys[$key] = array(
+			$keys[$key] = [
 				'name' => $key,
 				'column' => $row['FIELD_NAME'],
 				'table' => $table,
-			);
+			];
 		}
 		return $keys;
 	}
 
 
-
 	/**
 	 * Returns list of indices in given table (the constraints are not listed).
 	 * @param  string
@@ -626,15 +627,14 @@ class DibiFirebirdDriver extends DibiObject implements IDibiDriver, IDibiResultD
 				AND RDB\$UNIQUE_FLAG IS NULL
 				AND RDB\$FOREIGN_KEY IS NULL;"
 		);
-		$indices = array();
-		while ($row = $res->fetch(FALSE)) {
+		$indices = [];
+		while ($row = $res->fetch(false)) {
 			$indices[] = $row[0];
 		}
 		return $indices;
 	}
 
 
-
 	/**
 	 * Returns list of constraints in given table.
 	 * @param  string
@@ -651,15 +651,14 @@ class DibiFirebirdDriver extends DibiObject implements IDibiDriver, IDibiResultD
 					OR RDB\$FOREIGN_KEY IS NOT NULL
 			);"
 		);
-		$constraints = array();
-		while ($row = $res->fetch(FALSE)) {
+		$constraints = [];
+		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)
@@ -667,7 +666,7 @@ class DibiFirebirdDriver extends DibiObject implements IDibiDriver, IDibiResultD
 	 * @param  string
 	 * @return array
 	 */
-	public function getTriggersMeta($table = NULL)
+	public function getTriggersMeta($table = null)
 	{
 		$res = $this->query("
 			SELECT TRIM(RDB\$TRIGGER_NAME) AS TRIGGER_NAME,
@@ -693,46 +692,44 @@ class DibiFirebirdDriver extends DibiObject implements IDibiDriver, IDibiResultD
 				END AS TRIGGER_ENABLED
 			FROM RDB\$TRIGGERS
 			WHERE RDB\$SYSTEM_FLAG = 0"
-			. ($table === NULL ? ";" : " AND RDB\$RELATION_NAME = UPPER('$table');")
+			. ($table === null ? ';' : " AND RDB\$RELATION_NAME = UPPER('$table');")
 		);
-		$triggers = array();
-		while ($row = $res->fetch(TRUE)) {
-			$triggers[$row['TRIGGER_NAME']] = array(
+		$triggers = [];
+		while ($row = $res->fetch(true)) {
+			$triggers[$row['TRIGGER_NAME']] = [
 				'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)
+	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')";
+		$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 = [];
+		while ($row = $res->fetch(false)) {
 			$triggers[] = $row[0];
 		}
 		return $triggers;
 	}
 
 
-
 	/**
 	 * Returns metadata from stored procedures and their input and output parameters.
 	 * @param  string
@@ -772,8 +769,8 @@ class DibiFirebirdDriver extends DibiObject implements IDibiDriver, IDibiResultD
 				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)) {
+		$procedures = [];
+		while ($row = $res->fetch(true)) {
 			$key = $row['PROCEDURE_NAME'];
 			$io = trim($row['PARAMETER_TYPE']);
 			$num = $row['PARAMETER_NUMBER'];
@@ -786,103 +783,58 @@ class DibiFirebirdDriver extends DibiObject implements IDibiDriver, IDibiResultD
 	}
 
 
-
 	/**
 	 * Returns list of stored procedures.
 	 * @return array
 	 */
 	public function getProcedures()
 	{
-		$res = $this->query("
-			SELECT TRIM(RDB\$PROCEDURE_NAME)
-			FROM RDB\$PROCEDURES;"
+		$res = $this->query('
+			SELECT TRIM(RDB$PROCEDURE_NAME)
+			FROM RDB$PROCEDURES;'
 		);
-		$procedures = array();
-		while ($row = $res->fetch(FALSE)) {
+		$procedures = [];
+		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;"
+		$res = $this->query('
+			SELECT TRIM(RDB$GENERATOR_NAME)
+			FROM RDB$GENERATORS
+			WHERE RDB$SYSTEM_FLAG = 0;'
 		);
-		$generators = array();
-		while ($row = $res->fetch(FALSE)) {
+		$generators = [];
+		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;"
+		$res = $this->query('
+			SELECT TRIM(RDB$FUNCTION_NAME)
+			FROM RDB$FUNCTIONS
+			WHERE RDB$SYSTEM_FLAG = 0;'
 		);
-		$functions = array();
-		while ($row = $res->fetch(FALSE)) {
+		$functions = [];
+		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;
-	}
-
 }

src/Dibi/Drivers/MsSqlDriver.php

@@ -1,18 +1,17 @@
 <?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.
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
  */
 
-require_once dirname(__FILE__) . '/DibiMsSqlReflector.php';
+namespace Dibi\Drivers;
+
+use Dibi;
+
 
 /**
- * The dibi driver for MS SQL database.
+ * The driver for MS SQL database.
  *
  * Driver options:
  *   - host => the MS SQL server host name. It can also include a port number (hostname:port)
@@ -21,96 +20,91 @@ require_once dirname(__FILE__) . '/DibiMsSqlReflector.php';
  *   - 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
- * @package    dibi\drivers
+ *   - lazy, profiler, result, substitutes, ... => see Dibi\Connection options
  */
-class DibiMsSqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriver
+class MsSqlDriver implements Dibi\Driver, Dibi\ResultDriver
 {
-	/** @var resource  Connection resource */
+	use Dibi\Strict;
+
+	/** @var resource|null */
 	private $connection;
 
-	/** @var resource  Resultset resource */
+	/** @var resource|null */
 	private $resultSet;
 
 	/** @var bool */
-	private $autoFree = TRUE;
-
+	private $autoFree = true;
 
 
 	/**
-	 * @throws DibiNotSupportedException
+	 * @throws Dibi\NotSupportedException
 	 */
 	public function __construct()
 	{
 		if (!extension_loaded('mssql')) {
-			throw new DibiNotSupportedException("PHP extension 'mssql' is not loaded.");
+			throw new Dibi\NotSupportedException("PHP extension 'mssql' is not loaded.");
 		}
 	}
 
 
-
 	/**
 	 * Connects to a database.
 	 * @return void
-	 * @throws DibiException
+	 * @throws Dibi\Exception
 	 */
 	public function connect(array &$config)
 	{
 		if (isset($config['resource'])) {
 			$this->connection = $config['resource'];
 		} elseif (empty($config['persistent'])) {
-			$this->connection = @mssql_connect($config['host'], $config['username'], $config['password'], TRUE); // intentionally @
+			$this->connection = @mssql_connect($config['host'], $config['username'], $config['password'], true); // intentionally @
 		} else {
 			$this->connection = @mssql_pconnect($config['host'], $config['username'], $config['password']); // intentionally @
 		}
 
 		if (!is_resource($this->connection)) {
-			throw new DibiDriverException("Can't connect to DB.");
+			throw new Dibi\DriverException("Can't connect to DB.");
 		}
 
-		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]'.");
+		if (isset($config['database']) && !@mssql_select_db($this->escapeIdentifier($config['database']), $this->connection)) { // intentionally @
+			throw new Dibi\DriverException("Can't select DB '$config[database]'.");
 		}
 	}
 
 
-
 	/**
 	 * Disconnects from a database.
 	 * @return void
 	 */
 	public function disconnect()
 	{
-		mssql_close($this->connection);
+		@mssql_close($this->connection); // @ - connection can be already disconnected
 	}
 
 
-
 	/**
 	 * Executes the SQL query.
 	 * @param  string      SQL statement.
-	 * @return IDibiResultDriver|NULL
-	 * @throws DibiDriverException
+	 * @return Dibi\ResultDriver|null
+	 * @throws Dibi\DriverException
 	 */
 	public function query($sql)
 	{
 		$res = @mssql_query($sql, $this->connection); // intentionally @
 
-		if ($res === FALSE) {
-			throw new DibiDriverException(mssql_get_last_message(), 0, $sql);
+		if ($res === false) {
+			throw new Dibi\DriverException(mssql_get_last_message(), 0, $sql);
 
 		} elseif (is_resource($res)) {
 			return $this->createResultDriver($res);
 		}
+		return null;
 	}
 
 
-
 	/**
 	 * Gets the number of affected rows by the last INSERT, UPDATE or DELETE query.
-	 * @return int|FALSE  number of rows or FALSE on error
+	 * @return int|false  number of rows or false on error
 	 */
 	public function getAffectedRows()
 	{
@@ -118,10 +112,9 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 	}
 
 
-
 	/**
 	 * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query.
-	 * @return int|FALSE  int on success or FALSE on failure
+	 * @return int|false  int on success or false on failure
 	 */
 	public function getInsertId($sequence)
 	{
@@ -130,76 +123,70 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 			$row = mssql_fetch_row($res);
 			return $row[0];
 		}
-		return FALSE;
+		return false;
 	}
 
 
-
 	/**
 	 * Begins a transaction (if supported).
 	 * @param  string  optional savepoint name
 	 * @return void
-	 * @throws DibiDriverException
+	 * @throws Dibi\DriverException
 	 */
-	public function begin($savepoint = NULL)
+	public function begin($savepoint = null)
 	{
 		$this->query('BEGIN TRANSACTION');
 	}
 
 
-
 	/**
 	 * Commits statements in a transaction.
 	 * @param  string  optional savepoint name
 	 * @return void
-	 * @throws DibiDriverException
+	 * @throws Dibi\DriverException
 	 */
-	public function commit($savepoint = NULL)
+	public function commit($savepoint = null)
 	{
 		$this->query('COMMIT');
 	}
 
 
-
 	/**
 	 * Rollback changes in a transaction.
 	 * @param  string  optional savepoint name
 	 * @return void
-	 * @throws DibiDriverException
+	 * @throws Dibi\DriverException
 	 */
-	public function rollback($savepoint = NULL)
+	public function rollback($savepoint = null)
 	{
 		$this->query('ROLLBACK');
 	}
 
 
-
 	/**
 	 * Returns the connection resource.
-	 * @return mixed
+	 * @return resource|null
 	 */
 	public function getResource()
 	{
-		return is_resource($this->connection) ? $this->connection : NULL;
+		return is_resource($this->connection) ? $this->connection : null;
 	}
 
 
-
 	/**
 	 * Returns the connection reflector.
-	 * @return IDibiReflector
+	 * @return Dibi\Reflector
 	 */
 	public function getReflector()
 	{
-		return new DibiMsSqlReflector($this);
+		return new MsSqlReflector($this);
 	}
 
 
-
 	/**
 	 * Result set driver factory.
 	 * @param  resource
-	 * @return IDibiResultDriver
+	 * @return Dibi\ResultDriver
 	 */
 	public function createResultDriver($resource)
 	{
@@ -209,44 +196,76 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 	}
 
 
-
 	/********************* SQL ****************d*g**/
 
 
-
 	/**
 	 * Encodes data for use in a SQL statement.
-	 * @param  mixed     value
-	 * @param  string    type (dibi::TEXT, dibi::BOOL, ...)
+	 * @param  string    value
 	 * @return string    encoded value
-	 * @throws InvalidArgumentException
 	 */
-	public function escape($value, $type)
+	public function escapeText($value)
 	{
-		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.');
-		}
+		return "'" . str_replace("'", "''", $value) . "'";
 	}
 
 
+	/**
+	 * @param  string
+	 * @return string
+	 */
+	public function escapeBinary($value)
+	{
+		return "'" . str_replace("'", "''", $value) . "'";
+	}
+
+
+	/**
+	 * @param  string
+	 * @return string
+	 */
+	public function escapeIdentifier($value)
+	{
+		// @see https://msdn.microsoft.com/en-us/library/ms176027.aspx
+		return '[' . str_replace(['[', ']'], ['[[', ']]'], $value) . ']';
+	}
+
+
+	/**
+	 * @param  bool
+	 * @return string
+	 */
+	public function escapeBool($value)
+	{
+		return $value ? '1' : '0';
+	}
+
+
+	/**
+	 * @param  \DateTime|\DateTimeInterface|string|int
+	 * @return string
+	 */
+	public function escapeDate($value)
+	{
+		if (!$value instanceof \DateTime && !$value instanceof \DateTimeInterface) {
+			$value = new Dibi\DateTime($value);
+		}
+		return $value->format("'Y-m-d'");
+	}
+
+
+	/**
+	 * @param  \DateTime|\DateTimeInterface|string|int
+	 * @return string
+	 */
+	public function escapeDateTime($value)
+	{
+		if (!$value instanceof \DateTime && !$value instanceof \DateTimeInterface) {
+			$value = new Dibi\DateTime($value);
+		}
+		return 'CONVERT(DATETIME2(7), ' . $value->format("'Y-m-d H:i:s.u'") . ')';
+	}
+
 
 	/**
 	 * Encodes string for use in a LIKE statement.
@@ -256,65 +275,66 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 	 */
 	public function escapeLike($value, $pos)
 	{
-		$value = strtr($value, array("'" => "''", '%' => '[%]', '_' => '[_]', '[' => '[[]'));
+		$value = strtr($value, ["'" => "''", '%' => '[%]', '_' => '[_]', '[' => '[[]']);
 		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
+	 * @param  string
+	 * @return string
 	 */
-	public function unescape($value, $type)
+	public function unescapeBinary($value)
 	{
-		if ($type === dibi::BINARY) {
-			return $value;
-		}
-		throw new InvalidArgumentException('Unsupported type.');
+		return $value;
 	}
 
 
+	/** @deprecated */
+	public function escape($value, $type)
+	{
+		trigger_error(__METHOD__ . '() is deprecated.', E_USER_DEPRECATED);
+		return Dibi\Helpers::escape($this, $value, $type);
+	}
+
 
 	/**
 	 * Injects LIMIT/OFFSET to the SQL query.
-	 * @param  string &$sql  The SQL query that will be modified.
-	 * @param  int $limit
-	 * @param  int $offset
+	 * @param  string
+	 * @param  int|null
+	 * @param  int|null
 	 * @return void
 	 */
 	public function applyLimit(&$sql, $limit, $offset)
 	{
-		// offset support is missing
-		if ($limit >= 0) {
-			$sql = 'SELECT TOP ' . (int) $limit . ' * FROM (' . $sql . ') t';
-		}
-
 		if ($offset) {
-			throw new DibiNotImplementedException('Offset is not implemented.');
+			throw new Dibi\NotSupportedException('Offset is not supported by this database.');
+
+		} elseif ($limit < 0) {
+			throw new Dibi\NotSupportedException('Negative offset or limit.');
+
+		} elseif ($limit !== null) {
+			$sql = 'SELECT TOP ' . Dibi\Helpers::intVal($limit) . ' * FROM (' . $sql . ') t';
 		}
 	}
 
 
-
 	/********************* result set ****************d*g**/
 
 
-
 	/**
 	 * Automatically frees the resources allocated for this result set.
 	 * @return void
 	 */
 	public function __destruct()
 	{
-		$this->autoFree && $this->getResultResource() && $this->free();
+		if ($this->autoFree && $this->getResultResource()) {
+			$this->free();
+		}
 	}
 
 
-
 	/**
 	 * Returns the number of rows in a result set.
 	 * @return int
@@ -325,10 +345,9 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 	}
 
 
-
 	/**
 	 * Fetches the row at current position and moves the internal cursor to the next position.
-	 * @param  bool     TRUE for associative array, FALSE for numeric
+	 * @param  bool     true for associative array, false for numeric
 	 * @return array    array on success, nonarray if no next record
 	 */
 	public function fetch($assoc)
@@ -337,11 +356,10 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 	}
 
 
-
 	/**
 	 * 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
+	 * @return bool     true on success, false if unable to seek to specified record
 	 */
 	public function seek($row)
 	{
@@ -349,7 +367,6 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 	}
 
 
-
 	/**
 	 * Frees the resources allocated for this result set.
 	 * @return void
@@ -357,11 +374,10 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 	public function free()
 	{
 		mssql_free_result($this->resultSet);
-		$this->resultSet = NULL;
+		$this->resultSet = null;
 	}
 
 
-
 	/**
 	 * Returns metadata for all columns in a result set.
 	 * @return array
@@ -369,30 +385,27 @@ class DibiMsSqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 	public function getResultColumns()
 	{
 		$count = mssql_num_fields($this->resultSet);
-		$columns = array();
+		$columns = [];
 		for ($i = 0; $i < $count; $i++) {
 			$row = (array) mssql_fetch_field($this->resultSet, $i);
-			$columns[] = array(
+			$columns[] = [
 				'name' => $row['name'],
 				'fullname' => $row['column_source'] ? $row['column_source'] . '.' . $row['name'] : $row['name'],
 				'table' => $row['column_source'],
 				'nativetype' => $row['type'],
-			);
+			];
 		}
 		return $columns;
 	}
 
 
-
 	/**
 	 * Returns the result set resource.
-	 * @return mixed
+	 * @return resource|null
 	 */
 	public function getResultResource()
 	{
-		$this->autoFree = FALSE;
-		return is_resource($this->resultSet) ? $this->resultSet : NULL;
+		$this->autoFree = false;
+		return is_resource($this->resultSet) ? $this->resultSet : null;
 	}
-
-
 }

src/Dibi/Drivers/MsSqlReflector.php

@@ -1,66 +1,60 @@
 <?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
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
  */
 
+namespace Dibi\Drivers;
+
+use Dibi;
+
 
 /**
- * The dibi reflector for MsSQL databases.
- *
- * @author     Steven Bredenberg
- * @package    dibi\drivers
+ * The reflector for MS SQL databases.
  * @internal
  */
-class DibiMsSqlReflector extends DibiObject implements IDibiReflector
+class MsSqlReflector implements Dibi\Reflector
 {
-	/** @var IDibiDriver */
+	use Dibi\Strict;
+
+	/** @var Dibi\Driver */
 	private $driver;
 
 
-
-	public function __construct(IDibiDriver $driver)
+	public function __construct(Dibi\Driver $driver)
 	{
 		$this->driver = $driver;
 	}
 
 
-
 	/**
 	 * Returns list of tables.
 	 * @return array
 	 */
 	public function getTables()
 	{
-		$res = $this->driver->query("
+		$res = $this->driver->query('
 			SELECT TABLE_NAME, TABLE_TYPE
 			FROM INFORMATION_SCHEMA.TABLES
-		");
-		$tables = array();
-		while ($row = $res->fetch(FALSE)) {
-			$tables[] = array(
+		');
+		$tables = [];
+		while ($row = $res->fetch(false)) {
+			$tables[] = [
 				'name' => $row[0],
 				'view' => isset($row[1]) && $row[1] === 'VIEW',
-			);
+			];
 		}
 		return $tables;
 	}
 
 
-
 	/**
 	 * Returns count of rows in a table
 	 * @param  string
-	 * @return integer
+	 * @return int
 	 */
-	public function getTableCount($table, $fallback=true)
+	public function getTableCount($table, $fallback = true)
 	{
 		if (empty($table)) {
 			return false;
@@ -68,26 +62,25 @@ class DibiMsSqlReflector extends DibiObject implements IDibiReflector
 		$result = $this->driver->query("
 			SELECT MAX(rowcnt)
 			FROM sys.sysindexes
-			WHERE id=OBJECT_ID({$this->driver->escape($table, dibi::IDENTIFIER)})
+			WHERE id=OBJECT_ID({$this->driver->escapeIdentifier($table)})
 		");
-		$row = $result->fetch(FALSE);
+		$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]);
+				$row = $this->driver->query("SELECT COUNT(*) FROM {$this->driver->escapeIdentifier($table)}")->fetch(false);
+				$count = Dibi\Helpers::intVal($row[0]);
 			} else {
 				$count = false;
 			}
 		} else {
-			$count = intval($row[0]);
+			$count = Dibi\Helpers::intVal($row[0]);
 		}
 
 		return $count;
 	}
 
 
-
 	/**
 	 * Returns metadata for all columns in a table.
 	 * @param  string
@@ -98,47 +91,39 @@ class DibiMsSqlReflector extends DibiObject implements IDibiReflector
 		$res = $this->driver->query("
 			SELECT * FROM
 			INFORMATION_SCHEMA.COLUMNS
-			WHERE TABLE_NAME = {$this->driver->escape($table, dibi::TEXT)}
+			WHERE TABLE_NAME = {$this->driver->escapeText($table)}
 			ORDER BY TABLE_NAME, ORDINAL_POSITION
 		");
-		$columns = array();
-		while ($row = $res->fetch(TRUE)) {
-			$size = false;
+		$columns = [];
+		while ($row = $res->fetch(true)) {
+			static $size_cols = [
+				'DATETIME' => 'DATETIME_PRECISION',
+				'DECIMAL' => 'NUMERIC_PRECISION',
+				'CHAR' => 'CHARACTER_MAXIMUM_LENGTH',
+				'NCHAR' => 'CHARACTER_OCTET_LENGTH',
+				'NVARCHAR' => 'CHARACTER_OCTET_LENGTH',
+				'VARCHAR' => 'CHARACTER_OCTET_LENGTH',
+			];
+
 			$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(
+			$columns[] = [
 				'name' => $row['COLUMN_NAME'],
 				'table' => $table,
 				'nativetype' => $type,
-				'size' => $size,
-				'unsigned' => NULL,
+				'size' => isset($size_cols[$type], $row[$size_cols[$type]]) ? $row[$size_cols[$type]] : null,
+				'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
@@ -156,22 +141,22 @@ class DibiMsSqlReflector extends DibiObject implements IDibiReflector
 				(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)}
+			WHERE t.name = {$this->driver->escapeText($table)}
 				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)) {
+		$indexes = [];
+		while ($row = $res->fetch(true)) {
 			$index_name = $row['index_name'];
 
 			if (!isset($indexes[$index_name])) {
-				$indexes[$index_name] = array();
+				$indexes[$index_name] = [];
 				$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]['unique'] = (bool) $row['is_unique'];
+				$indexes[$index_name]['primary'] = (bool) $row['is_primary_key'];
+				$indexes[$index_name]['columns'] = [];
 			}
 			$indexes[$index_name]['columns'][] = $row['column_name'];
 		}
@@ -180,7 +165,6 @@ class DibiMsSqlReflector extends DibiObject implements IDibiReflector
 	}
 
 
-
 	/**
 	 * Returns metadata for all foreign keys in a table.
 	 * @param  string
@@ -200,18 +184,18 @@ class DibiMsSqlReflector extends DibiObject implements IDibiReflector
 			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)}
+			WHERE OBJECT_NAME(f.parent_object_id) = {$this->driver->escapeText($table)}
 		");
 
-		$keys = array();
-		while ($row = $res->fetch(TRUE)) {
+		$keys = [];
+		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]['local'] = [$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]['foreign'] = [$row['reference_column_name']]; // referenced columns
 				$keys[$key_name]['onDelete'] = false;
 				$keys[$key_name]['onUpdate'] = false;
 			} else {
@@ -221,5 +205,4 @@ class DibiMsSqlReflector extends DibiObject implements IDibiReflector
 		}
 		return array_values($keys);
 	}
-
 }

src/Dibi/Drivers/MySqlDriver.php

@@ -1,20 +1,17 @@
 <?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.
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
  */
 
+namespace Dibi\Drivers;
 
-require_once dirname(__FILE__) . '/DibiMySqlReflector.php';
+use Dibi;
 
 
 /**
- * The dibi driver for MySQL database.
+ * The driver for MySQL database.
  *
  * Driver options:
  *   - host => the MySQL server host name
@@ -29,47 +26,46 @@ require_once dirname(__FILE__) . '/DibiMySqlReflector.php';
  *   - 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
- * @package    dibi\drivers
+ *   - lazy, profiler, result, substitutes, ... => see Dibi\Connection options
  */
-class DibiMySqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriver
+class MySqlDriver implements Dibi\Driver, Dibi\ResultDriver
 {
+	use Dibi\Strict;
+
 	const ERROR_ACCESS_DENIED = 1045;
+
 	const ERROR_DUPLICATE_ENTRY = 1062;
+
 	const ERROR_DATA_TRUNCATED = 1265;
 
-	/** @var resource  Connection resource */
+	/** @var resource|null */
 	private $connection;
 
-	/** @var resource  Resultset resource */
+	/** @var resource|null */
 	private $resultSet;
 
 	/** @var bool */
-	private $autoFree = TRUE;
+	private $autoFree = true;
 
 	/** @var bool  Is buffered (seekable and countable)? */
 	private $buffered;
 
 
-
 	/**
-	 * @throws DibiNotSupportedException
+	 * @throws Dibi\NotSupportedException
 	 */
 	public function __construct()
 	{
 		if (!extension_loaded('mysql')) {
-			throw new DibiNotSupportedException("PHP extension 'mysql' is not loaded.");
+			throw new Dibi\NotSupportedException("PHP extension 'mysql' is not loaded.");
 		}
 	}
 
 
-
 	/**
 	 * Connects to a database.
 	 * @return void
-	 * @throws DibiException
+	 * @throws Dibi\Exception
 	 */
 	public function connect(array &$config)
 	{
@@ -78,19 +74,23 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 
 		} else {
 			// default values
-			DibiConnection::alias($config, 'flags', 'options');
-			if (!isset($config['charset'])) $config['charset'] = 'utf8';
-			if (!isset($config['timezone'])) $config['timezone'] = date('P');
-			if (!isset($config['username'])) $config['username'] = ini_get('mysql.default_user');
-			if (!isset($config['password'])) $config['password'] = ini_get('mysql.default_password');
+			Dibi\Helpers::alias($config, 'flags', 'options');
+			$config += [
+				'charset' => 'utf8',
+				'timezone' => date('P'),
+				'username' => ini_get('mysql.default_user'),
+				'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 (!isset($config['socket'])) {
+						$config['socket'] = ini_get('mysql.default_socket');
+					}
+					$config['host'] = null;
 				}
 			}
 
@@ -101,30 +101,25 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 			}
 
 			if (empty($config['persistent'])) {
-				$this->connection = @mysql_connect($host, $config['username'], $config['password'], TRUE, $config['flags']); // intentionally @
+				$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)) {
-			throw new DibiDriverException(mysql_error(), mysql_errno());
+			throw new Dibi\DriverException(mysql_error(), mysql_errno());
 		}
 
 		if (isset($config['charset'])) {
-			$ok = FALSE;
-			if (function_exists('mysql_set_charset')) {
-				// affects the character set used by mysql_real_escape_string() (was added in MySQL 5.0.7 and PHP 5.2.3)
-				$ok = @mysql_set_charset($config['charset'], $this->connection); // intentionally @
-			}
-			if (!$ok) {
+			if (!@mysql_set_charset($config['charset'], $this->connection)) { // intentionally @
 				$this->query("SET NAMES '$config[charset]'");
 			}
 		}
 
 		if (isset($config['database'])) {
 			if (!@mysql_select_db($config['database'], $this->connection)) { // intentionally @
-				throw new DibiDriverException(mysql_error($this->connection), mysql_errno($this->connection));
+				throw new Dibi\DriverException(mysql_error($this->connection), mysql_errno($this->connection));
 			}
 		}
 
@@ -140,23 +135,21 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 	}
 
 
-
 	/**
 	 * Disconnects from a database.
 	 * @return void
 	 */
 	public function disconnect()
 	{
-		mysql_close($this->connection);
+		@mysql_close($this->connection); // @ - connection can be already disconnected
 	}
 
 
-
 	/**
 	 * Executes the SQL query.
 	 * @param  string      SQL statement.
-	 * @return IDibiResultDriver|NULL
-	 * @throws DibiDriverException
+	 * @return Dibi\ResultDriver|null
+	 * @throws Dibi\DriverException
 	 */
 	public function query($sql)
 	{
@@ -166,8 +159,8 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 			$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);
+		if ($code = mysql_errno($this->connection)) {
+			throw MySqliDriver::createException(mysql_error($this->connection), $code, $sql);
 
 		} elseif (is_resource($res)) {
 			return $this->createResultDriver($res);
@@ -175,16 +168,17 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 	}
 
 
-
 	/**
 	 * Retrieves information about the most recently executed query.
 	 * @return array
 	 */
 	public function getInfo()
 	{
-		$res = array();
+		$res = [];
 		preg_match_all('#(.+?): +(\d+) *#', mysql_info($this->connection), $matches, PREG_SET_ORDER);
-		if (preg_last_error()) throw new DibiPcreException;
+		if (preg_last_error()) {
+			throw new Dibi\PcreException;
+		}
 
 		foreach ($matches as $m) {
 			$res[$m[1]] = (int) $m[2];
@@ -193,10 +187,9 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 	}
 
 
-
 	/**
 	 * Gets the number of affected rows by the last INSERT, UPDATE or DELETE query.
-	 * @return int|FALSE  number of rows or FALSE on error
+	 * @return int|false  number of rows or false on error
 	 */
 	public function getAffectedRows()
 	{
@@ -204,10 +197,9 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 	}
 
 
-
 	/**
 	 * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query.
-	 * @return int|FALSE  int on success or FALSE on failure
+	 * @return int|false  int on success or false on failure
 	 */
 	public function getInsertId($sequence)
 	{
@@ -215,72 +207,66 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 	}
 
 
-
 	/**
 	 * Begins a transaction (if supported).
 	 * @param  string  optional savepoint name
 	 * @return void
-	 * @throws DibiDriverException
+	 * @throws Dibi\DriverException
 	 */
-	public function begin($savepoint = NULL)
+	public function begin($savepoint = null)
 	{
 		$this->query($savepoint ? "SAVEPOINT $savepoint" : 'START TRANSACTION');
 	}
 
 
-
 	/**
 	 * Commits statements in a transaction.
 	 * @param  string  optional savepoint name
 	 * @return void
-	 * @throws DibiDriverException
+	 * @throws Dibi\DriverException
 	 */
-	public function commit($savepoint = NULL)
+	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
+	 * @throws Dibi\DriverException
 	 */
-	public function rollback($savepoint = NULL)
+	public function rollback($savepoint = null)
 	{
 		$this->query($savepoint ? "ROLLBACK TO SAVEPOINT $savepoint" : 'ROLLBACK');
 	}
 
 
-
 	/**
 	 * Returns the connection resource.
-	 * @return mixed
+	 * @return resource|null
 	 */
 	public function getResource()
 	{
-		return is_resource($this->connection) ? $this->connection : NULL;
+		return is_resource($this->connection) ? $this->connection : null;
 	}
 
 
-
 	/**
 	 * Returns the connection reflector.
-	 * @return IDibiReflector
+	 * @return Dibi\Reflector
 	 */
 	public function getReflector()
 	{
-		return new DibiMySqlReflector($this);
+		return new MySqlReflector($this);
 	}
 
 
-
 	/**
 	 * Result set driver factory.
 	 * @param  resource
-	 * @return IDibiResultDriver
+	 * @return Dibi\ResultDriver
 	 */
 	public function createResultDriver($resource)
 	{
@@ -290,52 +276,82 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 	}
 
 
-
 	/********************* SQL ****************d*g**/
 
 
-
 	/**
 	 * Encodes data for use in a SQL statement.
-	 * @param  mixed     value
-	 * @param  string    type (dibi::TEXT, dibi::BOOL, ...)
+	 * @param  string    value
 	 * @return string    encoded value
-	 * @throws InvalidArgumentException
 	 */
-	public function escape($value, $type)
+	public function escapeText($value)
 	{
-		switch ($type) {
-		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
-			return '`' . str_replace('`', '``', $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.');
+		if (!is_resource($this->connection)) {
+			throw new Dibi\Exception('Lost connection to server.');
 		}
+		return "'" . mysql_real_escape_string($value, $this->connection) . "'";
 	}
 
 
+	/**
+	 * @param  string
+	 * @return string
+	 */
+	public function escapeBinary($value)
+	{
+		if (!is_resource($this->connection)) {
+			throw new Dibi\Exception('Lost connection to server.');
+		}
+		return "_binary'" . mysql_real_escape_string($value, $this->connection) . "'";
+	}
+
+
+	/**
+	 * @param  string
+	 * @return string
+	 */
+	public function escapeIdentifier($value)
+	{
+		// @see http://dev.mysql.com/doc/refman/5.0/en/identifiers.html
+		return '`' . str_replace('`', '``', $value) . '`';
+	}
+
+
+	/**
+	 * @param  bool
+	 * @return string
+	 */
+	public function escapeBool($value)
+	{
+		return $value ? 1 : 0;
+	}
+
+
+	/**
+	 * @param  \DateTime|\DateTimeInterface|string|int
+	 * @return string
+	 */
+	public function escapeDate($value)
+	{
+		if (!$value instanceof \DateTime && !$value instanceof \DateTimeInterface) {
+			$value = new Dibi\DateTime($value);
+		}
+		return $value->format("'Y-m-d'");
+	}
+
+
+	/**
+	 * @param  \DateTime|\DateTimeInterface|string|int
+	 * @return string
+	 */
+	public function escapeDateTime($value)
+	{
+		if (!$value instanceof \DateTime && !$value instanceof \DateTimeInterface) {
+			$value = new Dibi\DateTime($value);
+		}
+		return $value->format("'Y-m-d H:i:s.u'");
+	}
+
 
 	/**
 	 * Encodes string for use in a LIKE statement.
@@ -350,46 +366,48 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 	}
 
 
-
 	/**
 	 * Decodes data from result set.
-	 * @param  string    value
-	 * @param  string    type (dibi::BINARY)
-	 * @return string    decoded value
-	 * @throws InvalidArgumentException
+	 * @param  string
+	 * @return string
 	 */
-	public function unescape($value, $type)
+	public function unescapeBinary($value)
 	{
-		if ($type === dibi::BINARY) {
-			return $value;
-		}
-		throw new InvalidArgumentException('Unsupported type.');
+		return $value;
 	}
 
 
+	/** @deprecated */
+	public function escape($value, $type)
+	{
+		trigger_error(__METHOD__ . '() is deprecated.', E_USER_DEPRECATED);
+		return Dibi\Helpers::escape($this, $value, $type);
+	}
+
 
 	/**
 	 * Injects LIMIT/OFFSET to the SQL query.
-	 * @param  string &$sql  The SQL query that will be modified.
-	 * @param  int $limit
-	 * @param  int $offset
+	 * @param  string
+	 * @param  int|null
+	 * @param  int|null
 	 * @return void
 	 */
 	public function applyLimit(&$sql, $limit, $offset)
 	{
-		if ($limit < 0 && $offset < 1) return;
+		if ($limit < 0 || $offset < 0) {
+			throw new Dibi\NotSupportedException('Negative offset or limit.');
 
-		// see http://dev.mysql.com/doc/refman/5.0/en/select.html
-		$sql .= ' LIMIT ' . ($limit < 0 ? '18446744073709551615' : (int) $limit)
-			. ($offset > 0 ? ' OFFSET ' . (int) $offset : '');
+		} elseif ($limit !== null || $offset) {
+			// see http://dev.mysql.com/doc/refman/5.0/en/select.html
+			$sql .= ' LIMIT ' . ($limit === null ? '18446744073709551615' : Dibi\Helpers::intVal($limit))
+				. ($offset ? ' OFFSET ' . Dibi\Helpers::intVal($offset) : '');
+		}
 	}
 
 
-
 	/********************* result set ****************d*g**/
 
 
-
 	/**
 	 * Automatically frees the resources allocated for this result set.
 	 * @return void
@@ -400,7 +418,6 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 	}
 
 
-
 	/**
 	 * Returns the number of rows in a result set.
 	 * @return int
@@ -408,16 +425,15 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 	public function getRowCount()
 	{
 		if (!$this->buffered) {
-			throw new DibiNotSupportedException('Row count is not available for unbuffered queries.');
+			throw new Dibi\NotSupportedException('Row count is not available for unbuffered queries.');
 		}
 		return mysql_num_rows($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
+	 * @param  bool     true for associative array, false for numeric
 	 * @return array    array on success, nonarray if no next record
 	 */
 	public function fetch($assoc)
@@ -426,24 +442,22 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 	}
 
 
-
 	/**
 	 * 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
+	 * @param  int   the 0-based cursor pos to seek to
+	 * @return bool  true on success, false if unable to seek to specified record
+	 * @throws Dibi\Exception
 	 */
 	public function seek($row)
 	{
 		if (!$this->buffered) {
-			throw new DibiNotSupportedException('Cannot seek an unbuffered result set.');
+			throw new Dibi\NotSupportedException('Cannot seek an unbuffered result set.');
 		}
 
 		return mysql_data_seek($this->resultSet, $row);
 	}
 
 
-
 	/**
 	 * Frees the resources allocated for this result set.
 	 * @return void
@@ -451,11 +465,10 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 	public function free()
 	{
 		mysql_free_result($this->resultSet);
-		$this->resultSet = NULL;
+		$this->resultSet = null;
 	}
 
 
-
 	/**
 	 * Returns metadata for all columns in a result set.
 	 * @return array
@@ -463,30 +476,29 @@ class DibiMySqlDriver extends DibiObject implements IDibiDriver, IDibiResultDriv
 	public function getResultColumns()
 	{
 		$count = mysql_num_fields($this->resultSet);
-		$columns = array();
+		$columns = [];
 		for ($i = 0; $i < $count; $i++) {
 			$row = (array) mysql_fetch_field($this->resultSet, $i);
-			$columns[] = array(
+			$columns[] = [
 				'name' => $row['name'],
 				'table' => $row['table'],
 				'fullname' => $row['table'] ? $row['table'] . '.' . $row['name'] : $row['name'],
 				'nativetype' => strtoupper($row['type']),
+				'type' => $row['type'] === 'time' ? Dibi\Type::TIME_INTERVAL : null,
 				'vendor' => $row,
-			);
+			];
 		}
 		return $columns;
 	}
 
 
-
 	/**
 	 * Returns the result set resource.
-	 * @return mixed
+	 * @return resource|null
 	 */
 	public function getResultResource()
 	{
-		$this->autoFree = FALSE;
-		return is_resource($this->resultSet) ? $this->resultSet : NULL;
+		$this->autoFree = false;
+		return is_resource($this->resultSet) ? $this->resultSet : null;
 	}
-
 }

src/Dibi/Drivers/MySqlReflector.php

@@ -0,0 +1,134 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi\Drivers;
+
+use Dibi;
+
+
+/**
+ * The reflector for MySQL databases.
+ * @internal
+ */
+class MySqlReflector implements Dibi\Reflector
+{
+	use Dibi\Strict;
+
+	/** @var Dibi\Driver */
+	private $driver;
+
+
+	public function __construct(Dibi\Driver $driver)
+	{
+		$this->driver = $driver;
+	}
+
+
+	/**
+	 * Returns list of tables.
+	 * @return array
+	 */
+	public function getTables()
+	{
+		$res = $this->driver->query('SHOW FULL TABLES');
+		$tables = [];
+		while ($row = $res->fetch(false)) {
+			$tables[] = [
+				'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)
+	{
+		$res = $this->driver->query("SHOW FULL COLUMNS FROM {$this->driver->escapeIdentifier($table)}");
+		$columns = [];
+		while ($row = $res->fetch(true)) {
+			$type = explode('(', $row['Type']);
+			$columns[] = [
+				'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)
+	{
+		$res = $this->driver->query("SHOW INDEX FROM {$this->driver->escapeIdentifier($table)}");
+		$indexes = [];
+		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
+	 * @throws Dibi\NotSupportedException
+	 */
+	public function getForeignKeys($table)
+	{
+		$data = $this->driver->query("SELECT `ENGINE` FROM information_schema.TABLES WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = {$this->driver->escapeText($table)}")->fetch(true);
+		if ($data['ENGINE'] !== 'InnoDB') {
+			throw new Dibi\NotSupportedException("Foreign keys are not supported in {$data['ENGINE']} tables.");
+		}
+
+		$res = $this->driver->query("
+			SELECT rc.CONSTRAINT_NAME, rc.UPDATE_RULE, rc.DELETE_RULE, kcu.REFERENCED_TABLE_NAME,
+				GROUP_CONCAT(kcu.REFERENCED_COLUMN_NAME ORDER BY kcu.ORDINAL_POSITION) AS REFERENCED_COLUMNS,
+				GROUP_CONCAT(kcu.COLUMN_NAME ORDER BY kcu.ORDINAL_POSITION) AS COLUMNS
+			FROM information_schema.REFERENTIAL_CONSTRAINTS rc
+			INNER JOIN information_schema.KEY_COLUMN_USAGE kcu ON
+				kcu.CONSTRAINT_NAME = rc.CONSTRAINT_NAME
+				AND kcu.CONSTRAINT_SCHEMA = rc.CONSTRAINT_SCHEMA
+			WHERE rc.CONSTRAINT_SCHEMA = DATABASE()
+				AND rc.TABLE_NAME = {$this->driver->escapeText($table)}
+			GROUP BY rc.CONSTRAINT_NAME
+		");
+
+		$foreignKeys = [];
+		while ($row = $res->fetch(true)) {
+			$keyName = $row['CONSTRAINT_NAME'];
+
+			$foreignKeys[$keyName]['name'] = $keyName;
+			$foreignKeys[$keyName]['local'] = explode(',', $row['COLUMNS']);
+			$foreignKeys[$keyName]['table'] = $row['REFERENCED_TABLE_NAME'];
+			$foreignKeys[$keyName]['foreign'] = explode(',', $row['REFERENCED_COLUMNS']);
+			$foreignKeys[$keyName]['onDelete'] = $row['DELETE_RULE'];
+			$foreignKeys[$keyName]['onUpdate'] = $row['UPDATE_RULE'];
+		}
+		return array_values($foreignKeys);
+	}
+}

src/Dibi/Drivers/MySqliDriver.php

@@ -1,20 +1,17 @@
 <?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.
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
  */
 
+namespace Dibi\Drivers;
 
-require_once dirname(__FILE__) . '/DibiMySqlReflector.php';
+use Dibi;
 
 
 /**
- * The dibi driver for MySQL database via improved extension.
+ * The driver for MySQL database.
  *
  * Driver options:
  *   - host => the MySQL server host name
@@ -30,47 +27,45 @@ require_once dirname(__FILE__) . '/DibiMySqlReflector.php';
  *   - 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
- * @package    dibi\drivers
  */
-class DibiMySqliDriver extends DibiObject implements IDibiDriver, IDibiResultDriver
+class MySqliDriver implements Dibi\Driver, Dibi\ResultDriver
 {
+	use Dibi\Strict;
+
 	const ERROR_ACCESS_DENIED = 1045;
+
 	const ERROR_DUPLICATE_ENTRY = 1062;
+
 	const ERROR_DATA_TRUNCATED = 1265;
 
-	/** @var mysqli  Connection resource */
+	/** @var \mysqli|null */
 	private $connection;
 
-	/** @var mysqli_result  Resultset resource */
+	/** @var \mysqli_result|null */
 	private $resultSet;
 
 	/** @var bool */
-	private $autoFree = TRUE;
+	private $autoFree = true;
 
 	/** @var bool  Is buffered (seekable and countable)? */
 	private $buffered;
 
 
-
 	/**
-	 * @throws DibiNotSupportedException
+	 * @throws Dibi\NotSupportedException
 	 */
 	public function __construct()
 	{
 		if (!extension_loaded('mysqli')) {
-			throw new DibiNotSupportedException("PHP extension 'mysqli' is not loaded.");
+			throw new Dibi\NotSupportedException("PHP extension 'mysqli' is not loaded.");
 		}
 	}
 
 
-
 	/**
 	 * Connects to a database.
 	 * @return void
-	 * @throws DibiException
+	 * @throws Dibi\Exception
 	 */
 	public function connect(array &$config)
 	{
@@ -80,51 +75,43 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver, IDibiResultDri
 
 		} else {
 			// default values
-			if (!isset($config['charset'])) $config['charset'] = 'utf8';
-			if (!isset($config['timezone'])) $config['timezone'] = date('P');
-			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;
+			$config += [
+				'charset' => 'utf8',
+				'timezone' => date('P'),
+				'username' => ini_get('mysqli.default_user'),
+				'password' => ini_get('mysqli.default_pw'),
+				'socket' => (string) ini_get('mysqli.default_socket'),
+				'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;
+					$config['host'] = null;
+					$config['port'] = null;
 				}
 			}
 
-			$foo = & $config['flags'];
-			$foo = & $config['database'];
+			$foo = &$config['flags'];
+			$foo = &$config['database'];
 
 			$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);
-					}
+				foreach ($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);
+				throw new Dibi\DriverException(mysqli_connect_error(), $errno);
 			}
 		}
 
 		if (isset($config['charset'])) {
-			$ok = FALSE;
-			if (version_compare(PHP_VERSION , '5.1.5', '>=')) {
-				// affects the character set used by mysql_real_escape_string() (was added in MySQL 5.0.7 and PHP 5.0.5, fixed in PHP 5.1.5)
-				$ok = @mysqli_set_charset($this->connection, $config['charset']); // intentionally @
-			}
-			if (!$ok) {
+			if (!@mysqli_set_charset($this->connection, $config['charset'])) {
 				$this->query("SET NAMES '$config[charset]'");
 			}
 		}
@@ -141,37 +128,55 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver, IDibiResultDri
 	}
 
 
-
 	/**
 	 * Disconnects from a database.
 	 * @return void
 	 */
 	public function disconnect()
 	{
-		mysqli_close($this->connection);
+		@mysqli_close($this->connection); // @ - connection can be already disconnected
 	}
 
 
-
 	/**
 	 * Executes the SQL query.
 	 * @param  string      SQL statement.
-	 * @return IDibiResultDriver|NULL
-	 * @throws DibiDriverException
+	 * @return Dibi\ResultDriver|null
+	 * @throws Dibi\DriverException
 	 */
 	public function query($sql)
 	{
 		$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);
+		if ($code = mysqli_errno($this->connection)) {
+			throw static::createException(mysqli_error($this->connection), $code, $sql);
 
 		} elseif (is_object($res)) {
 			return $this->createResultDriver($res);
 		}
+		return null;
 	}
 
 
+	/**
+	 * @return Dibi\DriverException
+	 */
+	public static function createException($message, $code, $sql)
+	{
+		if (in_array($code, [1216, 1217, 1451, 1452, 1701], true)) {
+			return new Dibi\ForeignKeyConstraintViolationException($message, $code, $sql);
+
+		} elseif (in_array($code, [1062, 1557, 1569, 1586], true)) {
+			return new Dibi\UniqueConstraintViolationException($message, $code, $sql);
+
+		} elseif (in_array($code, [1048, 1121, 1138, 1171, 1252, 1263, 1566], true)) {
+			return new Dibi\NotNullConstraintViolationException($message, $code, $sql);
+
+		} else {
+			return new Dibi\DriverException($message, $code, $sql);
+		}
+	}
+
 
 	/**
 	 * Retrieves information about the most recently executed query.
@@ -179,9 +184,11 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver, IDibiResultDri
 	 */
 	public function getInfo()
 	{
-		$res = array();
+		$res = [];
 		preg_match_all('#(.+?): +(\d+) *#', mysqli_info($this->connection), $matches, PREG_SET_ORDER);
-		if (preg_last_error()) throw new DibiPcreException;
+		if (preg_last_error()) {
+			throw new Dibi\PcreException;
+		}
 
 		foreach ($matches as $m) {
 			$res[$m[1]] = (int) $m[2];
@@ -190,21 +197,19 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver, IDibiResultDri
 	}
 
 
-
 	/**
 	 * Gets the number of affected rows by the last INSERT, UPDATE or DELETE query.
-	 * @return int|FALSE  number of rows or FALSE on error
+	 * @return int|false  number of rows or false on error
 	 */
 	public function getAffectedRows()
 	{
-		return mysqli_affected_rows($this->connection) === -1 ? FALSE : mysqli_affected_rows($this->connection);
+		return mysqli_affected_rows($this->connection) === -1 ? false : mysqli_affected_rows($this->connection);
 	}
 
 
-
 	/**
 	 * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query.
-	 * @return int|FALSE  int on success or FALSE on failure
+	 * @return int|false  int on success or false on failure
 	 */
 	public function getInsertId($sequence)
 	{
@@ -212,74 +217,67 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver, IDibiResultDri
 	}
 
 
-
 	/**
 	 * Begins a transaction (if supported).
 	 * @param  string  optional savepoint name
 	 * @return void
-	 * @throws DibiDriverException
+	 * @throws Dibi\DriverException
 	 */
-	public function begin($savepoint = NULL)
+	public function begin($savepoint = null)
 	{
 		$this->query($savepoint ? "SAVEPOINT $savepoint" : 'START TRANSACTION');
 	}
 
 
-
 	/**
 	 * Commits statements in a transaction.
 	 * @param  string  optional savepoint name
 	 * @return void
-	 * @throws DibiDriverException
+	 * @throws Dibi\DriverException
 	 */
-	public function commit($savepoint = NULL)
+	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
+	 * @throws Dibi\DriverException
 	 */
-	public function rollback($savepoint = NULL)
+	public function rollback($savepoint = null)
 	{
 		$this->query($savepoint ? "ROLLBACK TO SAVEPOINT $savepoint" : 'ROLLBACK');
 	}
 
 
-
 	/**
 	 * Returns the connection resource.
-	 * @return mysqli
+	 * @return \mysqli|null
 	 */
 	public function getResource()
 	{
-		return @$this->connection->thread_id ? $this->connection : NULL;
+		return @$this->connection->thread_id ? $this->connection : null;
 	}
 
 
-
 	/**
 	 * Returns the connection reflector.
-	 * @return IDibiReflector
+	 * @return Dibi\Reflector
 	 */
 	public function getReflector()
 	{
-		return new DibiMySqlReflector($this);
+		return new MySqlReflector($this);
 	}
 
 
-
 	/**
 	 * Result set driver factory.
-	 * @param  mysqli_result
-	 * @return IDibiResultDriver
+	 * @return Dibi\ResultDriver
 	 */
-	public function createResultDriver(mysqli_result $resource)
+	public function createResultDriver(\mysqli_result $resource)
 	{
 		$res = clone $this;
 		$res->resultSet = $resource;
@@ -287,45 +285,75 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver, IDibiResultDri
 	}
 
 
-
 	/********************* SQL ****************d*g**/
 
 
-
 	/**
 	 * Encodes data for use in a SQL statement.
-	 * @param  mixed     value
-	 * @param  string    type (dibi::TEXT, dibi::BOOL, ...)
+	 * @param  string    value
 	 * @return string    encoded value
-	 * @throws InvalidArgumentException
 	 */
-	public function escape($value, $type)
+	public function escapeText($value)
 	{
-		switch ($type) {
-		case dibi::TEXT:
-			return "'" . mysqli_real_escape_string($this->connection, $value) . "'";
-
-		case dibi::BINARY:
-			return "_binary'" . mysqli_real_escape_string($this->connection, $value) . "'";
-
-		case dibi::IDENTIFIER:
-			return '`' . str_replace('`', '``', $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.');
-		}
+		return "'" . mysqli_real_escape_string($this->connection, $value) . "'";
 	}
 
 
+	/**
+	 * @param  string
+	 * @return string
+	 */
+	public function escapeBinary($value)
+	{
+		return "_binary'" . mysqli_real_escape_string($this->connection, $value) . "'";
+	}
+
+
+	/**
+	 * @param  string
+	 * @return string
+	 */
+	public function escapeIdentifier($value)
+	{
+		return '`' . str_replace('`', '``', $value) . '`';
+	}
+
+
+	/**
+	 * @param  bool
+	 * @return string
+	 */
+	public function escapeBool($value)
+	{
+		return $value ? '1' : '0';
+	}
+
+
+	/**
+	 * @param  \DateTime|\DateTimeInterface|string|int
+	 * @return string
+	 */
+	public function escapeDate($value)
+	{
+		if (!$value instanceof \DateTime && !$value instanceof \DateTimeInterface) {
+			$value = new Dibi\DateTime($value);
+		}
+		return $value->format("'Y-m-d'");
+	}
+
+
+	/**
+	 * @param  \DateTime|\DateTimeInterface|string|int
+	 * @return string
+	 */
+	public function escapeDateTime($value)
+	{
+		if (!$value instanceof \DateTime && !$value instanceof \DateTimeInterface) {
+			$value = new Dibi\DateTime($value);
+		}
+		return $value->format("'Y-m-d H:i:s.u'");
+	}
+
 
 	/**
 	 * Encodes string for use in a LIKE statement.
@@ -340,57 +368,60 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver, IDibiResultDri
 	}
 
 
-
 	/**
 	 * Decodes data from result set.
-	 * @param  string    value
-	 * @param  string    type (dibi::BINARY)
-	 * @return string    decoded value
-	 * @throws InvalidArgumentException
+	 * @param  string
+	 * @return string
 	 */
-	public function unescape($value, $type)
+	public function unescapeBinary($value)
 	{
-		if ($type === dibi::BINARY) {
-			return $value;
-		}
-		throw new InvalidArgumentException('Unsupported type.');
+		return $value;
 	}
 
 
+	/** @deprecated */
+	public function escape($value, $type)
+	{
+		trigger_error(__METHOD__ . '() is deprecated.', E_USER_DEPRECATED);
+		return Dibi\Helpers::escape($this, $value, $type);
+	}
+
 
 	/**
 	 * Injects LIMIT/OFFSET to the SQL query.
-	 * @param  string &$sql  The SQL query that will be modified.
-	 * @param  int $limit
-	 * @param  int $offset
+	 * @param  string
+	 * @param  int|null
+	 * @param  int|null
 	 * @return void
 	 */
 	public function applyLimit(&$sql, $limit, $offset)
 	{
-		if ($limit < 0 && $offset < 1) return;
+		if ($limit < 0 || $offset < 0) {
+			throw new Dibi\NotSupportedException('Negative offset or limit.');
 
-		// see http://dev.mysql.com/doc/refman/5.0/en/select.html
-		$sql .= ' LIMIT ' . ($limit < 0 ? '18446744073709551615' : (int) $limit)
-			. ($offset > 0 ? ' OFFSET ' . (int) $offset : '');
+		} elseif ($limit !== null || $offset) {
+			// see http://dev.mysql.com/doc/refman/5.0/en/select.html
+			$sql .= ' LIMIT ' . ($limit === null ? '18446744073709551615' : Dibi\Helpers::intVal($limit))
+				. ($offset ? ' OFFSET ' . Dibi\Helpers::intVal($offset) : '');
+		}
 	}
 
 
-
 	/********************* result set ****************d*g**/
 
 
-
 	/**
 	 * Automatically frees the resources allocated for this result set.
 	 * @return void
 	 */
 	public function __destruct()
 	{
-		$this->autoFree && $this->getResultResource() && @$this->free();
+		if ($this->autoFree && $this->getResultResource()) {
+			@$this->free();
+		}
 	}
 
 
-
 	/**
 	 * Returns the number of rows in a result set.
 	 * @return int
@@ -398,16 +429,15 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver, IDibiResultDri
 	public function getRowCount()
 	{
 		if (!$this->buffered) {
-			throw new DibiNotSupportedException('Row count is not available for unbuffered queries.');
+			throw new Dibi\NotSupportedException('Row count is not available for unbuffered queries.');
 		}
 		return mysqli_num_rows($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
+	 * @param  bool     true for associative array, false for numeric
 	 * @return array    array on success, nonarray if no next record
 	 */
 	public function fetch($assoc)
@@ -416,23 +446,21 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver, IDibiResultDri
 	}
 
 
-
 	/**
 	 * 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
+	 * @param  int   the 0-based cursor pos to seek to
+	 * @return bool  true on success, false if unable to seek to specified record
+	 * @throws Dibi\Exception
 	 */
 	public function seek($row)
 	{
 		if (!$this->buffered) {
-			throw new DibiNotSupportedException('Cannot seek an unbuffered result set.');
+			throw new Dibi\NotSupportedException('Cannot seek an unbuffered result set.');
 		}
 		return mysqli_data_seek($this->resultSet, $row);
 	}
 
 
-
 	/**
 	 * Frees the resources allocated for this result set.
 	 * @return void
@@ -440,11 +468,10 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver, IDibiResultDri
 	public function free()
 	{
 		mysqli_free_result($this->resultSet);
-		$this->resultSet = NULL;
+		$this->resultSet = null;
 	}
 
 
-
 	/**
 	 * Returns metadata for all columns in a result set.
 	 * @return array
@@ -452,9 +479,10 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver, IDibiResultDri
 	public function getResultColumns()
 	{
 		static $types;
-		if (empty($types)) {
-			$consts = get_defined_constants(TRUE);
-			foreach ($consts['mysqli'] as $key => $value) {
+		if ($types === null) {
+			$consts = get_defined_constants(true);
+			$types = [];
+			foreach (isset($consts['mysqli']) ? $consts['mysqli'] : [] as $key => $value) {
 				if (strncmp($key, 'MYSQLI_TYPE_', 12) === 0) {
 					$types[$value] = substr($key, 12);
 				}
@@ -463,30 +491,29 @@ class DibiMySqliDriver extends DibiObject implements IDibiDriver, IDibiResultDri
 		}
 
 		$count = mysqli_num_fields($this->resultSet);
-		$columns = array();
+		$columns = [];
 		for ($i = 0; $i < $count; $i++) {
 			$row = (array) mysqli_fetch_field_direct($this->resultSet, $i);
-			$columns[] = array(
+			$columns[] = [
 				'name' => $row['name'],
 				'table' => $row['orgtable'],
 				'fullname' => $row['table'] ? $row['table'] . '.' . $row['name'] : $row['name'],
-				'nativetype' => $types[$row['type']],
+				'nativetype' => isset($types[$row['type']]) ? $types[$row['type']] : $row['type'],
+				'type' => $row['type'] === MYSQLI_TYPE_TIME ? Dibi\Type::TIME_INTERVAL : null,
 				'vendor' => $row,
-			);
+			];
 		}
 		return $columns;
 	}
 
 
-
 	/**
 	 * Returns the result set resource.
-	 * @return mysqli_result
+	 * @return \mysqli_result|null
 	 */
 	public function getResultResource()
 	{
-		$this->autoFree = FALSE;
-		return @$this->resultSet->type === NULL ? NULL : $this->resultSet;
+		$this->autoFree = false;
+		return $this->resultSet;
 	}
-
 }

src/Dibi/Drivers/OdbcDriver.php

@@ -1,17 +1,17 @@
 <?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.
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
  */
 
+namespace Dibi\Drivers;
+
+use Dibi;
+
 
 /**
- * The dibi driver interacting with databases via ODBC connections.
+ * The driver interacting with databases via ODBC connections.
  *
  * Driver options:
  *   - dsn => driver specific DSN
@@ -19,46 +19,46 @@
  *   - 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
- * @package    dibi\drivers
+ *   - microseconds (bool) => use microseconds in datetime format?
  */
-class DibiOdbcDriver extends DibiObject implements IDibiDriver, IDibiResultDriver, IDibiReflector
+class OdbcDriver implements Dibi\Driver, Dibi\ResultDriver, Dibi\Reflector
 {
-	/** @var resource  Connection resource */
+	use Dibi\Strict;
+
+	/** @var resource|null */
 	private $connection;
 
-	/** @var resource  Resultset resource */
+	/** @var resource|null */
 	private $resultSet;
 
 	/** @var bool */
-	private $autoFree = TRUE;
+	private $autoFree = true;
 
-	/** @var int|FALSE  Affected rows */
-	private $affectedRows = FALSE;
+	/** @var bool */
+	private $microseconds = true;
+
+	/** @var int|false  Affected rows */
+	private $affectedRows = false;
 
 	/** @var int  Cursor */
 	private $row = 0;
 
 
-
 	/**
-	 * @throws DibiNotSupportedException
+	 * @throws Dibi\NotSupportedException
 	 */
 	public function __construct()
 	{
 		if (!extension_loaded('odbc')) {
-			throw new DibiNotSupportedException("PHP extension 'odbc' is not loaded.");
+			throw new Dibi\NotSupportedException("PHP extension 'odbc' is not loaded.");
 		}
 	}
 
 
-
 	/**
 	 * Connects to a database.
 	 * @return void
-	 * @throws DibiException
+	 * @throws Dibi\Exception
 	 */
 	public function connect(array &$config)
 	{
@@ -66,9 +66,11 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver, IDibiResultDrive
 			$this->connection = $config['resource'];
 		} else {
 			// 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');
+			$config += [
+				'username' => ini_get('odbc.default_user'),
+				'password' => ini_get('odbc.default_pw'),
+				'dsn' => ini_get('odbc.default_db'),
+			];
 
 			if (empty($config['persistent'])) {
 				$this->connection = @odbc_connect($config['dsn'], $config['username'], $config['password']); // intentionally @
@@ -78,48 +80,50 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver, IDibiResultDrive
 		}
 
 		if (!is_resource($this->connection)) {
-			throw new DibiDriverException(odbc_errormsg() . ' ' . odbc_error());
+			throw new Dibi\DriverException(odbc_errormsg() . ' ' . odbc_error());
+		}
+
+		if (isset($config['microseconds'])) {
+			$this->microseconds = (bool) $config['microseconds'];
 		}
 	}
 
 
-
 	/**
 	 * Disconnects from a database.
 	 * @return void
 	 */
 	public function disconnect()
 	{
-		odbc_close($this->connection);
+		@odbc_close($this->connection); // @ - connection can be already disconnected
 	}
 
 
-
 	/**
 	 * Executes the SQL query.
 	 * @param  string      SQL statement.
-	 * @return IDibiResultDriver|NULL
-	 * @throws DibiDriverException
+	 * @return Dibi\ResultDriver|null
+	 * @throws Dibi\DriverException
 	 */
 	public function query($sql)
 	{
-		$this->affectedRows = FALSE;
+		$this->affectedRows = false;
 		$res = @odbc_exec($this->connection, $sql); // intentionally @
 
-		if ($res === FALSE) {
-			throw new DibiDriverException(odbc_errormsg($this->connection) . ' ' . odbc_error($this->connection), 0, $sql);
+		if ($res === false) {
+			throw new Dibi\DriverException(odbc_errormsg($this->connection) . ' ' . odbc_error($this->connection), 0, $sql);
 
 		} elseif (is_resource($res)) {
 			$this->affectedRows = odbc_num_rows($res);
-			return $this->createResultDriver($res);
+			return odbc_num_fields($res) ? $this->createResultDriver($res) : null;
 		}
+		return null;
 	}
 
 
-
 	/**
 	 * Gets the number of affected rows by the last INSERT, UPDATE or DELETE query.
-	 * @return int|FALSE  number of rows or FALSE on error
+	 * @return int|false  number of rows or false on error
 	 */
 	public function getAffectedRows()
 	{
@@ -127,65 +131,60 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver, IDibiResultDrive
 	}
 
 
-
 	/**
 	 * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query.
-	 * @return int|FALSE  int on success or FALSE on failure
+	 * @return int|false  int on success or false on failure
 	 */
 	public function getInsertId($sequence)
 	{
-		throw new DibiNotSupportedException('ODBC does not support autoincrementing.');
+		throw new Dibi\NotSupportedException('ODBC does not support autoincrementing.');
 	}
 
 
-
 	/**
 	 * Begins a transaction (if supported).
 	 * @param  string  optional savepoint name
 	 * @return void
-	 * @throws DibiDriverException
+	 * @throws Dibi\DriverException
 	 */
-	public function begin($savepoint = NULL)
+	public function begin($savepoint = null)
 	{
-		if (!odbc_autocommit($this->connection, FALSE)) {
-			throw new DibiDriverException(odbc_errormsg($this->connection) . ' ' . odbc_error($this->connection));
+		if (!odbc_autocommit($this->connection, false)) {
+			throw new Dibi\DriverException(odbc_errormsg($this->connection) . ' ' . odbc_error($this->connection));
 		}
 	}
 
 
-
 	/**
 	 * Commits statements in a transaction.
 	 * @param  string  optional savepoint name
 	 * @return void
-	 * @throws DibiDriverException
+	 * @throws Dibi\DriverException
 	 */
-	public function commit($savepoint = NULL)
+	public function commit($savepoint = null)
 	{
 		if (!odbc_commit($this->connection)) {
-			throw new DibiDriverException(odbc_errormsg($this->connection) . ' ' . odbc_error($this->connection));
+			throw new Dibi\DriverException(odbc_errormsg($this->connection) . ' ' . odbc_error($this->connection));
 		}
-		odbc_autocommit($this->connection, TRUE);
+		odbc_autocommit($this->connection, true);
 	}
 
 
-
 	/**
 	 * Rollback changes in a transaction.
 	 * @param  string  optional savepoint name
 	 * @return void
-	 * @throws DibiDriverException
+	 * @throws Dibi\DriverException
 	 */
-	public function rollback($savepoint = NULL)
+	public function rollback($savepoint = null)
 	{
 		if (!odbc_rollback($this->connection)) {
-			throw new DibiDriverException(odbc_errormsg($this->connection) . ' ' . odbc_error($this->connection));
+			throw new Dibi\DriverException(odbc_errormsg($this->connection) . ' ' . odbc_error($this->connection));
 		}
-		odbc_autocommit($this->connection, TRUE);
+		odbc_autocommit($this->connection, true);
 	}
 
 
-
 	/**
 	 * Is in transaction?
 	 * @return bool
@@ -196,21 +195,19 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver, IDibiResultDrive
 	}
 
 
-
 	/**
 	 * Returns the connection resource.
-	 * @return mixed
+	 * @return resource|null
 	 */
 	public function getResource()
 	{
-		return is_resource($this->connection) ? $this->connection : NULL;
+		return is_resource($this->connection) ? $this->connection : null;
 	}
 
 
-
 	/**
 	 * Returns the connection reflector.
-	 * @return IDibiReflector
+	 * @return Dibi\Reflector
 	 */
 	public function getReflector()
 	{
@@ -218,11 +215,10 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver, IDibiResultDrive
 	}
 
 
-
 	/**
 	 * Result set driver factory.
 	 * @param  resource
-	 * @return IDibiResultDriver
+	 * @return Dibi\ResultDriver
 	 */
 	public function createResultDriver($resource)
 	{
@@ -232,43 +228,75 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver, IDibiResultDrive
 	}
 
 
-
 	/********************* SQL ****************d*g**/
 
 
-
 	/**
 	 * Encodes data for use in a SQL statement.
-	 * @param  mixed     value
-	 * @param  string    type (dibi::TEXT, dibi::BOOL, ...)
+	 * @param  string    value
 	 * @return string    encoded value
-	 * @throws InvalidArgumentException
 	 */
-	public function escape($value, $type)
+	public function escapeText($value)
 	{
-		switch ($type) {
-		case dibi::TEXT:
-		case dibi::BINARY:
-			return "'" . str_replace("'", "''", $value) . "'";
-
-		case dibi::IDENTIFIER:
-			return '[' . str_replace(array('[', ']'), array('[[', ']]'), $value) . ']';
-
-		case dibi::BOOL:
-			return $value ? 1 : 0;
-
-		case dibi::DATE:
-			return $value instanceof DateTime ? $value->format("#m/d/Y#") : date("#m/d/Y#", $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.');
-		}
+		return "'" . str_replace("'", "''", $value) . "'";
 	}
 
 
+	/**
+	 * @param  string
+	 * @return string
+	 */
+	public function escapeBinary($value)
+	{
+		return "'" . str_replace("'", "''", $value) . "'";
+	}
+
+
+	/**
+	 * @param  string
+	 * @return string
+	 */
+	public function escapeIdentifier($value)
+	{
+		return '[' . str_replace(['[', ']'], ['[[', ']]'], $value) . ']';
+	}
+
+
+	/**
+	 * @param  bool
+	 * @return string
+	 */
+	public function escapeBool($value)
+	{
+		return $value ? '1' : '0';
+	}
+
+
+	/**
+	 * @param  \DateTime|\DateTimeInterface|string|int
+	 * @return string
+	 */
+	public function escapeDate($value)
+	{
+		if (!$value instanceof \DateTime && !$value instanceof \DateTimeInterface) {
+			$value = new Dibi\DateTime($value);
+		}
+		return $value->format('#m/d/Y#');
+	}
+
+
+	/**
+	 * @param  \DateTime|\DateTimeInterface|string|int
+	 * @return string
+	 */
+	public function escapeDateTime($value)
+	{
+		if (!$value instanceof \DateTime && !$value instanceof \DateTimeInterface) {
+			$value = new Dibi\DateTime($value);
+		}
+		return $value->format($this->microseconds ? '#m/d/Y H:i:s.u#' : '#m/d/Y H:i:s#');
+	}
+
 
 	/**
 	 * Encodes string for use in a LIKE statement.
@@ -278,63 +306,66 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver, IDibiResultDrive
 	 */
 	public function escapeLike($value, $pos)
 	{
-		$value = strtr($value, array("'" => "''", '%' => '[%]', '_' => '[_]', '[' => '[[]'));
+		$value = strtr($value, ["'" => "''", '%' => '[%]', '_' => '[_]', '[' => '[[]']);
 		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
+	 * @param  string
+	 * @return string
 	 */
-	public function unescape($value, $type)
+	public function unescapeBinary($value)
 	{
-		if ($type === dibi::BINARY) {
-			return $value;
-		}
-		throw new InvalidArgumentException('Unsupported type.');
+		return $value;
 	}
 
 
+	/** @deprecated */
+	public function escape($value, $type)
+	{
+		trigger_error(__METHOD__ . '() is deprecated.', E_USER_DEPRECATED);
+		return Dibi\Helpers::escape($this, $value, $type);
+	}
+
 
 	/**
 	 * Injects LIMIT/OFFSET to the SQL query.
-	 * @param  string &$sql  The SQL query that will be modified.
-	 * @param  int $limit
-	 * @param  int $offset
+	 * @param  string
+	 * @param  int|null
+	 * @param  int|null
 	 * @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 Dibi\NotSupportedException('Offset is not supported by this database.');
 
-		if ($offset) throw new DibiNotSupportedException('Offset is not implemented in driver odbc.');
+		} elseif ($limit < 0) {
+			throw new Dibi\NotSupportedException('Negative offset or limit.');
+
+		} elseif ($limit !== null) {
+			$sql = 'SELECT TOP ' . Dibi\Helpers::intVal($limit) . ' * FROM (' . $sql . ') t';
+		}
 	}
 
 
-
 	/********************* result set ****************d*g**/
 
 
-
 	/**
 	 * Automatically frees the resources allocated for this result set.
 	 * @return void
 	 */
 	public function __destruct()
 	{
-		$this->autoFree && $this->getResultResource() && $this->free();
+		if ($this->autoFree && $this->getResultResource()) {
+			$this->free();
+		}
 	}
 
 
-
 	/**
 	 * Returns the number of rows in a result set.
 	 * @return int
@@ -346,10 +377,9 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver, IDibiResultDrive
 	}
 
 
-
 	/**
 	 * Fetches the row at current position and moves the internal cursor to the next position.
-	 * @param  bool     TRUE for associative array, FALSE for numeric
+	 * @param  bool     true for associative array, false for numeric
 	 * @return array    array on success, nonarray if no next record
 	 */
 	public function fetch($assoc)
@@ -358,29 +388,31 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver, IDibiResultDrive
 			return odbc_fetch_array($this->resultSet, ++$this->row);
 		} else {
 			$set = $this->resultSet;
-			if (!odbc_fetch_row($set, ++$this->row)) return FALSE;
+			if (!odbc_fetch_row($set, ++$this->row)) {
+				return false;
+			}
 			$count = odbc_num_fields($set);
-			$cols = array();
-			for ($i = 1; $i <= $count; $i++) $cols[] = odbc_result($set, $i);
+			$cols = [];
+			for ($i = 1; $i <= $count; $i++) {
+				$cols[] = odbc_result($set, $i);
+			}
 			return $cols;
 		}
 	}
 
 
-
 	/**
 	 * 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
+	 * @param  int   the 0-based cursor pos to seek to
+	 * @return bool  true on success, false if unable to seek to specified record
 	 */
 	public function seek($row)
 	{
 		$this->row = $row;
-		return TRUE;
+		return true;
 	}
 
 
-
 	/**
 	 * Frees the resources allocated for this result set.
 	 * @return void
@@ -388,11 +420,10 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver, IDibiResultDrive
 	public function free()
 	{
 		odbc_free_result($this->resultSet);
-		$this->resultSet = NULL;
+		$this->resultSet = null;
 	}
 
 
-
 	/**
 	 * Returns metadata for all columns in a result set.
 	 * @return array
@@ -400,34 +431,31 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver, IDibiResultDrive
 	public function getResultColumns()
 	{
 		$count = odbc_num_fields($this->resultSet);
-		$columns = array();
+		$columns = [];
 		for ($i = 1; $i <= $count; $i++) {
-			$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),
-			);
+			$columns[] = [
+				'name' => odbc_field_name($this->resultSet, $i),
+				'table' => null,
+				'fullname' => odbc_field_name($this->resultSet, $i),
+				'nativetype' => odbc_field_type($this->resultSet, $i),
+			];
 		}
 		return $columns;
 	}
 
 
-
 	/**
 	 * Returns the result set resource.
-	 * @return mixed
+	 * @return resource|null
 	 */
 	public function getResultResource()
 	{
-		$this->autoFree = FALSE;
-		return is_resource($this->resultSet) ? $this->resultSet : NULL;
+		$this->autoFree = false;
+		return is_resource($this->resultSet) ? $this->resultSet : null;
 	}
 
 
-
-	/********************* IDibiReflector ****************d*g**/
-
+	/********************* Dibi\Reflector ****************d*g**/
 
 
 	/**
@@ -437,13 +465,13 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver, IDibiResultDrive
 	public function getTables()
 	{
 		$res = odbc_tables($this->connection);
-		$tables = array();
+		$tables = [];
 		while ($row = odbc_fetch_array($res)) {
 			if ($row['TABLE_TYPE'] === 'TABLE' || $row['TABLE_TYPE'] === 'VIEW') {
-				$tables[] = array(
+				$tables[] = [
 					'name' => $row['TABLE_NAME'],
 					'view' => $row['TABLE_TYPE'] === 'VIEW',
-				);
+				];
 			}
 		}
 		odbc_free_result($res);
@@ -451,7 +479,6 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver, IDibiResultDrive
 	}
 
 
-
 	/**
 	 * Returns metadata for all columns in a table.
 	 * @param  string
@@ -460,17 +487,17 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver, IDibiResultDrive
 	public function getColumns($table)
 	{
 		$res = odbc_columns($this->connection);
-		$columns = array();
+		$columns = [];
 		while ($row = odbc_fetch_array($res)) {
 			if ($row['TABLE_NAME'] === $table) {
-				$columns[] = array(
+				$columns[] = [
 					'name' => $row['COLUMN_NAME'],
 					'table' => $table,
 					'nativetype' => $row['TYPE_NAME'],
 					'size' => $row['COLUMN_SIZE'],
 					'nullable' => (bool) $row['NULLABLE'],
 					'default' => $row['COLUMN_DEF'],
-				);
+				];
 			}
 		}
 		odbc_free_result($res);
@@ -478,7 +505,6 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver, IDibiResultDrive
 	}
 
 
-
 	/**
 	 * Returns metadata for all indexes in a table.
 	 * @param  string
@@ -486,11 +512,10 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver, IDibiResultDrive
 	 */
 	public function getIndexes($table)
 	{
-		throw new DibiNotImplementedException;
+		throw new Dibi\NotImplementedException;
 	}
 
 
-
 	/**
 	 * Returns metadata for all foreign keys in a table.
 	 * @param  string
@@ -498,7 +523,6 @@ class DibiOdbcDriver extends DibiObject implements IDibiDriver, IDibiResultDrive
 	 */
 	public function getForeignKeys($table)
 	{
-		throw new DibiNotImplementedException;
+		throw new Dibi\NotImplementedException;
 	}
-
 }

src/Dibi/Drivers/OracleDriver.php

@@ -0,0 +1,542 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi\Drivers;
+
+use Dibi;
+
+
+/**
+ * The driver for Oracle database.
+ *
+ * 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
+ *   - schema => alters session schema
+ *   - nativeDate => use native date format (defaults to false)
+ *   - resource (resource) => existing connection resource
+ *   - persistent => Creates persistent connections with oci_pconnect instead of oci_new_connect
+ */
+class OracleDriver implements Dibi\Driver, Dibi\ResultDriver, Dibi\Reflector
+{
+	use Dibi\Strict;
+
+	/** @var resource|null */
+	private $connection;
+
+	/** @var resource|null */
+	private $resultSet;
+
+	/** @var bool */
+	private $autoFree = true;
+
+	/** @var bool */
+	private $autocommit = true;
+
+	/** @var string  Date and datetime format */
+	private $fmtDate;
+
+	private $fmtDateTime;
+
+	/** @var int|false Number of affected rows */
+	private $affectedRows = false;
+
+
+	/**
+	 * @throws Dibi\NotSupportedException
+	 */
+	public function __construct()
+	{
+		if (!extension_loaded('oci8')) {
+			throw new Dibi\NotSupportedException("PHP extension 'oci8' is not loaded.");
+		}
+	}
+
+
+	/**
+	 * Connects to a database.
+	 * @return void
+	 * @throws Dibi\Exception
+	 */
+	public function connect(array &$config)
+	{
+		$foo = &$config['charset'];
+
+		if (isset($config['formatDate']) || isset($config['formatDateTime'])) {
+			trigger_error('OracleDriver: options formatDate and formatDateTime are deprecated.', E_USER_DEPRECATED);
+		}
+		if (empty($config['nativeDate'])) {
+			$this->fmtDate = isset($config['formatDate']) ? $config['formatDate'] : 'U';
+			$this->fmtDateTime = isset($config['formatDateTime']) ? $config['formatDateTime'] : 'U';
+		}
+
+		if (isset($config['resource'])) {
+			$this->connection = $config['resource'];
+		} elseif (empty($config['persistent'])) {
+			$this->connection = @oci_new_connect($config['username'], $config['password'], $config['database'], $config['charset']); // intentionally @
+		} else {
+			$this->connection = @oci_pconnect($config['username'], $config['password'], $config['database'], $config['charset']); // intentionally @
+		}
+
+		if (!$this->connection) {
+			$err = oci_error();
+			throw new Dibi\DriverException($err['message'], $err['code']);
+		}
+
+		if (isset($config['schema'])) {
+			$this->query('ALTER SESSION SET CURRENT_SCHEMA=' . $config['schema']);
+		}
+	}
+
+
+	/**
+	 * Disconnects from a database.
+	 * @return void
+	 */
+	public function disconnect()
+	{
+		@oci_close($this->connection); // @ - connection can be already disconnected
+	}
+
+
+	/**
+	 * Executes the SQL query.
+	 * @param  string      SQL statement.
+	 * @return Dibi\ResultDriver|null
+	 * @throws Dibi\DriverException
+	 */
+	public function query($sql)
+	{
+		$this->affectedRows = false;
+		$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 static::createException($err['message'], $err['code'], $sql);
+
+			} elseif (is_resource($res)) {
+				$this->affectedRows = oci_num_rows($res);
+				return oci_num_fields($res) ? $this->createResultDriver($res) : null;
+			}
+		} else {
+			$err = oci_error($this->connection);
+			throw new Dibi\DriverException($err['message'], $err['code'], $sql);
+		}
+		return null;
+	}
+
+
+	/**
+	 * @return Dibi\DriverException
+	 */
+	public static function createException($message, $code, $sql)
+	{
+		if (in_array($code, [1, 2299, 38911], true)) {
+			return new Dibi\UniqueConstraintViolationException($message, $code, $sql);
+
+		} elseif (in_array($code, [1400], true)) {
+			return new Dibi\NotNullConstraintViolationException($message, $code, $sql);
+
+		} elseif (in_array($code, [2266, 2291, 2292], true)) {
+			return new Dibi\ForeignKeyConstraintViolationException($message, $code, $sql);
+
+		} else {
+			return new Dibi\DriverException($message, $code, $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
+	 */
+	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)
+	{
+		$row = $this->query("SELECT $sequence.CURRVAL AS ID FROM DUAL")->fetch(true);
+		return isset($row['ID']) ? Dibi\Helpers::intVal($row['ID']) : false;
+	}
+
+
+	/**
+	 * Begins a transaction (if supported).
+	 * @param  string  optional savepoint name
+	 * @return void
+	 */
+	public function begin($savepoint = null)
+	{
+		$this->autocommit = false;
+	}
+
+
+	/**
+	 * Commits statements in a transaction.
+	 * @param  string  optional savepoint name
+	 * @return void
+	 * @throws Dibi\DriverException
+	 */
+	public function commit($savepoint = null)
+	{
+		if (!oci_commit($this->connection)) {
+			$err = oci_error($this->connection);
+			throw new Dibi\DriverException($err['message'], $err['code']);
+		}
+		$this->autocommit = true;
+	}
+
+
+	/**
+	 * Rollback changes in a transaction.
+	 * @param  string  optional savepoint name
+	 * @return void
+	 * @throws Dibi\DriverException
+	 */
+	public function rollback($savepoint = null)
+	{
+		if (!oci_rollback($this->connection)) {
+			$err = oci_error($this->connection);
+			throw new Dibi\DriverException($err['message'], $err['code']);
+		}
+		$this->autocommit = true;
+	}
+
+
+	/**
+	 * Returns the connection resource.
+	 * @return resource|null
+	 */
+	public function getResource()
+	{
+		return is_resource($this->connection) ? $this->connection : null;
+	}
+
+
+	/**
+	 * Returns the connection reflector.
+	 * @return Dibi\Reflector
+	 */
+	public function getReflector()
+	{
+		return $this;
+	}
+
+
+	/**
+	 * Result set driver factory.
+	 * @param  resource
+	 * @return Dibi\ResultDriver
+	 */
+	public function createResultDriver($resource)
+	{
+		$res = clone $this;
+		$res->resultSet = $resource;
+		return $res;
+	}
+
+
+	/********************* SQL ****************d*g**/
+
+
+	/**
+	 * Encodes data for use in a SQL statement.
+	 * @param  string    value
+	 * @return string    encoded value
+	 */
+	public function escapeText($value)
+	{
+		return "'" . str_replace("'", "''", $value) . "'"; // TODO: not tested
+	}
+
+
+	/**
+	 * @param  string
+	 * @return string
+	 */
+	public function escapeBinary($value)
+	{
+		return "'" . str_replace("'", "''", $value) . "'"; // TODO: not tested
+	}
+
+
+	/**
+	 * @param  string
+	 * @return string
+	 */
+	public function escapeIdentifier($value)
+	{
+		// @see http://download.oracle.com/docs/cd/B10500_01/server.920/a96540/sql_elements9a.htm
+		return '"' . str_replace('"', '""', $value) . '"';
+	}
+
+
+	/**
+	 * @param  bool
+	 * @return string
+	 */
+	public function escapeBool($value)
+	{
+		return $value ? '1' : '0';
+	}
+
+
+	/**
+	 * @param  \DateTime|\DateTimeInterface|string|int
+	 * @return string
+	 */
+	public function escapeDate($value)
+	{
+		if (!$value instanceof \DateTime && !$value instanceof \DateTimeInterface) {
+			$value = new Dibi\DateTime($value);
+		}
+		return $this->fmtDate
+			? $value->format($this->fmtDate)
+			: "to_date('" . $value->format('Y-m-d') . "', 'YYYY-mm-dd')";
+	}
+
+
+	/**
+	 * @param  \DateTime|\DateTimeInterface|string|int
+	 * @return string
+	 */
+	public function escapeDateTime($value)
+	{
+		if (!$value instanceof \DateTime && !$value instanceof \DateTimeInterface) {
+			$value = new Dibi\DateTime($value);
+		}
+		return $this->fmtDateTime
+			? $value->format($this->fmtDateTime)
+			: "to_date('" . $value->format('Y-m-d G:i:s') . "', 'YYYY-mm-dd hh24:mi:ss')";
+	}
+
+
+	/**
+	 * 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
+	 * @return string
+	 */
+	public function unescapeBinary($value)
+	{
+		return $value;
+	}
+
+
+	/** @deprecated */
+	public function escape($value, $type)
+	{
+		trigger_error(__METHOD__ . '() is deprecated.', E_USER_DEPRECATED);
+		return Dibi\Helpers::escape($this, $value, $type);
+	}
+
+
+	/**
+	 * Injects LIMIT/OFFSET to the SQL query.
+	 * @param  string
+	 * @param  int|null
+	 * @param  int|null
+	 * @return void
+	 */
+	public function applyLimit(&$sql, $limit, $offset)
+	{
+		if ($limit < 0 || $offset < 0) {
+			throw new Dibi\NotSupportedException('Negative offset or limit.');
+
+		} elseif ($offset) {
+			// see http://www.oracle.com/technology/oramag/oracle/06-sep/o56asktom.html
+			$sql = 'SELECT * FROM (SELECT t.*, ROWNUM AS "__rnum" FROM (' . $sql . ') t '
+				. ($limit !== null ? 'WHERE ROWNUM <= ' . ((int) $offset + (int) $limit) : '')
+				. ') WHERE "__rnum" > ' . $offset;
+
+		} elseif ($limit !== null) {
+			$sql = 'SELECT * FROM (' . $sql . ') WHERE ROWNUM <= ' . Dibi\Helpers::intVal($limit);
+		}
+	}
+
+
+	/********************* result set ****************d*g**/
+
+
+	/**
+	 * Automatically frees the resources allocated for this result set.
+	 * @return void
+	 */
+	public function __destruct()
+	{
+		if ($this->autoFree && $this->getResultResource()) {
+			$this->free();
+		}
+	}
+
+
+	/**
+	 * Returns the number of rows in a result set.
+	 * @return int
+	 */
+	public function getRowCount()
+	{
+		throw new Dibi\NotSupportedException('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 oci_fetch_array($this->resultSet, ($assoc ? OCI_ASSOC : OCI_NUM) | OCI_RETURN_NULLS);
+	}
+
+
+	/**
+	 * Moves cursor position without fetching row.
+	 * @param  int   the 0-based cursor pos to seek to
+	 * @return bool  true on success, false if unable to seek to specified record
+	 */
+	public function seek($row)
+	{
+		throw new Dibi\NotImplementedException;
+	}
+
+
+	/**
+	 * Frees the resources allocated for this result set.
+	 * @return void
+	 */
+	public function free()
+	{
+		oci_free_statement($this->resultSet);
+		$this->resultSet = null;
+	}
+
+
+	/**
+	 * Returns metadata for all columns in a result set.
+	 * @return array
+	 */
+	public function getResultColumns()
+	{
+		$count = oci_num_fields($this->resultSet);
+		$columns = [];
+		for ($i = 1; $i <= $count; $i++) {
+			$type = oci_field_type($this->resultSet, $i);
+			$columns[] = [
+				'name' => oci_field_name($this->resultSet, $i),
+				'table' => null,
+				'fullname' => oci_field_name($this->resultSet, $i),
+				'nativetype' => $type === 'NUMBER' && oci_field_scale($this->resultSet, $i) === 0 ? 'INTEGER' : $type,
+			];
+		}
+		return $columns;
+	}
+
+
+	/**
+	 * Returns the result set resource.
+	 * @return resource|null
+	 */
+	public function getResultResource()
+	{
+		$this->autoFree = false;
+		return is_resource($this->resultSet) ? $this->resultSet : null;
+	}
+
+
+	/********************* Dibi\Reflector ****************d*g**/
+
+
+	/**
+	 * Returns list of tables.
+	 * @return array
+	 */
+	public function getTables()
+	{
+		$res = $this->query('SELECT * FROM cat');
+		$tables = [];
+		while ($row = $res->fetch(false)) {
+			if ($row[1] === 'TABLE' || $row[1] === 'VIEW') {
+				$tables[] = [
+					'name' => $row[0],
+					'view' => $row[1] === 'VIEW',
+				];
+			}
+		}
+		return $tables;
+	}
+
+
+	/**
+	 * Returns metadata for all columns in a table.
+	 * @param  string
+	 * @return array
+	 */
+	public function getColumns($table)
+	{
+		$res = $this->query('SELECT * FROM "ALL_TAB_COLUMNS" WHERE "TABLE_NAME" = ' . $this->escapeText($table));
+		$columns = [];
+		while ($row = $res->fetch(true)) {
+			$columns[] = [
+				'table' => $row['TABLE_NAME'],
+				'name' => $row['COLUMN_NAME'],
+				'nativetype' => $row['DATA_TYPE'],
+				'size' => isset($row['DATA_LENGTH']) ? $row['DATA_LENGTH'] : null,
+				'nullable' => $row['NULLABLE'] === 'Y',
+				'default' => $row['DATA_DEFAULT'],
+				'vendor' => $row,
+			];
+		}
+		return $columns;
+	}
+
+
+	/**
+	 * Returns metadata for all indexes in a table.
+	 * @param  string
+	 * @return array
+	 */
+	public function getIndexes($table)
+	{
+		throw new Dibi\NotImplementedException;
+	}
+
+
+	/**
+	 * Returns metadata for all foreign keys in a table.
+	 * @param  string
+	 * @return array
+	 */
+	public function getForeignKeys($table)
+	{
+		throw new Dibi\NotImplementedException;
+	}
+}

src/Dibi/Drivers/PdoDriver.php

@@ -0,0 +1,580 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi\Drivers;
+
+use Dibi;
+use PDO;
+
+
+/**
+ * The driver for PDO.
+ *
+ * Driver options:
+ *   - dsn => driver specific DSN
+ *   - username (or user)
+ *   - password (or pass)
+ *   - options (array) => driver specific options {@see PDO::__construct}
+ *   - resource (PDO) => existing connection
+ *   - version
+ */
+class PdoDriver implements Dibi\Driver, Dibi\ResultDriver
+{
+	use Dibi\Strict;
+
+	/** @var PDO|null  Connection resource */
+	private $connection;
+
+	/** @var \PDOStatement|null  Resultset resource */
+	private $resultSet;
+
+	/** @var int|false  Affected rows */
+	private $affectedRows = false;
+
+	/** @var string */
+	private $driverName;
+
+	/** @var string */
+	private $serverVersion = '';
+
+
+	/**
+	 * @throws Dibi\NotSupportedException
+	 */
+	public function __construct()
+	{
+		if (!extension_loaded('pdo')) {
+			throw new Dibi\NotSupportedException("PHP extension 'pdo' is not loaded.");
+		}
+	}
+
+
+	/**
+	 * Connects to a database.
+	 * @return void
+	 * @throws Dibi\Exception
+	 */
+	public function connect(array &$config)
+	{
+		$foo = &$config['dsn'];
+		$foo = &$config['options'];
+		Dibi\Helpers::alias($config, 'resource', 'pdo');
+
+		if ($config['resource'] instanceof PDO) {
+			$this->connection = $config['resource'];
+			unset($config['resource'], $config['pdo']);
+		} else {
+			try {
+				$this->connection = new PDO($config['dsn'], $config['username'], $config['password'], $config['options']);
+			} catch (\PDOException $e) {
+				if ($e->getMessage() === 'could not find driver') {
+					throw new Dibi\NotSupportedException('PHP extension for PDO is not loaded.');
+				}
+				throw new Dibi\DriverException($e->getMessage(), $e->getCode());
+			}
+		}
+
+		if ($this->connection->getAttribute(PDO::ATTR_ERRMODE) !== PDO::ERRMODE_SILENT) {
+			throw new Dibi\DriverException('PDO connection in exception or warning error mode is not supported.');
+		}
+
+		$this->driverName = $this->connection->getAttribute(PDO::ATTR_DRIVER_NAME);
+		$this->serverVersion = isset($config['version'])
+			? $config['version']
+			: @$this->connection->getAttribute(PDO::ATTR_SERVER_VERSION); // @ - may be not supported
+	}
+
+
+	/**
+	 * Disconnects from a database.
+	 * @return void
+	 */
+	public function disconnect()
+	{
+		$this->connection = null;
+	}
+
+
+	/**
+	 * Executes the SQL query.
+	 * @param  string      SQL statement.
+	 * @return Dibi\ResultDriver|null
+	 * @throws Dibi\DriverException
+	 */
+	public function query($sql)
+	{
+		$res = $this->connection->query($sql);
+		if ($res) {
+			$this->affectedRows = $res->rowCount();
+			return $res->columnCount() ? $this->createResultDriver($res) : null;
+		}
+
+		$this->affectedRows = false;
+
+		list($sqlState, $code, $message) = $this->connection->errorInfo();
+		$message = "SQLSTATE[$sqlState]: $message";
+		switch ($this->driverName) {
+			case 'mysql':
+				throw MySqliDriver::createException($message, $code, $sql);
+
+			case 'oci':
+				throw OracleDriver::createException($message, $code, $sql);
+
+			case 'pgsql':
+				throw PostgreDriver::createException($message, $sqlState, $sql);
+
+			case 'sqlite':
+				throw Sqlite3Driver::createException($message, $code, $sql);
+
+			default:
+				throw new Dibi\DriverException($message, $code, $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
+	 */
+	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)
+	{
+		return $this->connection->lastInsertId($sequence);
+	}
+
+
+	/**
+	 * Begins a transaction (if supported).
+	 * @param  string  optional savepoint name
+	 * @return void
+	 * @throws Dibi\DriverException
+	 */
+	public function begin($savepoint = null)
+	{
+		if (!$this->connection->beginTransaction()) {
+			$err = $this->connection->errorInfo();
+			throw new Dibi\DriverException("SQLSTATE[$err[0]]: $err[2]", $err[1]);
+		}
+	}
+
+
+	/**
+	 * Commits statements in a transaction.
+	 * @param  string  optional savepoint name
+	 * @return void
+	 * @throws Dibi\DriverException
+	 */
+	public function commit($savepoint = null)
+	{
+		if (!$this->connection->commit()) {
+			$err = $this->connection->errorInfo();
+			throw new Dibi\DriverException("SQLSTATE[$err[0]]: $err[2]", $err[1]);
+		}
+	}
+
+
+	/**
+	 * Rollback changes in a transaction.
+	 * @param  string  optional savepoint name
+	 * @return void
+	 * @throws Dibi\DriverException
+	 */
+	public function rollback($savepoint = null)
+	{
+		if (!$this->connection->rollBack()) {
+			$err = $this->connection->errorInfo();
+			throw new Dibi\DriverException("SQLSTATE[$err[0]]: $err[2]", $err[1]);
+		}
+	}
+
+
+	/**
+	 * Returns the connection resource.
+	 * @return PDO|null
+	 */
+	public function getResource()
+	{
+		return $this->connection;
+	}
+
+
+	/**
+	 * Returns the connection reflector.
+	 * @return Dibi\Reflector
+	 */
+	public function getReflector()
+	{
+		switch ($this->driverName) {
+			case 'mysql':
+				return new MySqlReflector($this);
+
+			case 'sqlite':
+				return new SqliteReflector($this);
+
+			default:
+				throw new Dibi\NotSupportedException;
+		}
+	}
+
+
+	/**
+	 * Result set driver factory.
+	 * @param  \PDOStatement
+	 * @return Dibi\ResultDriver
+	 */
+	public function createResultDriver(\PDOStatement $resource)
+	{
+		$res = clone $this;
+		$res->resultSet = $resource;
+		return $res;
+	}
+
+
+	/********************* SQL ****************d*g**/
+
+
+	/**
+	 * Encodes data for use in a SQL statement.
+	 * @param  string    value
+	 * @return string    encoded value
+	 */
+	public function escapeText($value)
+	{
+		if ($this->driverName === 'odbc') {
+			return "'" . str_replace("'", "''", $value) . "'";
+		} else {
+			return $this->connection->quote($value, PDO::PARAM_STR);
+		}
+	}
+
+
+	/**
+	 * @param  string
+	 * @return string
+	 */
+	public function escapeBinary($value)
+	{
+		if ($this->driverName === 'odbc') {
+			return "'" . str_replace("'", "''", $value) . "'";
+		} else {
+			return $this->connection->quote($value, PDO::PARAM_LOB);
+		}
+	}
+
+
+	/**
+	 * @param  string
+	 * @return string
+	 */
+	public function escapeIdentifier($value)
+	{
+		switch ($this->driverName) {
+			case 'mysql':
+				return '`' . str_replace('`', '``', $value) . '`';
+
+			case 'oci':
+			case 'pgsql':
+				return '"' . str_replace('"', '""', $value) . '"';
+
+			case 'sqlite':
+				return '[' . strtr($value, '[]', '  ') . ']';
+
+			case 'odbc':
+			case 'mssql':
+				return '[' . str_replace(['[', ']'], ['[[', ']]'], $value) . ']';
+
+			case 'dblib':
+			case 'sqlsrv':
+				return '[' . str_replace(']', ']]', $value) . ']';
+
+			default:
+				return $value;
+		}
+	}
+
+
+	/**
+	 * @param  bool
+	 * @return string
+	 */
+	public function escapeBool($value)
+	{
+		if ($this->driverName === 'pgsql') {
+			return $value ? 'TRUE' : 'FALSE';
+		} else {
+			return $value ? '1' : '0';
+		}
+	}
+
+
+	/**
+	 * @param  \DateTime|\DateTimeInterface|string|int
+	 * @return string
+	 */
+	public function escapeDate($value)
+	{
+		if (!$value instanceof \DateTime && !$value instanceof \DateTimeInterface) {
+			$value = new Dibi\DateTime($value);
+		}
+		return $value->format($this->driverName === 'odbc' ? '#m/d/Y#' : "'Y-m-d'");
+	}
+
+
+	/**
+	 * @param  \DateTime|\DateTimeInterface|string|int
+	 * @return string
+	 */
+	public function escapeDateTime($value)
+	{
+		if (!$value instanceof \DateTime && !$value instanceof \DateTimeInterface) {
+			$value = new Dibi\DateTime($value);
+		}
+		switch ($this->driverName) {
+			case 'odbc':
+				return $value->format('#m/d/Y H:i:s.u#');
+			case 'mssql':
+			case 'sqlsrv':
+				return 'CONVERT(DATETIME2(7), ' . $value->format("'Y-m-d H:i:s.u'") . ')';
+			default:
+				return $value->format("'Y-m-d H:i:s.u'");
+		}
+	}
+
+
+	/**
+	 * Encodes string for use in a LIKE statement.
+	 * @param  string
+	 * @param  int
+	 * @return string
+	 */
+	public function escapeLike($value, $pos)
+	{
+		switch ($this->driverName) {
+			case 'mysql':
+				$value = addcslashes(str_replace('\\', '\\\\', $value), "\x00\n\r\\'%_");
+				return ($pos <= 0 ? "'%" : "'") . $value . ($pos >= 0 ? "%'" : "'");
+
+			case 'oci':
+				$value = addcslashes(str_replace('\\', '\\\\', $value), "\x00\\%_");
+				$value = str_replace("'", "''", $value);
+				return ($pos <= 0 ? "'%" : "'") . $value . ($pos >= 0 ? "%'" : "'");
+
+			case 'pgsql':
+				$bs = substr($this->connection->quote('\\', PDO::PARAM_STR), 1, -1); // standard_conforming_strings = on/off
+				$value = substr($this->connection->quote($value, PDO::PARAM_STR), 1, -1);
+				$value = strtr($value, ['%' => $bs . '%', '_' => $bs . '_', '\\' => '\\\\']);
+				return ($pos <= 0 ? "'%" : "'") . $value . ($pos >= 0 ? "%'" : "'");
+
+			case 'sqlite':
+				$value = addcslashes(substr($this->connection->quote($value, PDO::PARAM_STR), 1, -1), '%_\\');
+				return ($pos <= 0 ? "'%" : "'") . $value . ($pos >= 0 ? "%'" : "'") . " ESCAPE '\\'";
+
+			case 'odbc':
+			case 'mssql':
+			case 'dblib':
+			case 'sqlsrv':
+				$value = strtr($value, ["'" => "''", '%' => '[%]', '_' => '[_]', '[' => '[[]']);
+				return ($pos <= 0 ? "'%" : "'") . $value . ($pos >= 0 ? "%'" : "'");
+
+			default:
+				throw new Dibi\NotImplementedException;
+		}
+	}
+
+
+	/**
+	 * Decodes data from result set.
+	 * @param  string
+	 * @return string
+	 */
+	public function unescapeBinary($value)
+	{
+		return $value;
+	}
+
+
+	/** @deprecated */
+	public function escape($value, $type)
+	{
+		trigger_error(__METHOD__ . '() is deprecated.', E_USER_DEPRECATED);
+		return Dibi\Helpers::escape($this, $value, $type);
+	}
+
+
+	/**
+	 * Injects LIMIT/OFFSET to the SQL query.
+	 * @param  string
+	 * @param  int|null
+	 * @param  int|null
+	 * @return void
+	 */
+	public function applyLimit(&$sql, $limit, $offset)
+	{
+		if ($limit < 0 || $offset < 0) {
+			throw new Dibi\NotSupportedException('Negative offset or limit.');
+		}
+
+		switch ($this->driverName) {
+			case 'mysql':
+				if ($limit !== null || $offset) {
+					// see http://dev.mysql.com/doc/refman/5.0/en/select.html
+					$sql .= ' LIMIT ' . ($limit === null ? '18446744073709551615' : Dibi\Helpers::intVal($limit))
+						. ($offset ? ' OFFSET ' . Dibi\Helpers::intVal($offset) : '');
+				}
+				break;
+
+			case 'pgsql':
+				if ($limit !== null) {
+					$sql .= ' LIMIT ' . Dibi\Helpers::intVal($limit);
+				}
+				if ($offset) {
+					$sql .= ' OFFSET ' . Dibi\Helpers::intVal($offset);
+				}
+				break;
+
+			case 'sqlite':
+				if ($limit !== null || $offset) {
+					$sql .= ' LIMIT ' . ($limit === null ? '-1' : Dibi\Helpers::intVal($limit))
+						. ($offset ? ' OFFSET ' . Dibi\Helpers::intVal($offset) : '');
+				}
+				break;
+
+			case 'oci':
+				if ($offset) {
+					// see http://www.oracle.com/technology/oramag/oracle/06-sep/o56asktom.html
+					$sql = 'SELECT * FROM (SELECT t.*, ROWNUM AS "__rnum" FROM (' . $sql . ') t '
+						. ($limit !== null ? 'WHERE ROWNUM <= ' . ((int) $offset + (int) $limit) : '')
+						. ') WHERE "__rnum" > ' . $offset;
+
+				} elseif ($limit !== null) {
+					$sql = 'SELECT * FROM (' . $sql . ') WHERE ROWNUM <= ' . Dibi\Helpers::intVal($limit);
+				}
+				break;
+
+			case 'mssql':
+			case 'sqlsrv':
+			case 'dblib':
+				if (version_compare($this->serverVersion, '11.0') >= 0) { // 11 == SQL Server 2012
+					// requires ORDER BY, see https://technet.microsoft.com/en-us/library/gg699618(v=sql.110).aspx
+					if ($limit !== null) {
+						$sql = sprintf('%s OFFSET %d ROWS FETCH NEXT %d ROWS ONLY', rtrim($sql), $offset, $limit);
+					} elseif ($offset) {
+						$sql = sprintf('%s OFFSET %d ROWS', rtrim($sql), $offset);
+					}
+					break;
+				}
+				// break omitted
+			case 'odbc':
+				if ($offset) {
+					throw new Dibi\NotSupportedException('Offset is not supported by this database.');
+
+				} elseif ($limit !== null) {
+					$sql = 'SELECT TOP ' . Dibi\Helpers::intVal($limit) . ' * FROM (' . $sql . ') t';
+					break;
+				}
+				// break omitted
+			default:
+				throw new Dibi\NotSupportedException('PDO or driver does not support applying limit or offset.');
+		}
+	}
+
+
+	/********************* result set ****************d*g**/
+
+
+	/**
+	 * Returns the number of rows in a result set.
+	 * @return int
+	 */
+	public function getRowCount()
+	{
+		return $this->resultSet->rowCount();
+	}
+
+
+	/**
+	 * 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 $this->resultSet->fetch($assoc ? PDO::FETCH_ASSOC : PDO::FETCH_NUM);
+	}
+
+
+	/**
+	 * Moves cursor position without fetching row.
+	 * @param  int   the 0-based cursor pos to seek to
+	 * @return bool  true on success, false if unable to seek to specified record
+	 */
+	public function seek($row)
+	{
+		throw new Dibi\NotSupportedException('Cannot seek an unbuffered result set.');
+	}
+
+
+	/**
+	 * Frees the resources allocated for this result set.
+	 * @return void
+	 */
+	public function free()
+	{
+		$this->resultSet = null;
+	}
+
+
+	/**
+	 * Returns metadata for all columns in a result set.
+	 * @return array
+	 * @throws Dibi\Exception
+	 */
+	public function getResultColumns()
+	{
+		$count = $this->resultSet->columnCount();
+		$columns = [];
+		for ($i = 0; $i < $count; $i++) {
+			$row = @$this->resultSet->getColumnMeta($i); // intentionally @
+			if ($row === false) {
+				throw new Dibi\NotSupportedException('Driver does not support meta data.');
+			}
+			$row = $row + [
+				'table' => null,
+				'native_type' => 'VAR_STRING',
+			];
+
+			$columns[] = [
+				'name' => $row['name'],
+				'table' => $row['table'],
+				'nativetype' => $row['native_type'],
+				'type' => $row['native_type'] === 'TIME' && $this->driverName === 'mysql' ? Dibi\Type::TIME_INTERVAL : null,
+				'fullname' => $row['table'] ? $row['table'] . '.' . $row['name'] : $row['name'],
+				'vendor' => $row,
+			];
+		}
+		return $columns;
+	}
+
+
+	/**
+	 * Returns the result set resource.
+	 * @return \PDOStatement|null
+	 */
+	public function getResultResource()
+	{
+		return $this->resultSet;
+	}
+}

src/Dibi/Drivers/PostgreDriver.php

@@ -0,0 +1,744 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi\Drivers;
+
+use Dibi;
+
+
+/**
+ * The driver for PostgreSQL database.
+ *
+ * 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
+ */
+class PostgreDriver implements Dibi\Driver, Dibi\ResultDriver, Dibi\Reflector
+{
+	use Dibi\Strict;
+
+	/** @var resource|null */
+	private $connection;
+
+	/** @var resource|null */
+	private $resultSet;
+
+	/** @var bool */
+	private $autoFree = true;
+
+	/** @var int|false  Affected rows */
+	private $affectedRows = false;
+
+
+	/**
+	 * @throws Dibi\NotSupportedException
+	 */
+	public function __construct()
+	{
+		if (!extension_loaded('pgsql')) {
+			throw new Dibi\NotSupportedException("PHP extension 'pgsql' is not loaded.");
+		}
+	}
+
+
+	/**
+	 * Connects to a database.
+	 * @return void
+	 * @throws Dibi\Exception
+	 */
+	public function connect(array &$config)
+	{
+		$error = null;
+		if (isset($config['resource'])) {
+			$this->connection = $config['resource'];
+
+		} else {
+			$config += [
+				'charset' => 'utf8',
+			];
+			if (isset($config['string'])) {
+				$string = $config['string'];
+			} else {
+				$string = '';
+				Dibi\Helpers::alias($config, 'user', 'username');
+				Dibi\Helpers::alias($config, 'dbname', 'database');
+				foreach (['host', 'hostaddr', 'port', 'dbname', 'user', 'password', 'connect_timeout', 'options', 'sslmode', 'service'] as $key) {
+					if (isset($config[$key])) {
+						$string .= $key . '=' . $config[$key] . ' ';
+					}
+				}
+			}
+
+			set_error_handler(function ($severity, $message) use (&$error) {
+				$error = $message;
+			});
+			if (empty($config['persistent'])) {
+				$this->connection = pg_connect($string, PGSQL_CONNECT_FORCE_NEW);
+			} else {
+				$this->connection = pg_pconnect($string, PGSQL_CONNECT_FORCE_NEW);
+			}
+			restore_error_handler();
+		}
+
+		if (!is_resource($this->connection)) {
+			throw new Dibi\DriverException($error ?: 'Connecting error.');
+		}
+
+		pg_set_error_verbosity($this->connection, PGSQL_ERRORS_VERBOSE);
+
+		if (isset($config['charset']) && pg_set_client_encoding($this->connection, $config['charset'])) {
+			throw static::createException(pg_last_error($this->connection));
+		}
+
+		if (isset($config['schema'])) {
+			$this->query('SET search_path TO "' . implode('", "', (array) $config['schema']) . '"');
+		}
+	}
+
+
+	/**
+	 * Disconnects from a database.
+	 * @return void
+	 */
+	public function disconnect()
+	{
+		@pg_close($this->connection); // @ - connection can be already disconnected
+	}
+
+
+	/**
+	 * Pings database.
+	 * @return bool
+	 */
+	public function ping()
+	{
+		return pg_ping($this->connection);
+	}
+
+
+	/**
+	 * Executes the SQL query.
+	 * @param  string      SQL statement.
+	 * @return Dibi\ResultDriver|null
+	 * @throws Dibi\DriverException
+	 */
+	public function query($sql)
+	{
+		$this->affectedRows = false;
+		$res = @pg_query($this->connection, $sql); // intentionally @
+
+		if ($res === false) {
+			throw static::createException(pg_last_error($this->connection), null, $sql);
+
+		} elseif (is_resource($res)) {
+			$this->affectedRows = pg_affected_rows($res);
+			if (pg_num_fields($res)) {
+				return $this->createResultDriver($res);
+			}
+		}
+		return null;
+	}
+
+
+	/**
+	 * @return Dibi\DriverException
+	 */
+	public static function createException($message, $code = null, $sql = null)
+	{
+		if ($code === null && preg_match('#^ERROR:\s+(\S+):\s*#', $message, $m)) {
+			$code = $m[1];
+			$message = substr($message, strlen($m[0]));
+		}
+
+		if ($code === '0A000' && strpos($message, 'truncate') !== false) {
+			return new Dibi\ForeignKeyConstraintViolationException($message, $code, $sql);
+
+		} elseif ($code === '23502') {
+			return new Dibi\NotNullConstraintViolationException($message, $code, $sql);
+
+		} elseif ($code === '23503') {
+			return new Dibi\ForeignKeyConstraintViolationException($message, $code, $sql);
+
+		} elseif ($code === '23505') {
+			return new Dibi\UniqueConstraintViolationException($message, $code, $sql);
+
+		} else {
+			return new Dibi\DriverException($message, $code, $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
+	 */
+	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)
+	{
+		if ($sequence === null) {
+			// PostgreSQL 8.1 is needed
+			$res = $this->query('SELECT LASTVAL()');
+		} else {
+			$res = $this->query("SELECT CURRVAL('$sequence')");
+		}
+
+		if (!$res) {
+			return false;
+		}
+
+		$row = $res->fetch(false);
+		return is_array($row) ? $row[0] : false;
+	}
+
+
+	/**
+	 * Begins a transaction (if supported).
+	 * @param  string  optional savepoint name
+	 * @return void
+	 * @throws Dibi\DriverException
+	 */
+	public function begin($savepoint = null)
+	{
+		$this->query($savepoint ? "SAVEPOINT $savepoint" : 'START TRANSACTION');
+	}
+
+
+	/**
+	 * Commits statements in a transaction.
+	 * @param  string  optional savepoint name
+	 * @return void
+	 * @throws Dibi\DriverException
+	 */
+	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 Dibi\DriverException
+	 */
+	public function rollback($savepoint = null)
+	{
+		$this->query($savepoint ? "ROLLBACK TO SAVEPOINT $savepoint" : 'ROLLBACK');
+	}
+
+
+	/**
+	 * Is in transaction?
+	 * @return bool
+	 */
+	public function inTransaction()
+	{
+		return !in_array(pg_transaction_status($this->connection), [PGSQL_TRANSACTION_UNKNOWN, PGSQL_TRANSACTION_IDLE], true);
+	}
+
+
+	/**
+	 * Returns the connection resource.
+	 * @return resource|null
+	 */
+	public function getResource()
+	{
+		return is_resource($this->connection) ? $this->connection : null;
+	}
+
+
+	/**
+	 * Returns the connection reflector.
+	 * @return Dibi\Reflector
+	 */
+	public function getReflector()
+	{
+		return $this;
+	}
+
+
+	/**
+	 * Result set driver factory.
+	 * @param  resource
+	 * @return Dibi\ResultDriver
+	 */
+	public function createResultDriver($resource)
+	{
+		$res = clone $this;
+		$res->resultSet = $resource;
+		return $res;
+	}
+
+
+	/********************* SQL ****************d*g**/
+
+
+	/**
+	 * Encodes data for use in a SQL statement.
+	 * @param  string    value
+	 * @return string    encoded value
+	 */
+	public function escapeText($value)
+	{
+		if (!is_resource($this->connection)) {
+			throw new Dibi\Exception('Lost connection to server.');
+		}
+		return "'" . pg_escape_string($this->connection, $value) . "'";
+	}
+
+
+	/**
+	 * @param  string
+	 * @return string
+	 */
+	public function escapeBinary($value)
+	{
+		if (!is_resource($this->connection)) {
+			throw new Dibi\Exception('Lost connection to server.');
+		}
+		return "'" . pg_escape_bytea($this->connection, $value) . "'";
+	}
+
+
+	/**
+	 * @param  string
+	 * @return string
+	 */
+	public function escapeIdentifier($value)
+	{
+		// @see http://www.postgresql.org/docs/8.2/static/sql-syntax-lexical.html#SQL-SYNTAX-IDENTIFIERS
+		return '"' . str_replace('"', '""', $value) . '"';
+	}
+
+
+	/**
+	 * @param  bool
+	 * @return string
+	 */
+	public function escapeBool($value)
+	{
+		return $value ? 'TRUE' : 'FALSE';
+	}
+
+
+	/**
+	 * @param  \DateTime|\DateTimeInterface|string|int
+	 * @return string
+	 */
+	public function escapeDate($value)
+	{
+		if (!$value instanceof \DateTime && !$value instanceof \DateTimeInterface) {
+			$value = new Dibi\DateTime($value);
+		}
+		return $value->format("'Y-m-d'");
+	}
+
+
+	/**
+	 * @param  \DateTime|\DateTimeInterface|string|int
+	 * @return string
+	 */
+	public function escapeDateTime($value)
+	{
+		if (!$value instanceof \DateTime && !$value instanceof \DateTimeInterface) {
+			$value = new Dibi\DateTime($value);
+		}
+		return $value->format("'Y-m-d H:i:s.u'");
+	}
+
+
+	/**
+	 * Encodes string for use in a LIKE statement.
+	 * @param  string
+	 * @param  int
+	 * @return string
+	 */
+	public function escapeLike($value, $pos)
+	{
+		$bs = pg_escape_string($this->connection, '\\'); // standard_conforming_strings = on/off
+		$value = pg_escape_string($this->connection, $value);
+		$value = strtr($value, ['%' => $bs . '%', '_' => $bs . '_', '\\' => '\\\\']);
+		return ($pos <= 0 ? "'%" : "'") . $value . ($pos >= 0 ? "%'" : "'");
+	}
+
+
+	/**
+	 * Decodes data from result set.
+	 * @param  string
+	 * @return string
+	 */
+	public function unescapeBinary($value)
+	{
+		return pg_unescape_bytea($value);
+	}
+
+
+	/** @deprecated */
+	public function escape($value, $type)
+	{
+		trigger_error(__METHOD__ . '() is deprecated.', E_USER_DEPRECATED);
+		return Dibi\Helpers::escape($this, $value, $type);
+	}
+
+
+	/**
+	 * Injects LIMIT/OFFSET to the SQL query.
+	 * @param  string
+	 * @param  int|null
+	 * @param  int|null
+	 * @return void
+	 */
+	public function applyLimit(&$sql, $limit, $offset)
+	{
+		if ($limit < 0 || $offset < 0) {
+			throw new Dibi\NotSupportedException('Negative offset or limit.');
+		}
+		if ($limit !== null) {
+			$sql .= ' LIMIT ' . Dibi\Helpers::intVal($limit);
+		}
+		if ($offset) {
+			$sql .= ' OFFSET ' . Dibi\Helpers::intVal($offset);
+		}
+	}
+
+
+	/********************* result set ****************d*g**/
+
+
+	/**
+	 * Automatically frees the resources allocated for this result set.
+	 * @return void
+	 */
+	public function __destruct()
+	{
+		if ($this->autoFree && $this->getResultResource()) {
+			$this->free();
+		}
+	}
+
+
+	/**
+	 * Returns the number of rows in a result set.
+	 * @return int
+	 */
+	public function getRowCount()
+	{
+		return pg_num_rows($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)
+	{
+		return pg_fetch_array($this->resultSet, null, $assoc ? PGSQL_ASSOC : PGSQL_NUM);
+	}
+
+
+	/**
+	 * Moves cursor position without fetching row.
+	 * @param  int   the 0-based cursor pos to seek to
+	 * @return bool  true on success, false if unable to seek to specified record
+	 */
+	public function seek($row)
+	{
+		return pg_result_seek($this->resultSet, $row);
+	}
+
+
+	/**
+	 * Frees the resources allocated for this result set.
+	 * @return void
+	 */
+	public function free()
+	{
+		pg_free_result($this->resultSet);
+		$this->resultSet = null;
+	}
+
+
+	/**
+	 * Returns metadata for all columns in a result set.
+	 * @return array
+	 */
+	public function getResultColumns()
+	{
+		$count = pg_num_fields($this->resultSet);
+		$columns = [];
+		for ($i = 0; $i < $count; $i++) {
+			$row = [
+				'name' => pg_field_name($this->resultSet, $i),
+				'table' => pg_field_table($this->resultSet, $i),
+				'nativetype' => pg_field_type($this->resultSet, $i),
+			];
+			$row['fullname'] = $row['table'] ? $row['table'] . '.' . $row['name'] : $row['name'];
+			$columns[] = $row;
+		}
+		return $columns;
+	}
+
+
+	/**
+	 * Returns the result set resource.
+	 * @return resource|null
+	 */
+	public function getResultResource()
+	{
+		$this->autoFree = false;
+		return is_resource($this->resultSet) ? $this->resultSet : null;
+	}
+
+
+	/********************* Dibi\Reflector ****************d*g**/
+
+
+	/**
+	 * Returns list of tables.
+	 * @return array
+	 */
+	public function getTables()
+	{
+		$version = pg_parameter_status($this->getResource(), 'server_version');
+		if ($version < 7.4) {
+			throw new Dibi\DriverException('Reflection requires PostgreSQL 7.4 and newer.');
+		}
+
+		$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 = ANY (current_schemas(false))";
+
+		if ($version >= 9.3) {
+			$query .= '
+				UNION ALL
+				SELECT
+					matviewname, 1
+				FROM
+					pg_matviews
+				WHERE
+					schemaname = ANY (current_schemas(false))';
+		}
+
+		$res = $this->query($query);
+		$tables = pg_fetch_all($res->resultSet);
+		return $tables ?: [];
+	}
+
+
+	/**
+	 * Returns metadata for all columns in a table.
+	 * @param  string
+	 * @return array
+	 */
+	public function getColumns($table)
+	{
+		$_table = $this->escapeText($this->escapeIdentifier($table));
+		$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.oid = $_table::regclass
+		");
+		$primary = (int) pg_fetch_object($res->resultSet)->indkey;
+
+		$res = $this->query("
+			SELECT *
+			FROM information_schema.columns c
+			JOIN pg_class ON pg_class.relname = c.table_name
+			JOIN pg_namespace nsp ON nsp.oid = pg_class.relnamespace AND nsp.nspname = c.table_schema
+			WHERE pg_class.oid = $_table::regclass
+			ORDER BY c.ordinal_position
+		");
+
+		if (!$res->getRowCount()) {
+			$res = $this->query("
+				SELECT
+					a.attname AS column_name,
+					pg_type.typname AS udt_name,
+					a.attlen AS numeric_precision,
+					a.atttypmod-4 AS character_maximum_length,
+					NOT a.attnotnull AS is_nullable,
+					a.attnum AS ordinal_position,
+					adef.adsrc AS column_default
+				FROM
+					pg_attribute a
+					JOIN pg_type ON a.atttypid = pg_type.oid
+					JOIN pg_class cls ON a.attrelid = cls.oid
+					LEFT JOIN pg_attrdef adef ON adef.adnum = a.attnum AND adef.adrelid = a.attrelid
+				WHERE
+					cls.relkind IN ('r', 'v', 'mv')
+					AND a.attrelid = $_table::regclass
+					AND a.attnum > 0
+					AND NOT a.attisdropped
+				ORDER BY ordinal_position
+			");
+		}
+
+		$columns = [];
+		while ($row = $res->fetch(true)) {
+			$size = (int) max($row['character_maximum_length'], $row['numeric_precision']);
+			$columns[] = [
+				'name' => $row['column_name'],
+				'table' => $table,
+				'nativetype' => strtoupper($row['udt_name']),
+				'size' => $size > 0 ? $size : null,
+				'nullable' => $row['is_nullable'] === 'YES' || $row['is_nullable'] === 't',
+				'default' => $row['column_default'],
+				'autoincrement' => (int) $row['ordinal_position'] === $primary && substr($row['column_default'], 0, 7) === 'nextval',
+				'vendor' => $row,
+			];
+		}
+		return $columns;
+	}
+
+
+	/**
+	 * Returns metadata for all indexes in a table.
+	 * @param  string
+	 * @return array
+	 */
+	public function getIndexes($table)
+	{
+		$_table = $this->escapeText($this->escapeIdentifier($table));
+		$res = $this->query("
+			SELECT
+				a.attnum AS ordinal_position,
+				a.attname AS column_name
+			FROM
+				pg_attribute a
+				JOIN pg_class cls ON a.attrelid = cls.oid
+			WHERE
+				a.attrelid = $_table::regclass
+				AND a.attnum > 0
+				AND NOT a.attisdropped
+			ORDER BY ordinal_position
+		");
+
+		$columns = [];
+		while ($row = $res->fetch(true)) {
+			$columns[$row['ordinal_position']] = $row['column_name'];
+		}
+
+		$res = $this->query("
+			SELECT pg_class2.relname, indisunique, indisprimary, indkey
+			FROM pg_class
+			LEFT JOIN pg_index on pg_class.oid = pg_index.indrelid
+			INNER JOIN pg_class as pg_class2 on pg_class2.oid = pg_index.indexrelid
+			WHERE pg_class.oid = $_table::regclass
+		");
+
+		$indexes = [];
+		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) {
+				$indexes[$row['relname']]['columns'][] = $columns[$index];
+			}
+		}
+		return array_values($indexes);
+	}
+
+
+	/**
+	 * Returns metadata for all foreign keys in a table.
+	 * @param  string
+	 * @return array
+	 */
+	public function getForeignKeys($table)
+	{
+		$_table = $this->escapeText($this->escapeIdentifier($table));
+
+		$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 = [];
+		while ($row = $res->fetch(true)) {
+			if (!isset($fKeys[$row['name']])) {
+				$fKeys[$row['name']] = [
+					'name' => $row['name'],
+					'table' => $row['table'],
+					'local' => [],
+					'foreign' => [],
+					'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;
+	}
+}

src/Dibi/Drivers/Sqlite3Driver.php

@@ -1,20 +1,18 @@
 <?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.
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
  */
 
+namespace Dibi\Drivers;
 
-require_once dirname(__FILE__) . '/DibiSqliteReflector.php';
+use Dibi;
+use SQLite3;
 
 
 /**
- * The dibi driver for SQLite3 database.
+ * The driver for SQLite3 database.
  *
  * Driver options:
  *   - database (or file) => the filename of the SQLite3 database
@@ -23,77 +21,78 @@ require_once dirname(__FILE__) . '/DibiSqliteReflector.php';
  *   - 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
+class Sqlite3Driver implements Dibi\Driver, Dibi\ResultDriver
 {
-	/** @var SQLite3  Connection resource */
+	use Dibi\Strict;
+
+	/** @var SQLite3|null */
 	private $connection;
 
-	/** @var SQLite3Result  Resultset resource */
+	/** @var \SQLite3Result|null */
 	private $resultSet;
 
 	/** @var bool */
-	private $autoFree = TRUE;
+	private $autoFree = true;
 
-	/** @var string  Date and datetime format */
-	private $fmtDate, $fmtDateTime;
+	/** @var string  Date format */
+	private $fmtDate;
+
+	/** @var string  Datetime format */
+	private $fmtDateTime;
 
 	/** @var string  character encoding */
-	private $dbcharset, $charset;
+	private $dbcharset;
 
+	private $charset;
 
 
 	/**
-	 * @throws DibiNotSupportedException
+	 * @throws Dibi\NotSupportedException
 	 */
 	public function __construct()
 	{
 		if (!extension_loaded('sqlite3')) {
-			throw new DibiNotSupportedException("PHP extension 'sqlite3' is not loaded.");
+			throw new Dibi\NotSupportedException("PHP extension 'sqlite3' is not loaded.");
 		}
 	}
 
 
-
 	/**
 	 * Connects to a database.
 	 * @return void
-	 * @throws DibiException
+	 * @throws Dibi\Exception
 	 */
 	public function connect(array &$config)
 	{
-		DibiConnection::alias($config, 'database', 'file');
+		Dibi\Helpers::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());
+		} else {
+			try {
+				$this->connection = new SQLite3($config['database']);
+			} catch (\Exception $e) {
+				throw new Dibi\DriverException($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;
+			$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");
+			$this->query('PRAGMA foreign_keys = ON');
 		}
 	}
 
 
-
 	/**
 	 * Disconnects from a database.
 	 * @return void
@@ -104,33 +103,62 @@ class DibiSqlite3Driver extends DibiObject implements IDibiDriver, IDibiResultDr
 	}
 
 
-
 	/**
 	 * Executes the SQL query.
 	 * @param  string      SQL statement.
-	 * @return IDibiResultDriver|NULL
-	 * @throws DibiDriverException
+	 * @return Dibi\ResultDriver|null
+	 * @throws Dibi\DriverException
 	 */
 	public function query($sql)
 	{
-		if ($this->dbcharset !== NULL) {
+		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);
+		if ($code = $this->connection->lastErrorCode()) {
+			throw static::createException($this->connection->lastErrorMsg(), $code, $sql);
 
-		} elseif ($res instanceof SQLite3Result) {
+		} elseif ($res instanceof \SQLite3Result && $res->numColumns()) {
 			return $this->createResultDriver($res);
 		}
+		return null;
+	}
+
+
+	/**
+	 * @return Dibi\DriverException
+	 */
+	public static function createException($message, $code, $sql)
+	{
+		if ($code !== 19) {
+			return new Dibi\DriverException($message, $code, $sql);
+
+		} elseif (strpos($message, 'must be unique') !== false
+			|| strpos($message, 'is not unique') !== false
+			|| strpos($message, 'UNIQUE constraint failed') !== false
+		) {
+			return new Dibi\UniqueConstraintViolationException($message, $code, $sql);
+
+		} elseif (strpos($message, 'may not be NULL') !== false
+			|| strpos($message, 'NOT NULL constraint failed') !== false
+		) {
+			return new Dibi\NotNullConstraintViolationException($message, $code, $sql);
+
+		} elseif (strpos($message, 'foreign key constraint failed') !== false
+			|| strpos($message, 'FOREIGN KEY constraint failed') !== false
+		) {
+			return new Dibi\ForeignKeyConstraintViolationException($message, $code, $sql);
+
+		} else {
+			return new Dibi\ConstraintViolationException($message, $code, $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
+	 * @return int|false  number of rows or false on error
 	 */
 	public function getAffectedRows()
 	{
@@ -138,10 +166,9 @@ class DibiSqlite3Driver extends DibiObject implements IDibiDriver, IDibiResultDr
 	}
 
 
-
 	/**
 	 * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query.
-	 * @return int|FALSE  int on success or FALSE on failure
+	 * @return int|false  int on success or false on failure
 	 */
 	public function getInsertId($sequence)
 	{
@@ -149,49 +176,45 @@ class DibiSqlite3Driver extends DibiObject implements IDibiDriver, IDibiResultDr
 	}
 
 
-
 	/**
 	 * Begins a transaction (if supported).
 	 * @param  string  optional savepoint name
 	 * @return void
-	 * @throws DibiDriverException
+	 * @throws Dibi\DriverException
 	 */
-	public function begin($savepoint = NULL)
+	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
+	 * @throws Dibi\DriverException
 	 */
-	public function commit($savepoint = NULL)
+	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
+	 * @throws Dibi\DriverException
 	 */
-	public function rollback($savepoint = NULL)
+	public function rollback($savepoint = null)
 	{
 		$this->query($savepoint ? "ROLLBACK TO SAVEPOINT $savepoint" : 'ROLLBACK');
 	}
 
 
-
 	/**
 	 * Returns the connection resource.
-	 * @return mixed
+	 * @return SQLite3|null
 	 */
 	public function getResource()
 	{
@@ -199,24 +222,22 @@ class DibiSqlite3Driver extends DibiObject implements IDibiDriver, IDibiResultDr
 	}
 
 
-
 	/**
 	 * Returns the connection reflector.
-	 * @return IDibiReflector
+	 * @return Dibi\Reflector
 	 */
 	public function getReflector()
 	{
-		return new DibiSqliteReflector($this);
+		return new SqliteReflector($this);
 	}
 
 
-
 	/**
 	 * Result set driver factory.
-	 * @param  SQLite3Result
-	 * @return IDibiResultDriver
+	 * @param  \SQLite3Result
+	 * @return Dibi\ResultDriver
 	 */
-	public function createResultDriver(SQLite3Result $resource)
+	public function createResultDriver(\SQLite3Result $resource)
 	{
 		$res = clone $this;
 		$res->resultSet = $resource;
@@ -224,45 +245,75 @@ class DibiSqlite3Driver extends DibiObject implements IDibiDriver, IDibiResultDr
 	}
 
 
-
 	/********************* SQL ****************d*g**/
 
 
-
 	/**
 	 * Encodes data for use in a SQL statement.
-	 * @param  mixed     value
-	 * @param  string    type (dibi::TEXT, dibi::BOOL, ...)
+	 * @param  string    value
 	 * @return string    encoded value
-	 * @throws InvalidArgumentException
 	 */
-	public function escape($value, $type)
+	public function escapeText($value)
 	{
-		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.');
-		}
+		return "'" . $this->connection->escapeString($value) . "'";
 	}
 
 
+	/**
+	 * @param  string
+	 * @return string
+	 */
+	public function escapeBinary($value)
+	{
+		return "X'" . bin2hex((string) $value) . "'";
+	}
+
+
+	/**
+	 * @param  string
+	 * @return string
+	 */
+	public function escapeIdentifier($value)
+	{
+		return '[' . strtr($value, '[]', '  ') . ']';
+	}
+
+
+	/**
+	 * @param  bool
+	 * @return string
+	 */
+	public function escapeBool($value)
+	{
+		return $value ? '1' : '0';
+	}
+
+
+	/**
+	 * @param  \DateTime|\DateTimeInterface|string|int
+	 * @return string
+	 */
+	public function escapeDate($value)
+	{
+		if (!$value instanceof \DateTime && !$value instanceof \DateTimeInterface) {
+			$value = new Dibi\DateTime($value);
+		}
+		return $value->format($this->fmtDate);
+	}
+
+
+	/**
+	 * @param  \DateTime|\DateTimeInterface|string|int
+	 * @return string
+	 */
+	public function escapeDateTime($value)
+	{
+		if (!$value instanceof \DateTime && !$value instanceof \DateTimeInterface) {
+			$value = new Dibi\DateTime($value);
+		}
+		return $value->format($this->fmtDateTime);
+	}
+
 
 	/**
 	 * Encodes string for use in a LIKE statement.
@@ -277,103 +328,102 @@ class DibiSqlite3Driver extends DibiObject implements IDibiDriver, IDibiResultDr
 	}
 
 
-
 	/**
 	 * Decodes data from result set.
-	 * @param  string    value
-	 * @param  string    type (dibi::BINARY)
-	 * @return string    decoded value
-	 * @throws InvalidArgumentException
+	 * @param  string
+	 * @return string
 	 */
-	public function unescape($value, $type)
+	public function unescapeBinary($value)
 	{
-		if ($type === dibi::BINARY) {
-			return $value;
-		}
-		throw new InvalidArgumentException('Unsupported type.');
+		return $value;
 	}
 
 
+	/** @deprecated */
+	public function escape($value, $type)
+	{
+		trigger_error(__METHOD__ . '() is deprecated.', E_USER_DEPRECATED);
+		return Dibi\Helpers::escape($this, $value, $type);
+	}
+
 
 	/**
 	 * Injects LIMIT/OFFSET to the SQL query.
-	 * @param  string &$sql  The SQL query that will be modified.
-	 * @param  int $limit
-	 * @param  int $offset
+	 * @param  string
+	 * @param  int|null
+	 * @param  int|null
 	 * @return void
 	 */
 	public function applyLimit(&$sql, $limit, $offset)
 	{
-		if ($limit < 0 && $offset < 1) return;
-		$sql .= ' LIMIT ' . $limit . ($offset > 0 ? ' OFFSET ' . (int) $offset : '');
+		if ($limit < 0 || $offset < 0) {
+			throw new Dibi\NotSupportedException('Negative offset or limit.');
+
+		} elseif ($limit !== null || $offset) {
+			$sql .= ' LIMIT ' . ($limit === null ? '-1' : Dibi\Helpers::intVal($limit))
+				. ($offset ? ' OFFSET ' . Dibi\Helpers::intVal($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();
+		if ($this->autoFree && $this->getResultResource()) {
+			@$this->free();
+		}
 	}
 
 
-
 	/**
 	 * Returns the number of rows in a result set.
 	 * @return int
-	 * @throws DibiNotSupportedException
+	 * @throws Dibi\NotSupportedException
 	 */
 	public function getRowCount()
 	{
-		throw new DibiNotSupportedException('Row count is not available for unbuffered queries.');
+		throw new Dibi\NotSupportedException('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
+	 * @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();
+		$charset = $this->charset === null ? null : $this->charset . '//TRANSLIT';
+		if ($row && $charset) {
 			foreach ($row as $k => $v) {
-				if ($charset !== NULL && is_string($v)) {
-					$v = iconv($this->dbcharset, $charset, $v);
+				if (is_string($v)) {
+					$row[$k] = 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
+	 * @param  int   the 0-based cursor pos to seek to
+	 * @return bool  true on success, false if unable to seek to specified record
+	 * @throws Dibi\NotSupportedException
 	 */
 	public function seek($row)
 	{
-		throw new DibiNotSupportedException('Cannot seek an unbuffered result set.');
+		throw new Dibi\NotSupportedException('Cannot seek an unbuffered result set.');
 	}
 
 
-
 	/**
 	 * Frees the resources allocated for this result set.
 	 * @return void
@@ -381,11 +431,10 @@ class DibiSqlite3Driver extends DibiObject implements IDibiDriver, IDibiResultDr
 	public function free()
 	{
 		$this->resultSet->finalize();
-		$this->resultSet = NULL;
+		$this->resultSet = null;
 	}
 
 
-
 	/**
 	 * Returns metadata for all columns in a result set.
 	 * @return array
@@ -393,37 +442,35 @@ class DibiSqlite3Driver extends DibiObject implements IDibiDriver, IDibiResultDr
 	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');
+		$columns = [];
+		static $types = [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,
+			$type = $this->resultSet->columnType($i); // buggy in PHP 7.4.4 & 7.3.16, bug 79414
+			$columns[] = [
+				'name' => $this->resultSet->columnName($i),
+				'table' => null,
 				'fullname' => $this->resultSet->columnName($i),
-				'nativetype' => $types[$this->resultSet->columnType($i)],
-			);
+				'nativetype' => $type ? $types[$type] : null,
+			];
 		}
 		return $columns;
 	}
 
 
-
 	/**
 	 * Returns the result set resource.
-	 * @return mixed
+	 * @return \SQLite3Result|null
 	 */
 	public function getResultResource()
 	{
-		$this->autoFree = FALSE;
+		$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
@@ -431,13 +478,12 @@ class DibiSqlite3Driver extends DibiObject implements IDibiDriver, IDibiResultDr
 	 * @param  int     num of arguments
 	 * @return void
 	 */
-	public function registerFunction($name, $callback, $numArgs = -1)
+	public function registerFunction($name, callable $callback, $numArgs = -1)
 	{
 		$this->connection->createFunction($name, $callback, $numArgs);
 	}
 
 
-
 	/**
 	 * Registers an aggregating user defined function for use in SQL statements.
 	 * @param  string  function name
@@ -446,9 +492,8 @@ class DibiSqlite3Driver extends DibiObject implements IDibiDriver, IDibiResultDr
 	 * @param  int     num of arguments
 	 * @return void
 	 */
-	public function registerAggregateFunction($name, $rowCallback, $agrCallback, $numArgs = -1)
+	public function registerAggregateFunction($name, callable $rowCallback, callable $agrCallback, $numArgs = -1)
 	{
 		$this->connection->createAggregate($name, $rowCallback, $agrCallback, $numArgs);
 	}
-
 }

src/Dibi/Drivers/SqliteReflector.php

@@ -1,36 +1,33 @@
 <?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.
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
  */
 
+namespace Dibi\Drivers;
+
+use Dibi;
+
 
 /**
- * The dibi reflector for SQLite database.
- *
- * @author     David Grudl
- * @package    dibi\drivers
+ * The reflector for SQLite database.
  * @internal
  */
-class DibiSqliteReflector extends DibiObject implements IDibiReflector
+class SqliteReflector implements Dibi\Reflector
 {
-	/** @var IDibiDriver */
+	use Dibi\Strict;
+
+	/** @var Dibi\Driver */
 	private $driver;
 
 
-
-	public function __construct(IDibiDriver $driver)
+	public function __construct(Dibi\Driver $driver)
 	{
 		$this->driver = $driver;
 	}
 
 
-
 	/**
 	 * Returns list of tables.
 	 * @return array
@@ -43,15 +40,14 @@ class DibiSqliteReflector extends DibiObject implements IDibiReflector
 			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 = [];
+		while ($row = $res->fetch(true)) {
 			$tables[] = $row;
 		}
 		return $tables;
 	}
 
 
-
 	/**
 	 * Returns metadata for all columns in a table.
 	 * @param  string
@@ -59,35 +55,27 @@ class DibiSqliteReflector extends DibiObject implements IDibiReflector
 	 */
 	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)) {
+		$res = $this->driver->query("PRAGMA table_info({$this->driver->escapeIdentifier($table)})");
+		$columns = [];
+		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(
+			$columns[] = [
 				'name' => $column,
 				'table' => $table,
 				'fullname' => "$table.$column",
 				'nativetype' => strtoupper($type[0]),
-				'size' => isset($type[1]) ? (int) $type[1] : NULL,
+				'size' => isset($type[1]) ? (int) $type[1] : null,
 				'nullable' => $row['notnull'] == '0',
 				'default' => $row['dflt_value'],
-				'autoincrement' => (bool) preg_match($pattern, $meta['sql']),
+				'autoincrement' => $row['pk'] && $type[0] === 'INTEGER',
 				'vendor' => $row,
-			);
+			];
 		}
 		return $columns;
 	}
 
 
-
 	/**
 	 * Returns metadata for all indexes in a table.
 	 * @param  string
@@ -95,16 +83,16 @@ class DibiSqliteReflector extends DibiObject implements IDibiReflector
 	 */
 	public function getIndexes($table)
 	{
-		$res = $this->driver->query("PRAGMA index_list({$this->driver->escape($table, dibi::IDENTIFIER)})");
-		$indexes = array();
-		while ($row = $res->fetch(TRUE)) {
+		$res = $this->driver->query("PRAGMA index_list({$this->driver->escapeIdentifier($table)})");
+		$indexes = [];
+		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)) {
+			$res = $this->driver->query("PRAGMA index_info({$this->driver->escapeIdentifier($index)})");
+			while ($row = $res->fetch(true)) {
 				$indexes[$index]['columns'][$row['seqno']] = $row['name'];
 			}
 		}
@@ -112,7 +100,7 @@ class DibiSqliteReflector extends DibiObject implements IDibiReflector
 		$columns = $this->getColumns($table);
 		foreach ($indexes as $index => $values) {
 			$column = $indexes[$index]['columns'][0];
-			$primary = FALSE;
+			$primary = false;
 			foreach ($columns as $info) {
 				if ($column == $info['name']) {
 					$primary = $info['vendor']['pk'];
@@ -124,12 +112,12 @@ class DibiSqliteReflector extends DibiObject implements IDibiReflector
 		if (!$indexes) { // @see http://www.sqlite.org/lang_createtable.html#rowid
 			foreach ($columns as $column) {
 				if ($column['vendor']['pk']) {
-					$indexes[] = array(
+					$indexes[] = [
 						'name' => 'ROWID',
-						'unique' => TRUE,
-						'primary' => TRUE,
-						'columns' => array($column['name']),
-					);
+						'unique' => true,
+						'primary' => true,
+						'columns' => [$column['name']],
+					];
 					break;
 				}
 			}
@@ -139,7 +127,6 @@ class DibiSqliteReflector extends DibiObject implements IDibiReflector
 	}
 
 
-
 	/**
 	 * Returns metadata for all foreign keys in a table.
 	 * @param  string
@@ -147,12 +134,9 @@ class DibiSqliteReflector extends DibiObject implements IDibiReflector
 	 */
 	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)) {
+		$res = $this->driver->query("PRAGMA foreign_key_list({$this->driver->escapeIdentifier($table)})");
+		$keys = [];
+		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
@@ -160,11 +144,10 @@ class DibiSqliteReflector extends DibiObject implements IDibiReflector
 			$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;
+			if ($keys[$row['id']]['foreign'][0] == null) {
+				$keys[$row['id']]['foreign'] = null;
 			}
 		}
 		return array_values($keys);
 	}
-
 }

src/Dibi/Drivers/SqlsrvDriver.php

@@ -0,0 +1,439 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi\Drivers;
+
+use Dibi;
+use Dibi\Helpers;
+
+
+/**
+ * The driver for Microsoft SQL Server and SQL Azure databases.
+ *
+ * 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 https://msdn.microsoft.com/en-us/library/cc296161(SQL.90).aspx}
+ *   - charset => character encoding to set (default is UTF-8)
+ *   - resource (resource) => existing connection resource
+ */
+class SqlsrvDriver implements Dibi\Driver, Dibi\ResultDriver
+{
+	use Dibi\Strict;
+
+	/** @var resource|null */
+	private $connection;
+
+	/** @var resource|null */
+	private $resultSet;
+
+	/** @var bool */
+	private $autoFree = true;
+
+	/** @var int|false  Affected rows */
+	private $affectedRows = false;
+
+	/** @var string */
+	private $version = '';
+
+
+	/**
+	 * @throws Dibi\NotSupportedException
+	 */
+	public function __construct()
+	{
+		if (!extension_loaded('sqlsrv')) {
+			throw new Dibi\NotSupportedException("PHP extension 'sqlsrv' is not loaded.");
+		}
+	}
+
+
+	/**
+	 * Connects to a database.
+	 * @return void
+	 * @throws Dibi\Exception
+	 */
+	public function connect(array &$config)
+	{
+		Helpers::alias($config, 'options|UID', 'username');
+		Helpers::alias($config, 'options|PWD', 'password');
+		Helpers::alias($config, 'options|Database', 'database');
+		Helpers::alias($config, 'options|CharacterSet', 'charset');
+
+		if (isset($config['resource'])) {
+			$this->connection = $config['resource'];
+
+		} else {
+			$options = $config['options'];
+
+			// Default values
+			if (!isset($options['CharacterSet'])) {
+				$options['CharacterSet'] = 'UTF-8';
+			}
+			$options['PWD'] = (string) $options['PWD'];
+			$options['UID'] = (string) $options['UID'];
+			$options['Database'] = (string) $options['Database'];
+
+			$this->connection = sqlsrv_connect($config['host'], $options);
+		}
+
+		if (!is_resource($this->connection)) {
+			$info = sqlsrv_errors();
+			throw new Dibi\DriverException($info[0]['message'], $info[0]['code']);
+		}
+		$this->version = sqlsrv_server_info($this->connection)['SQLServerVersion'];
+	}
+
+
+	/**
+	 * Disconnects from a database.
+	 * @return void
+	 */
+	public function disconnect()
+	{
+		@sqlsrv_close($this->connection); // @ - connection can be already disconnected
+	}
+
+
+	/**
+	 * Executes the SQL query.
+	 * @param  string      SQL statement.
+	 * @return Dibi\ResultDriver|null
+	 * @throws Dibi\DriverException
+	 */
+	public function query($sql)
+	{
+		$this->affectedRows = false;
+		$res = sqlsrv_query($this->connection, $sql);
+
+		if ($res === false) {
+			$info = sqlsrv_errors();
+			throw new Dibi\DriverException($info[0]['message'], $info[0]['code'], $sql);
+
+		} elseif (is_resource($res)) {
+			$this->affectedRows = sqlsrv_rows_affected($res);
+			return sqlsrv_num_fields($res) ? $this->createResultDriver($res) : null;
+		}
+		return null;
+	}
+
+
+	/**
+	 * 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 SCOPE_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 Dibi\DriverException
+	 */
+	public function begin($savepoint = null)
+	{
+		sqlsrv_begin_transaction($this->connection);
+	}
+
+
+	/**
+	 * Commits statements in a transaction.
+	 * @param  string  optional savepoint name
+	 * @return void
+	 * @throws Dibi\DriverException
+	 */
+	public function commit($savepoint = null)
+	{
+		sqlsrv_commit($this->connection);
+	}
+
+
+	/**
+	 * Rollback changes in a transaction.
+	 * @param  string  optional savepoint name
+	 * @return void
+	 * @throws Dibi\DriverException
+	 */
+	public function rollback($savepoint = null)
+	{
+		sqlsrv_rollback($this->connection);
+	}
+
+
+	/**
+	 * Returns the connection resource.
+	 * @return resource|null
+	 */
+	public function getResource()
+	{
+		return is_resource($this->connection) ? $this->connection : null;
+	}
+
+
+	/**
+	 * Returns the connection reflector.
+	 * @return Dibi\Reflector
+	 */
+	public function getReflector()
+	{
+		return new SqlsrvReflector($this);
+	}
+
+
+	/**
+	 * Result set driver factory.
+	 * @param  resource
+	 * @return Dibi\ResultDriver
+	 */
+	public function createResultDriver($resource)
+	{
+		$res = clone $this;
+		$res->resultSet = $resource;
+		return $res;
+	}
+
+
+	/********************* SQL ****************d*g**/
+
+
+	/**
+	 * Encodes data for use in a SQL statement.
+	 * @param  string    value
+	 * @return string    encoded value
+	 */
+	public function escapeText($value)
+	{
+		return "'" . str_replace("'", "''", $value) . "'";
+	}
+
+
+	/**
+	 * @param  string
+	 * @return string
+	 */
+	public function escapeBinary($value)
+	{
+		return "'" . str_replace("'", "''", $value) . "'";
+	}
+
+
+	/**
+	 * @param  string
+	 * @return string
+	 */
+	public function escapeIdentifier($value)
+	{
+		// @see https://msdn.microsoft.com/en-us/library/ms176027.aspx
+		return '[' . str_replace(']', ']]', $value) . ']';
+	}
+
+
+	/**
+	 * @param  bool
+	 * @return string
+	 */
+	public function escapeBool($value)
+	{
+		return $value ? '1' : '0';
+	}
+
+
+	/**
+	 * @param  \DateTime|\DateTimeInterface|string|int
+	 * @return string
+	 */
+	public function escapeDate($value)
+	{
+		if (!$value instanceof \DateTime && !$value instanceof \DateTimeInterface) {
+			$value = new Dibi\DateTime($value);
+		}
+		return $value->format("'Y-m-d'");
+	}
+
+
+	/**
+	 * @param  \DateTime|\DateTimeInterface|string|int
+	 * @return string
+	 */
+	public function escapeDateTime($value)
+	{
+		if (!$value instanceof \DateTime && !$value instanceof \DateTimeInterface) {
+			$value = new Dibi\DateTime($value);
+		}
+		return 'CONVERT(DATETIME2(7), ' . $value->format("'Y-m-d H:i:s.u'") . ')';
+	}
+
+
+	/**
+	 * Encodes string for use in a LIKE statement.
+	 * @param  string
+	 * @param  int
+	 * @return string
+	 */
+	public function escapeLike($value, $pos)
+	{
+		$value = strtr($value, ["'" => "''", '%' => '[%]', '_' => '[_]', '[' => '[[]']);
+		return ($pos <= 0 ? "'%" : "'") . $value . ($pos >= 0 ? "%'" : "'");
+	}
+
+
+	/**
+	 * Decodes data from result set.
+	 * @param  string
+	 * @return string
+	 */
+	public function unescapeBinary($value)
+	{
+		return $value;
+	}
+
+
+	/** @deprecated */
+	public function escape($value, $type)
+	{
+		trigger_error(__METHOD__ . '() is deprecated.', E_USER_DEPRECATED);
+		return Helpers::escape($this, $value, $type);
+	}
+
+
+	/**
+	 * Injects LIMIT/OFFSET to the SQL query.
+	 * @param  string
+	 * @param  int|null
+	 * @param  int|null
+	 * @return void
+	 */
+	public function applyLimit(&$sql, $limit, $offset)
+	{
+		if ($limit < 0 || $offset < 0) {
+			throw new Dibi\NotSupportedException('Negative offset or limit.');
+
+		} elseif (version_compare($this->version, '11', '<')) { // 11 == SQL Server 2012
+			if ($offset) {
+				throw new Dibi\NotSupportedException('Offset is not supported by this database.');
+
+			} elseif ($limit !== null) {
+				$sql = sprintf('SELECT TOP (%d) * FROM (%s) t', $limit, $sql);
+			}
+
+		} elseif ($limit !== null) {
+			// requires ORDER BY, see https://technet.microsoft.com/en-us/library/gg699618(v=sql.110).aspx
+			$sql = sprintf('%s OFFSET %d ROWS FETCH NEXT %d ROWS ONLY', rtrim($sql), $offset, $limit);
+		} elseif ($offset) {
+			// requires ORDER BY, see https://technet.microsoft.com/en-us/library/gg699618(v=sql.110).aspx
+			$sql = sprintf('%s OFFSET %d ROWS', rtrim($sql), $offset);
+		}
+	}
+
+
+	/********************* result set ****************d*g**/
+
+
+	/**
+	 * Automatically frees the resources allocated for this result set.
+	 * @return void
+	 */
+	public function __destruct()
+	{
+		if ($this->autoFree && $this->getResultResource()) {
+			$this->free();
+		}
+	}
+
+
+	/**
+	 * Returns the number of rows in a result set.
+	 * @return int
+	 */
+	public function getRowCount()
+	{
+		throw new Dibi\NotSupportedException('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 bool  true on success, false if unable to seek to specified record
+	 */
+	public function seek($row)
+	{
+		throw new Dibi\NotSupportedException('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 = [];
+		foreach ((array) sqlsrv_field_metadata($this->resultSet) as $fieldMetadata) {
+			$columns[] = [
+				'name' => $fieldMetadata['Name'],
+				'fullname' => $fieldMetadata['Name'],
+				'nativetype' => $fieldMetadata['Type'],
+			];
+		}
+		return $columns;
+	}
+
+
+	/**
+	 * Returns the result set resource.
+	 * @return resource|null
+	 */
+	public function getResultResource()
+	{
+		$this->autoFree = false;
+		return is_resource($this->resultSet) ? $this->resultSet : null;
+	}
+}

src/Dibi/Drivers/SqlsrvReflector.php

@@ -1,55 +1,51 @@
 <?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.
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
  */
 
+namespace Dibi\Drivers;
+
+use Dibi;
+
 
 /**
- * The dibi reflector for MSSQL2005 databases.
- *
- * @author     Daniel Kouba
- * @package    dibi\drivers
+ * The reflector for Microsoft SQL Server and SQL Azure databases.
  * @internal
  */
-class DibiMsSql2005Reflector extends DibiObject implements IDibiReflector
+class SqlsrvReflector implements Dibi\Reflector
 {
-	/** @var IDibiDriver */
+	use Dibi\Strict;
+
+	/** @var Dibi\Driver */
 	private $driver;
 
 
-
-	public function __construct(IDibiDriver $driver)
+	public function __construct(Dibi\Driver $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(
+		$res = $this->driver->query("SELECT TABLE_NAME, TABLE_TYPE FROM INFORMATION_SCHEMA.TABLES WHERE [TABLE_SCHEMA] = 'dbo'");
+		$tables = [];
+		while ($row = $res->fetch(false)) {
+			$tables[] = [
 				'name' => $row[0],
 				'view' => isset($row[1]) && $row[1] === 'VIEW',
-			);
+			];
 		}
 		return $tables;
 	}
 
 
-
 	/**
 	 * Returns metadata for all columns in a table.
 	 * @param  string
@@ -61,11 +57,11 @@ class DibiMsSql2005Reflector extends DibiObject implements IDibiReflector
 			SELECT c.name as COLUMN_NAME, c.is_identity AS AUTO_INCREMENT
 			FROM sys.columns c
 			INNER JOIN sys.tables t ON c.object_id = t.object_id
-			WHERE t.name = {$this->driver->escape($table, dibi::TEXT)}
+			WHERE t.name = {$this->driver->escapeText($table)}
 		");
 
-		$autoIncrements = array();
-		while ($row = $res->fetch(TRUE)) {
+		$autoIncrements = [];
+		while ($row = $res->fetch(true)) {
 			$autoIncrements[$row['COLUMN_NAME']] = (bool) $row['AUTO_INCREMENT'];
 		}
 
@@ -82,27 +78,26 @@ class DibiMsSql2005Reflector extends DibiObject implements IDibiReflector
 					And TC.CONSTRAINT_TYPE = 'PRIMARY KEY'
 					And CCU.COLUMN_NAME = C.COLUMN_NAME
 			) As Z
-			WHERE C.TABLE_NAME = {$this->driver->escape($table, dibi::TEXT)}
+			WHERE C.TABLE_NAME = {$this->driver->escapeText($table)}
 		");
-		$columns = array();
-		while ($row = $res->fetch(TRUE)) {
-			$columns[] = array(
+		$columns = [];
+		while ($row = $res->fetch(true)) {
+			$columns[] = [
 				'name' => $row['COLUMN_NAME'],
 				'table' => $table,
 				'nativetype' => strtoupper($row['DATA_TYPE']),
 				'size' => $row['CHARACTER_MAXIMUM_LENGTH'],
-				'unsigned' => TRUE,
+				'unsigned' => true,
 				'nullable' => $row['IS_NULLABLE'] === 'YES',
 				'default' => $row['COLUMN_DEFAULT'],
 				'autoincrement' => $autoIncrements[$row['COLUMN_NAME']],
 				'vendor' => $row,
-			);
+			];
 		}
 		return $columns;
 	}
 
 
-
 	/**
 	 * Returns metadata for all indexes in a table.
 	 * @param  string
@@ -110,25 +105,24 @@ class DibiMsSql2005Reflector extends DibiObject implements IDibiReflector
 	 */
 	public function getIndexes($table)
 	{
-		$keyUsagesRes = $this->driver->query("SELECT * FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE WHERE TABLE_NAME = {$this->driver->escape($table, dibi::TEXT)}");
-		$keyUsages = array();
-		while( $row = $keyUsagesRes->fetch(TRUE) ) {
-			$keyUsages[$row['CONSTRAINT_NAME']][(int) $row['ORDINAL_POSITION'] - 1] = $row['COLUMN_NAME'];
+		$keyUsagesRes = $this->driver->query(sprintf('EXEC [sys].[sp_helpindex] @objname = N%s', $this->driver->escapeText($table)));
+		$keyUsages = [];
+		while ($row = $keyUsagesRes->fetch(true)) {
+			$keyUsages[$row['index_name']] = explode(',', $row['index_keys']);
 		}
 
-		$res = $this->driver->query("SELECT * FROM INFORMATION_SCHEMA.TABLE_CONSTRAINTS WHERE TABLE_NAME = {$this->driver->escape($table, dibi::TEXT)}");
-		$indexes = array();
-		while ($row = $res->fetch(TRUE)) {
-			$indexes[$row['CONSTRAINT_NAME']]['name'] = $row['CONSTRAINT_NAME'];
-			$indexes[$row['CONSTRAINT_NAME']]['unique'] = $row['CONSTRAINT_TYPE'] === 'UNIQUE';
-			$indexes[$row['CONSTRAINT_NAME']]['primary'] = $row['CONSTRAINT_TYPE'] === 'PRIMARY KEY';
-			$indexes[$row['CONSTRAINT_NAME']]['columns'] = isset($keyUsages[$row['CONSTRAINT_NAME']]) ? $keyUsages[$row['CONSTRAINT_NAME']] : array();
+		$res = $this->driver->query("SELECT [i].* FROM [sys].[indexes] [i] INNER JOIN [sys].[tables] [t] ON [i].[object_id] = [t].[object_id] WHERE [t].[name] = {$this->driver->escapeText($table)}");
+		$indexes = [];
+		while ($row = $res->fetch(true)) {
+			$indexes[$row['name']]['name'] = $row['name'];
+			$indexes[$row['name']]['unique'] = $row['is_unique'] === 1;
+			$indexes[$row['name']]['primary'] = $row['is_primary_key'] === 1;
+			$indexes[$row['name']]['columns'] = isset($keyUsages[$row['name']]) ? $keyUsages[$row['name']] : [];
 		}
 		return array_values($indexes);
 	}
 
 
-
 	/**
 	 * Returns metadata for all foreign keys in a table.
 	 * @param  string
@@ -136,7 +130,6 @@ class DibiMsSql2005Reflector extends DibiObject implements IDibiReflector
 	 */
 	public function getForeignKeys($table)
 	{
-		throw new DibiNotImplementedException;
+		throw new Dibi\NotImplementedException;
 	}
-
 }

src/Dibi/Event.php

@@ -1,24 +1,20 @@
 <?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.
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
  */
 
+namespace Dibi;
 
 
 /**
  * Profiler & logger event.
- *
- * @author     David Grudl
- * @package    dibi
  */
-class DibiEvent
+class Event
 {
+	use Strict;
+
 	/** event type */
 	const CONNECT = 1,
 		SELECT = 4,
@@ -32,7 +28,7 @@ class DibiEvent
 		TRANSACTION = 448, // BEGIN | COMMIT | ROLLBACK
 		ALL = 1023;
 
-	/** @var DibiConnection */
+	/** @var Connection */
 	public $connection;
 
 	/** @var int */
@@ -41,64 +37,64 @@ class DibiEvent
 	/** @var string */
 	public $sql;
 
-	/** @var DibiResult|DibiDriverException|NULL */
+	/** @var Result|DriverException|null */
 	public $result;
 
 	/** @var float */
 	public $time;
 
-	/** @var int */
+	/** @var int|null */
 	public $count;
 
-	/** @var array */
+	/** @var array|null */
 	public $source;
 
 
-
-	public function __construct(DibiConnection $connection, $type, $sql = NULL)
+	public function __construct(Connection $connection, $type, $sql = null)
 	{
 		$this->connection = $connection;
 		$this->type = $type;
 		$this->sql = trim($sql);
-		$this->time = -microtime(TRUE);
+		$this->time = -microtime(true);
 
 		if ($type === self::QUERY && preg_match('#\(?\s*(SELECT|UPDATE|INSERT|DELETE)#iA', $this->sql, $matches)) {
-			static $types = array(
+			static $types = [
 				'SELECT' => self::SELECT, 'UPDATE' => self::UPDATE,
 				'INSERT' => self::INSERT, 'DELETE' => self::DELETE,
-			);
+			];
 			$this->type = $types[strtoupper($matches[1])];
 		}
 
-		$rc = new ReflectionClass('dibi');
+		$rc = new \ReflectionClass('dibi');
 		$dibiDir = dirname($rc->getFileName()) . DIRECTORY_SEPARATOR;
-		foreach (debug_backtrace(FALSE) as $row) {
+		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']);
+				$this->source = [$row['file'], (int) $row['line']];
 				break;
 			}
 		}
 
-		dibi::$elapsedTime = FALSE;
-		dibi::$numOfQueries++;
-		dibi::$sql = $sql;
+		\dibi::$elapsedTime = null;
+		\dibi::$numOfQueries++;
+		\dibi::$sql = $sql;
 	}
 
 
-
-	public function done($result = NULL)
+	/**
+	 * @param  Result|DriverException|null
+	 */
+	public function done($result = null)
 	{
 		$this->result = $result;
 		try {
-			$this->count = $result instanceof DibiResult ? count($result) : NULL;
-		} catch (DibiException $e) {
-			$this->count = NULL;
+			$this->count = $result instanceof Result ? count($result) : null;
+		} catch (Exception $e) {
+			$this->count = null;
 		}
 
-		$this->time += microtime(TRUE);
-		dibi::$elapsedTime = $this->time;
-		dibi::$totalTime += $this->time;
+		$this->time += microtime(true);
+		\dibi::$elapsedTime = $this->time;
+		\dibi::$totalTime += $this->time;
 		return $this;
 	}
-
 }

src/Dibi/Expression.php

@@ -0,0 +1,32 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi;
+
+
+/**
+ * SQL expression.
+ */
+class Expression
+{
+	use Strict;
+
+	/** @var array */
+	private $values;
+
+
+	public function __construct()
+	{
+		$this->values = func_get_args();
+	}
+
+
+	public function getValues()
+	{
+		return $this->values;
+	}
+}

src/Dibi/Fluent.php

@@ -1,50 +1,51 @@
 <?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.
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
  */
 
+namespace Dibi;
 
 
 /**
- * dibi SQL builder via fluent interfaces. EXPERIMENTAL!
+ * SQL builder via fluent interfaces.
  *
- * @author     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)
+ * @method Fluent select(...$field)
+ * @method Fluent distinct()
+ * @method Fluent from($table, ...$args = null)
+ * @method Fluent where(...$cond)
+ * @method Fluent groupBy(...$field)
+ * @method Fluent having(...$cond)
+ * @method Fluent orderBy(...$field)
+ * @method Fluent limit(int $limit)
+ * @method Fluent offset(int $offset)
+ * @method Fluent join(...$table)
+ * @method Fluent leftJoin(...$table)
+ * @method Fluent innerJoin(...$table)
+ * @method Fluent rightJoin(...$table)
+ * @method Fluent outerJoin(...$table)
+ * @method Fluent as(...$field)
+ * @method Fluent on(...$cond)
+ * @method Fluent using(...$cond)
  */
-class DibiFluent extends DibiObject implements IDataSource
+class Fluent implements IDataSource
 {
-	const REMOVE = FALSE;
+	use Strict;
+
+	const REMOVE = false;
 
 	/** @var array */
-	public static $masks = array(
-		'SELECT' => array('SELECT', 'DISTINCT', 'FROM', 'WHERE', 'GROUP BY',
-			'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'),
-	);
+	public static $masks = [
+		'SELECT' => ['SELECT', 'DISTINCT', 'FROM', 'WHERE', 'GROUP BY',
+			'HAVING', 'ORDER BY', 'LIMIT', 'OFFSET', ],
+		'UPDATE' => ['UPDATE', 'SET', 'WHERE', 'ORDER BY', 'LIMIT'],
+		'INSERT' => ['INSERT', 'INTO', 'VALUES', 'SELECT'],
+		'DELETE' => ['DELETE', 'FROM', 'USING', 'WHERE', 'ORDER BY', 'LIMIT'],
+	];
 
 	/** @var array  default modifiers for arrays */
-	public static $modifiers = array(
+	public static $modifiers = [
 		'SELECT' => '%n',
 		'FROM' => '%n',
 		'IN' => '%in',
@@ -54,107 +55,105 @@ class DibiFluent extends DibiObject implements IDataSource
 		'HAVING' => '%and',
 		'ORDER BY' => '%by',
 		'GROUP BY' => '%by',
-	);
+	];
 
 	/** @var array  clauses separators */
-	public static $separators = array(
+	public static $separators = [
 		'SELECT' => ',',
 		'FROM' => ',',
 		'WHERE' => 'AND',
 		'GROUP BY' => ',',
 		'HAVING' => 'AND',
 		'ORDER BY' => ',',
-		'LIMIT' => FALSE,
-		'OFFSET' => FALSE,
+		'LIMIT' => false,
+		'OFFSET' => false,
 		'SET' => ',',
 		'VALUES' => ',',
-		'INTO' => FALSE,
-	);
+		'INTO' => false,
+	];
 
 	/** @var array  clauses */
-	public static $clauseSwitches = array(
+	public static $clauseSwitches = [
 		'JOIN' => 'FROM',
 		'INNER JOIN' => 'FROM',
 		'LEFT JOIN' => 'FROM',
 		'RIGHT JOIN' => 'FROM',
-	);
+	];
 
-	/** @var DibiConnection */
+	/** @var Connection */
 	private $connection;
 
 	/** @var array */
-	private $setups = array();
+	private $setups = [];
 
-	/** @var string */
+	/** @var string|null */
 	private $command;
 
 	/** @var array */
-	private $clauses = array();
+	private $clauses = [];
 
 	/** @var array */
-	private $flags = array();
+	private $flags = [];
 
-	/** @var array */
+	/** @var array|null */
 	private $cursor;
 
-	/** @var DibiHashMap  normalized clauses */
+	/** @var HashMap  normalized clauses */
 	private static $normalizer;
 
 
-
 	/**
-	 * @param  DibiConnection
+	 * @param  Connection
 	 */
-	public function __construct(DibiConnection $connection)
+	public function __construct(Connection $connection)
 	{
 		$this->connection = $connection;
 
-		if (self::$normalizer === NULL) {
-			self::$normalizer = new DibiHashMap(array(__CLASS__, '_formatClause'));
+		if (self::$normalizer === null) {
+			self::$normalizer = new HashMap([__CLASS__, '_formatClause']);
 		}
 	}
 
 
-
 	/**
 	 * Appends new argument to the clause.
 	 * @param  string clause name
 	 * @param  array  arguments
-	 * @return DibiFluent  provides a fluent interface
+	 * @return self
 	 */
 	public function __call($clause, $args)
 	{
 		$clause = self::$normalizer->$clause;
 
 		// lazy initialization
-		if ($this->command === NULL) {
+		if ($this->command === null) {
 			if (isset(self::$masks[$clause])) {
-				$this->clauses = array_fill_keys(self::$masks[$clause], NULL);
+				$this->clauses = array_fill_keys(self::$masks[$clause], null);
 			}
-			$this->cursor = & $this->clauses[$clause];
-			$this->cursor = array();
+			$this->cursor = &$this->clauses[$clause];
+			$this->cursor = [];
 			$this->command = $clause;
 		}
 
 		// auto-switch to a clause
 		if (isset(self::$clauseSwitches[$clause])) {
-			$this->cursor = & $this->clauses[self::$clauseSwitches[$clause]];
+			$this->cursor = &$this->clauses[self::$clauseSwitches[$clause]];
 		}
 
 		if (array_key_exists($clause, $this->clauses)) {
 			// append to clause
-			$this->cursor = & $this->clauses[$clause];
+			$this->cursor = &$this->clauses[$clause];
 
 			// TODO: really delete?
-			if ($args === array(self::REMOVE)) {
-				$this->cursor = NULL;
+			if ($args === [self::REMOVE]) {
+				$this->cursor = null;
 				return $this;
 			}
 
 			if (isset(self::$separators[$clause])) {
 				$sep = self::$separators[$clause];
-				if ($sep === FALSE) { // means: replace
-					$this->cursor = array();
+				if ($sep === false) { // means: replace
+					$this->cursor = [];
 
 				} elseif (!empty($this->cursor)) {
 					$this->cursor[] = $sep;
@@ -163,40 +162,40 @@ class DibiFluent extends DibiObject implements IDataSource
 
 		} else {
 			// append to currect flow
-			if ($args === array(self::REMOVE)) {
+			if ($args === [self::REMOVE]) {
 				return $this;
 			}
 
 			$this->cursor[] = $clause;
 		}
 
-		if ($this->cursor === NULL) {
-			$this->cursor = array();
+		if ($this->cursor === null) {
+			$this->cursor = [];
 		}
 
 		// special types or argument
 		if (count($args) === 1) {
 			$arg = $args[0];
-			// TODO: really ignore TRUE?
-			if ($arg === TRUE) { // flag
+			// 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);
+				$args = [$clause === 'AS' ? '%N' : '%n', $arg];
 
-			} elseif (is_array($arg) || ($arg instanceof Traversable && !$arg instanceof self)) { // any array
+			} elseif (is_array($arg) || ($arg instanceof \Traversable && !$arg instanceof self)) { // any array
 				if (isset(self::$modifiers[$clause])) {
-					$args = array(self::$modifiers[$clause], $arg);
+					$args = [self::$modifiers[$clause], $arg];
 
 				} elseif (is_string(key($arg))) { // associative array
-					$args = array('%a', $arg);
+					$args = ['%a', $arg];
 				}
-			} // case $arg === FALSE is handled above
+			} // case $arg === false is handled above
 		}
 
 		foreach ($args as $arg) {
 			if ($arg instanceof self) {
-				$arg = "($arg)";
+				$arg = new Literal("($arg)");
 			}
 			$this->cursor[] = $arg;
 		}
@@ -205,53 +204,45 @@ class DibiFluent extends DibiObject implements IDataSource
 	}
 
 
-
 	/**
 	 * Switch to a clause.
 	 * @param  string clause name
-	 * @return DibiFluent  provides a fluent interface
+	 * @return self
 	 */
-	public function clause($clause, $remove = FALSE)
+	public function clause($clause)
 	{
-		$this->cursor = & $this->clauses[self::$normalizer->$clause];
-
-		if ($remove) { // deprecated, use removeClause
-			trigger_error(__METHOD__ . '(..., TRUE) is deprecated; use removeClause() instead.', E_USER_NOTICE);
-			$this->cursor = NULL;
-
-		} elseif ($this->cursor === NULL) {
-			$this->cursor = array();
+		$this->cursor = &$this->clauses[self::$normalizer->$clause];
+		if ($this->cursor === null) {
+			$this->cursor = [];
 		}
 
 		return $this;
 	}
 
 
-
 	/**
 	 * Removes a clause.
 	 * @param  string clause name
-	 * @return DibiFluent  provides a fluent interface
+	 * @return self
 	 */
 	public function removeClause($clause)
 	{
-		$this->clauses[self::$normalizer->$clause] = NULL;
+		$this->clauses[self::$normalizer->$clause] = null;
 		return $this;
 	}
 
 
-
 	/**
 	 * Change a SQL flag.
 	 * @param  string  flag name
 	 * @param  bool  value
-	 * @return DibiFluent  provides a fluent interface
+	 * @return self
 	 */
-	public function setFlag($flag, $value = TRUE)
+	public function setFlag($flag, $value = true)
 	{
 		$flag = strtoupper($flag);
 		if ($value) {
-			$this->flags[$flag] = TRUE;
+			$this->flags[$flag] = true;
 		} else {
 			unset($this->flags[$flag]);
 		}
@@ -259,7 +250,6 @@ class DibiFluent extends DibiObject implements IDataSource
 	}
 
 
-
 	/**
 	 * Is a flag set?
 	 * @param  string  flag name
@@ -271,7 +261,6 @@ class DibiFluent extends DibiObject implements IDataSource
 	}
 
 
-
 	/**
 	 * Returns SQL command.
 	 * @return string
@@ -282,10 +271,8 @@ class DibiFluent extends DibiObject implements IDataSource
 	}
 
 
-
 	/**
-	 * Returns the dibi connection.
-	 * @return DibiConnection
+	 * @return Connection
 	 */
 	final public function getConnection()
 	{
@@ -293,12 +280,11 @@ class DibiFluent extends DibiObject implements IDataSource
 	}
 
 
-
 	/**
-	 * Adds DibiResult setup.
+	 * Adds Result setup.
 	 * @param  string  method
 	 * @param  mixed   args
-	 * @return DibiFluent  provides a fluent interface
+	 * @return self
 	 */
 	public function setupResult($method)
 	{
@@ -307,68 +293,69 @@ class DibiFluent extends DibiObject implements IDataSource
 	}
 
 
-
 	/********************* executing ****************d*g**/
 
 
-
 	/**
 	 * Generates and executes SQL query.
 	 * @param  mixed what to return?
-	 * @return DibiResult|int  result set object (if any)
-	 * @throws DibiException
+	 * @return Result|int  result set or number of affected rows
+	 * @throws Exception
 	 */
-	public function execute($return = NULL)
+	public function execute($return = null)
 	{
 		$res = $this->query($this->_export());
-		return $return === dibi::IDENTIFIER ? $this->connection->getInsertId() : $res;
+		switch ($return) {
+			case \dibi::IDENTIFIER:
+				return $this->connection->getInsertId();
+			case \dibi::AFFECTED_ROWS:
+				return $this->connection->getAffectedRows();
+			default:
+				return $res;
+		}
 	}
 
 
-
 	/**
 	 * Generates, executes SQL query and fetches the single row.
-	 * @return DibiRow|FALSE  array on success, FALSE if no next record
+	 * @return Row|false
 	 */
 	public function fetch()
 	{
-		if ($this->command === 'SELECT') {
-			return $this->query($this->_export(NULL, array('%lmt', 1)))->fetch();
+		if ($this->command === 'SELECT' && !$this->clauses['LIMIT']) {
+			return $this->query($this->_export(null, ['%lmt', 1]))->fetch();
 		} else {
 			return $this->query($this->_export())->fetch();
 		}
 	}
 
 
-
 	/**
 	 * Like fetch(), but returns only first field.
-	 * @return mixed  value on success, FALSE if no next record
+	 * @return mixed  value on success, false if no next record
 	 */
 	public function fetchSingle()
 	{
-		if ($this->command === 'SELECT') {
-			return $this->query($this->_export(NULL, array('%lmt', 1)))->fetchSingle();
+		if ($this->command === 'SELECT' && !$this->clauses['LIMIT']) {
+			return $this->query($this->_export(null, ['%lmt', 1]))->fetchSingle();
 		} else {
 			return $this->query($this->_export())->fetchSingle();
 		}
 	}
 
 
-
 	/**
 	 * Fetches all records from table.
 	 * @param  int  offset
 	 * @param  int  limit
 	 * @return array
 	 */
-	public function fetchAll($offset = NULL, $limit = NULL)
+	public function fetchAll($offset = null, $limit = null)
 	{
-		return $this->query($this->_export(NULL, array('%ofs %lmt', $offset, $limit)))->fetchAll();
+		return $this->query($this->_export(null, ['%ofs %lmt', $offset, $limit]))->fetchAll();
 	}
 
 
-
 	/**
 	 * Fetches all records from table and returns associative tree.
 	 * @param  string  associative descriptor
@@ -380,85 +367,77 @@ class DibiFluent extends DibiObject implements IDataSource
 	}
 
 
-
 	/**
 	 * 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)
+	public function fetchPairs($key = null, $value = null)
 	{
 		return $this->query($this->_export())->fetchPairs($key, $value);
 	}
 
 
-
 	/**
 	 * Required by the IteratorAggregate interface.
 	 * @param  int  offset
 	 * @param  int  limit
-	 * @return DibiResultIterator
+	 * @return ResultIterator
 	 */
-	public function getIterator($offset = NULL, $limit = NULL)
+	public function getIterator($offset = null, $limit = null)
 	{
-		return $this->query($this->_export(NULL, array('%ofs %lmt', $offset, $limit)))->getIterator();
+		return $this->query($this->_export(null, ['%ofs %lmt', $offset, $limit]))->getIterator();
 	}
 
 
-
 	/**
 	 * Generates and prints SQL query or it's part.
 	 * @param  string clause name
 	 * @return bool
 	 */
-	public function test($clause = NULL)
+	public function test($clause = null)
 	{
 		return $this->connection->test($this->_export($clause));
 	}
 
 
-
 	/**
 	 * @return int
 	 */
 	public function count()
 	{
-		return (int) $this->query(array(
-			'SELECT COUNT(*) FROM (%ex', $this->_export(), ') AS [data]'
-		))->fetchSingle();
+		return Helpers::intVal($this->query([
+			'SELECT COUNT(*) FROM (%ex', $this->_export(), ') [data]',
+		])->fetchSingle());
 	}
 
 
-
 	/**
-	 * @return DibiResult
+	 * @return Result|int
 	 */
 	private function query($args)
 	{
 		$res = $this->connection->query($args);
 		foreach ($this->setups as $setup) {
-			call_user_func_array(array($res, array_shift($setup)), $setup);
+			call_user_func_array([$res, array_shift($setup)], $setup);
 		}
 		return $res;
 	}
 
 
-
 	/********************* exporting ****************d*g**/
 
 
-
 	/**
-	 * @return DibiDataSource
+	 * @return DataSource
 	 */
 	public function toDataSource()
 	{
-		return new DibiDataSource($this->connection->translate($this->_export()), $this->connection);
+		return new DataSource($this->connection->translate($this->_export()), $this->connection);
 	}
 
 
-
 	/**
 	 * Returns SQL query.
 	 * @return string
@@ -467,39 +446,45 @@ class DibiFluent extends DibiObject implements IDataSource
 	{
 		try {
 			return $this->connection->translate($this->_export());
-		} catch (Exception $e) {
+		} catch (\Exception $e) {
 			trigger_error($e->getMessage(), E_USER_ERROR);
+			return '';
 		}
 	}
 
 
-
 	/**
-	 * Generates parameters for DibiTranslator.
+	 * Generates parameters for Translator.
 	 * @param  string clause name
 	 * @return array
 	 */
-	protected function _export($clause = NULL, $args = array())
+	protected function _export($clause = null, $args = [])
 	{
-		if ($clause === NULL) {
+		if ($clause === null) {
 			$data = $this->clauses;
+			if ($this->command === 'SELECT' && ($data['LIMIT'] || $data['OFFSET'])) {
+				$args = array_merge(['%lmt %ofs', $data['LIMIT'][0], $data['OFFSET'][0]], $args);
+				unset($data['LIMIT'], $data['OFFSET']);
+			}
 
 		} else {
 			$clause = self::$normalizer->$clause;
 			if (array_key_exists($clause, $this->clauses)) {
-				$data = array($clause => $this->clauses[$clause]);
+				$data = [$clause => $this->clauses[$clause]];
 			} else {
-				return array();
+				return [];
 			}
 		}
 
 		foreach ($data as $clause => $statement) {
-			if ($statement !== NULL) {
+			if ($statement !== null) {
 				$args[] = $clause;
 				if ($clause === $this->command && $this->flags) {
 					$args[] = implode(' ', array_keys($this->flags));
 				}
-				foreach ($statement as $arg) $args[] = $arg;
+				foreach ($statement as $arg) {
+					$args[] = $arg;
+				}
 			}
 		}
 
@@ -507,7 +492,6 @@ class DibiFluent extends DibiObject implements IDataSource
 	}
 
 
-
 	/**
 	 * Format camelCase clause name to UPPER CASE.
 	 * @param  string
@@ -524,15 +508,13 @@ class DibiFluent extends DibiObject implements IDataSource
 	}
 
 
-
 	public function __clone()
 	{
 		// remove references
 		foreach ($this->clauses as $clause => $val) {
-			$this->clauses[$clause] = & $val;
+			$this->clauses[$clause] = &$val;
 			unset($val);
 		}
-		$this->cursor = & $foo;
+		$this->cursor = &$foo;
 	}
-
 }

src/Dibi/HashMap.php

@@ -0,0 +1,64 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi;
+
+
+/**
+ * Lazy cached storage.
+ * @internal
+ */
+abstract class HashMapBase
+{
+	/** @var callable */
+	private $callback;
+
+
+	public function __construct(callable $callback)
+	{
+		$this->callback = $callback;
+	}
+
+
+	public function setCallback(callable $callback)
+	{
+		$this->callback = $callback;
+	}
+
+
+	public function getCallback()
+	{
+		return $this->callback;
+	}
+}
+
+
+/**
+ * Lazy cached storage.
+ * @internal
+ */
+final class HashMap extends HashMapBase
+{
+	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);
+		}
+	}
+}

src/Dibi/Helpers.php

@@ -0,0 +1,302 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi;
+
+
+class Helpers
+{
+	use Strict;
+
+	/** @var HashMap */
+	private static $types;
+
+
+	/**
+	 * Prints out a syntax highlighted version of the SQL command or Result.
+	 * @param  string|Result
+	 * @param  bool  return output instead of printing it?
+	 * @return string
+	 */
+	public static function dump($sql = null, $return = false)
+	{
+		ob_start();
+		if ($sql instanceof Result && PHP_SAPI === 'cli') {
+			$hasColors = (substr(getenv('TERM'), 0, 5) === 'xterm');
+			$maxLen = 0;
+			foreach ($sql as $i => $row) {
+				if ($i === 0) {
+					foreach ($row as $col => $foo) {
+						$len = mb_strlen($col);
+						$maxLen = max($len, $maxLen);
+					}
+				}
+
+				echo $hasColors ? "\033[1;37m#row: $i\033[0m\n" : "#row: $i\n";
+				foreach ($row as $col => $val) {
+					$spaces = $maxLen - mb_strlen($col) + 2;
+					echo "$col" . str_repeat(' ', $spaces) . "$val\n";
+				}
+				echo "\n";
+			}
+
+			echo empty($row) ? "empty result set\n\n" : "\n";
+
+		} elseif ($sql instanceof Result) {
+			foreach ($sql as $i => $row) {
+				if ($i === 0) {
+					echo "\n<table class=\"dump\">\n<thead>\n\t<tr>\n\t\t<th>#row</th>\n";
+					foreach ($row as $col => $foo) {
+						echo "\t\t<th>" . htmlspecialchars((string) $col) . "</th>\n";
+					}
+					echo "\t</tr>\n</thead>\n<tbody>\n";
+				}
+
+				echo "\t<tr>\n\t\t<th>", $i, "</th>\n";
+				foreach ($row as $col) {
+					echo "\t\t<td>", htmlspecialchars((string) $col), "</td>\n";
+				}
+				echo "\t</tr>\n";
+			}
+
+			echo empty($row)
+				? '<p><em>empty result set</em></p>'
+				: "</tbody>\n</table>\n";
+
+		} else {
+			if ($sql === null) {
+				$sql = \dibi::$sql;
+			}
+
+			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|FETCH\s+NEXT|SET|VALUES|LEFT\s+JOIN|INNER\s+JOIN|TRUNCATE|START\s+TRANSACTION|BEGIN|COMMIT|ROLLBACK(?:\s+TO\s+SAVEPOINT)?|(?:RELEASE\s+)?SAVEPOINT';
+			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 = preg_replace("#(?<=[\\s,(])($keywords1)(?=[\\s,)])#i", "\n\$1", $sql);
+
+			// reduce spaces
+			$sql = preg_replace('#[ \t]{2,}#', ' ', $sql);
+
+			$sql = wordwrap($sql, 100);
+			$sql = preg_replace("#([ \t]*\r?\n){2,}#", "\n", $sql);
+
+			// syntax highlight
+			$highlighter = "#(/\\*.+?\\*/)|(\\*\\*.+?\\*\\*)|(?<=[\\s,(])($keywords1)(?=[\\s,)])|(?<=[\\s,(=])($keywords2)(?=[\\s,)=])#is";
+			if (PHP_SAPI === 'cli') {
+				if (substr(getenv('TERM'), 0, 5) === 'xterm') {
+					$sql = preg_replace_callback($highlighter, function ($m) {
+						if (!empty($m[1])) { // comment
+							return "\033[1;30m" . $m[1] . "\033[0m";
+
+						} elseif (!empty($m[2])) { // error
+							return "\033[1;31m" . $m[2] . "\033[0m";
+
+						} elseif (!empty($m[3])) { // most important keywords
+							return "\033[1;34m" . $m[3] . "\033[0m";
+
+						} elseif (!empty($m[4])) { // other keywords
+							return "\033[1;32m" . $m[4] . "\033[0m";
+						}
+					}, $sql);
+				}
+				echo trim($sql) . "\n\n";
+
+			} else {
+				$sql = htmlspecialchars($sql);
+				$sql = preg_replace_callback($highlighter, function ($m) {
+					if (!empty($m[1])) { // comment
+						return '<em style="color:gray">' . $m[1] . '</em>';
+
+					} elseif (!empty($m[2])) { // error
+						return '<strong style="color:red">' . $m[2] . '</strong>';
+
+					} elseif (!empty($m[3])) { // most important keywords
+						return '<strong style="color:blue">' . $m[3] . '</strong>';
+
+					} elseif (!empty($m[4])) { // other keywords
+						return '<strong style="color:green">' . $m[4] . '</strong>';
+					}
+				}, $sql);
+				echo '<pre class="dump">', trim($sql), "</pre>\n\n";
+			}
+		}
+
+		if ($return) {
+			return ob_get_clean();
+		} else {
+			ob_end_flush();
+		}
+	}
+
+
+	/**
+	 * Finds the best suggestion.
+	 * @return string|null
+	 * @internal
+	 */
+	public static function getSuggestion(array $items, $value)
+	{
+		$best = null;
+		$min = (strlen($value) / 4 + 1) * 10 + .1;
+		foreach (array_unique($items, SORT_REGULAR) as $item) {
+			$item = is_object($item) ? $item->getName() : $item;
+			if (($len = levenshtein($item, $value, 10, 11, 10)) > 0 && $len < $min) {
+				$min = $len;
+				$best = $item;
+			}
+		}
+		return $best;
+	}
+
+
+	/** @internal */
+	public static function escape(Driver $driver, $value, $type)
+	{
+		static $types = [
+			Type::TEXT => 'text',
+			Type::BINARY => 'binary',
+			Type::BOOL => 'bool',
+			Type::DATE => 'date',
+			Type::DATETIME => 'datetime',
+			\dibi::IDENTIFIER => 'identifier',
+		];
+		if (isset($types[$type])) {
+			return $driver->{'escape' . $types[$type]}($value);
+		} else {
+			throw new \InvalidArgumentException('Unsupported type.');
+		}
+	}
+
+
+	/**
+	 * Heuristic type detection.
+	 * @param  string
+	 * @return string|null
+	 * @internal
+	 */
+	public static function detectType($type)
+	{
+		static $patterns = [
+			'^_' => Type::TEXT, // PostgreSQL arrays
+			'BYTEA|BLOB|BIN' => Type::BINARY,
+			'TEXT|CHAR|POINT|INTERVAL|STRING' => Type::TEXT,
+			'YEAR|BYTE|COUNTER|SERIAL|INT|LONG|SHORT|^TINY$' => Type::INTEGER,
+			'CURRENCY|REAL|MONEY|FLOAT|DOUBLE|DECIMAL|NUMERIC|NUMBER' => Type::FLOAT,
+			'^TIME$' => Type::TIME,
+			'TIME' => Type::DATETIME, // DATETIME, TIMESTAMP
+			'DATE' => Type::DATE,
+			'BOOL' => Type::BOOL,
+		];
+
+		foreach ($patterns as $s => $val) {
+			if (preg_match("#$s#i", $type)) {
+				return $val;
+			}
+		}
+		return null;
+	}
+
+
+	/**
+	 * @internal
+	 */
+	public static function getTypeCache()
+	{
+		if (self::$types === null) {
+			self::$types = new HashMap([__CLASS__, 'detectType']);
+		}
+		return self::$types;
+	}
+
+
+	/**
+	 * Apply configuration alias or default values.
+	 * @param  array  connect configuration
+	 * @param  string key
+	 * @param  string alias key
+	 * @return void
+	 */
+	public static function alias(&$config, $key, $alias)
+	{
+		$foo = &$config;
+		foreach (explode('|', $key) as $key) {
+			$foo = &$foo[$key];
+		}
+
+		if (!isset($foo) && isset($config[$alias])) {
+			$foo = $config[$alias];
+			unset($config[$alias]);
+		}
+	}
+
+
+	/**
+	 * Import SQL dump from file.
+	 * @return int  count of sql commands
+	 */
+	public static function loadFromFile(Connection $connection, $file, callable $onProgress = null)
+	{
+		@set_time_limit(0); // intentionally @
+
+		$handle = @fopen($file, 'r'); // intentionally @
+		if (!$handle) {
+			throw new \RuntimeException("Cannot open file '$file'.");
+		}
+
+		$stat = fstat($handle);
+		$count = $size = 0;
+		$delimiter = ';';
+		$sql = '';
+		$driver = $connection->getDriver();
+		while (($s = fgets($handle)) !== false) {
+			$size += strlen($s);
+			if (strtoupper(substr($s, 0, 10)) === 'DELIMITER ') {
+				$delimiter = trim(substr($s, 10));
+
+			} elseif (substr($ts = rtrim($s), -strlen($delimiter)) === $delimiter) {
+				$sql .= substr($ts, 0, -strlen($delimiter));
+				$driver->query($sql);
+				$sql = '';
+				$count++;
+				if ($onProgress) {
+					call_user_func($onProgress, $count, isset($stat['size']) ? $size * 100 / $stat['size'] : null);
+				}
+
+			} else {
+				$sql .= $s;
+			}
+		}
+
+		if (rtrim($sql) !== '') {
+			$driver->query($sql);
+			$count++;
+			if ($onProgress) {
+				call_user_func($onProgress, $count, isset($stat['size']) ? 100 : null);
+			}
+		}
+		fclose($handle);
+		return $count;
+	}
+
+
+	/**
+	 * @internal
+	 * @return string|int
+	 */
+	public static function intVal($value)
+	{
+		if (is_int($value)) {
+			return $value;
+		} elseif (is_string($value) && preg_match('#-?\d++\z#A', $value)) {
+			// support for long numbers - keep them unchanged
+			return is_float($number = $value * 1) ? $value : $number;
+		} else {
+			throw new Exception("Expected number, '$value' given.");
+		}
+	}
+}

src/Dibi/Literal.php

@@ -0,0 +1,35 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi;
+
+
+/**
+ * SQL literal value.
+ */
+class Literal
+{
+	use Strict;
+
+	/** @var string */
+	private $value;
+
+
+	public function __construct($value)
+	{
+		$this->value = (string) $value;
+	}
+
+
+	/**
+	 * @return string
+	 */
+	public function __toString()
+	{
+		return $this->value;
+	}
+}

src/Dibi/Loggers/FileLogger.php

@@ -1,24 +1,22 @@
 <?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.
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
  */
 
+namespace Dibi\Loggers;
+
+use Dibi;
 
 
 /**
- * dibi file logger.
- *
- * @author     David Grudl
- * @package    dibi
+ * Dibi file logger.
  */
-class DibiFileLogger extends DibiObject
+class FileLogger
 {
+	use Dibi\Strict;
+
 	/** @var string  Name of the file where SQL errors should be logged */
 	public $file;
 
@@ -26,30 +24,30 @@ class DibiFileLogger extends DibiObject
 	public $filter;
 
 
-
-	public function __construct($file, $filter = NULL)
+	public function __construct($file, $filter = null)
 	{
 		$this->file = $file;
-		$this->filter = $filter ? (int) $filter : DibiEvent::QUERY;
+		$this->filter = $filter ? (int) $filter : Dibi\Event::QUERY;
 	}
 
 
-
 	/**
 	 * After event notification.
 	 * @return void
 	 */
-	public function logEvent(DibiEvent $event)
+	public function logEvent(Dibi\Event $event)
 	{
 		if (($event->type & $this->filter) === 0) {
 			return;
 		}
 
 		$handle = fopen($this->file, 'a');
-		if (!$handle) return; // or throw exception?
+		if (!$handle) {
+			return; // or throw exception?
+		}
 		flock($handle, LOCK_EX);
 
-		if ($event->result instanceof Exception) {
+		if ($event->result instanceof \Exception) {
 			$message = $event->result->getMessage();
 			if ($code = $event->result->getCode()) {
 				$message = "[$code] $message";
@@ -63,9 +61,9 @@ class DibiFileLogger extends DibiObject
 			);
 		} else {
 			fwrite($handle,
-				"OK: " . $event->sql
+				'OK: ' . $event->sql
 				. ($event->count ? ";\n-- rows: " . $event->count : '')
-				. "\n-- takes: " . sprintf('%0.3f', $event->time * 1000) . ' ms'
+				. "\n-- takes: " . sprintf('%0.3f ms', $event->time * 1000)
 				. "\n-- source: " . implode(':', $event->source)
 				. "\n-- driver: " . $event->connection->getConfig('driver') . '/' . $event->connection->getConfig('name')
 				. "\n-- " . date('Y-m-d H:i:s')
@@ -74,5 +72,4 @@ class DibiFileLogger extends DibiObject
 		}
 		fclose($handle);
 	}
-
 }

src/Dibi/Loggers/FirePhpLogger.php

@@ -0,0 +1,94 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi\Loggers;
+
+use Dibi;
+
+
+/**
+ * FirePHP logger.
+ */
+class FirePhpLogger
+{
+	use Dibi\Strict;
+
+	/** maximum number of rows */
+	public static $maxQueries = 30;
+
+	/** maximum SQL length */
+	public static $maxLength = 1000;
+
+	/** size of json stream chunk */
+	public static $streamChunkSize = 4990;
+
+	/** @var int */
+	public $filter;
+
+	/** @var float  Elapsed time for all queries */
+	public $totalTime = 0;
+
+	/** @var int  Number of all queries */
+	public $numOfQueries = 0;
+
+	/** @var array */
+	private static $fireTable = [['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 : Dibi\Event::QUERY;
+	}
+
+
+	/**
+	 * After event notification.
+	 * @return void
+	 */
+	public function logEvent(Dibi\Event $event)
+	{
+		if (headers_sent() || ($event->type & $this->filter) === 0 || count(self::$fireTable) > self::$maxQueries) {
+			return;
+		}
+
+		if (!$this->numOfQueries) {
+			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');
+		}
+		$this->totalTime += $event->time;
+		$this->numOfQueries++;
+		self::$fireTable[] = [
+			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'),
+		];
+
+		$payload = json_encode([
+			[
+				'Type' => 'TABLE',
+				'Label' => 'dibi profiler (' . $this->numOfQueries . ' SQL queries took ' . sprintf('%0.3f', $this->totalTime * 1000) . ' ms)',
+			],
+			self::$fireTable,
+		]);
+		foreach (str_split($payload, self::$streamChunkSize) 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|");
+	}
+}

src/Dibi/Reflection/Column.php

@@ -0,0 +1,164 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi\Reflection;
+
+use Dibi;
+
+
+/**
+ * Reflection metadata class for a table or result set column.
+ *
+ * @property-read string $name
+ * @property-read string $fullName
+ * @property-read Table $table
+ * @property-read string $type
+ * @property-read mixed $nativeType
+ * @property-read int|null $size
+ * @property-read bool|null $unsigned
+ * @property-read bool|null $nullable
+ * @property-read bool|null $autoIncrement
+ * @property-read mixed $default
+ */
+class Column
+{
+	use Dibi\Strict;
+
+	/** @var Dibi\Reflector|null when created by Result */
+	private $reflector;
+
+	/** @var array (name, nativetype, [table], [fullname], [size], [nullable], [default], [autoincrement], [vendor]) */
+	private $info;
+
+
+	public function __construct(Dibi\Reflector $reflector = null, array $info)
+	{
+		$this->reflector = $reflector;
+		$this->info = $info;
+	}
+
+
+	/**
+	 * @return string
+	 */
+	public function getName()
+	{
+		return $this->info['name'];
+	}
+
+
+	/**
+	 * @return string
+	 */
+	public function getFullName()
+	{
+		return isset($this->info['fullname']) ? $this->info['fullname'] : null;
+	}
+
+
+	/**
+	 * @return bool
+	 */
+	public function hasTable()
+	{
+		return !empty($this->info['table']);
+	}
+
+
+	/**
+	 * @return Table
+	 */
+	public function getTable()
+	{
+		if (empty($this->info['table']) || !$this->reflector) {
+			throw new Dibi\Exception('Table is unknown or not available.');
+		}
+		return new Table($this->reflector, ['name' => $this->info['table']]);
+	}
+
+
+	/**
+	 * @return string|null
+	 */
+	public function getTableName()
+	{
+		return isset($this->info['table']) && $this->info['table'] != null ? $this->info['table'] : null; // intentionally ==
+	}
+
+
+	/**
+	 * @return string
+	 */
+	public function getType()
+	{
+		return Dibi\Helpers::getTypeCache()->{$this->info['nativetype']};
+	}
+
+
+	/**
+	 * @return string
+	 */
+	public function getNativeType()
+	{
+		return $this->info['nativetype'];
+	}
+
+
+	/**
+	 * @return int|null
+	 */
+	public function getSize()
+	{
+		return isset($this->info['size']) ? (int) $this->info['size'] : null;
+	}
+
+
+	/**
+	 * @return bool|null
+	 */
+	public function isUnsigned()
+	{
+		return isset($this->info['unsigned']) ? (bool) $this->info['unsigned'] : null;
+	}
+
+
+	/**
+	 * @return bool|null
+	 */
+	public function isNullable()
+	{
+		return isset($this->info['nullable']) ? (bool) $this->info['nullable'] : null;
+	}
+
+
+	/**
+	 * @return bool|null
+	 */
+	public function isAutoIncrement()
+	{
+		return isset($this->info['autoincrement']) ? (bool) $this->info['autoincrement'] : null;
+	}
+
+
+	/**
+	 * @return mixed
+	 */
+	public function getDefault()
+	{
+		return isset($this->info['default']) ? $this->info['default'] : null;
+	}
+
+
+	/**
+	 * @param  string
+	 * @return mixed
+	 */
+	public function getVendorInfo($key)
+	{
+		return isset($this->info['vendor'][$key]) ? $this->info['vendor'][$key] : null;
+	}
+}

src/Dibi/Reflection/Database.php

@@ -0,0 +1,114 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi\Reflection;
+
+use Dibi;
+
+
+/**
+ * Reflection metadata class for a database.
+ *
+ * @property-read string $name
+ * @property-read array $tables
+ * @property-read array $tableNames
+ */
+class Database
+{
+	use Dibi\Strict;
+
+	/** @var Dibi\Reflector */
+	private $reflector;
+
+	/** @var string|null */
+	private $name;
+
+	/** @var Table[]|null */
+	private $tables;
+
+
+	public function __construct(Dibi\Reflector $reflector, $name)
+	{
+		$this->reflector = $reflector;
+		$this->name = $name;
+	}
+
+
+	/**
+	 * @return string|null
+	 */
+	public function getName()
+	{
+		return $this->name;
+	}
+
+
+	/**
+	 * @return Table[]
+	 */
+	public function getTables()
+	{
+		$this->init();
+		return array_values($this->tables);
+	}
+
+
+	/**
+	 * @return string[]
+	 */
+	public function getTableNames()
+	{
+		$this->init();
+		$res = [];
+		foreach ($this->tables as $table) {
+			$res[] = $table->getName();
+		}
+		return $res;
+	}
+
+
+	/**
+	 * @param  string
+	 * @return Table
+	 */
+	public function getTable($name)
+	{
+		$this->init();
+		$l = strtolower($name);
+		if (isset($this->tables[$l])) {
+			return $this->tables[$l];
+
+		} else {
+			throw new Dibi\Exception("Database '$this->name' has no table '$name'.");
+		}
+	}
+
+
+	/**
+	 * @param  string
+	 * @return bool
+	 */
+	public function hasTable($name)
+	{
+		$this->init();
+		return isset($this->tables[strtolower($name)]);
+	}
+
+
+	/**
+	 * @return void
+	 */
+	protected function init()
+	{
+		if ($this->tables === null) {
+			$this->tables = [];
+			foreach ($this->reflector->getTables() as $info) {
+				$this->tables[strtolower($info['name'])] = new Table($this->reflector, $info);
+			}
+		}
+	}
+}

src/Dibi/Reflection/ForeignKey.php

@@ -0,0 +1,53 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi\Reflection;
+
+use Dibi;
+
+
+/**
+ * Reflection metadata class for a foreign key.
+ *
+ * @property-read string $name
+ * @property-read array $references
+ */
+class ForeignKey
+{
+	use Dibi\Strict;
+
+	/** @var string */
+	private $name;
+
+	/** @var array of [local, foreign, onDelete, onUpdate] */
+	private $references;
+
+
+	public function __construct($name, array $references)
+	{
+		$this->name = $name;
+		$this->references = $references;
+	}
+
+
+	/**
+	 * @return string
+	 */
+	public function getName()
+	{
+		return $this->name;
+	}
+
+
+	/**
+	 * @return array
+	 */
+	public function getReferences()
+	{
+		return $this->references;
+	}
+}

src/Dibi/Reflection/Index.php

@@ -0,0 +1,69 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi\Reflection;
+
+use Dibi;
+
+
+/**
+ * Reflection metadata class for a index or primary key.
+ *
+ * @property-read string $name
+ * @property-read array $columns
+ * @property-read bool $unique
+ * @property-read bool $primary
+ */
+class Index
+{
+	use Dibi\Strict;
+
+	/** @var array (name, columns, [unique], [primary]) */
+	private $info;
+
+
+	public function __construct(array $info)
+	{
+		$this->info = $info;
+	}
+
+
+	/**
+	 * @return string
+	 */
+	public function getName()
+	{
+		return $this->info['name'];
+	}
+
+
+	/**
+	 * @return array
+	 */
+	public function getColumns()
+	{
+		return $this->info['columns'];
+	}
+
+
+	/**
+	 * @return bool
+	 */
+	public function isUnique()
+	{
+		return !empty($this->info['unique']);
+	}
+
+
+	/**
+	 * @return bool
+	 */
+	public function isPrimary()
+	{
+		return !empty($this->info['primary']);
+	}
+}

src/Dibi/Reflection/Result.php

@@ -0,0 +1,105 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi\Reflection;
+
+use Dibi;
+
+
+/**
+ * Reflection metadata class for a result set.
+ *
+ * @property-read array $columns
+ * @property-read array $columnNames
+ */
+class Result
+{
+	use Dibi\Strict;
+
+	/** @var Dibi\ResultDriver */
+	private $driver;
+
+	/** @var Column[]|null */
+	private $columns;
+
+	/** @var string[]|null */
+	private $names;
+
+
+	public function __construct(Dibi\ResultDriver $driver)
+	{
+		$this->driver = $driver;
+	}
+
+
+	/**
+	 * @return Column[]
+	 */
+	public function getColumns()
+	{
+		$this->initColumns();
+		return array_values($this->columns);
+	}
+
+
+	/**
+	 * @param  bool
+	 * @return string[]
+	 */
+	public function getColumnNames($fullNames = false)
+	{
+		$this->initColumns();
+		$res = [];
+		foreach ($this->columns as $column) {
+			$res[] = $fullNames ? $column->getFullName() : $column->getName();
+		}
+		return $res;
+	}
+
+
+	/**
+	 * @param  string
+	 * @return Column
+	 */
+	public function getColumn($name)
+	{
+		$this->initColumns();
+		$l = strtolower($name);
+		if (isset($this->names[$l])) {
+			return $this->names[$l];
+
+		} else {
+			throw new Dibi\Exception("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 = [];
+			$reflector = $this->driver instanceof Dibi\Reflector ? $this->driver : null;
+			foreach ($this->driver->getResultColumns() as $info) {
+				$this->columns[] = $this->names[strtolower($info['name'])] = new Column($reflector, $info);
+			}
+		}
+	}
+}

src/Dibi/Reflection/Table.php

@@ -0,0 +1,200 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi\Reflection;
+
+use Dibi;
+
+
+/**
+ * Reflection metadata class for a database table.
+ *
+ * @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 Index $primaryKey
+ */
+class Table
+{
+	use Dibi\Strict;
+
+	/** @var Dibi\Reflector */
+	private $reflector;
+
+	/** @var string */
+	private $name;
+
+	/** @var bool */
+	private $view;
+
+	/** @var Column[]|null */
+	private $columns;
+
+	/** @var ForeignKey[]|null */
+	private $foreignKeys;
+
+	/** @var Index[]|null */
+	private $indexes;
+
+	/** @var Index|null */
+	private $primaryKey;
+
+
+	public function __construct(Dibi\Reflector $reflector, array $info)
+	{
+		$this->reflector = $reflector;
+		$this->name = $info['name'];
+		$this->view = !empty($info['view']);
+	}
+
+
+	/**
+	 * @return string
+	 */
+	public function getName()
+	{
+		return $this->name;
+	}
+
+
+	/**
+	 * @return bool
+	 */
+	public function isView()
+	{
+		return $this->view;
+	}
+
+
+	/**
+	 * @return Column[]
+	 */
+	public function getColumns()
+	{
+		$this->initColumns();
+		return array_values($this->columns);
+	}
+
+
+	/**
+	 * @return string[]
+	 */
+	public function getColumnNames()
+	{
+		$this->initColumns();
+		$res = [];
+		foreach ($this->columns as $column) {
+			$res[] = $column->getName();
+		}
+		return $res;
+	}
+
+
+	/**
+	 * @param  string
+	 * @return Column
+	 */
+	public function getColumn($name)
+	{
+		$this->initColumns();
+		$l = strtolower($name);
+		if (isset($this->columns[$l])) {
+			return $this->columns[$l];
+
+		} else {
+			throw new Dibi\Exception("Table '$this->name' has no column '$name'.");
+		}
+	}
+
+
+	/**
+	 * @param  string
+	 * @return bool
+	 */
+	public function hasColumn($name)
+	{
+		$this->initColumns();
+		return isset($this->columns[strtolower($name)]);
+	}
+
+
+	/**
+	 * @return ForeignKey[]
+	 */
+	public function getForeignKeys()
+	{
+		$this->initForeignKeys();
+		return $this->foreignKeys;
+	}
+
+
+	/**
+	 * @return Index[]
+	 */
+	public function getIndexes()
+	{
+		$this->initIndexes();
+		return $this->indexes;
+	}
+
+
+	/**
+	 * @return Index
+	 */
+	public function getPrimaryKey()
+	{
+		$this->initIndexes();
+		return $this->primaryKey;
+	}
+
+
+	/**
+	 * @return void
+	 */
+	protected function initColumns()
+	{
+		if ($this->columns === null) {
+			$this->columns = [];
+			foreach ($this->reflector->getColumns($this->name) as $info) {
+				$this->columns[strtolower($info['name'])] = new Column($this->reflector, $info);
+			}
+		}
+	}
+
+
+	/**
+	 * @return void
+	 */
+	protected function initIndexes()
+	{
+		if ($this->indexes === null) {
+			$this->initColumns();
+			$this->indexes = [];
+			foreach ($this->reflector->getIndexes($this->name) as $info) {
+				foreach ($info['columns'] as $key => $name) {
+					$info['columns'][$key] = $this->columns[strtolower($name)];
+				}
+				$this->indexes[strtolower($info['name'])] = new Index($info);
+				if (!empty($info['primary'])) {
+					$this->primaryKey = $this->indexes[strtolower($info['name'])];
+				}
+			}
+		}
+	}
+
+
+	/**
+	 * @return void
+	 */
+	protected function initForeignKeys()
+	{
+		throw new Dibi\NotImplementedException;
+	}
+}

src/Dibi/Result.php

@@ -0,0 +1,622 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi;
+
+
+/**
+ * Query result.
+ *
+ * @property-read int $rowCount
+ */
+class Result implements IDataSource
+{
+	use Strict;
+
+	/** @var array  ResultDriver */
+	private $driver;
+
+	/** @var array  Translate table */
+	private $types = [];
+
+	/** @var Reflection\Result */
+	private $meta;
+
+	/** @var bool  Already fetched? Used for allowance for first seek(0) */
+	private $fetched = false;
+
+	/** @var string|null  returned object class */
+	private $rowClass = 'Dibi\Row';
+
+	/** @var callable|null  returned object factory */
+	private $rowFactory;
+
+	/** @var array  format */
+	private $formats = [];
+
+
+	/**
+	 * @param  ResultDriver
+	 */
+	public function __construct($driver)
+	{
+		$this->driver = $driver;
+		$this->detectTypes();
+	}
+
+
+	/**
+	 * @deprecated
+	 */
+	final public function getResource()
+	{
+		trigger_error(__METHOD__ . '() is deprecated, use getResultDriver()->getResultResource().', E_USER_DEPRECATED);
+		return $this->getResultDriver()->getResultResource();
+	}
+
+
+	/**
+	 * Frees the resources allocated for this result set.
+	 * @return void
+	 */
+	final public function free()
+	{
+		if ($this->driver !== null) {
+			$this->driver->free();
+			$this->driver = $this->meta = null;
+		}
+	}
+
+
+	/**
+	 * Safe access to property $driver.
+	 * @return ResultDriver
+	 * @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 bool     true on success, false if unable to seek to specified record
+	 * @throws Exception
+	 */
+	final public function seek($row)
+	{
+		return ($row != 0 || $this->fetched) // intentionally ==
+			? (bool) $this->getResultDriver()->seek($row)
+			: true;
+	}
+
+
+	/**
+	 * Required by the Countable interface.
+	 * @return int
+	 */
+	final public function count()
+	{
+		return $this->getResultDriver()->getRowCount();
+	}
+
+
+	/**
+	 * Returns the number of rows in a result set.
+	 * @return int
+	 */
+	final public function getRowCount()
+	{
+		return $this->getResultDriver()->getRowCount();
+	}
+
+
+	/**
+	 * Required by the IteratorAggregate interface.
+	 * @return ResultIterator
+	 */
+	final public function getIterator()
+	{
+		return new ResultIterator($this);
+	}
+
+
+	/**
+	 * Returns the number of columns in a result set.
+	 * @return int
+	 */
+	final public function getColumnCount()
+	{
+		return count($this->types);
+	}
+
+
+	/********************* fetching rows ****************d*g**/
+
+
+	/**
+	 * Set fetched object class. This class should extend the Row class.
+	 * @param  string
+	 * @return self
+	 */
+	public function setRowClass($class)
+	{
+		$this->rowClass = $class;
+		return $this;
+	}
+
+
+	/**
+	 * Returns fetched object class name.
+	 * @return string
+	 */
+	public function getRowClass()
+	{
+		return $this->rowClass;
+	}
+
+
+	/**
+	 * Set a factory to create fetched object instances. These should extend the Row class.
+	 * @return self
+	 */
+	public function setRowFactory(callable $callback)
+	{
+		$this->rowFactory = $callback;
+		return $this;
+	}
+
+
+	/**
+	 * Fetches the row at current position, process optional type conversion.
+	 * and moves the internal cursor to the next position
+	 * @return Row|false
+	 */
+	final public function fetch()
+	{
+		$row = $this->getResultDriver()->fetch(true);
+		if (!is_array($row)) {
+			return false;
+		}
+		$this->fetched = true;
+		$this->normalize($row);
+		if ($this->rowFactory) {
+			return call_user_func($this->rowFactory, $row);
+		} elseif ($this->rowClass) {
+			$row = new $this->rowClass($row);
+		}
+		return $row;
+	}
+
+
+	/**
+	 * Like fetch(), but returns only first field.
+	 * @return mixed value on success, false if no next record
+	 */
+	final public function fetchSingle()
+	{
+		$row = $this->getResultDriver()->fetch(true);
+		if (!is_array($row)) {
+			return false;
+		}
+		$this->fetched = true;
+		$this->normalize($row);
+		return reset($row);
+	}
+
+
+	/**
+	 * Fetches all records from table.
+	 * @param  int  offset
+	 * @param  int  limit
+	 * @return Row[]|array[]
+	 */
+	final public function fetchAll($offset = null, $limit = null)
+	{
+		$limit = $limit === null ? -1 : Helpers::intVal($limit);
+		$this->seek($offset);
+		$row = $this->fetch();
+		if (!$row) {
+			return [];  // empty result set
+		}
+
+		$data = [];
+		do {
+			if ($limit === 0) {
+				break;
+			}
+			$limit--;
+			$data[] = $row;
+		} while ($row = $this->fetch());
+
+		return $data;
+	}
+
+
+	/**
+	 * Fetches all records from table and returns associative tree.
+	 * 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 array
+	 * @throws \InvalidArgumentException
+	 */
+	final public function fetchAssoc($assoc)
+	{
+		if (strpos($assoc, ',') !== false) {
+			return $this->oldFetchAssoc($assoc);
+		}
+
+		$this->seek(0);
+		$row = $this->fetch();
+		if (!$row) {
+			return [];  // empty result set
+		}
+
+		$data = null;
+		$assoc = preg_split('#(\[\]|->|=|\|)#', $assoc, -1, 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();
+		if (!$row) {
+			return [];  // empty result set
+		}
+
+		$data = null;
+		$assoc = explode(',', $assoc);
+
+		// strip leading = and @
+		$leaf = '@';  // gap
+		$last = count($assoc) - 1;
+		while ($assoc[$last] === '=' || $assoc[$last] === '@') {
+			$leaf = $assoc[$last];
+			unset($assoc[$last]);
+			$last--;
+
+			if ($last < 0) {
+				$assoc[] = '#';
+				break;
+			}
+		}
+
+		do {
+			$x = &$data;
+
+			foreach ($assoc as $i => $as) {
+				if ($as === '#') { // indexed-array node
+					$x = &$x[];
+
+				} elseif ($as === '=') { // "record" node
+					if ($x === null) {
+						$x = $row->toArray();
+						$x = &$x[$assoc[$i + 1]];
+						$x = null; // prepare child node
+					} else {
+						$x = &$x[$assoc[$i + 1]];
+					}
+
+				} 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]};
+					}
+
+				} else { // associative-array node
+					$x = &$x[$row->$as];
+				}
+			}
+
+			if ($x === null) { // build leaf
+				if ($leaf === '=') {
+					$x = $row->toArray();
+				} else {
+					$x = $row;
+				}
+			}
+		} while ($row = $this->fetch());
+
+		unset($x);
+		return $data;
+	}
+
+
+	/**
+	 * Fetches all records from table like $key => $value pairs.
+	 * @param  string  associative key
+	 * @param  string  value
+	 * @return array
+	 * @throws \InvalidArgumentException
+	 */
+	final public function fetchPairs($key = null, $value = null)
+	{
+		$this->seek(0);
+		$row = $this->fetch();
+		if (!$row) {
+			return [];  // empty result set
+		}
+
+		$data = [];
+
+		if ($value === null) {
+			if ($key !== null) {
+				throw new \InvalidArgumentException('Either none or both columns must be specified.');
+			}
+
+			// autodetect
+			$tmp = array_keys($row->toArray());
+			$key = $tmp[0];
+			if (count($row) < 2) { // indexed-array
+				do {
+					$data[] = $row[$key];
+				} while ($row = $this->fetch());
+				return $data;
+			}
+
+			$value = $tmp[1];
+
+		} else {
+			if (!property_exists($row, $value)) {
+				throw new \InvalidArgumentException("Unknown value column '$value'.");
+			}
+
+			if ($key === null) { // indexed-array
+				do {
+					$data[] = $row[$value];
+				} while ($row = $this->fetch());
+				return $data;
+			}
+
+			if (!property_exists($row, $key)) {
+				throw new \InvalidArgumentException("Unknown key column '$key'.");
+			}
+		}
+
+		do {
+			$data[(string) $row[$key]] = $row[$value];
+		} while ($row = $this->fetch());
+
+		return $data;
+	}
+
+
+	/********************* column types ****************d*g**/
+
+
+	/**
+	 * Autodetect column types.
+	 * @return void
+	 */
+	private function detectTypes()
+	{
+		$cache = Helpers::getTypeCache();
+		try {
+			foreach ($this->getResultDriver()->getResultColumns() as $col) {
+				$this->types[$col['name']] = isset($col['type']) ? $col['type'] : $cache->{$col['nativetype']};
+			}
+		} catch (NotSupportedException $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 ($type === Type::TEXT) {
+				$row[$key] = (string) $value;
+
+			} elseif ($type === Type::INTEGER) {
+				$row[$key] = is_float($tmp = $value * 1)
+					? (is_string($value) ? $value : (int) $value)
+					: $tmp;
+
+			} elseif ($type === Type::FLOAT) {
+				$value = ltrim((string) $value, '0');
+				$p = strpos($value, '.');
+				$e = strpos($value, 'e');
+				if ($p !== false && $e === false) {
+					$value = rtrim(rtrim($value, '0'), '.');
+				} elseif ($p !== false && $e !== false) {
+					$value = rtrim($value, '.');
+				}
+				if ($value === '' || $value[0] === '.') {
+					$value = '0' . $value;
+				}
+				$row[$key] = $value === str_replace(',', '.', (string) ($float = (float) $value))
+					? $float
+					: $value;
+
+			} elseif ($type === Type::BOOL) {
+				$row[$key] = ((bool) $value) && $value !== 'f' && $value !== 'F';
+
+			} elseif ($type === Type::DATETIME || $type === Type::DATE || $type === Type::TIME) {
+				if ($value && substr((string) $value, 0, 3) !== '000') { // '', null, false, '0000-00-00', ...
+					$value = new DateTime($value);
+					$row[$key] = empty($this->formats[$type]) ? $value : $value->format($this->formats[$type]);
+				} else {
+					$row[$key] = null;
+				}
+
+			} elseif ($type === Type::TIME_INTERVAL) {
+				preg_match('#^(-?)(\d+)\D(\d+)\D(\d+)\z#', $value, $m);
+				$row[$key] = new \DateInterval("PT$m[2]H$m[3]M$m[4]S");
+				$row[$key]->invert = (int) (bool) $m[1];
+
+			} elseif ($type === Type::BINARY) {
+				$row[$key] = $this->getResultDriver()->unescapeBinary($value);
+
+			} else {
+				$row[$key] = $value;
+			}
+		}
+	}
+
+
+	/**
+	 * Define column type.
+	 * @param  string  column
+	 * @param  string  type (use constant Type::*)
+	 * @return self
+	 */
+	final public function setType($col, $type)
+	{
+		$this->types[$col] = $type;
+		return $this;
+	}
+
+
+	/**
+	 * Returns column type.
+	 * @return string
+	 */
+	final public function getType($col)
+	{
+		return isset($this->types[$col]) ? $this->types[$col] : null;
+	}
+
+
+	/**
+	 * Sets date format.
+	 * @param  string
+	 * @param  string|null  format
+	 * @return self
+	 */
+	final public function setFormat($type, $format)
+	{
+		$this->formats[$type] = $format;
+		return $this;
+	}
+
+
+	/**
+	 * Returns data format.
+	 * @return string|null
+	 */
+	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 Reflection\Result
+	 */
+	public function getInfo()
+	{
+		if ($this->meta === null) {
+			$this->meta = new Reflection\Result($this->getResultDriver());
+		}
+		return $this->meta;
+	}
+
+
+	/**
+	 * @return Reflection\Column[]
+	 */
+	final public function getColumns()
+	{
+		return $this->getInfo()->getColumns();
+	}
+
+
+	/********************* misc tools ****************d*g**/
+
+
+	/**
+	 * Displays complete result set as HTML or text table for debug purposes.
+	 * @return void
+	 */
+	final public function dump()
+	{
+		echo Helpers::dump($this);
+	}
+}

src/Dibi/ResultIterator.php

@@ -1,53 +1,39 @@
 <?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.
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
  */
 
+namespace Dibi;
 
 
 /**
  * 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
+class ResultIterator implements \Iterator, \Countable
 {
-	/** @var DibiResult */
+	use Strict;
+
+	/** @var Result */
 	private $result;
 
-	/** @var int */
+	/** @var mixed */
 	private $row;
 
 	/** @var int */
-	private $pointer;
+	private $pointer = 0;
 
 
 	/**
-	 * @param  DibiResult
+	 * @param  Result
 	 */
-	public function __construct(DibiResult $result)
+	public function __construct(Result $result)
 	{
 		$this->result = $result;
 	}
 
 
-
 	/**
 	 * Rewinds the iterator to the first element.
 	 * @return void
@@ -60,7 +46,6 @@ class DibiResultIterator implements Iterator, Countable
 	}
 
 
-
 	/**
 	 * Returns the key of the current element.
 	 * @return mixed
@@ -71,7 +56,6 @@ class DibiResultIterator implements Iterator, Countable
 	}
 
 
-
 	/**
 	 * Returns the current element.
 	 * @return mixed
@@ -82,7 +66,6 @@ class DibiResultIterator implements Iterator, Countable
 	}
 
 
-
 	/**
 	 * Moves forward to next element.
 	 * @return void
@@ -94,7 +77,6 @@ class DibiResultIterator implements Iterator, Countable
 	}
 
 
-
 	/**
 	 * Checks if there is a current element after calls to rewind() or next().
 	 * @return bool
@@ -105,7 +87,6 @@ class DibiResultIterator implements Iterator, Countable
 	}
 
 
-
 	/**
 	 * Required by the Countable interface.
 	 * @return int
@@ -114,5 +95,4 @@ class DibiResultIterator implements Iterator, Countable
 	{
 		return $this->result->getRowCount();
 	}
-
 }

src/Dibi/Row.php

@@ -0,0 +1,93 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi;
+
+
+/**
+ * Result set single row.
+ */
+class Row 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|string|null
+	 */
+	public function asDateTime($key, $format = null)
+	{
+		$time = $this[$key];
+		if (!$time instanceof DateTime) {
+			if (!$time || substr((string) $time, 0, 3) === '000') { // '', null, false, '0000-00-00', ...
+				return null;
+			}
+			$time = new DateTime($time);
+		}
+		return $format === null ? $time : $time->format($format);
+	}
+
+
+	public function __get($key)
+	{
+		$hint = Helpers::getSuggestion(array_keys((array) $this), $key);
+		trigger_error("Attempt to read missing column '$key'" . ($hint ? ", did you mean '$hint'?" : '.'), E_USER_NOTICE);
+	}
+
+
+	/********************* 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);
+	}
+}

src/Dibi/Strict.php

@@ -0,0 +1,151 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi;
+
+use ReflectionClass;
+use ReflectionMethod;
+use ReflectionProperty;
+
+
+/**
+ * Better OOP experience.
+ */
+trait Strict
+{
+	/** @var array [method => [type => callback]] */
+	private static $extMethods;
+
+
+	/**
+	 * Call to undefined method.
+	 * @throws \LogicException
+	 */
+	public function __call($name, $args)
+	{
+		if ($cb = self::extensionMethod(get_class($this) . '::' . $name)) { // back compatiblity
+			array_unshift($args, $this);
+			return call_user_func_array($cb, $args);
+		}
+		$class = method_exists($this, $name) ? 'parent' : get_class($this);
+		$items = (new ReflectionClass($this))->getMethods(ReflectionMethod::IS_PUBLIC);
+		$hint = ($t = Helpers::getSuggestion($items, $name)) ? ", did you mean $t()?" : '.';
+		throw new \LogicException("Call to undefined method $class::$name()$hint");
+	}
+
+
+	/**
+	 * Call to undefined static method.
+	 * @throws \LogicException
+	 */
+	public static function __callStatic($name, $args)
+	{
+		$rc = new ReflectionClass(get_called_class());
+		$items = array_intersect($rc->getMethods(ReflectionMethod::IS_PUBLIC), $rc->getMethods(ReflectionMethod::IS_STATIC));
+		$hint = ($t = Helpers::getSuggestion($items, $name)) ? ", did you mean $t()?" : '.';
+		throw new \LogicException("Call to undefined static method {$rc->getName()}::$name()$hint");
+	}
+
+
+	/**
+	 * Access to undeclared property.
+	 * @throws \LogicException
+	 */
+	public function &__get($name)
+	{
+		if ((method_exists($this, $m = 'get' . $name) || method_exists($this, $m = 'is' . $name))
+			&& (new ReflectionMethod($this, $m))->isPublic()
+		) { // back compatiblity
+			$ret = $this->$m();
+			return $ret;
+		}
+		$rc = new ReflectionClass($this);
+		$items = array_diff($rc->getProperties(ReflectionProperty::IS_PUBLIC), $rc->getProperties(ReflectionProperty::IS_STATIC));
+		$hint = ($t = Helpers::getSuggestion($items, $name)) ? ", did you mean $$t?" : '.';
+		throw new \LogicException("Attempt to read undeclared property {$rc->getName()}::$$name$hint");
+	}
+
+
+	/**
+	 * Access to undeclared property.
+	 * @throws \LogicException
+	 */
+	public function __set($name, $value)
+	{
+		$rc = new ReflectionClass($this);
+		$items = array_diff($rc->getProperties(ReflectionProperty::IS_PUBLIC), $rc->getProperties(ReflectionProperty::IS_STATIC));
+		$hint = ($t = Helpers::getSuggestion($items, $name)) ? ", did you mean $$t?" : '.';
+		throw new \LogicException("Attempt to write to undeclared property {$rc->getName()}::$$name$hint");
+	}
+
+
+	/**
+	 * @return bool
+	 */
+	public function __isset($name)
+	{
+		return false;
+	}
+
+
+	/**
+	 * Access to undeclared property.
+	 * @throws \LogicException
+	 */
+	public function __unset($name)
+	{
+		$class = get_class($this);
+		throw new \LogicException("Attempt to unset undeclared property $class::$$name.");
+	}
+
+
+	/**
+	 * @param  string  method name
+	 * @param  callable
+	 * @return mixed
+	 */
+	public static function extensionMethod($name, $callback = null)
+	{
+		if (strpos($name, '::') === false) {
+			$class = get_called_class();
+		} else {
+			list($class, $name) = explode('::', $name);
+			$class = (new ReflectionClass($class))->getName();
+		}
+
+		if (self::$extMethods === null) { // for backwards compatibility
+			$list = get_defined_functions();
+			foreach ($list['user'] as $fce) {
+				$pair = explode('_prototype_', $fce);
+				if (count($pair) === 2) {
+					trigger_error("Extension method defined as $fce() is deprecated, use $class::extensionMethod('$name', ...).", E_USER_DEPRECATED);
+					self::$extMethods[$pair[1]][(new ReflectionClass($pair[0]))->getName()] = $fce;
+					self::$extMethods[$pair[1]][''] = null;
+				}
+			}
+		}
+
+		$list = &self::$extMethods[strtolower($name)];
+		if ($callback === null) { // getter
+			$cache = &$list[''][$class];
+			if (isset($cache)) {
+				return $cache;
+			}
+
+			foreach ([$class] + class_parents($class) + class_implements($class) as $cl) {
+				if (isset($list[$cl])) {
+					return $cache = $list[$cl];
+				}
+			}
+			return $cache = false;
+
+		} else { // setter
+			$list[$class] = $callback;
+			$list[''] = null;
+		}
+	}
+}

src/Dibi/Translator.php

@@ -0,0 +1,624 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi;
+
+
+/**
+ * SQL translator.
+ */
+final class Translator
+{
+	use Strict;
+
+	/** @var Connection */
+	private $connection;
+
+	/** @var Driver */
+	private $driver;
+
+	/** @var int */
+	private $cursor = 0;
+
+	/** @var array */
+	private $args;
+
+	/** @var string[] */
+	private $errors;
+
+	/** @var bool */
+	private $comment = false;
+
+	/** @var int */
+	private $ifLevel = 0;
+
+	/** @var int */
+	private $ifLevelStart = 0;
+
+	/** @var int|null */
+	private $limit;
+
+	/** @var int|null */
+	private $offset;
+
+	/** @var HashMap */
+	private $identifiers;
+
+
+	public function __construct(Connection $connection)
+	{
+		$this->connection = $connection;
+		$this->driver = $connection->getDriver();
+		$this->identifiers = new HashMap([$this, 'delimite']);
+	}
+
+
+	/**
+	 * Generates SQL. Can be called only once.
+	 * @param  array
+	 * @return string
+	 * @throws Exception
+	 */
+	public function translate(array $args)
+	{
+		$args = array_values($args);
+		while (count($args) === 1 && is_array($args[0])) { // implicit array expansion
+			$args = array_values($args[0]);
+		}
+		$this->args = $args;
+		$this->errors = [];
+
+		$commandIns = null;
+		$lastArr = null;
+		$cursor = &$this->cursor;
+		$comment = &$this->comment;
+
+		// iterate
+		$sql = [];
+		while ($cursor < count($this->args)) {
+			$arg = $this->args[$cursor];
+			$cursor++;
+
+			// simple string means SQL
+			if (is_string($arg)) {
+				// speed-up - is regexp required?
+				$toSkip = strcspn($arg, '`[\'":%?');
+
+				if (strlen($arg) === $toSkip) { // needn't be translated
+					$sql[] = $arg;
+				} else {
+					$sql[] = substr($arg, 0, $toSkip)
+/*
+					. preg_replace_callback('/
+					(?=[`[\'":%?])                    ## speed-up
+					(?:
+						`(.+?)`|                     ## 1) `identifier`
+						\[(.+?)\]|                   ## 2) [identifier]
+						(\')((?:\'\'|[^\'])*)\'|     ## 3,4) 'string'
+						(")((?:""|[^"])*)"|          ## 5,6) "string"
+						(\'|")|                      ## 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('/(?=[`[\'":%?])(?:`(.+?)`|\[(.+?)\]|(\')((?:\'\'|[^\'])*)\'|(")((?:""|[^"])*)"|(\'|")|:(\S*?:)([a-zA-Z0-9._]?)|%([a-zA-Z~][a-zA-Z0-9~]{0,5})|(\?))/s',
+							[$this, 'cb'],
+							substr($arg, $toSkip)
+					);
+					if (preg_last_error()) {
+						throw new PcreException;
+					}
+				}
+				continue;
+			}
+
+			if ($comment) {
+				$sql[] = '...';
+				continue;
+			}
+
+			if ($arg instanceof \Traversable) {
+				$arg = iterator_to_array($arg);
+			}
+
+			if (is_array($arg) && is_string(key($arg))) {
+				// associative array -> autoselect between SET or VALUES & LIST
+				if ($commandIns === null) {
+					$commandIns = strtoupper(substr(ltrim($this->args[0]), 0, 6));
+					$commandIns = $commandIns === 'INSERT' || $commandIns === 'REPLAC';
+					$sql[] = $this->formatValue($arg, $commandIns ? 'v' : 'a');
+				} else {
+					if ($lastArr === $cursor - 1) {
+						$sql[] = ',';
+					}
+					$sql[] = $this->formatValue($arg, $commandIns ? 'l' : 'a');
+				}
+				$lastArr = $cursor;
+				continue;
+			}
+
+			// default processing
+			$sql[] = $this->formatValue($arg, false);
+		} // while
+
+
+		if ($comment) {
+			$sql[] = '*/';
+		}
+
+		$sql = implode(' ', $sql);
+
+		if ($this->errors) {
+			throw new Exception('SQL translate error: ' . trim(reset($this->errors), '*'), 0, $sql);
+		}
+
+		// apply limit
+		if ($this->limit !== null || $this->offset !== null) {
+			$this->driver->applyLimit($sql, $this->limit, $this->offset);
+		}
+
+		return $sql;
+	}
+
+
+	/**
+	 * Apply modifier to single value.
+	 * @param  mixed
+	 * @param  string
+	 * @return string
+	 */
+	public function formatValue($value, $modifier)
+	{
+		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 = [];
+			switch ($modifier) {
+				case 'and':
+				case 'or':  // key=val AND key IS NULL AND ...
+					if (empty($value)) {
+						return '1=1';
+					}
+
+					foreach ($value as $k => $v) {
+						if (is_string($k)) {
+							$pair = explode('%', $k, 2); // split into identifier & modifier
+							$k = $this->identifiers->{$pair[0]} . ' ';
+							if (!isset($pair[1])) {
+								$v = $this->formatValue($v, false);
+								$vx[] = $k . ($v === 'NULL' ? 'IS ' : '= ') . $v;
+
+							} elseif ($pair[1] === 'ex') {
+								$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(') ' . 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->driver->escapeIdentifier($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->identifiers->{$pair[0]} . '='
+							. $this->formatValue($v, isset($pair[1]) ? $pair[1] : (is_array($v) ? 'ex' : false));
+					}
+					return implode(', ', $vx);
+
+
+				case 'in':// replaces scalar %in modifier!
+				case 'l': // (val, val, ...)
+					foreach ($value as $k => $v) {
+						$pair = explode('%', (string) $k, 2); // split into identifier & modifier
+						$vx[] = $this->formatValue($v, isset($pair[1]) ? $pair[1] : (is_array($v) ? 'ex' : false));
+					}
+					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->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)) {
+									return $this->errors[] = '**Multi-insert array "' . $k . '" is different**';
+								}
+							} else {
+								$proto = array_keys($v);
+							}
+						} else {
+							return $this->errors[] = '**Unexpected type ' . (is_object($v) ? get_class($v) : 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_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->identifiers->$k . ' ' . $v;
+						} else {
+							$vx[] = $this->identifiers->$v;
+						}
+					}
+					return implode(', ', $vx);
+
+				case 'ex':
+				case 'sql':
+					return call_user_func_array([$this->connection, 'translate'], $value);
+
+				default:  // value, value, value - all with the same modifier
+					foreach ($value as $v) {
+						$vx[] = $this->formatValue($v, $modifier);
+					}
+					return implode(', ', $vx);
+			}
+		}
+
+
+		// with modifier procession
+		if ($modifier) {
+			if ($value !== null && !is_scalar($value)) {  // array is already processed
+				if ($value instanceof Literal && ($modifier === 'sql' || $modifier === 'SQL')) {
+					return (string) $value;
+
+				} elseif ($value instanceof Expression && $modifier === 'ex') {
+					return call_user_func_array([$this->connection, 'translate'], $value->getValues());
+
+				} elseif (($value instanceof \DateTime || $value instanceof \DateTimeInterface) && ($modifier === 'd' || $modifier === 't' || $modifier === 'dt')) {
+					// continue
+				} else {
+					$type = is_object($value) ? get_class($value) : gettype($value);
+					return $this->errors[] = "**Invalid combination of type $type and modifier %$modifier**";
+				}
+			}
+
+			switch ($modifier) {
+				case 's':  // string
+					return $value === null ? 'NULL' : $this->driver->escapeText((string) $value);
+
+				case 'bin':// binary
+					return $value === null ? 'NULL' : $this->driver->escapeBinary($value);
+
+				case 'b':  // boolean
+					return $value === null ? 'NULL' : $this->driver->escapeBool($value);
+
+				case 'sN': // string or null
+				case 'sn':
+					return $value == '' ? 'NULL' : $this->driver->escapeText((string) $value); // notice two equal signs
+
+				case 'in': // deprecated
+					trigger_error('Modifier %in is deprecated, use %iN.', E_USER_DEPRECATED);
+					// break omitted
+				case 'iN': // signed int or null
+					if ($value == '') {
+						$value = null;
+					}
+					// break omitted
+				case 'i':  // signed int
+				case 'u':  // unsigned int, ignored
+					if ($value === null) {
+						return 'NULL';
+					} elseif (is_string($value)) {
+						if (preg_match('#[+-]?\d++(?:e\d+)?\z#A', $value)) {
+							return $value; // support for long numbers - keep them unchanged
+						} elseif (substr($value, 1, 1) === 'x' && is_numeric($value)) {
+							trigger_error('Support for hex strings has been deprecated.', E_USER_DEPRECATED);
+							return (string) hexdec($value);
+						} else {
+							throw new Exception("Expected number, '$value' given.");
+						}
+					} else {
+						return (string) (int) $value;
+					}
+					// break omitted
+				case 'f':  // float
+					if ($value === null) {
+						return 'NULL';
+					} elseif (is_string($value)) {
+						if (is_numeric($value) && substr($value, 1, 1) !== 'x') {
+							return $value; // support for long numbers - keep them unchanged
+						} else {
+							throw new Exception("Expected number, '$value' given.");
+						}
+					} else {
+						return rtrim(rtrim(number_format($value + 0, 10, '.', ''), '0'), '.');
+					}
+					// break omitted
+				case 'd':  // date
+				case 't':  // datetime
+				case 'dt': // datetime
+					if ($value === null) {
+						return 'NULL';
+					} else {
+						return $modifier === 'd' ? $this->driver->escapeDate($value) : $this->driver->escapeDateTime($value);
+					}
+					// break omitted
+				case 'by':
+				case 'n':  // composed identifier name
+					return $this->identifiers->$value;
+
+				case 'N':  // identifier name
+					return $this->driver->escapeIdentifier($value);
+
+				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) {
+						$value = substr($value, 0, $toSkip)
+						. preg_replace_callback(
+							'/(?=[`[\'":])(?:`(.+?)`|\[(.+?)\]|(\')((?:\'\'|[^\'])*)\'|(")((?:""|[^"])*)"|(\'|")|:(\S*?:)([a-zA-Z0-9._]?))/s',
+							[$this, 'cb'],
+							substr($value, $toSkip)
+						);
+						if (preg_last_error()) {
+							throw new PcreException;
+						}
+					}
+					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':
+				case 'a':
+				case 'l':
+				case 'v':
+					$type = gettype($value);
+					return $this->errors[] = "**Invalid combination of type $type and modifier %$modifier**";
+
+				default:
+					return $this->errors[] = "**Unknown or unexpected modifier %$modifier**";
+			}
+		}
+
+
+		// without modifier procession
+		if (is_string($value)) {
+			return $this->driver->escapeText($value);
+
+		} elseif (is_int($value)) {
+			return (string) $value;
+
+		} elseif (is_float($value)) {
+			return rtrim(rtrim(number_format($value, 10, '.', ''), '0'), '.');
+
+		} elseif (is_bool($value)) {
+			return $this->driver->escapeBool($value);
+
+		} elseif ($value === null) {
+			return 'NULL';
+
+		} elseif ($value instanceof \DateTime || $value instanceof \DateTimeInterface) {
+			return $this->driver->escapeDateTime($value);
+
+		} elseif ($value instanceof Literal) {
+			return (string) $value;
+
+		} elseif ($value instanceof Expression) {
+			return call_user_func_array([$this->connection, 'translate'], $value->getValues());
+
+		} else {
+			$type = is_object($value) ? get_class($value) : gettype($value);
+			return $this->errors[] = "**Unexpected $type**";
+		}
+	}
+
+
+	/**
+	 * PREG callback from translate() or formatValue().
+	 * @param  array
+	 * @return string
+	 */
+	private function cb($matches)
+	{
+		//    [1] => `ident`
+		//    [2] => [ident]
+		//    [3] => '
+		//    [4] => string
+		//    [5] => "
+		//    [6] => string
+		//    [7] => lone-quote
+		//    [8] => substitution
+		//    [9] => substitution flag
+		//    [10] => modifier (when called from self::translate())
+		//    [11] => placeholder (when called from self::translate())
+
+
+		if (!empty($matches[11])) { // placeholder
+			$cursor = &$this->cursor;
+
+			if ($cursor >= count($this->args)) {
+				return $this->errors[] = '**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') {
+				return $this->errors[] = "**Extra modifier %$mod**";
+			}
+
+			if ($mod === 'if') {
+				$this->ifLevel++;
+				$cursor++;
+				if (!$this->comment && !$this->args[$cursor - 1]) {
+					// open comment
+					$this->ifLevelStart = $this->ifLevel;
+					$this->comment = true;
+					return '/*';
+				}
+				return '';
+
+			} elseif ($mod === 'else') {
+				if ($this->ifLevelStart === $this->ifLevel) {
+					$this->ifLevelStart = 0;
+					$this->comment = false;
+					return '*/';
+				} elseif (!$this->comment) {
+					$this->ifLevelStart = $this->ifLevel;
+					$this->comment = true;
+					return '/*';
+				}
+
+			} elseif ($mod === 'end') {
+				$this->ifLevel--;
+				if ($this->ifLevelStart === $this->ifLevel + 1) {
+					// close comment
+					$this->ifLevelStart = 0;
+					$this->comment = false;
+					return '*/';
+				}
+				return '';
+
+			} elseif ($mod === 'ex') { // array expansion
+				array_splice($this->args, $cursor, 1, $this->args[$cursor]);
+				return '';
+
+			} elseif ($mod === 'lmt') { // apply limit
+				$arg = $this->args[$cursor++];
+				if ($arg === null) {
+				} elseif ($this->comment) {
+					return "(limit $arg)";
+				} else {
+					$this->limit = Helpers::intVal($arg);
+				}
+				return '';
+
+			} elseif ($mod === 'ofs') { // apply offset
+				$arg = $this->args[$cursor++];
+				if ($arg === null) {
+				} elseif ($this->comment) {
+					return "(offset $arg)";
+				} else {
+					$this->offset = Helpers::intVal($arg);
+				}
+				return '';
+
+			} else { // default processing
+				$cursor++;
+				return $this->formatValue($this->args[$cursor - 1], $mod);
+			}
+		}
+
+		if ($this->comment) {
+			return '...';
+		}
+
+		if ($matches[1]) { // SQL identifiers: `ident`
+			return $this->identifiers->{$matches[1]};
+
+		} elseif ($matches[2]) { // SQL identifiers: [ident]
+			return $this->identifiers->{$matches[2]};
+
+		} elseif ($matches[3]) { // SQL strings: '...'
+			return $this->driver->escapeText(str_replace("''", "'", $matches[4]));
+
+		} elseif ($matches[5]) { // SQL strings: "..."
+			return $this->driver->escapeText(str_replace('""', '"', $matches[6]));
+
+		} elseif ($matches[7]) { // string quote
+			return $this->errors[] = '**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
+		}
+
+		throw new \Exception('this should be never executed');
+	}
+
+
+	/**
+	 * Apply substitutions to indentifier and delimites it.
+	 * @param  string indentifier
+	 * @return string
+	 * @internal
+	 */
+	public function delimite($value)
+	{
+		$value = $this->connection->substitute($value);
+		$parts = explode('.', $value);
+		foreach ($parts as &$v) {
+			if ($v !== '*') {
+				$v = $this->driver->escapeIdentifier($v);
+			}
+		}
+		return implode('.', $parts);
+	}
+}

src/Dibi/Type.php

@@ -0,0 +1,32 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi;
+
+
+/**
+ * Data types.
+ */
+class Type
+{
+	const
+		TEXT = 's', // as 'string'
+		BINARY = 'bin',
+		BOOL = 'b',
+		INTEGER = 'i',
+		FLOAT = 'f',
+		DATE = 'd',
+		DATETIME = 'dt',
+		TIME = 't',
+		TIME_INTERVAL = 'ti';
+
+
+	final public function __construct()
+	{
+		throw new \LogicException('Cannot instantiate static class ' . __CLASS__);
+	}
+}

src/Dibi/dibi.php

@@ -0,0 +1,461 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+use Dibi\Type;
+
+
+/**
+ * Static container class for Dibi connections.
+ */
+class dibi
+{
+	use Dibi\Strict;
+
+	const
+		AFFECTED_ROWS = 'a',
+		IDENTIFIER = 'n';
+
+	/** version */
+	const
+		VERSION = '3.2.4',
+		REVISION = 'released on 2020-03-26';
+
+	/** sorting order */
+	const
+		ASC = 'ASC',
+		DESC = 'DESC';
+
+	/** @deprecated */
+	const
+		TEXT = Type::TEXT,
+		BINARY = Type::BINARY,
+		BOOL = Type::BOOL,
+		INTEGER = Type::INTEGER,
+		FLOAT = Type::FLOAT,
+		DATE = Type::DATE,
+		DATETIME = Type::DATETIME,
+		TIME = Type::TIME,
+		FIELD_TEXT = Type::TEXT,
+		FIELD_BINARY = Type::BINARY,
+		FIELD_BOOL = Type::BOOL,
+		FIELD_INTEGER = Type::INTEGER,
+		FIELD_FLOAT = Type::FLOAT,
+		FIELD_DATE = Type::DATE,
+		FIELD_DATETIME = Type::DATETIME,
+		FIELD_TIME = Type::TIME;
+
+	/** @var string|null  Last SQL command @see dibi::query() */
+	public static $sql;
+
+	/** @var float|null  Elapsed time for last query */
+	public static $elapsedTime;
+
+	/** @var float  Elapsed time for all queries */
+	public static $totalTime;
+
+	/** @var int  Number or queries */
+	public static $numOfQueries = 0;
+
+	/** @var string  Default dibi driver */
+	public static $defaultDriver = 'mysqli';
+
+	/** @var Dibi\Connection[]  Connection registry storage for Dibi\Connection objects */
+	private static $registry = [];
+
+	/** @var Dibi\Connection  Current connection */
+	private static $connection;
+
+
+	/**
+	 * Static class - cannot be instantiated.
+	 */
+	final public function __construct()
+	{
+		throw new LogicException('Cannot instantiate static class ' . get_class($this));
+	}
+
+
+	/********************* connections handling ****************d*g**/
+
+
+	/**
+	 * Creates a new Connection object and connects it to specified database.
+	 * @param  array|string   connection parameters
+	 * @param  string  connection name
+	 * @return Dibi\Connection
+	 * @throws Dibi\Exception
+	 */
+	public static function connect($config = [], $name = '0')
+	{
+		return self::$connection = self::$registry[$name] = new Dibi\Connection($config, $name);
+	}
+
+
+	/**
+	 * Disconnects from database (doesn't destroy Connection object).
+	 * @return void
+	 */
+	public static function disconnect()
+	{
+		self::getConnection()->disconnect();
+	}
+
+
+	/**
+	 * Returns true when connection was established.
+	 * @return bool
+	 */
+	public static function isConnected()
+	{
+		return (self::$connection !== null) && self::$connection->isConnected();
+	}
+
+
+	/**
+	 * Retrieve active connection.
+	 * @param  string   connection registy name
+	 * @return Dibi\Connection
+	 * @throws Dibi\Exception
+	 */
+	public static function getConnection($name = null)
+	{
+		if ($name === null) {
+			if (self::$connection === null) {
+				throw new Dibi\Exception('Dibi is not connected to database.');
+			}
+
+			return self::$connection;
+		}
+
+		if (!isset(self::$registry[$name])) {
+			throw new Dibi\Exception("There is no connection named '$name'.");
+		}
+
+		return self::$registry[$name];
+	}
+
+
+	/**
+	 * Sets connection.
+	 * @param  Dibi\Connection
+	 * @return Dibi\Connection
+	 */
+	public static function setConnection(Dibi\Connection $connection)
+	{
+		return self::$connection = $connection;
+	}
+
+
+	/**
+	 * @deprecated
+	 */
+	public static function activate($name)
+	{
+		trigger_error(__METHOD__ . '() is deprecated.', E_USER_DEPRECATED);
+		self::$connection = self::getConnection($name);
+	}
+
+
+	/********************* monostate for active connection ****************d*g**/
+
+
+	/**
+	 * Generates and executes SQL query - Monostate for Dibi\Connection::query().
+	 * @param  array|mixed      one or more arguments
+	 * @return Dibi\Result|int   result set or number of affected rows
+	 * @throws Dibi\Exception
+	 */
+	public static function query($args)
+	{
+		$args = func_get_args();
+		return self::getConnection()->query($args);
+	}
+
+
+	/**
+	 * Executes the SQL query - Monostate for Dibi\Connection::nativeQuery().
+	 * @param  string           SQL statement.
+	 * @return Dibi\Result|int   result set or number of affected rows
+	 */
+	public static function nativeQuery($sql)
+	{
+		return self::getConnection()->nativeQuery($sql);
+	}
+
+
+	/**
+	 * Generates and prints SQL query - Monostate for Dibi\Connection::test().
+	 * @param  array|mixed  one or more arguments
+	 * @return bool
+	 */
+	public static function test($args)
+	{
+		$args = func_get_args();
+		return self::getConnection()->test($args);
+	}
+
+
+	/**
+	 * Generates and returns SQL query as DataSource - Monostate for Dibi\Connection::test().
+	 * @param  array|mixed      one or more arguments
+	 * @return Dibi\DataSource
+	 */
+	public static function dataSource($args)
+	{
+		$args = func_get_args();
+		return self::getConnection()->dataSource($args);
+	}
+
+
+	/**
+	 * Executes SQL query and fetch result - Monostate for Dibi\Connection::query() & fetch().
+	 * @param  array|mixed    one or more arguments
+	 * @return Dibi\Row
+	 * @throws Dibi\Exception
+	 */
+	public static function fetch($args)
+	{
+		$args = func_get_args();
+		return self::getConnection()->query($args)->fetch();
+	}
+
+
+	/**
+	 * Executes SQL query and fetch results - Monostate for Dibi\Connection::query() & fetchAll().
+	 * @param  array|mixed    one or more arguments
+	 * @return Dibi\Row[]
+	 * @throws Dibi\Exception
+	 */
+	public static function fetchAll($args)
+	{
+		$args = func_get_args();
+		return self::getConnection()->query($args)->fetchAll();
+	}
+
+
+	/**
+	 * Executes SQL query and fetch first column - Monostate for Dibi\Connection::query() & fetchSingle().
+	 * @param  array|mixed    one or more arguments
+	 * @return mixed
+	 * @throws Dibi\Exception
+	 */
+	public static function fetchSingle($args)
+	{
+		$args = func_get_args();
+		return self::getConnection()->query($args)->fetchSingle();
+	}
+
+
+	/**
+	 * Executes SQL query and fetch pairs - Monostate for Dibi\Connection::query() & fetchPairs().
+	 * @param  array|mixed    one or more arguments
+	 * @return array
+	 * @throws Dibi\Exception
+	 */
+	public static function fetchPairs($args)
+	{
+		$args = func_get_args();
+		return self::getConnection()->query($args)->fetchPairs();
+	}
+
+
+	/**
+	 * Gets the number of affected rows.
+	 * Monostate for Dibi\Connection::getAffectedRows()
+	 * @return int  number of rows
+	 * @throws Dibi\Exception
+	 */
+	public static function getAffectedRows()
+	{
+		return self::getConnection()->getAffectedRows();
+	}
+
+
+	/**
+	 * @deprecated
+	 */
+	public static function affectedRows()
+	{
+		trigger_error(__METHOD__ . '() is deprecated, use getAffectedRows()', E_USER_DEPRECATED);
+		return self::getConnection()->getAffectedRows();
+	}
+
+
+	/**
+	 * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query.
+	 * Monostate for Dibi\Connection::getInsertId()
+	 * @param  string     optional sequence name
+	 * @return int
+	 * @throws Dibi\Exception
+	 */
+	public static function getInsertId($sequence = null)
+	{
+		return self::getConnection()->getInsertId($sequence);
+	}
+
+
+	/**
+	 * @deprecated
+	 */
+	public static function insertId($sequence = null)
+	{
+		trigger_error(__METHOD__ . '() is deprecated, use getInsertId()', E_USER_DEPRECATED);
+		return self::getConnection()->getInsertId($sequence);
+	}
+
+
+	/**
+	 * Begins a transaction - Monostate for Dibi\Connection::begin().
+	 * @param  string  optional savepoint name
+	 * @return void
+	 * @throws Dibi\Exception
+	 */
+	public static function begin($savepoint = null)
+	{
+		self::getConnection()->begin($savepoint);
+	}
+
+
+	/**
+	 * Commits statements in a transaction - Monostate for Dibi\Connection::commit($savepoint = null).
+	 * @param  string  optional savepoint name
+	 * @return void
+	 * @throws Dibi\Exception
+	 */
+	public static function commit($savepoint = null)
+	{
+		self::getConnection()->commit($savepoint);
+	}
+
+
+	/**
+	 * Rollback changes in a transaction - Monostate for Dibi\Connection::rollback().
+	 * @param  string  optional savepoint name
+	 * @return void
+	 * @throws Dibi\Exception
+	 */
+	public static function rollback($savepoint = null)
+	{
+		self::getConnection()->rollback($savepoint);
+	}
+
+
+	/**
+	 * Gets a information about the current database - Monostate for Dibi\Connection::getDatabaseInfo().
+	 * @return Dibi\Reflection\Database
+	 */
+	public static function getDatabaseInfo()
+	{
+		return self::getConnection()->getDatabaseInfo();
+	}
+
+
+	/**
+	 * Import SQL dump from file - extreme fast!
+	 * @param  string  filename
+	 * @return int  count of sql commands
+	 */
+	public static function loadFile($file)
+	{
+		return Dibi\Helpers::loadFromFile(self::getConnection(), $file);
+	}
+
+
+	/********************* fluent SQL builders ****************d*g**/
+
+
+	/**
+	 * @return Dibi\Fluent
+	 */
+	public static function command()
+	{
+		return self::getConnection()->command();
+	}
+
+
+	/**
+	 * @param  mixed    column name
+	 * @return Dibi\Fluent
+	 */
+	public static function select($args)
+	{
+		$args = func_get_args();
+		return call_user_func_array([self::getConnection(), 'select'], $args);
+	}
+
+
+	/**
+	 * @param  string   table
+	 * @param  array
+	 * @return Dibi\Fluent
+	 */
+	public static function update($table, $args)
+	{
+		return self::getConnection()->update($table, $args);
+	}
+
+
+	/**
+	 * @param  string   table
+	 * @param  array
+	 * @return Dibi\Fluent
+	 */
+	public static function insert($table, $args)
+	{
+		return self::getConnection()->insert($table, $args);
+	}
+
+
+	/**
+	 * @param  string   table
+	 * @return Dibi\Fluent
+	 */
+	public static function delete($table)
+	{
+		return self::getConnection()->delete($table);
+	}
+
+
+	/********************* substitutions ****************d*g**/
+
+
+	/**
+	 * Returns substitution hashmap - Monostate for Dibi\Connection::getSubstitutes().
+	 * @return Dibi\HashMap
+	 */
+	public static function getSubstitutes()
+	{
+		return self::getConnection()->getSubstitutes();
+	}
+
+
+	/********************* misc tools ****************d*g**/
+
+
+	/**
+	 * Prints out a syntax highlighted version of the SQL command or Result.
+	 * @param  string|Result
+	 * @param  bool  return output instead of printing it?
+	 * @return string|null
+	 */
+	public static function dump($sql = null, $return = false)
+	{
+		return Dibi\Helpers::dump($sql, $return);
+	}
+
+
+	/**
+	 * Strips microseconds part.
+	 * @param  \DateTime|\DateTimeInterface
+	 * @return \DateTime|\DateTimeInterface
+	 */
+	public static function stripMicroseconds($dt)
+	{
+		$class = get_class($dt);
+		return new $class($dt->format('Y-m-d H:i:s'), $dt->getTimezone());
+	}
+}

src/Dibi/exceptions.php

@@ -0,0 +1,153 @@
+<?php
+
+/**
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
+ */
+
+namespace Dibi;
+
+
+/**
+ * Dibi common exception.
+ */
+class Exception extends \Exception
+{
+	/** @var string|null */
+	private $sql;
+
+
+	/**
+	 * @param  string  Message describing the exception
+	 * @param  string|int
+	 * @param  string  SQL command
+	 * @param  \Exception
+	 */
+	public function __construct($message = '', $code = 0, $sql = null, \Exception $previous = null)
+	{
+		parent::__construct($message, 0, $previous);
+		$this->code = $code;
+		$this->sql = $sql;
+	}
+
+
+	/**
+	 * @return string  The SQL passed to the constructor
+	 */
+	final public function getSql()
+	{
+		return $this->sql;
+	}
+
+
+	/**
+	 * @return string  string represenation of exception with SQL command
+	 */
+	public function __toString()
+	{
+		return parent::__toString() . ($this->sql ? "\nSQL: " . $this->sql : '');
+	}
+}
+
+
+/**
+ * database server exception.
+ */
+class DriverException extends Exception
+{
+}
+
+
+/**
+ * PCRE exception.
+ */
+class PcreException extends Exception
+{
+	public function __construct($message = '%msg.')
+	{
+		static $messages = [
+			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);
+	}
+}
+
+
+class NotImplementedException extends Exception
+{
+}
+
+
+class NotSupportedException extends Exception
+{
+}
+
+
+/**
+ * Database procedure exception.
+ */
+class ProcedureException extends Exception
+{
+	/** @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 = '', $code = 0, $severity = '', $sql = null)
+	{
+		parent::__construct($message, (int) $code, $sql);
+		$this->severity = $severity;
+	}
+
+
+	/**
+	 * Gets the exception severity.
+	 * @return string
+	 */
+	public function getSeverity()
+	{
+		return $this->severity;
+	}
+}
+
+
+/**
+ * Base class for all constraint violation related exceptions.
+ */
+class ConstraintViolationException extends DriverException
+{
+}
+
+
+/**
+ * Exception for a foreign key constraint violation.
+ */
+class ForeignKeyConstraintViolationException extends ConstraintViolationException
+{
+}
+
+
+/**
+ * Exception for a NOT NULL constraint violation.
+ */
+class NotNullConstraintViolationException extends ConstraintViolationException
+{
+}
+
+
+/**
+ * Exception for a unique constraint violation.
+ */
+class UniqueConstraintViolationException extends ConstraintViolationException
+{
+}

src/Dibi/interfaces.php

@@ -1,67 +1,60 @@
 <?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.
+ * This file is part of the Dibi, smart database abstraction layer (https://dibiphp.com)
+ * Copyright (c) 2005 David Grudl (https://davidgrudl.com)
  */
 
+namespace Dibi;
 
 
 /**
  * Provides an interface between a dataset and data-aware components.
- * @package    dibi
  */
-interface IDataSource extends Countable, IteratorAggregate
+interface IDataSource extends \Countable, \IteratorAggregate
 {
-	//function IteratorAggregate::getIterator();
-	//function Countable::count();
+	//function \IteratorAggregate::getIterator();
+	//function \Countable::count();
 }
 
 
-
 /**
- * dibi driver interface.
- * @package    dibi
+ * Driver interface.
  */
-interface IDibiDriver
+interface Driver
 {
-
 	/**
 	 * Connects to a database.
 	 * @param  array
 	 * @return void
-	 * @throws DibiException
+	 * @throws Exception
 	 */
 	function connect(array &$config);
 
 	/**
 	 * Disconnects from a database.
 	 * @return void
-	 * @throws DibiException
+	 * @throws Exception
 	 */
 	function disconnect();
 
 	/**
 	 * Internal: Executes the SQL query.
 	 * @param  string      SQL statement.
-	 * @return IDibiResultDriver|NULL
-	 * @throws DibiDriverException
+	 * @return ResultDriver|null
+	 * @throws DriverException
 	 */
 	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
+	 * @return int|false  number of rows or false on error
 	 */
 	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
+	 * @return int|false  int on success or false on failure
 	 */
 	function getInsertId($sequence);
 
@@ -69,25 +62,25 @@ interface IDibiDriver
 	 * Begins a transaction (if supported).
 	 * @param  string  optional savepoint name
 	 * @return void
-	 * @throws DibiDriverException
+	 * @throws DriverException
 	 */
-	function begin($savepoint = NULL);
+	function begin($savepoint = null);
 
 	/**
 	 * Commits statements in a transaction.
 	 * @param  string  optional savepoint name
 	 * @return void
-	 * @throws DibiDriverException
+	 * @throws DriverException
 	 */
-	function commit($savepoint = NULL);
+	function commit($savepoint = null);
 
 	/**
 	 * Rollback changes in a transaction.
 	 * @param  string  optional savepoint name
 	 * @return void
-	 * @throws DibiDriverException
+	 * @throws DriverException
 	 */
-	function rollback($savepoint = NULL);
+	function rollback($savepoint = null);
 
 	/**
 	 * Returns the connection resource.
@@ -97,18 +90,46 @@ interface IDibiDriver
 
 	/**
 	 * Returns the connection reflector.
-	 * @return IDibiReflector
+	 * @return Reflector
 	 */
 	function getReflector();
 
 	/**
 	 * Encodes data for use in a SQL statement.
 	 * @param  string    value
-	 * @param  string    type (dibi::TEXT, dibi::BOOL, ...)
 	 * @return string    encoded value
-	 * @throws InvalidArgumentException
 	 */
-	function escape($value, $type);
+	function escapeText($value);
+
+	/**
+	 * @param  string
+	 * @return string
+	 */
+	function escapeBinary($value);
+
+	/**
+	 * @param  string
+	 * @return string
+	 */
+	function escapeIdentifier($value);
+
+	/**
+	 * @param  bool
+	 * @return string
+	 */
+	function escapeBool($value);
+
+	/**
+	 * @param  \DateTime|\DateTimeInterface|string|int
+	 * @return string
+	 */
+	function escapeDate($value);
+
+	/**
+	 * @param  \DateTime|\DateTimeInterface|string|int
+	 * @return string
+	 */
+	function escapeDateTime($value);
 
 	/**
 	 * Encodes string for use in a LIKE statement.
@@ -120,26 +141,20 @@ interface IDibiDriver
 
 	/**
 	 * Injects LIMIT/OFFSET to the SQL query.
-	 * @param  string &$sql  The SQL query that will be modified.
-	 * @param  int $limit
-	 * @param  int $offset
+	 * @param  string
+	 * @param  int|null
+	 * @param  int|null
 	 * @return void
 	 */
 	function applyLimit(&$sql, $limit, $offset);
-
 }
 
 
-
-
-
 /**
- * dibi result set driver interface.
- * @package    dibi
+ * Result set driver interface.
  */
-interface IDibiResultDriver
+interface ResultDriver
 {
-
 	/**
 	 * Returns the number of rows in a result set.
 	 * @return int
@@ -149,14 +164,14 @@ interface IDibiResultDriver
 	/**
 	 * 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
+	 * @return bool     true on success, false if unable to seek to specified record
+	 * @throws Exception
 	 */
 	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
+	 * @param  bool     true for associative array, false for numeric
 	 * @return array    array on success, nonarray if no next record
 	 * @internal
 	 */
@@ -183,28 +198,18 @@ interface IDibiResultDriver
 
 	/**
 	 * Decodes data from result set.
-	 * @param  string    value
-	 * @param  string    type (dibi::BINARY)
-	 * @return string    decoded value
-	 * @throws InvalidArgumentException
+	 * @param  string
+	 * @return string
 	 */
-	function unescape($value, $type);
-
+	function unescapeBinary($value);
 }
 
 
-
-
-
 /**
- * dibi driver reflection.
- *
- * @author     David Grudl
- * @package    dibi
+ * Reflection driver.
  */
-interface IDibiReflector
+interface Reflector
 {
-
 	/**
 	 * Returns list of tables.
 	 * @return array of {name [, (bool) view ]}
@@ -231,5 +236,4 @@ interface IDibiReflector
 	 * @return array
 	 */
 	function getForeignKeys($table);
-
 }