mirror of
https://github.com/dg/dibi.git
synced 2025-02-24 10:53:17 +01:00
692 lines
15 KiB
PHP
692 lines
15 KiB
PHP
<?php
|
|
|
|
/**
|
|
* dibi - tiny'n'smart database abstraction layer
|
|
* ----------------------------------------------
|
|
*
|
|
* @copyright Copyright (c) 2005, 2010 David Grudl
|
|
* @license http://dibiphp.com/license dibi license
|
|
* @link http://dibiphp.com
|
|
* @package dibi
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
* dibi connection.
|
|
*
|
|
* @copyright Copyright (c) 2005, 2010 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 IDibiProfiler $profiler
|
|
* @property-read DibiDatabaseInfo $databaseInfo
|
|
*/
|
|
class DibiConnection extends DibiObject
|
|
{
|
|
/** @var array Current connection configuration */
|
|
private $config;
|
|
|
|
/** @var IDibiDriver */
|
|
private $driver;
|
|
|
|
/** @var DibiTranslator */
|
|
private $translator;
|
|
|
|
/** @var IDibiProfiler */
|
|
private $profiler;
|
|
|
|
/** @var bool Is connected? */
|
|
private $connected = FALSE;
|
|
|
|
|
|
|
|
/**
|
|
* Connection options: (see driver-specific options too)
|
|
* - lazy (bool) => if TRUE, connection will be established only when required
|
|
* - result (array) => result set options
|
|
* - detectTypes (bool) => detect the types of result set fields?
|
|
* - formatDateTime => date-time format (if empty, DateTime objects will be returned)
|
|
* - profiler (array or bool)
|
|
* - run (bool) => enable profiler?
|
|
* - class => profiler class name (default is DibiProfiler)
|
|
* - 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)
|
|
{
|
|
// 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|detectTypes', 'resultDetectTypes'); // back compatibility
|
|
self::alias($config, 'result|formatDateTime', 'resultDateTime');
|
|
|
|
if (!isset($config['driver'])) {
|
|
$config['driver'] = dibi::$defaultDriver;
|
|
}
|
|
|
|
$driver = preg_replace('#[^a-z0-9_]#', '_', strtolower($config['driver']));
|
|
$class = "Dibi" . $driver . "Driver";
|
|
if (!class_exists($class, FALSE)) {
|
|
include_once dirname(__FILE__) . "/../drivers/$driver.php";
|
|
|
|
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->driver);
|
|
|
|
// profiler
|
|
$profilerCfg = & $config['profiler'];
|
|
if (is_scalar($profilerCfg)) { // back compatibility
|
|
$profilerCfg = array(
|
|
'run' => (bool) $profilerCfg,
|
|
'class' => strlen($profilerCfg) > 1 ? $profilerCfg : NULL,
|
|
);
|
|
}
|
|
|
|
if (!empty($profilerCfg['run'])) {
|
|
$class = isset($profilerCfg['class']) ? $profilerCfg['class'] : 'DibiProfiler';
|
|
if (!class_exists($class)) {
|
|
throw new DibiException("Unable to create instance of dibi profiler '$class'.");
|
|
}
|
|
$this->setProfiler(new $class($profilerCfg));
|
|
}
|
|
|
|
if (!empty($config['substitutes'])) {
|
|
foreach ($config['substitutes'] as $key => $value) {
|
|
dibi::addSubst($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->disconnect();
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
* Connects to a database.
|
|
* @return void
|
|
*/
|
|
final public function connect()
|
|
{
|
|
if ($this->profiler !== NULL) {
|
|
$ticket = $this->profiler->before($this, IDibiProfiler::CONNECT);
|
|
}
|
|
$this->driver->connect($this->config);
|
|
$this->connected = TRUE;
|
|
if (isset($ticket)) {
|
|
$this->profiler->after($ticket);
|
|
}
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
* 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)
|
|
{
|
|
$this->connected || $this->connect();
|
|
$args = func_get_args();
|
|
return $this->nativeQuery($this->translator->translate($args));
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
* Generates and returns SQL query.
|
|
* @param array|mixed one or more arguments
|
|
* @return string
|
|
* @throws DibiException
|
|
*/
|
|
final public function translate($args)
|
|
{
|
|
$this->connected || $this->connect();
|
|
$args = func_get_args();
|
|
return $this->translator->translate($args);
|
|
}
|
|
|
|
|
|
|
|
/** @deprecated */
|
|
function sql($args)
|
|
{
|
|
trigger_error(__METHOD__ . '() is deprecated; use translate() instead.', E_USER_NOTICE);
|
|
$this->connected || $this->connect();
|
|
$args = func_get_args();
|
|
return $this->translator->translate($args);
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
* Generates and prints SQL query.
|
|
* @param array|mixed one or more arguments
|
|
* @return bool
|
|
*/
|
|
final public function test($args)
|
|
{
|
|
$this->connected || $this->connect();
|
|
$args = func_get_args();
|
|
try {
|
|
dibi::dump($this->translator->translate($args));
|
|
return TRUE;
|
|
|
|
} catch (DibiException $e) {
|
|
dibi::dump($e->getSql());
|
|
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)
|
|
{
|
|
$this->connected || $this->connect();
|
|
$args = func_get_args();
|
|
return new DibiDataSource($this->translator->translate($args), $this);
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
* 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();
|
|
|
|
if ($this->profiler !== NULL) {
|
|
$event = IDibiProfiler::QUERY;
|
|
if (preg_match('#\s*(SELECT|UPDATE|INSERT|DELETE)#i', $sql, $matches)) {
|
|
static $events = array(
|
|
'SELECT' => IDibiProfiler::SELECT, 'UPDATE' => IDibiProfiler::UPDATE,
|
|
'INSERT' => IDibiProfiler::INSERT, 'DELETE' => IDibiProfiler::DELETE,
|
|
);
|
|
$event = $events[strtoupper($matches[1])];
|
|
}
|
|
$ticket = $this->profiler->before($this, $event, $sql);
|
|
}
|
|
|
|
dibi::$sql = $sql;
|
|
if ($res = $this->driver->query($sql)) { // intentionally =
|
|
$res = new DibiResult($res, $this->config['result']);
|
|
} else {
|
|
$res = $this->driver->getAffectedRows();
|
|
}
|
|
|
|
if (isset($ticket)) {
|
|
$this->profiler->after($ticket, $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();
|
|
if ($this->profiler !== NULL) {
|
|
$ticket = $this->profiler->before($this, IDibiProfiler::BEGIN, $savepoint);
|
|
}
|
|
$this->driver->begin($savepoint);
|
|
if (isset($ticket)) {
|
|
$this->profiler->after($ticket);
|
|
}
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
* Commits statements in a transaction.
|
|
* @param string optional savepoint name
|
|
* @return void
|
|
*/
|
|
public function commit($savepoint = NULL)
|
|
{
|
|
$this->connected || $this->connect();
|
|
if ($this->profiler !== NULL) {
|
|
$ticket = $this->profiler->before($this, IDibiProfiler::COMMIT, $savepoint);
|
|
}
|
|
$this->driver->commit($savepoint);
|
|
if (isset($ticket)) {
|
|
$this->profiler->after($ticket);
|
|
}
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
* Rollback changes in a transaction.
|
|
* @param string optional savepoint name
|
|
* @return void
|
|
*/
|
|
public function rollback($savepoint = NULL)
|
|
{
|
|
$this->connected || $this->connect();
|
|
if ($this->profiler !== NULL) {
|
|
$ticket = $this->profiler->before($this, IDibiProfiler::ROLLBACK, $savepoint);
|
|
}
|
|
$this->driver->rollback($savepoint);
|
|
if (isset($ticket)) {
|
|
$this->profiler->after($ticket);
|
|
}
|
|
}
|
|
|
|
|
|
|
|
/********************* 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);
|
|
}
|
|
|
|
|
|
|
|
/********************* profiler ****************d*g**/
|
|
|
|
|
|
|
|
/**
|
|
* @param IDibiProfiler
|
|
* @return DibiConnection provides a fluent interface
|
|
*/
|
|
public function setProfiler(IDibiProfiler $profiler = NULL)
|
|
{
|
|
$this->profiler = $profiler;
|
|
return $this;
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
* @return IDibiProfiler
|
|
*/
|
|
public function getProfiler()
|
|
{
|
|
return $this->profiler;
|
|
}
|
|
|
|
|
|
|
|
/********************* 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 FileNotFoundException("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++;
|
|
}
|
|
}
|
|
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 NotSupportedException('You cannot serialize or unserialize ' . $this->getClass() . ' instances.');
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
* Prevents serialization.
|
|
*/
|
|
public function __sleep()
|
|
{
|
|
throw new NotSupportedException('You cannot serialize or unserialize ' . $this->getClass() . ' instances.');
|
|
}
|
|
|
|
}
|