Tag: codeiginter 3

Categories
Codeigniter Programming

CodeIgniter 3 – Create your own Hello World with simple form and database!

CodeIgniter 3 Hello World

In the previous tutorial, you you learnt how to remove the “index.php” from URL. Now, we are ready for the “Hello World!” complete with code. 

GOALS!

In this tutorial, we will learn CodeIgniter 3 MVC by making a Hello World! program, complete with database, introduction to CRUD operations, form, switching pages and code. We will cover a LOT in this tutorial and I am sure you will get a lot of knowledge about CodeIgniter 3. Check the following list to see what you will learn.

  1. Create a database to be used by Model
  2. Connect the database to the web application
  3. Create a custom model:
    • Model will use the Database
    • model will contain a “Hello World!” in a function as a return value for controller to use.
  4. Create two custom views:
    • We will Load views from controller.
    • Pass data to the views using controller.
    • Use data from controller in Views.
    • Make a form which will work along with Controller.
    • Call controller custom function.
    • Pages association (move from page to page)
  5. Create a controller that will:
    • Load the model.
    • Use model function in controller.
    • Receive input from model in controller.
    • Interact with database using model.
    • Pass data to views using data[] array.
    • Create custom controller function.
    • Load views.
    • Load view from a button in another view.
    • Use helper;
    • Use constructor.

As you can see, this is a seriously deep “Hello World!” tutorial. I am sure that you will learn a lot in the end. You will be prepared to learn more without having to worry about learning the basics. Lets get started!

BEGIN!

Creating the Database

1. Create a Database

We will create a database to be used for this tutorial.

  1. In XAMPP, go to localhost/phpmyadmin/
  2. Create a  database called “citutorial“
  3. Create a table using this SQL query 
    CREATE TABLE `citutorial`.`helloworldtable` ( `id` INT NOT NULL AUTO_INCREMENT , `message` VARCHAR(255) NOT NULL , PRIMARY KEY (`id`) ) ENGINE = InnoDB;
  4. Now make a simple “Hello World!” entry in the table so that the table has just a single entry of
    id = 1
    message = Hello World!

Eventually, your table should look like this,

 

2. Connect the Database

Go to the /application/config/database.php and modify the settings for the database citutorial. You need to input the database username, password and database name. By default, the username in XAMPP is “root” and password is empty i.e. “”. And the database name is “citutorial“. So the settings are,

$active_group = 'default';
$query_builder = TRUE;

$db['default'] = array(
	'dsn'	=> '',
	'hostname' => 'localhost',
	'username' => 'root',
	'password' => '',
	'database' => 'citutorial',
	'dbdriver' => 'mysqli',
	'dbprefix' => '',
	'pconnect' => FALSE,
	'db_debug' => (ENVIRONMENT !== 'production'),
	'cache_on' => FALSE,
	'cachedir' => '',
	'char_set' => 'utf8',
	'dbcollat' => 'utf8_general_ci',
	'swap_pre' => '',
	'encrypt' => FALSE,
	'compress' => FALSE,
	'stricton' => FALSE,
	'failover' => array(),
	'save_queries' => TRUE
);

Creating the Model

Understanding the Model

We will now understand the model which will retrieve the “Hello World!” message from the database table we created in steps 1 & 2. First, I will show you what method I used and then you will get the entire model code.

For this tutorial, I have first selected the “table” in our database using this line of code.

// $this->db->from("NAME_OF_TABLE");
$query = $this->db->from("helloworldtable");

Then, I provided the criteria to find the “Hello World!” message from the table like this. Note that in the following line of code, “message” is the column name and “Hello World!” is the specific search keyword that is to be matched in order to retrieve the value.

//$this->db->where('TABLE_COLUMN_NAME', "SEARCH_KEYWORD");
$query = $this->db->where('message', "Hello World!");

Then, I checked if the query was successful and performed an action on the basis of the success or failure of the query like so.

if(!$query){
	echo "Failed to find the \"Hello World\" Entry<br>";
}else{
	echo "Successfully found the \"Hello World\" Entry<br>";
	return $this->db->get()->result();
}

Note that in the end, I simply returned the result of the query like this.

return $this->db->get()->result();

(Alternative approach)

Now, note that all of this could also have been done using the following model function (which I won’t use).

function return_helloworld_message(){
	$this->db->from("helloworldtable");
	$this->db->where('message', "Hello World!");
	return $this->db->get()->result();
}

3. Creating the model

Lets finally create the model file and add the code.

  1. Go to \application\models\1_hello_world\ and create a file called “Helloworld_model.php”.
  2. Double check that the file name starts with a capital letter since it is important in CI3.0+ versions.
  3. Now, open the file and add the following code to it. 
    <?php
defined('BASEPATH') OR exit('No direct script access allowed');

class Helloworld_model extends CI_Model {

	public function __construct()
    {
            // Call the CI_Model constructor
            parent::__construct();
    }

    function return_helloworld_message(){
    	// From the given table,
    	$query = $this->db->from("helloworldtable");

    	// Find where the column "message" has a value called "Hello World!"
    	$query = $this->db->where('message', "Hello World!");

    	// Check if the query was successful
    	if(!$query){
    		echo "Failed to find the \"Hello World\" Entry
";
    	}else{
    		echo "Successfully found the \"Hello World\" Entry
";
    		return $this->db->get()->result();
    	}
    	// Then, return the value from Model to the calling controller
    }
}

This completes the model to be used in this tutorial.  Next, we will prepare our views to receive the input.

 

Creating the Views

For this tutorial, we will make two views.

  1. First view will be used to request a “Hello World!” query.
  2. Second view will be used to show the output (either failure or success)

4.1 Creating a view to request for a “Hello World!” message

This view will show a page which will ask the user to press a button to perform a request. Here are some points to note:

Follow these steps to make the request view..

  1. Go to \application\views\1_hello_world\ and create a file called “request_a_helloworld_message.php”.
  2. Add the following code to it. 
    <?php
defined('BASEPATH') OR exit('No direct script access allowed');
?>
<?php 

     echo $buttonText;
     echo $pageTitle;
     echo $heading;
?>
<form action="<?php echo base_url();?>1_hello_world/helloworld/requestModel" method="post">
<?php echo $button_info; ?>
<input type="submit" value="<?php echo $buttonText; ?>" />
</form>

4.2 Creating a view to show result

Upon completion of the request, an output message will be generated. This could contain either the “Hello World!” or an error message informing us about the failure to find the “Hello World!” message in database table.

    1. Go to \application\views\1_hello_world\ and create a file called “resultDisplay.php”.
    2. Add the following code to it 
      <?php defined('BASEPATH') OR exit('No direct script access allowed'); ?>
<?php
      echo pageTitle;
      foreach ($modelData as $row) { 
            echo $row--->message;
      }
?>
<form action="&lt;?php echo base_url();?&gt;1_hello_world/helloworld/" method="post">
	<input type="submit" value="<?php echo $buttonText; ?>" />
	
	<table>
		<tr>
			<td><?php echo $button_info; ?></td>
		</tr>
	</table>
</form>

 

Creating the Controller

Now comes the really interesting component of CodeIgniter. The Controller! The controller will allow us to perform the following functions of the Hello World! tutorial application.

    1. Load the database to be used by the Model.
    2. Allow switching between two views with a button.
    3. Send data from controller and model to the view.
    4. Loading views.
    5. Calling model functions and passing its result into the view.

Now, lets first understand how I used the controller in this tutorial.

Understanding the Controller

In my controller. I have two functions which are,

    1. index() function which by default loads a request view.
    2. requestModel() function which is called by clicking a button in the “request_a_helloworld_message.php”  view.

 

index()

In this function, I am simply loading a view and passing data to it. The data is passed as an array like this,

$data['pageTitle'] = "Codeonion Tutorials!";
$data['heading'] = "Welcome to Hello World! Request page!";
$data['button_info'] = "Press the button to see the message from model.";
$data['buttonText'] = "Submit a Request to model";

The reason I have done it is to show you how it is possible to control the data you wish to show in view from the controller, instead of actually typing it into the view as simple HTML.

When loading views, it is possible to pass data to it. You can even load entire views into variables and pass them into the view.

$this->load->view('1_hello_world/request_a_helloworld_message', $data);

 

requestModel()

In this function, I am calling a model function and basically passing its result into the view.

I am calling a model and giving it a name of “helloworldmodel” like this,

$this->load->model('1_hello_world/Helloworld_model', 'helloworldmodel');

Afterwards, I have called a model function called “return_helloworld_message()” and stored its output in “$data[‘modelData’]” like this,

$data['modelData'] = $this->helloworldmodel->return_helloworld_message();

Finally, as before, I have loaded a view to show results and passed data to it like this.

$this->load->view('1_hello_world/resultDisplay', $data);

 

5. Creating the controller

Now, we will finally create a controller and put the code in it.

  1. Go to \application\controllers\1_hello_world\ and create a “Helloworld.php” and make sure that the file name starts with a capital letter
  2. Copy the following code into the Helloworld.php controller. 
    <?php
defined('BASEPATH') OR exit('No direct script access allowed');

class Helloworld extends CI_Controller {
	public function __construct()
        {
            parent::__construct();
            // Helpers and libraries called in constructor will be available
            // in every function of this Helloworld controller class
            $this->load->database();
            $this->load->helper("URL");
        }

	public function index(){

		// General strings stored in $data array
		// These are to be displayed in the "request_a_helloworld_message" view
		$data['pageTitle'] = "Codeonion Tutorials!";
		$data['heading'] = "Welcome to Hello World! Request page!";
		$data['button_info'] = "Press the button to see the message from model.";
		$data['buttonText'] = "Submit a Request to model";

		// And we pass the data into the view.
		$this->load->view('1_hello_world/request_a_helloworld_message', $data);
	}

	public function requestModel(){

		// General Variables just like in index() function of this controller
		$data['pageTitle'] = "Codeonion Tutorials!";
		$data['heading'] = "This is the result!";
		$data['button_info'] = "Press the button to see the Hello World! message.";
		$data['buttonText'] = "Back";

		// We load the model
		$this->load->model('1_hello_world/Helloworld_model', 'helloworldmodel');

		// We store the result of modal function in $data array
		$data['modelData'] = $this->helloworldmodel->return_helloworld_message();

		// We pass $data array into the "resultDisplay" view
		$this->load->view('1_hello_world/resultDisplay', $data);

	}
}

    Now, you are ready to test the application.

 

Testing the Hello World! application

  1. Go to your browser (chrome in my case) and go to the following address (or the correct address according to your own setup)
    http://localhost/tutorial/1_hello_world/helloworld
  2. You will see the following on the browser
  3. Press the “Submit a Request to model” button and you will go to the following link
    http://localhost/tutorial/1_hello_world/helloworld/requestModel
  4. At this point, you will be seeing this output,
  5. At this point, you can press back to start over.

You can now see that your application can retrieve data from database. This is it! the tutorial is complete!

Conclusion

You have learnt how to create a complete MVC application using CodeIgniter complete with the database. You now have the knowledge required to learn and develop more advanced web applications.

If you found my post helpful or have any questions, please leave a comment. [button link=”https://www.facebook.com/ubaaconsultants” type=”small” newwindow=”yes”] Facebook[/button] [button link=”https://twitter.com/Codeonion” type=”small” newwindow=”yes”] Twitter[/button]

If you think that there is something missing, or you would like me to add something or even, if you wish to request a tutorial, just let me know and I will make a tutorial just for you.

Back to CodeIgniter Tutorials

Categories
Codeigniter Programming

CodeIgniter 3 Tutorial 1: Download, Installation, Introduction and Welcome!

Back to CodeIgniter Tutorials

This is the first part of CodeIgniter 3 tutorials. CodeIgniter 3.0 introduced a lot of upgrades over 2.x versions of CodeIgniter. Users who wish to upgrade to CodeIgniter 3 may have to perform changes as mentioned here in the official CodeIgniter 3.0 documentation.

Here are my Tutorials for CodeIgniter:

CodeIgniter 3 Tutorials
CodeIgniter 2.2 Tutorials

This tutorial series is for new users of CodeIgniter users who wish to start with CodeIgniter 3.x. We will start with downloading Codeigniter.

CodeIgniter can be obtained from any of the two places.

  1. Official Website Here
  2. Official Github Repository Here

Lets download from the official website

Now, install XAMPP as I have explained here and also here for my CodeIgniter 2.2 Tutorials Series.

Now, once you have installed XAMPP and downloaded CodeIgniter 3, we can now start installing CodeIgniter. Follow the following steps.

  1. Assuming you installed XAMPP in D:\, go to D:\xampp\htdocs
  2. For this example, create a subfolder “tutorial” so we now have, 
    D:\xampp\htdocs\tutorial
  3. Now, extract the contents of downloaded CodeIgniter files here.
  4. You will now have the following base structure of CodeIgniter.
  5. CodeIgniter is INSTALLED!
  6. Here is the simple explanation of all of these files and folders (You can skip if you are already familiar otehrwise, I highly recommend reading the brief descriptions below):
    1. \application\
      (108Kb, 45 Files)
      This folder contains the web application that you will develop using CodeIgniter.
    2. \system\
      (2.05MB, 202 Files)
      This folder contains the actual CodeIgniter framework. In other words, the cool stuff! It is not necessary, but it would be nice to open this folder by yourself and see how everything works behind the scenes. Also, this is the folder that is affected with each version. So yuou might be required to make changes to this folder if you ever wish to upgrade.
    3. \user_guide\
      (6.41MB, 191 Files)
      This folder contains the latest CodeIgniter documentation at the time of release of whichever version that you downloaded. It is SAFE TO DELETE this folder at the cost of losing offline official guide. I personally delete these from my projects to save size.
    4. \.gitignore
      This file tells Github to ignore the specified files and folders to be ignored when committing to a repository.
    5. \composer.json
      This file is used with composer to keep the packages up to date.
    6. \contributing.md
      Simply put, this is a readme file for “contributing to the CodeIgniter project” topic.
    7. \index.php
      This file contains variables that control how your application behaves. For example,

      1. Error Reporting levels
      2. \system\ folder name (which it allows to be changed)
      3. Want to know how to change \application\ folder name? This file does it!
      4. Want to move the \application\view\ folder out of the \application\ folder? index.php does it!
      5. Override application routing.
      6. Meddle with the config parameters.

 

And some more parameters which should not be touched and if you did, then God help you.

 

    • \license.txt
      Legal stuff about CodeIgniter Project
    • \readme.rst
      Official Readme of the CodeIgniter project!
    • You will see the following default welcome screen:

Back to CodeIgniter Tutorials