Rename interfaces from iFoo to Foo_Interface

This commit is contained in:
Timothy Warren 2014-03-28 13:38:34 -04:00
parent e9e03953a7
commit b3d3c3f35d
7 changed files with 474 additions and 498 deletions

View File

@ -21,7 +21,7 @@
* @package Query * @package Query
* @subpackage Query * @subpackage Query
*/ */
abstract class Abstract_Driver extends PDO implements idriver { abstract class Abstract_Driver extends PDO implements Driver_Interface {
// Reference to the last executed query // Reference to the last executed query
protected $statement; protected $statement;

View File

@ -1,452 +0,0 @@
<?php
/**
* Query
*
* Free Query Builder / Database Abstraction Layer
*
* @package Query
* @author Timothy J. Warren
* @copyright Copyright (c) 2012 - 2014
* @link https://github.com/aviat4ion/Query
* @license http://philsturgeon.co.uk/code/dbad-license
*/
// --------------------------------------------------------------------------
/**
* Base class for query builder - defines the internal methods
*
* @package Query
* @subpackage Query
*/
abstract class Abstract_Query_Builder implements iQuery_Builder {
/**
* Helper function for returning sql strings
*
* @param string $type
* @param string $table
* @param bool $reset
* @resturn string
*/
protected function _get_compile($type, $table, $reset)
{
$sql = $this->_compile($type, $table);
// Reset the query builder for the next query
if ($reset)
{
$this->reset_query();
}
return $sql;
}
// --------------------------------------------------------------------------
/**
* Simplify building having clauses
*
* @param mixed $key
* @param mixed $val
* @param string $conj
* @return $this
*/
protected function _having($key, $val=array(), $conj='AND')
{
$where = $this->_where($key, $val);
// Create key/value placeholders
foreach($where as $f => $val)
{
// Split each key by spaces, in case there
// is an operator such as >, <, !=, etc.
$f_array = explode(' ', trim($f));
$item = $this->db->quote_ident($f_array[0]);
// Simple key value, or an operator
$item .= (count($f_array) === 1) ? '=?' : " {$f_array[1]} ?";
// Put in the query map for select statements
$this->having_map[] = array(
'conjunction' => ( ! empty($this->having_map)) ? " {$conj} " : ' HAVING ',
'string' => $item
);
}
return $this;
}
// --------------------------------------------------------------------------
/**
* Do all the repeditive stuff for where/having type methods
*
* @param mixed $key
* @param mixed $val
* @return array
*/
protected function _where($key, $val=array())
{
$where = array();
// Key and value passed? Add them to the where array
if (is_scalar($key) && is_scalar($val))
{
$where[$key] = $val;
$this->where_values[] = $val;
}
// Array or object, loop through and add to the where array
elseif ( ! is_scalar($key))
{
foreach($key as $k => $v)
{
$where[$k] = $v;
$this->where_values[] = $v;
}
}
return $where;
}
// --------------------------------------------------------------------------
/**
* Simplify generating where string
*
* @param mixed $key
* @param mixed $val
* @param string $conj
* @return $this
*/
protected function _where_string($key, $val=array(), $conj='AND')
{
$where = $this->_where($key, $val);
// Create key/value placeholders
foreach($where as $f => $val)
{
// Split each key by spaces, in case there
// is an operator such as >, <, !=, etc.
$f_array = explode(' ', trim($f));
$item = $this->db->quote_ident($f_array[0]);
// Simple key value, or an operator
$item .= (count($f_array) === 1) ? '=?' : " {$f_array[1]} ?";
// Get the type of the first item in the query map
$first_item = end($this->query_map);
// Determine the correct conjunction
if (empty($this->query_map))
{
$conj = "\nWHERE ";
}
elseif ($first_item['type'] === 'group_start')
{
$conj = '';
}
else
{
$conj = " {$conj} ";
}
// Put in the query map for select statements
$this->query_map[] = array(
'type' => 'where',
'conjunction' => $conj,
'string' => $item
);
}
return $this;
}
// --------------------------------------------------------------------------
/**
* Simplify where_in methods
*
* @param mixed $key
* @param mixed $val
* @param string $in - The (not) in fragment
* @param string $conj - The where in conjunction
* @return $this
*/
protected function _where_in($key, $val=array(), $in='IN', $conj='AND')
{
$key = $this->db->quote_ident($key);
$params = array_fill(0, count($val), '?');
foreach($val as $v)
{
$this->where_values[] = $v;
}
$string = $key . " {$in} (".implode(',', $params).') ';
$this->query_map[] = array(
'type' => 'where_in',
'conjunction' => ( ! empty($this->query_map)) ? " {$conj} " : ' WHERE ',
'string' => $string
);
return $this;
}
// --------------------------------------------------------------------------
/**
* Simplify 'like' methods
*
* @param string $field
* @param mixed $val
* @param string $pos
* @param string $like
* @param string $conj
* @return $this
*/
protected function _like($field, $val, $pos, $like='LIKE', $conj='AND')
{
$field = $this->db->quote_ident($field);
// Add the like string into the order map
$l = $field. " {$like} ?";
if ($pos == 'before')
{
$val = "%{$val}";
}
elseif ($pos == 'after')
{
$val = "{$val}%";
}
else
{
$val = "%{$val}%";
}
$this->query_map[] = array(
'type' => 'like',
'conjunction' => (empty($this->query_map)) ? ' WHERE ' : " {$conj} ",
'string' => $l
);
// Add to the values array
$this->where_values[] = $val;
return $this;
}
// --------------------------------------------------------------------------
/**
* Method to simplify select_ methods
*
* @param string $field
* @param string $as
* @return string
*/
protected function _select($field, $as = FALSE)
{
// Escape the identifiers
$field = $this->db->quote_ident($field);
$as = ($as !== FALSE)
? $this->db->quote_ident($as)
: $field;
return "({$field}) AS {$as} ";
}
// --------------------------------------------------------------------------
/**
* Executes the compiled query
*
* @param string $type
* @param string $table
* @param string $sql
* @param mixed $vals
* @return mixed
*/
protected function _run($type, $table, $sql=NULL, $vals=NULL)
{
if (is_null($sql))
{
$sql = $this->_compile($type, $table);
}
if (is_null($vals))
{
$vals = array_merge($this->values, (array) $this->where_values);
}
$evals = (is_array($vals)) ? $vals : array();
$start_time = microtime(TRUE);
if (empty($vals))
{
$res = $this->db->query($sql);
}
else
{
$res = $this->db->prepare_execute($sql, $vals);
}
$end_time = microtime(TRUE);
$total_time = number_format($end_time - $start_time, 5);
// Add the interpreted query to the list of executed queries
foreach($evals as $k => &$v)
{
$v = ( ! is_numeric($v)) ? htmlentities($this->db->quote($v), ENT_NOQUOTES, 'utf-8', FALSE) : $v;
}
$esql = str_replace('?', "%s", $sql);
array_unshift($vals, $esql);
array_unshift($evals, $esql);
$this->queries[] = array(
'time' => $total_time,
'sql' => call_user_func_array('sprintf', $evals),
);
$this->queries['total_time'] += $total_time;
array_shift($vals);
// Set the last query to get rowcounts properly
$this->db->last_query = $sql;
// Reset class state for next query
$this->reset_query();
return $res;
}
// --------------------------------------------------------------------------
/**
* Calls a function further down the inheritence chain
*
* @param string $name
* @param array $params
* @return mixed
* @throws BadMethodCallException
*/
public function __call($name, $params)
{
if (method_exists($this->db, $name))
{
return call_user_func_array(array($this->db, $name), $params);
}
throw new BadMethodCallException("Method does not exist");
}
// --------------------------------------------------------------------------
/**
* Sub-method for generating sql strings
*
* @param string $type
* @param string $table
* @return $string
*/
protected function _compile_type($type='', $table='')
{
if ($type === 'insert')
{
$param_count = count($this->set_array_keys);
$params = array_fill(0, $param_count, '?');
$sql = "INSERT INTO {$table} ("
. implode(',', $this->set_array_keys)
. ")\nVALUES (".implode(',', $params).')';
}
elseif ($type === 'update')
{
$sql = "UPDATE {$table}\nSET {$this->set_string}";
}
elseif ($type === 'delete')
{
$sql = "DELETE FROM {$table}";
}
else // GET queries
{
$sql = "SELECT * \nFROM {$this->from_string}";
// Set the select string
if ( ! empty($this->select_string))
{
// Replace the star with the selected fields
$sql = str_replace('*', $this->select_string, $sql);
}
}
return $sql;
}
// --------------------------------------------------------------------------
/**
* String together the sql statements for sending to the db
*
* @param string $type
* @param string $table
* @return $string
*/
protected function _compile($type='', $table='')
{
// Get the base clause for the query
$sql = $this->_compile_type($type, $this->db->quote_table($table));
// Set the where clause
if ( ! empty($this->query_map))
{
foreach($this->query_map as $k => $q)
{
$sql .= $q['conjunction'] . $q['string'];
}
}
// Set the group_by clause
if ( ! empty($this->group_string))
{
$sql .= $this->group_string;
}
// Set the order_by clause
if ( ! empty($this->order_string))
{
$sql .= $this->order_string;
}
// Set the having clause
if ( ! empty($this->having_map))
{
foreach($this->having_map as $h)
{
$sql .= $h['conjunction'] . $h['string'];
}
}
// Set the limit via the class variables
if (isset($this->limit) && is_numeric($this->limit))
{
$sql = $this->sql->limit($sql, $this->limit, $this->offset);
}
// See what needs to happen to only return the query plan
if (isset($this->explain) && $this->explain === TRUE)
{
$sql = $this->sql->explain($sql);
}
return $sql;
}
}
// End of abstract_query_builder.php

View File

@ -19,7 +19,7 @@
* @package Query * @package Query
* @subpackage Query * @subpackage Query
*/ */
abstract class Abstract_SQL implements iSQL { abstract class Abstract_SQL implements SQL_Interface {
/** /**
* Limit clause * Limit clause

View File

@ -16,7 +16,7 @@
/** /**
* PDO Interface to implement for database drivers * PDO Interface to implement for database drivers
*/ */
interface idriver { interface Driver_Interface {
/** /**
* Constructor/Connection method * Constructor/Connection method
@ -88,4 +88,4 @@ interface idriver {
*/ */
public function setAttribute($attribute, $value); public function setAttribute($attribute, $value);
} }
// End of idriver.php // End of driver_interface.php

View File

@ -20,7 +20,7 @@
* @package Query * @package Query
* @subpackage Query * @subpackage Query
*/ */
class Query_Builder extends Abstract_Query_Builder { class Query_Builder implements Query_Builder_Interface {
// -------------------------------------------------------------------------- // --------------------------------------------------------------------------
// ! SQL Clause Strings // ! SQL Clause Strings
@ -70,9 +70,6 @@ class Query_Builder extends Abstract_Query_Builder {
// Value for offset in limit string // Value for offset in limit string
protected $offset; protected $offset;
// Alias to $this->db->sql
public $sql;
// Query component order mapping // Query component order mapping
// for complex select queries // for complex select queries
// //
@ -99,7 +96,10 @@ class Query_Builder extends Abstract_Query_Builder {
// Subclass instances // Subclass instances
public $db; public $db;
protected $parser; protected $parser;
// Aliases to driver subclasses
public $util; public $util;
public $sql;
// -------------------------------------------------------------------------- // --------------------------------------------------------------------------
// ! Methods // ! Methods
@ -108,10 +108,10 @@ class Query_Builder extends Abstract_Query_Builder {
/** /**
* Constructor * Constructor
* *
* @param DB_PDO $db * @param Abstract_driver $db
* @param object $params - the connection parameters * @param object $params - the connection parameters
*/ */
public function __construct($db, $params) public function __construct(Abstract_Driver $db, $params)
{ {
$this->db = $db; $this->db = $db;
@ -145,11 +145,30 @@ class Query_Builder extends Abstract_Query_Builder {
// ! Select Queries // ! Select Queries
// -------------------------------------------------------------------------- // --------------------------------------------------------------------------
/**
* Method to simplify select_ methods
*
* @param string $field
* @param string $as
* @return string
*/
protected function _select($field, $as = FALSE)
{
// Escape the identifiers
$field = $this->db->quote_ident($field);
$as = ($as !== FALSE)
? $this->db->quote_ident($as)
: $field;
return "({$field}) AS {$as} ";
}
/** /**
* Specifies rows to select in a query * Specifies rows to select in a query
* *
* @param string $fields * @param string $fields
* @return $this * @return Query_Builder
*/ */
public function select($fields) public function select($fields)
{ {
@ -195,7 +214,7 @@ class Query_Builder extends Abstract_Query_Builder {
* *
* @param string $field * @param string $field
* @param string $as * @param string $as
* @return $this * @return Query_Builder
*/ */
public function select_max($field, $as=FALSE) public function select_max($field, $as=FALSE)
{ {
@ -211,7 +230,7 @@ class Query_Builder extends Abstract_Query_Builder {
* *
* @param string $field * @param string $field
* @param string $as * @param string $as
* @return $this * @return Query_Builder
*/ */
public function select_min($field, $as=FALSE) public function select_min($field, $as=FALSE)
{ {
@ -227,7 +246,7 @@ class Query_Builder extends Abstract_Query_Builder {
* *
* @param string $field * @param string $field
* @param string $as * @param string $as
* @return $this * @return Query_Builder
*/ */
public function select_avg($field, $as=FALSE) public function select_avg($field, $as=FALSE)
{ {
@ -243,7 +262,7 @@ class Query_Builder extends Abstract_Query_Builder {
* *
* @param string $field * @param string $field
* @param string $as * @param string $as
* @return $this * @return Query_Builder
*/ */
public function select_sum($field, $as=FALSE) public function select_sum($field, $as=FALSE)
{ {
@ -257,7 +276,7 @@ class Query_Builder extends Abstract_Query_Builder {
/** /**
* Adds the 'distinct' keyword to a query * Adds the 'distinct' keyword to a query
* *
* @return $this * @return Query_Builder
*/ */
public function distinct() public function distinct()
{ {
@ -271,7 +290,7 @@ class Query_Builder extends Abstract_Query_Builder {
/** /**
* Tell the database to give you the query plan instead of result set * Tell the database to give you the query plan instead of result set
* *
* @return $this * @return Query_Builder
*/ */
public function explain() public function explain()
{ {
@ -285,7 +304,7 @@ class Query_Builder extends Abstract_Query_Builder {
* Specify the database table to select from * Specify the database table to select from
* *
* @param string $tblname * @param string $tblname
* @return $this * @return Query_Builder
*/ */
public function from($tblname) public function from($tblname)
{ {
@ -307,13 +326,57 @@ class Query_Builder extends Abstract_Query_Builder {
// ! 'Like' methods // ! 'Like' methods
// -------------------------------------------------------------------------- // --------------------------------------------------------------------------
/**
* Simplify 'like' methods
*
* @param string $field
* @param mixed $val
* @param string $pos
* @param string $like
* @param string $conj
* @return $this
*/
protected function _like($field, $val, $pos, $like='LIKE', $conj='AND')
{
$field = $this->db->quote_ident($field);
// Add the like string into the order map
$l = $field. " {$like} ?";
if ($pos == 'before')
{
$val = "%{$val}";
}
elseif ($pos == 'after')
{
$val = "{$val}%";
}
else
{
$val = "%{$val}%";
}
$this->query_map[] = array(
'type' => 'like',
'conjunction' => (empty($this->query_map)) ? ' WHERE ' : " {$conj} ",
'string' => $l
);
// Add to the values array
$this->where_values[] = $val;
return $this;
}
// --------------------------------------------------------------------------
/** /**
* Creates a Like clause in the sql statement * Creates a Like clause in the sql statement
* *
* @param string $field * @param string $field
* @param mixed $val * @param mixed $val
* @param string $pos * @param string $pos
* @return $this * @return Query_Builder
*/ */
public function like($field, $val, $pos='both') public function like($field, $val, $pos='both')
{ {
@ -328,7 +391,7 @@ class Query_Builder extends Abstract_Query_Builder {
* @param string $field * @param string $field
* @param mixed $val * @param mixed $val
* @param string $pos * @param string $pos
* @return $this * @return Query_Builder
*/ */
public function or_like($field, $val, $pos='both') public function or_like($field, $val, $pos='both')
{ {
@ -343,7 +406,7 @@ class Query_Builder extends Abstract_Query_Builder {
* @param string $field * @param string $field
* @param mixed $val * @param mixed $val
* @param string $pos * @param string $pos
* @return $this * @return Query_Builder
*/ */
public function not_like($field, $val, $pos='both') public function not_like($field, $val, $pos='both')
{ {
@ -358,7 +421,7 @@ class Query_Builder extends Abstract_Query_Builder {
* @param string $field * @param string $field
* @param mixed $val * @param mixed $val
* @param string $pos * @param string $pos
* @return $this * @return Query_Builder
*/ */
public function or_not_like($field, $val, $pos='both') public function or_not_like($field, $val, $pos='both')
{ {
@ -369,12 +432,48 @@ class Query_Builder extends Abstract_Query_Builder {
// ! Having methods // ! Having methods
// -------------------------------------------------------------------------- // --------------------------------------------------------------------------
/**
* Simplify building having clauses
*
* @param mixed $key
* @param mixed $val
* @param string $conj
* @return $this
*/
protected function _having($key, $val=array(), $conj='AND')
{
$where = $this->_where($key, $val);
// Create key/value placeholders
foreach($where as $f => $val)
{
// Split each key by spaces, in case there
// is an operator such as >, <, !=, etc.
$f_array = explode(' ', trim($f));
$item = $this->db->quote_ident($f_array[0]);
// Simple key value, or an operator
$item .= (count($f_array) === 1) ? '=?' : " {$f_array[1]} ?";
// Put in the query map for select statements
$this->having_map[] = array(
'conjunction' => ( ! empty($this->having_map)) ? " {$conj} " : ' HAVING ',
'string' => $item
);
}
return $this;
}
// --------------------------------------------------------------------------
/** /**
* Generates a 'Having' clause * Generates a 'Having' clause
* *
* @param mixed $key * @param mixed $key
* @param mixed $val * @param mixed $val
* @return $this * @return Query_Builder
*/ */
public function having($key, $val=array()) public function having($key, $val=array())
{ {
@ -388,7 +487,7 @@ class Query_Builder extends Abstract_Query_Builder {
* *
* @param mixed $key * @param mixed $key
* @param mixed $val * @param mixed $val
* @return $this * @return Query_Builder
*/ */
public function or_having($key, $val=array()) public function or_having($key, $val=array())
{ {
@ -399,6 +498,124 @@ class Query_Builder extends Abstract_Query_Builder {
// ! 'Where' methods // ! 'Where' methods
// -------------------------------------------------------------------------- // --------------------------------------------------------------------------
/**
* Do all the repeditive stuff for where/having type methods
*
* @param mixed $key
* @param mixed $val
* @return array
*/
protected function _where($key, $val=array())
{
$where = array();
// Key and value passed? Add them to the where array
if (is_scalar($key) && is_scalar($val))
{
$where[$key] = $val;
$this->where_values[] = $val;
}
// Array or object, loop through and add to the where array
elseif ( ! is_scalar($key))
{
foreach($key as $k => $v)
{
$where[$k] = $v;
$this->where_values[] = $v;
}
}
return $where;
}
// --------------------------------------------------------------------------
/**
* Simplify generating where string
*
* @param mixed $key
* @param mixed $val
* @param string $conj
* @return $this
*/
protected function _where_string($key, $val=array(), $conj='AND')
{
$where = $this->_where($key, $val);
// Create key/value placeholders
foreach($where as $f => $val)
{
// Split each key by spaces, in case there
// is an operator such as >, <, !=, etc.
$f_array = explode(' ', trim($f));
$item = $this->db->quote_ident($f_array[0]);
// Simple key value, or an operator
$item .= (count($f_array) === 1) ? '=?' : " {$f_array[1]} ?";
// Get the type of the first item in the query map
$first_item = end($this->query_map);
// Determine the correct conjunction
if (empty($this->query_map))
{
$conj = "\nWHERE ";
}
elseif ($first_item['type'] === 'group_start')
{
$conj = '';
}
else
{
$conj = " {$conj} ";
}
// Put in the query map for select statements
$this->query_map[] = array(
'type' => 'where',
'conjunction' => $conj,
'string' => $item
);
}
return $this;
}
// --------------------------------------------------------------------------
/**
* Simplify where_in methods
*
* @param mixed $key
* @param mixed $val
* @param string $in - The (not) in fragment
* @param string $conj - The where in conjunction
* @return $this
*/
protected function _where_in($key, $val=array(), $in='IN', $conj='AND')
{
$key = $this->db->quote_ident($key);
$params = array_fill(0, count($val), '?');
foreach($val as $v)
{
$this->where_values[] = $v;
}
$string = $key . " {$in} (".implode(',', $params).') ';
$this->query_map[] = array(
'type' => 'where_in',
'conjunction' => ( ! empty($this->query_map)) ? " {$conj} " : ' WHERE ',
'string' => $string
);
return $this;
}
// --------------------------------------------------------------------------
/** /**
* Specify condition(s) in the where clause of a query * Specify condition(s) in the where clause of a query
* Note: this function works with key / value, or a * Note: this function works with key / value, or a
@ -407,7 +624,7 @@ class Query_Builder extends Abstract_Query_Builder {
* @param mixed $key * @param mixed $key
* @param mixed $val * @param mixed $val
* @param mixed $escape * @param mixed $escape
* @return $this * @return Query_Builder
*/ */
public function where($key, $val=array(), $escape=NULL) public function where($key, $val=array(), $escape=NULL)
{ {
@ -421,7 +638,7 @@ class Query_Builder extends Abstract_Query_Builder {
* *
* @param string $key * @param string $key
* @param mixed $val * @param mixed $val
* @return $this * @return Query_Builder
*/ */
public function or_where($key, $val=array()) public function or_where($key, $val=array())
{ {
@ -435,7 +652,7 @@ class Query_Builder extends Abstract_Query_Builder {
* *
* @param mixed $field * @param mixed $field
* @param mixed $val * @param mixed $val
* @return $this * @return Query_Builder
*/ */
public function where_in($field, $val=array()) public function where_in($field, $val=array())
{ {
@ -449,7 +666,7 @@ class Query_Builder extends Abstract_Query_Builder {
* *
* @param string $field * @param string $field
* @param mixed $val * @param mixed $val
* @return $this * @return Query_Builder
*/ */
public function or_where_in($field, $val=array()) public function or_where_in($field, $val=array())
{ {
@ -463,7 +680,7 @@ class Query_Builder extends Abstract_Query_Builder {
* *
* @param string $field * @param string $field
* @param mixed $val * @param mixed $val
* @return $this * @return Query_Builder
*/ */
public function where_not_in($field, $val=array()) public function where_not_in($field, $val=array())
{ {
@ -477,7 +694,7 @@ class Query_Builder extends Abstract_Query_Builder {
* *
* @param string $field * @param string $field
* @param mixed $val * @param mixed $val
* @return $this * @return Query_Builder
*/ */
public function or_where_not_in($field, $val=array()) public function or_where_not_in($field, $val=array())
{ {
@ -493,7 +710,7 @@ class Query_Builder extends Abstract_Query_Builder {
* *
* @param mixed $key * @param mixed $key
* @param mixed $val * @param mixed $val
* @return $this * @return Query_Builder
*/ */
public function set($key, $val = NULL) public function set($key, $val = NULL)
{ {
@ -532,7 +749,7 @@ class Query_Builder extends Abstract_Query_Builder {
* @param string $table * @param string $table
* @param string $condition * @param string $condition
* @param string $type * @param string $type
* @return $this * @return Query_Builder
*/ */
public function join($table, $condition, $type='') public function join($table, $condition, $type='')
{ {
@ -574,7 +791,7 @@ class Query_Builder extends Abstract_Query_Builder {
* Group the results by the selected field(s) * Group the results by the selected field(s)
* *
* @param mixed $field * @param mixed $field
* @return $this * @return Query_Builder
*/ */
public function group_by($field) public function group_by($field)
{ {
@ -600,7 +817,7 @@ class Query_Builder extends Abstract_Query_Builder {
* *
* @param string $field * @param string $field
* @param string $type * @param string $type
* @return $this * @return Query_Builder
*/ */
public function order_by($field, $type="") public function order_by($field, $type="")
{ {
@ -654,7 +871,7 @@ class Query_Builder extends Abstract_Query_Builder {
/** /**
* Adds a paren to the current query for query grouping * Adds a paren to the current query for query grouping
* *
* @return $this * @return Query_Builder
*/ */
public function group_start() public function group_start()
{ {
@ -673,7 +890,7 @@ class Query_Builder extends Abstract_Query_Builder {
* Adds a paren to the current query for query grouping, * Adds a paren to the current query for query grouping,
* prefixed with 'OR' * prefixed with 'OR'
* *
* @return $this * @return Query_Builder
*/ */
public function or_group_start() public function or_group_start()
{ {
@ -692,7 +909,7 @@ class Query_Builder extends Abstract_Query_Builder {
* Adds a paren to the current query for query grouping, * Adds a paren to the current query for query grouping,
* prefixed with 'OR NOT' * prefixed with 'OR NOT'
* *
* @return $this * @return Query_Builder
*/ */
public function or_not_group_start() public function or_not_group_start()
{ {
@ -710,7 +927,7 @@ class Query_Builder extends Abstract_Query_Builder {
/** /**
* Ends a query group * Ends a query group
* *
* @return $this * @return Query_Builder
*/ */
public function group_end() public function group_end()
{ {
@ -734,7 +951,7 @@ class Query_Builder extends Abstract_Query_Builder {
* @param $table * @param $table
* @param int $limit * @param int $limit
* @param int $offset * @param int $offset
* @return object * @return PDOStatement
*/ */
public function get($table='', $limit=FALSE, $offset=FALSE) public function get($table='', $limit=FALSE, $offset=FALSE)
{ {
@ -762,7 +979,7 @@ class Query_Builder extends Abstract_Query_Builder {
* @param array $where * @param array $where
* @param int $limit * @param int $limit
* @param int $offset * @param int $offset
* @return object * @return PDOStatement
*/ */
public function get_where($table, $where=array(), $limit=FALSE, $offset=FALSE) public function get_where($table, $where=array(), $limit=FALSE, $offset=FALSE)
{ {
@ -899,6 +1116,29 @@ class Query_Builder extends Abstract_Query_Builder {
// ! SQL Returning Methods // ! SQL Returning Methods
// -------------------------------------------------------------------------- // --------------------------------------------------------------------------
/**
* Helper function for returning sql strings
*
* @param string $type
* @param string $table
* @param bool $reset
* @resturn string
*/
protected function _get_compile($type, $table, $reset)
{
$sql = $this->_compile($type, $table);
// Reset the query builder for the next query
if ($reset)
{
$this->reset_query();
}
return $sql;
}
// --------------------------------------------------------------------------
/** /**
* Returns the generated 'select' sql query * Returns the generated 'select' sql query
* *
@ -1004,5 +1244,193 @@ class Query_Builder extends Abstract_Query_Builder {
$this->$var = array(); $this->$var = array();
} }
} }
// --------------------------------------------------------------------------
/**
* Executes the compiled query
*
* @param string $type
* @param string $table
* @param string $sql
* @param mixed $vals
* @return PDOStatement
*/
protected function _run($type, $table, $sql=NULL, $vals=NULL)
{
if (is_null($sql))
{
$sql = $this->_compile($type, $table);
}
if (is_null($vals))
{
$vals = array_merge($this->values, (array) $this->where_values);
}
$evals = (is_array($vals)) ? $vals : array();
$start_time = microtime(TRUE);
if (empty($vals))
{
$res = $this->db->query($sql);
}
else
{
$res = $this->db->prepare_execute($sql, $vals);
}
$end_time = microtime(TRUE);
$total_time = number_format($end_time - $start_time, 5);
// Add the interpreted query to the list of executed queries
foreach($evals as &$v)
{
$v = ( ! is_numeric($v)) ? htmlentities($this->db->quote($v), ENT_NOQUOTES, 'utf-8', FALSE) : $v;
}
$esql = str_replace('?', "%s", $sql);
array_unshift($vals, $esql);
array_unshift($evals, $esql);
$this->queries[] = array(
'time' => $total_time,
'sql' => call_user_func_array('sprintf', $evals),
);
$this->queries['total_time'] += $total_time;
array_shift($vals);
// Set the last query to get rowcounts properly
$this->db->last_query = $sql;
// Reset class state for next query
$this->reset_query();
return $res;
}
// --------------------------------------------------------------------------
/**
* Calls a function further down the inheritence chain
*
* @param string $name
* @param array $params
* @return mixed
* @throws BadMethodCallException
*/
public function __call($name, $params)
{
if (method_exists($this->db, $name))
{
return call_user_func_array(array($this->db, $name), $params);
}
throw new BadMethodCallException("Method does not exist");
}
// --------------------------------------------------------------------------
/**
* Sub-method for generating sql strings
*
* @param string $type
* @param string $table
* @return $string
*/
protected function _compile_type($type='', $table='')
{
if ($type === 'insert')
{
$param_count = count($this->set_array_keys);
$params = array_fill(0, $param_count, '?');
$sql = "INSERT INTO {$table} ("
. implode(',', $this->set_array_keys)
. ")\nVALUES (".implode(',', $params).')';
}
elseif ($type === 'update')
{
$sql = "UPDATE {$table}\nSET {$this->set_string}";
}
elseif ($type === 'delete')
{
$sql = "DELETE FROM {$table}";
}
else // GET queries
{
$sql = "SELECT * \nFROM {$this->from_string}";
// Set the select string
if ( ! empty($this->select_string))
{
// Replace the star with the selected fields
$sql = str_replace('*', $this->select_string, $sql);
}
}
return $sql;
}
// --------------------------------------------------------------------------
/**
* String together the sql statements for sending to the db
*
* @param string $type
* @param string $table
* @return $string
*/
protected function _compile($type='', $table='')
{
// Get the base clause for the query
$sql = $this->_compile_type($type, $this->db->quote_table($table));
// Set the where clause
if ( ! empty($this->query_map))
{
foreach($this->query_map as $q)
{
$sql .= $q['conjunction'] . $q['string'];
}
}
// Set the group_by clause
if ( ! empty($this->group_string))
{
$sql .= $this->group_string;
}
// Set the order_by clause
if ( ! empty($this->order_string))
{
$sql .= $this->order_string;
}
// Set the having clause
if ( ! empty($this->having_map))
{
foreach($this->having_map as $h)
{
$sql .= $h['conjunction'] . $h['string'];
}
}
// Set the limit via the class variables
if (is_numeric($this->limit))
{
$sql = $this->sql->limit($sql, $this->limit, $this->offset);
}
// See what needs to happen to only return the query plan
if ($this->explain === TRUE)
{
$sql = $this->sql->explain($sql);
}
return $sql;
}
} }
// End of query_builder.php // End of query_builder.php

View File

@ -19,7 +19,7 @@
* @package Query * @package Query
* @subpackage Query * @subpackage Query
*/ */
interface iQuery_Builder { interface Query_Builder_Interface {
// -------------------------------------------------------------------------- // --------------------------------------------------------------------------
// ! Select Queries // ! Select Queries
@ -85,9 +85,9 @@ interface iQuery_Builder {
* @return $this * @return $this
*/ */
public function distinct(); public function distinct();
// -------------------------------------------------------------------------- // --------------------------------------------------------------------------
/** /**
* Shows the query plan for the query * Shows the query plan for the query
* *
@ -487,4 +487,4 @@ interface iQuery_Builder {
public function reset_query(); public function reset_query();
} }
// End of iquery_builder.php // End of query_builder_interface.php

View File

@ -19,7 +19,7 @@
* @package Query * @package Query
* @subpackage Query * @subpackage Query
*/ */
interface iSQL { interface SQL_Interface {
/** /**
* Get database specific sql for limit clause * Get database specific sql for limit clause
@ -121,4 +121,4 @@ interface iSQL {
public function column_list($table); public function column_list($table);
} }
// End of isql.php // End of sql_interface.php