Database interaction in CodeIgniter

by Anuj Kumar

Databases are the backbone behind any Web application. Without a database, you’d have nowhere to hold all of your data, and SQL queries can become long and cumbersome to type out. Thankfully, CodeIgniter gives us a brilliantly simple way to interact with our Database. The database library also makes changing between database types—from MySQL to Oracle, for example—easier, because it acts as a wrapper and provides many functions for us to use on the database.
Loading the library
Loading the Database library is slightly different from loading other libraries. This is because it is large and resides in a different folder, unlike the other libraries.

$this->load->database();

1	$this->load->database();

Performing simple queries
CodeIgniter gives us a function that we can pass a SQL Query to, and the query will be run on the database. Here’s how it works:

$this->db->query('PUT YOUR SQL HERE');

1	$this->db->query('PUT YOUR SQL HERE');

This function is simple to use; you simply use this function in place of any native PHP functions you would use to run queries. This function will return TRUE or FALSE for write queries, and will return a dataset for read queries.
There is another function that you can use for very simple queries; this will only return TRUE or FALSE. It won’t let you cache your query or run the query timer. In most cases you won’t want to use this function.

$this->db->simple_query('PUT YOUR SQL HERE');

1	$this->db->simple_query('PUT YOUR SQL HERE');

The SQL code that you pass to these functions are database-dependent. Only Active Record queries are independent of any type of Database SQL.
Returning values
You can assign the function $this->db->query() to a variable. You can then run a number of helper functions on the variable in order to return the data in different formats. Take the following example:

$query = $this->db->query('SELECT * FROM 'users'')

1	$query = $this->db->query('SELECT * FROM 'users'')

Returning a result object
In this case, returning the result will return an array of objects, or an empty array if the query failed. You would usually use this function in a foreach loop.

foreach($query->result() as $row)
{ 
echo $row->username; 
echo $row->email;
 }

foreach($query->result() as $row)

{

echo $row->username;

echo $row->email;

}

If your query does not return a result, the CodeIgniter User Guide encourages you to check for a failure before using this function.

if($query->num_rows > 0)
{ 
foreach($query->result() as $row){  
echo $row->username;    
echo $row->email;
}
}

if($query->num_rows > 0)

{

foreach($query->result() as $row){

echo $row->username;

echo $row->email;

}

Returning a result array You are also able to return the result dataset as an array. Typically, you would use this function inside a foreach loop as well.

foreach($query->result_array() as $row){
echo $row['username']; 
echo $row['email'];
 }

foreach($query->result_array() as $row){

echo $row['username'];

echo $row['email'];

}

Returning a row object
If your query is only expected to return a single result, you should return the row by using the following function. The row is returned as an object.

if($query->num_rows() > 0){
$row = $query->row();   
echo $row->username;
echo $row->email;
}

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

$row = $query->row();

echo $row->username;

echo $row->email;

}

You can return a specific row by passing the row number as a digit in the first parameter.

$query->row(2);

1	$query->row(2);

Returning a row array
You can return a row as an array, if you prefer. The function is used in the same way as the previous example.

if($query->num_rows() > 0){ 
$row = $query->row_array();   
echo $row['username'];
echo $row['email'];
 }

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

$row = $query->row_array();

echo $row['username'];

echo $row['email'];

}

You can return a numbered row by passing the digit to the first parameter, also.

$query->row_array(2);

1	$query->row_array(2);

Result helper functions
Besides the helper function that helps to return the dataset in different ways, there are some other more generalized helper functions.
Number of rows returned
Used in the same way as the other helper functions, this will return the total number of rows returned from a query. Take the following example:

echo $query->num_rows();

1	echo $query->num_rows();

Number of fields returned
Just like the previous function, this will return the number of fields returned by your query.

echo $query->num_fields();

1	echo $query->num_fields();

Free result
This function will remove the resource ID associated with your query, and free the associated memory. PHP will usually do this by default, although when using many queries you may wish to use this to free up memory space.