Home arrow PHP arrow Page 2 - Adding Ordering and Grouping Clauses to the CodeIgniter Library with Method Chaining

Creating the JOIN, ORDER BY and GROUP parts of a query - PHP

Welcome to the tenth installment of a series on method chaining in PHP 5. Comprised of twelve tutorials, this series teaches you the key concepts that surround the implementation of chainable methods within PHP classes, and shows how to put them to work to create a custom library for the popular CodeIgniter framework.

TABLE OF CONTENTS:
  1. Adding Ordering and Grouping Clauses to the CodeIgniter Library with Method Chaining
  2. Creating the JOIN, ORDER BY and GROUP parts of a query
  3. Conditional queries: adding WHERE modifiers to a SELECt statement
  4. The custom model class's full source code
By: Alejandro Gervasio
Rating: starstarstarstarstar / 1
November 25, 2009

print this article
SEARCH DEV SHED

TOOLS YOU CAN USE

advertisement

Before I proceed to add to the custom model library the additional chainable methods that I mentioned in the introduction, itíd be convenient to recall how the library looked previously. So, here is its full source code, as shown in the preceding article:

The MIT License

 

Copyright (c) 2008 Simon Stenhouse

 

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

 

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

 

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

 

 

class AbstractModel

{

protected $table = '';

protected $fields = array();

protected $validation = array();

protected $error_prefix = '<p>';

protected static $instance = NULL;

protected $ci = NULL;

protected $db = NULL;

 

// Factory method that creates a singleton model object

public static function factory($model)

{

if (self::$instance == NULL)

{

$model = ucfirst($model);

self::$instance = new $model;

}

return self::$instance;

}

 

// Constructor

public function __construct()

{

$this->ci = & get_instance();

$this->db = $this->ci->db;

$table = strtolower(get_class($this)) . 's';

if ($this->db->table_exists($table))

{

$this->table = $table;

$this->fields = $this->db->field_names($this->table);

}

else

{

return;

}

}

 

// Sets a new property for the model

function __set($property, $value)

{

if(in_array($property, array_merge($this->fields, array('error', 'result')), TRUE))

{

$this->$property = $value;

}

}

 

// Gets the value of an existing property of the model

function __get($property)

{

if(isset($this->$property))

{

return $this->$property;

}

return NULL;

}

 

// Fetches rows from specified table

public function fetch($limit = NULL, $offset = NULL)

{

$data = array();

foreach ($this->fields as $field)

{

if (isset($this->$field) AND $this->$field != '')

{

$data[$field] = $this->$field;

}

}

$query = !empty($data) ? $this->db->get_where($this->table, $data, $limit, $offset) : $this->db->get($this->table, $limit, $offset);

if ($query->num_rows() > 0)

{

$this->result = $query->result();

return $this;

}

$this->error = 'No rows were returned.';

return FALSE;

}

 

// Inserts a new row into the specified database table

public function save()

{

$data = array();

foreach ($this->fields as $field)

{

if (isset($this->$field))

{

$data[$field] = $this->$field;

 

}

}

// if there is any data available go ahead and save/update row

if( !empty($data))

{

// validate input data

if ($this->validate($data) === FALSE)

{

$this->error = $this->get_error_string();

return FALSE;

}

// if id property has been set in the controller update existing row

if ( !empty($this->id))

{

// Update existing record

$this->db->where('id', $this->id);

$this->db->update($this->table, $data);

}

else

{

// otherwise insert new row

$this->db->insert($this->table, $data);

$this->id = $this->db->insert_id();

}

return TRUE;

}

$this->error = 'No valid data was provided to save row.';

return FALSE;

}

 

// Deletes a row

public function delete()

{

if (isset($this->id))

{

$this->db->where('id', $this->id);

$this->db->delete($this->table);

return TRUE;

}

$this->error = 'Error deleting row.';

return FALSE;

}

 

// Builds SELECT part of the query

public function select($select = '*', $protect_identifiers = TRUE)

{

if ($select != '*' AND !empty($select))

{

$select = explode(',', $select);

foreach ($select as $key => $field)

{

if ( !in_array($field, $this->fields, TRUE))

{

unset($select[$key]);

}

}

$select = !empty($select) ? $select : '*';

}

$this->db->select($select, $protect_identifiers);

return $this;

}

 

// Builds the select MAX part of the query

public function select_max($field, $alias = '')

{

if (in_array($field, $this->fields, TRUE))

{

$this->db->select_max($field, $alias);

}

return $this;

}

 

// Builds the select MIN part of the query

public function select_min($field, $alias = '')

{

if (in_array($field, $this->fields, TRUE))

{

$this->db->select_min($field, $alias);

}

return $this;

}

 

// Builds the select AVG part of the query

public function select_average($field, $alias = '')

{

if (in_array($field, $this->fields, TRUE))

{

$this->db->select_min($field, $alias);

}

return $this;

}

 

// Builds the select SUM part of the query

public function select_sum($field, $alias = '')

{

if (in_array($field, $this->fields, TRUE))

{

$this->db->select_min($field, $alias);

}

return $this;

}

}

Now that youíve recalled how the above ďAbstractModelĒ class was defined, itís time to make it a bit more functional. To do that, Iím going to code other chainable methods. These will be tasked with creating in turn the JOIN, ORDER BY, GROUP BY, LIKE, OR LIKE, NOT LIKE and DISTINCT query modifiers. 

Here are the corresponding definitions for these methods:

// Builds the JOIN part of the query

public function join($table, $join, $join_type = '')

{

if ( !empty($table) AND !empty($join))

{

$this->db->join($table, $join, $join_type);

}

return $this;

}

 

// Builds the ORDER BY part of the query

public function order_by($field = 'id', $order = 'ASC')

{

if (in_array($field, $this->fields, TRUE))

{

$this->db->order_by($field, $order);

}

return $this;

}

 

// Builds the GROUP BY part of the query

public function group_by($field)

{

if (in_array($field, $this->fields, TRUE))

{

$this->db->group_by($field);

}

return $this;

}

 

// Builds the LIKE part of the query using the AND operator

public function like($field, $match, $position = '')

{

if (in_array($field, $this->fields, TRUE) AND !empty($match))

{

$this->db->like($field, $match, $position);

}

return $this;

}

 

// Builds the OR LIKE part if the query using the OR operator

public function or_like($field, $match, $position = '')

{

if (in_array($field, $this->fields, TRUE) AND !empty($match))

{

$this->db->or_like($field, $match, $position);

}

return $this;

}

 

// Builds the NOT LIKE part of the query

public function not_like($field, $match, $position = '')

{

if (in_array($field, $this->fields, TRUE) AND !empty($match))

{

$this->db->not_like($field, $match, $position);

}

return $this;

}

 

// Builds the DISTINCT part of the query

public function distinct()

{

$this->db->distinct();

return $this;

}

Definitely, if youíre familiar with the CodeIgniter database class, then you wonít have major problems grasping the logic that drives the previous chainable methods. They behave as simple proxies for their counterparts in the class.

Of course, all of these methods returns to client code an instance of the custom model class, which makes it really easy to chain them to others. That was pretty simple to understand, wasnít it?

So far, so good. At this point, the custom model class looks much more functional, since now itís capable of adding some other modifiers to the SELECT statement. So, what's the next step? In the next section Iím going to code another set of chainable methods, which will be charged with adding several WHERE clauses to a query.

To see how these methods will be implemented, click on the link below and keep reading.



 
 
>>> More PHP Articles          >>> More By Alejandro Gervasio
 

blog comments powered by Disqus
escort Bursa Bursa escort Antalya eskort
   

PHP ARTICLES

- Hackers Compromise PHP Sites to Launch Attac...
- Red Hat, Zend Form OpenShift PaaS Alliance
- PHP IDE News
- BCD, Zend Extend PHP Partnership
- PHP FAQ Highlight
- PHP Creator Didn't Set Out to Create a Langu...
- PHP Trends Revealed in Zend Study
- PHP: Best Methods for Running Scheduled Jobs
- PHP Array Functions: array_change_key_case
- PHP array_combine Function
- PHP array_chunk Function
- PHP Closures as View Helpers: Lazy-Loading F...
- Using PHP Closures as View Helpers
- PHP File and Operating System Program Execut...
- PHP: Effects of Wrapping Code in Class Const...

Developer Shed Affiliates

 


Dev Shed Tutorial Topics: