Miscellaneous Code

  Home arrow Miscellaneous Code arrow Page 4 - Fetching Database Rows with a Model fo...
MISCELLANEOUS CODE

Fetching Database Rows with a Model for the CodeIgniter PHP Framework
By: Alejandros Gervasio
  • Search For More Articles!
  • Disclaimer
  • Author Terms
  • Rating: 4 stars4 stars4 stars4 stars4 stars / 5
    2009-08-26

    Table of Contents:
  • Fetching Database Rows with a Model for the CodeIgniter PHP Framework
  • Review: the current AbstractModel class
  • Implementing the fetch() method
  • The complete source code of the generic model class

  •  
     

    SEARCH CODEWALKERS

    TOOLS YOU CAN USE

    advertisement

    Fetching Database Rows with a Model for the CodeIgniter PHP Framework - The complete source code of the generic model class


    (Page 4 of 4 )

    As I said in the previous section, below I listed the full source code corresponding to the generic model class, this time including the “fetch()” method that you learned before. Here it is for you:

    abstract class MY_Model extends Model

    {

    protected $table = ''; // table associated to the model

    protected $fields = array(); // fields of table associated to the model

    protected $id = NULL; // value of the primary key of the table associated to the model

    protected $data = array(); // model input data

    protected $insertID = NULL; // insertion ID

    protected $numRows = NULL; // number of rows returned by SELECTS

    protected $validation = array(); // model validation rules

    protected $errors = array(); // model errors

     

    /**

    * Constructor

    *

    * @access protected

    */

    protected function __construct()

    {

    parent::Model();

    // get CI super object as a model property

    $this->ci =& get_instance();

    }

     

    /**

    * Sets associated table data for the model

    *

    * @author Alejandro Gervasio

    * @return void

    * @access public

    */

    public function setTableData($table = 'default')

    {

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

    {

    $this->table = $table;

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

    }

    }

     

    /**

    * Sets value of primary key of the associated table for the model

    *

    * @author Alejandro Gervasio

    * @param integer

    * @return void

    * @access public

    */

    public function setID($id)

    {

    $this->id = is_integer($id) AND $id > 0 ? $id : 1;

    }

     

    /**

    * Gets value of primary key of the associated table for the model

    *

    * @author Alejandro Gervasio

    * @return integer

    * @access public

    */

    public function getID()

    {

    return $this->id;

     }

     

    /** Sets input data for the model

     *

    * @author Alejandro Gervasio

    * @param array

    * @return void

    * @access public

    */

    public function setData($data)

    {

    if ( is_array($data) AND count($data) > 0)

     {

    foreach ($data as $key => $value)

     {

    if (array_search($key, $this->fields) === FALSE)

     {

    unset($data[$key]);

     }

    }

    $this->data = $data;

     }

    }

     

    /**

    * Sets validation rules for model data

    *

    * @author Alejandro Gervasio

    * @param array

    * @return void

    * @access public

    */

    public function setValidation($validation)

    {

    if ( is_array($validation) AND count($validation) > 0)

     {

    foreach ($validation as $field => $rule)

     {

    if (array_search($field, $this->fields) === FALSE)

     {

    unset($validation[$key]);

     }

    }

    $this->validation = $validation;

     }

    }

     

    /**

    * Returns a result set with specified fields according to given conditions.

     *

    * @author Alejandro Gervasio

    * @return query result on success - Boolean FALSE on failure

    * @access public

    */

    public function fetch($fields = '*', $where = NULL, $order = 'id ASC', $limit = NULL, $offset = 0, $join = NULL)

    {

    if ($fields != '*')

    {

    $this->db->select($fields);

     }

    if ($this->id != NULL)

    {

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

     }

    elseif($where != NULL)

    {

    $this->db->where($where);

     }

    if ($order != 'id ASC')

    {

    $this->db->orderby($order);

     }

    if ($limit != NULL)

     {

    $this->db->limit($limit, $offset);

     }

    if( $join != NULL)

    {

    $this->db->join($join);

     }

    $query = $this->db->get($this->table);

    $this->numRows = $query->num_rows();

    if ($this->numRows > 0)

     {

    return ($this->numRows > 1 ) ? $query->result() : $query->row();

    }

    $this->errors[] ='No rows were returned by the query.';

     return FALSE;

    }

    }

    For the time being, the model class looks a bit more functional, since it’s capable of fetching one and multiple rows from the specified database table. Nonetheless, there’s still a long road ahead of us, because it’s necessary to code other methods that provide the class with the ability to insert, update and delete database records. But, these will be coded in upcoming tutorials, so for the moment play with the class in its current state and try to incorporate into it your own improvements.

    Final thoughts

    Over this third installment of the series, I coded a core method of the generic model class, which comes in handy for retrieving records from a specified database table according to a number of conditions. This is a typical wrapper for many of the query modifier methods provided by CodeIgniter’s Active Record class, so I suggest that you first familiarize yourself with its underlying logic.

    In the upcoming part, I’m going to define another core method for the model, which this time will be responsible for inserting new rows into the associated database table. Therefore, don’t miss the next article!


    DISCLAIMER: The content provided in this article is not warranted or guaranteed by Developer Shed, Inc. The content provided is intended for entertainment and/or educational purposes in order to introduce to the reader key ideas, concepts, and/or product reviews. As such it is incumbent upon the reader to employ real-world tactics for security and implementation of best practices. We are not liable for any negative consequences that may result from implementing any information covered in our articles or tutorials. If this is a hardware review, it is not recommended to open and/or modify your hardware.
    blog comments powered by Disqus

    MISCELLANEOUS CODE ARTICLES

    - Creating a Web Page Controller with the HMVC...
    - Coding Controllers and Views for the HMVC De...
    - A Sample Web Application with the HMVC Desig...
    - Adding a Class to Parse Views to an HMVC Des...
    - Building a Model Class for the HMVC Design P...
    - Filtering Input Data and Generating HTML For...
    - The HMVC Design Pattern: Working with MySQL ...
    - Dispatching Requests to MVC Triads with the ...
    - Implementing the Hierarchical Model-View-Con...
    - A Web App Based on a Model for the CodeIgnit...
    - Completing a Model for the CodeIgniter PHP F...
    - Validating Input Data with the CodeIgniter P...
    - Deleting Database Records with the CodeIgnit...
    - Inserting Database Records with a CodeIgnite...
    - Fetching Database Rows with a Model for the ...


    © 2003-2012 by Developer Shed. All rights reserved. DS Cluster 4 - Follow our Sitemap