CakePHP Tutorial for Beginners

CakePHP is an open source web application framework. It follows the Model-View-Controller (MVC) approach and written in PHP. CakePHP makes building web applications simpler, faster and require less code.

This CakePHP tutorial will drive you to the right direction for getting started with CakePHP framework and provide basic guide of CakePHP application development. Our step by step cakePHP tutorial helps beginners for install and configures the CakePHP application. You can learn CakePHP from scratch with our easy tutorial. Also we will develop a sample CakePHP project and it will help you for better understanding the whole process.

Application flow of the CakePHP are given below:


Download CakePHP

At first you need to download the stable release of CakePHP from Github – CakePHP Releases

Basic Configuration

  • Step1: Extract zip file and change folder name with your desire project name. For example cakephp/.
  • Step2: Move the cakephp/ folder to the localhost server. Your directory setup looks like the following.
    • /cakephp
      • /app
      • /lib
      • /plugins
      • /vendors
      • .htaccess
      • index.php
      • README
  • Step3: Create database at the phpMyAdmin. For example cakephp_db.
  • Step4: Open the app/Config/core.php file and make the following changes.
    •  Change the value of Security.salt at Line no.225.
      • Before changes:
      • After changes:
    •  Change the value of Security.cipherSeed at Line no.230.
      • Before changes:
      • After changes:
  • Step5: Rename database.php.default file to database.php at the app/Config/ directory.
  • Step6: Open the “app/Config/database.php” file and make the following changes.
    •  Go to the line no.67 and replace the values of host, login, password, database_name with your database host, database username, database password and database name.

      • Before changes:
        public $default = array(
        'datasource' => 'Database/Mysql',
        'persistent' => false,
        'host' => 'localhost',
        'login' => 'user',
        'password' => 'password',
        'database' => 'database_name',
        'prefix' => '',
        //'encoding' => 'utf8',
      • After changes:
        public $default = array(
        'datasource' => 'Database/Mysql',
        'persistent' => false,
        'host' => 'localhost',
        'login' => 'root',
        'password' => '',
        'database' => 'cakephp_db',
        'prefix' => '',
        //'encoding' => 'utf8',
  • Step7: Run the project URL(http://localhost/cakephp/) at the browser.

CakePHP Naming Conventions

  • Controller Conventions – Controller class names are plural, CamelCased and end in Controller.(PostsController, LatestPostsController)
  • Model Conventions – Model class names are singular and CamelCased.(Post, LatestPost)
  • Database Conventions – Table names corresponding to CakePHP models are plural and underscored. (posts, latest_posts)
  • View Conventions – View template files are named after the controller functions they displayed, in an underscored form. The postDetails() function of PostController class will look for a view template in app/View/Post/post_details.ctp. The basic pattern is app/View/Controller/underscored_function_name.ctp

Sample Project

In this sample project we will create a products table at the cakephp_db database. And we will insert some data manually at this table. We will fetch and display products in our sample CakePHP project.

Table Creation & Data Insert: Following SQL is used for products table creation.

CREATE TABLE `products` (
 `title` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
 `description` text COLLATE utf8_unicode_ci NOT NULL,
 `price` float(10,2) NOT NULL,
 `created` datetime NOT NULL,
 `modified` datetime NOT NULL,
 `status` tinyint(1) NOT NULL DEFAULT '1',

Once table creation is completed, insert some demo product data into this table.

Controller: Create a products controller with ProductsController class into the app/Controller/ directory. Controller file and class name should be ProductsController.

class ProductsController extends AppController {
    public function 
index() {
//fetch products resultset from databse
$products $this->Product->find('all',array('fields'=>array('','Product.title','Product.description','Product.price','Product.created','Product.status'),'conditions'=>array('Product.status'=>1)));
//set products data and pass to the view 

View: Create view for display products in app/View/ directory. The controller class name is ProductsController and method is index. For creating the index view, we need to Products/ directory and a index.ctp file. So, the complete path of the view file (index.ctp) would be app/View/Products/index.ctp.

<?php foreach($products as $row): ?>
        <h1><?php echo $row['Product']['title']; ?></h1>
        <h6>Price: <?php echo $row['Product']['price']; ?></h6>
        <p><?php echo $row['Product']['description']; ?></p>
<?php endforeach; ?>

Model: Model creation is not required until you need validation or associations.

Routes: Open the app/Config/routes.php file and set the default controller and action. Go to the line no.27 and change controller name from "pages" to "products" and action name from "display" to "index". If you want to load the different view for this action, you need to pass the view file name after the action element.

Router::connect('/', array('controller' => 'products''action' => 'index'));

Testing: Run the base URL at the browser, products list would displayed.


 Our next post will explain about layout, database and advanced label of CakePHP. Please follow CodexWorld for notify about the next post.


  1. Dhaval Said...
  2. Ambili R Said...
  3. Khetesh Said...
  4. Yasar Rana Said...
  5. Sanjay Said...
  6. Uday Bhanu Said...
  7. Ankit Prajapati Said...
  8. Kishor Said...
  9. Neel Said...
  10. Arvind Sharma Said...
  11. Kanaiya Said...
  12. Chintan Singh Said...
  13. Mandeep Said...

Leave a reply

CodexWorld Newsletter

Subscribe CodexWorld updates via email and get every new post delivered to your inbox.