Query/drivers/firebird/firebird_driver.php

352 lines
7.5 KiB
PHP
Raw Normal View History

2012-04-10 14:06:34 -04:00
<?php
/**
* Query
*
* Free Query Builder / Database Abstraction Layer
*
2012-04-20 13:17:39 -04:00
* @package Query
* @author Timothy J. Warren
2014-01-02 12:36:50 -05:00
* @copyright Copyright (c) 2012 - 2014
2012-04-10 14:06:34 -04:00
* @link https://github.com/aviat4ion/Query
2012-04-20 13:17:39 -04:00
* @license http://philsturgeon.co.uk/code/dbad-license
2012-04-10 14:06:34 -04:00
*/
// --------------------------------------------------------------------------
/**
* Firebird Database class
*
* PDO-firebird isn't stable, so this is a wrapper of the fbird_ public functions.
2012-04-20 13:17:39 -04:00
*
* @package Query
* @subpackage Drivers
2012-04-10 14:06:34 -04:00
*/
class Firebird extends Abstract_Driver {
2012-04-10 14:06:34 -04:00
/**
* Reference to the last query executed
*
* @var object
*/
2014-03-17 19:34:48 -04:00
protected $statement = NULL;
/**
* Reference to the resource returned by
* the last query executed
*
* @var resource
*/
protected $statement_link = NULL;
/**
* Reference to the current transaction
*
* @var resource
*/
protected $trans = NULL;
/**
* Reference to the connection resource
*
* @var resource
*/
2014-03-17 19:34:48 -04:00
protected $conn = NULL;
2012-04-10 14:06:34 -04:00
/**
* Open the link to the database
*
* @param string $dbpath
2012-04-10 14:06:34 -04:00
* @param string $user
* @param string $pass
* @param array $options
2012-04-10 14:06:34 -04:00
*/
public function __construct($dbpath, $user='SYSDBA', $pass='masterkey', array $options = array())
2012-04-10 14:06:34 -04:00
{
$connect_function = (isset($options[PDO::ATTR_PERSISTENT]) && $options[PDO::ATTR_PERSISTENT] == TRUE)
? 'fbird_pconnect'
: 'fbird_connect';
$this->conn = $connect_function($dbpath, $user, $pass, 'utf-8', 0);
2012-04-10 14:06:34 -04:00
// Throw an exception to make this match other pdo classes
2014-03-17 19:45:41 -04:00
if ( ! is_resource($this->conn)) throw new PDOException(fbird_errmsg(), fbird_errcode(), NULL);
// Load these classes here because this
// driver does not call the constructor
// of DB_PDO, which defines these two
// class variables for the other drivers
2014-04-02 15:11:46 -04:00
// Load the sql class
$class = __CLASS__."_sql";
$this->sql = new $class();
// Load the util class
$class = __CLASS__."_util";
$this->util = new $class($this);
2012-04-10 14:06:34 -04:00
}
// --------------------------------------------------------------------------
/**
* Empty a database table
*
* @param string $table
*/
public function truncate($table)
{
2012-11-07 08:42:34 -05:00
// Firebird lacks a truncate command
2012-04-10 14:06:34 -04:00
$sql = 'DELETE FROM "'.$table.'"';
$this->statement = $this->query($sql);
}
// --------------------------------------------------------------------------
/**
* Execute an sql statement and return number of affected rows
*
* @param string $sql
* @return int
*/
public function exec($sql)
{
2014-03-31 16:01:58 -04:00
return NULL;
}
// --------------------------------------------------------------------------
/**
* Implement for compatibility with PDO
*
* @param int $attribute
* @return mixed
*/
public function getAttribute($attribute)
{
return NULL;
}
// --------------------------------------------------------------------------
/**
* Return whether the current statement is in a transaction
*
* @return bool
*/
public function inTransaction()
{
return ! is_null($this->trans);
}
// --------------------------------------------------------------------------
/**
* Returns the last value of the specified generator
*
* @param string $name
* @return mixed
*/
public function lastInsertId($name = NULL)
{
return fbird_gen_id($name, 0, $this->conn);
}
// --------------------------------------------------------------------------
2012-04-10 14:06:34 -04:00
/**
* Wrapper public function to better match PDO
*
* @param string $sql
* @return Firebird_Result
* @throws PDOException
2012-04-10 14:06:34 -04:00
*/
public function query($sql = '')
2012-04-10 14:06:34 -04:00
{
2014-03-17 20:12:58 -04:00
if (empty($sql)) throw new PDOException("Query method requires an sql query!", 0, NULL);
2012-04-10 14:06:34 -04:00
$this->statement_link = (isset($this->trans))
? fbird_query($this->trans, $sql)
: fbird_query($this->conn, $sql);
// Throw the error as a exception
2014-02-11 14:29:41 -05:00
$err_string = fbird_errmsg() . "Last query:" . $this->last_query;
2014-03-17 19:45:41 -04:00
if ($this->statement_link === FALSE) throw new PDOException($err_string, fbird_errcode(), NULL);
$this->statement = new FireBird_Result($this->statement_link);
2012-04-10 14:06:34 -04:00
return $this->statement;
2012-04-10 14:06:34 -04:00
}
// --------------------------------------------------------------------------
/**
* Emulate PDO prepare
*
* @param string $query
* @param array $options
* @return Firebird_Result
* @throws PDOException
2012-04-10 14:06:34 -04:00
*/
public function prepare($query, $options=array())
2012-04-10 14:06:34 -04:00
{
$this->statement_link = fbird_prepare($this->conn, $query);
// Throw the error as an exception
2014-03-17 19:45:41 -04:00
if ($this->statement_link === FALSE) throw new PDOException(fbird_errmsg(), fbird_errcode(), NULL);
2012-04-10 14:06:34 -04:00
$this->statement = new FireBird_Result($this->statement_link);
2012-04-10 14:06:34 -04:00
return $this->statement;
2012-04-10 14:06:34 -04:00
}
// --------------------------------------------------------------------------
/**
* Start a database transaction
*
* @return boolean|null
2012-04-10 14:06:34 -04:00
*/
public function beginTransaction()
{
2014-02-11 14:29:41 -05:00
return (($this->trans = fbird_trans($this->conn)) !== NULL) ? TRUE : NULL;
2012-04-10 14:06:34 -04:00
}
// --------------------------------------------------------------------------
/**
* Commit a database transaction
*
* @return bool
*/
public function commit()
{
$res = fbird_commit($this->trans);
$this->trans = NULL;
return $res;
2012-04-10 14:06:34 -04:00
}
// --------------------------------------------------------------------------
/**
* Rollback a transaction
*
* @return bool
*/
public function rollBack()
{
$res = fbird_rollback($this->trans);
$this->trans = NULL;
return $res;
}
// --------------------------------------------------------------------------
/**
* Set a connection attribute
* @param int $attribute
* @param mixed $value
* @return bool
*/
public function setAttribute($attribute, $value)
{
return FALSE;
2012-04-10 14:06:34 -04:00
}
// --------------------------------------------------------------------------
/**
* Prepare and execute a query
*
* @param string $sql
* @param array $args
* @return Firebird_Result
2012-04-10 14:06:34 -04:00
*/
public function prepare_execute($sql, $args)
{
$query = $this->prepare($sql);
// Set the statement in the class variable for easy later access
$this->statement_link =& $query;
2012-04-10 14:06:34 -04:00
return $query->execute($args);
}
// --------------------------------------------------------------------------
/**
* Method to emulate PDO->quote
*
* @param string $str
* @param int $param_type
2012-04-10 14:06:34 -04:00
* @return string
*/
public function quote($str, $param_type = PDO::PARAM_STR)
2012-04-10 14:06:34 -04:00
{
if(is_numeric($str))
{
return $str;
}
return "'".str_replace("'", "''", $str)."'";
}
// --------------------------------------------------------------------------
/**
* Method to emulate PDO->errorInfo / PDOStatement->errorInfo
*
* @return array
*/
public function errorInfo()
{
$code = fbird_errcode();
$msg = fbird_errmsg();
return array(0, $code, $msg);
}
2012-04-18 11:42:19 -04:00
// --------------------------------------------------------------------------
2012-04-18 11:42:19 -04:00
/**
* Method to emulate PDO->errorCode
2012-04-18 11:42:19 -04:00
*
* @return array
*/
public function errorCode()
{
return fbird_errcode();
}
2012-04-10 14:06:34 -04:00
// --------------------------------------------------------------------------
/**
* Bind a prepared query with arguments for executing
*
* @param string $sql
* @param array $params
* @return NULL
2012-04-10 14:06:34 -04:00
*/
public function prepare_query($sql, $params)
{
// You can't bind query statements before execution with
// the firebird database
return NULL;
2012-04-10 14:06:34 -04:00
}
// --------------------------------------------------------------------------
/**
* Create sql for batch insert
*
* @param string $table
* @param array $data
* @return string
*/
public function insert_batch($table, $data=array())
{
// This is not very applicable to the firebird database
return NULL;
}
2012-04-10 14:06:34 -04:00
}
// End of firebird_driver.php