Lets check to make sure we have everything needed before going on.

• *AMP (Apache MySQL PHP) install
• Knowledge of PHP
• Know what a frame work is (Framework Article)
• Know what MVC is (Wikipedia Entry)

Lets go!
Download:
Download the latest Kohana 3.0 PHP (At the time of this writing: 3.0.1.2) and unpack it somewhere.

Install:
Open the file we just downloaded in your favorite archive program and extract it to a temporary location. Open that temporary location and you should have a folder that is named “kohana” or something like that. Open that folder. Open a new window and open the root directory of your *AMP install. Since I’m using WAMP Server – mine is “C:\wamp\www\”. Next make a new folder in there named “mykohana3″. Copy the files from the “kohana” directory to the “mykohana3″. Make sure your *AMP installation is up and running then point your browser to “http://yourserver/mykohana3/”. You should have a screen stating that everything is “OK”.

If everything is “OK”, then remove or rename the “install.php” file in the “mykohana3″ directory. Next open up the “example.htaccess” file and change the following line:

RewriteBase /kohana/

to:

RewriteBase /mykohana3/


Save it as “.htaccess”.

Now open the “bootstrap.php” file located in the “application” folder and cange the following line:

Kohana::init(array('base_url' => '/kohana/'));

to:

Kohana::init(array('base_url'  => '/mykohana3/',
                   'index_file'=> ''));

Save this file then refresh your browser. You should get something that reads “hello, world!” on your screen.

You might already notice that configuration for KO3 is a little bit more involved, editing two files instead of one, which isn’t a big deal at all.

Now to make our first controller! Open a new document and put the following into it:

<?php
defined('SYSPATH') or die('No direct script access.');

class Controller_Ko3 extends Controller
 {
    public function action_index()
     {
        $this->request->response = 'My First Kohana 3.0 Controller';
     }
 } // End

Save this as “ko3.php” in the “application/classes/controller” folder. You might have noticed another difference between Kohana 2.3.x and 3.0 is the directory structure, not really all that much of difference. Now that you have it saved, point your browser to “http://yourhost/mykohana3/ko3″. You should she “My First Kohana 3.0 Controller” on your screen now.

Now for an explanation of the code.

defined('SYSPATH') or die('No direct script access.');

This line basically tells PHP not load this file directly. It can only be included from the framework.

class Controller_Ko3 extends Controller

This creates an controller which is a class that is extended from the Controller class that is part of the framework.

public function action_index()

This created a public method called “action_index”. The “action_index” method is a default action that is loaded by the framework. It’s like your index.php file so to say.

$this->request->response = 'My First Kohana 3.0 Controller';

This will output “My First Kohana 3.0 Controller” to the screen. This basically works like “echo”.

Pretty easy eh? Now if you wanted to add addition action to your controller you would add another public method that has a prefix of “action_” and the you would access via going to “http://yourserver/mykohana3/controller/action”

Let go ahead and add a new method to our “ko3″ controller by adding the following after the “action_index” method:

    public function action_another()
     {
        $this->request->response = 'Another action';
     }

Save the file and loaded up “http://yourserver/mykohana3/ko3/another” in your browser. If all goes well you should see “Another action” in your browser.

That was fun an all, but lets make it a little bit more dynamic!

Copy this code and put it after the “action_another” method:

    public function action_dynamic($say)
     {
        $this->request->response = 'You said: '.$say;
     }

Save this and load “http://yourserver/mykohana3/ko3/dynamic/Monkey” and you should see “You said: Monkey”

Untill next time, when I will go over the first part of views, happy coding!
Sources used: Unofficial Kohana 3 Wiki

Before we get into this tutorial, lets go over what will be required.

• *AMP (Apache MySQL PHP) install
• Knowledge of PHP
• Know what a frame work is (Framework Article)
• Know what MVC is (Wikipedia Entry)

Lets get started!
Download:
Load http://www.kohanaphp.com in your favorite browser and click the download link. On this page, click the “Download Kohana!” button. You should be prompted to save a file. Go a head and save the file some where. At the time of this writing, the version was at 2.3.2.

Install:
Open the file we just downloaded in your favorite archive program and extract it to a temporary location. Open that temporary location and you should have a folder that is named “Kohana_v2.3.2″ or something like that. Open that folder. Open a new window and open the root directory of your *AMP install. Since I’m using WAMP Server – mine is C:\wamp\www\. Next make a new folder in there named “myfirstkohana”. Copy the files from the “Kohana_v2.3.2″ directory to the “myfirstkohana”. Make sure your *AMP installation is up and running then point your browser to http://yourserver/myfirstkohana/ . You should have a screen stating that everything is “OK”.

If everything is “OK”, then remove or rename the “install.php” file in the “myfirstkohana” directory. Next we want to navigate into the application folder, then in the the config folder. Open the file named “config.php” in your favorite editor. There should be a line that reads: “$config['site_domain'] = ‘/kohana/’;” (Line 7 for me). We need to change the “/kohana/” part to reflect our install. So replace “/kohana/” with “/myfirstkohana/”. Also search for “$config['index_page'] = ‘index.php’;” and make the “index.php” part blank, so that line (Line 21 for me) should now read “$config['index_page'] = ”;”. Save that file.

Create a new document, cut and paste the following into it:

# Turn on URL rewriting
RewriteEngine On

# Put your installation directory here:
# If your URL is www.example.com/, use /
# If your URL is www.example.com/kohana/, use /kohana/
RewriteBase /myfirstkohana/

# Do not enable rewriting for files or directories that exist
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d

# For reuests that are not actual files or directories,
# Rewrite to index.php/URL
RewriteRule ^(.*)$ index.php/$1 [PT,L]

Save this file in the “myfirstkohana” directory as “.htaccess”.

These changes will help with creating clean URLs that help with SEO efforts.

Reload the browser page and you should get something like this:

If everything looks good, then we have successfully installed Kohana PHP. Now lets make it do stuff!

My first controller:
Open a new document and put the following into it:

<?php
defined('SYSPATH') or die('No direct access allowed.');

class Hello_Controller extends Controller
 {
  public function index()
   {
    echo 'Hello World!';
   }
 }

Save this in “myfirstkohana/application/controllers” as “hello.php”. Here’s a little explaination of what we did. The line “defined(’SYSPATH’) or die(’No direct access allowed.’);” basically prevents the file from being executed by itself. The next line “class Hello_Controller extends Controller” creates a class called “Hello_Controller” that extends the controller object. The rules to follow for creating controllers is as follows:

• Must reside in a controllers (sub-)directory
• Controller filename must be lowercase, e.g. articles.php
• Controller class must map to filename and capitalized, and must be appended with _Controller, e.g. Articles_Controller
• Must have the Controller class as (grand)parent
• Controller methods preceded by ‘_’ (e.g. _do_something() ) cannot be called by the URI mapping

stolen from: Kohana Docs

The first method, “index” is the default action. Pretty easy right? If you point your browser to “http://yourserver/myfirstkohana/hello/” you should see “Hello World!” on the screen now.

What if you wanted to exend the controller to do something else? Let add another method in the class that looks like:

public function america()
 {
  echo 'Hello America!';
 }

Now the hello.php should look like:

<?php
defined('SYSPATH') or die('No direct access allowed.');

class Hello_Controller extends Controller
 {
  public function index()
   {
    echo 'Hello World!';
   }

  public function america()
   {
    echo 'Hello America!';
   }
 }

Save this and open “http://yourserver/hello/america/”. Notice that is now show “Hello America!” on the screen. That wasn’t too hard, but lets make this a little more dynamic with arguements. Make a new method that will look like this:

public function name($name)
 {
  echo 'Hello ',$name,'!';
 }

Load up “http://yourserver/hello/name/monkey” and you should see “Hello monkey!” on your screen. Pretty straight forward. Let make it even more ‘friendly’. Add this to the top of the class:

public function __call($method, $arguments)
 {
  $this->name($method);
 }

If we load up “http://yourserver/myfirstkohana/hello/MrGuy/” we should get the same thing as if we loaded “http://yourserver/myfirstkohana/hello/name/MrGuy/” which would be “Hello MrGuy!”.

That’s it for this lesson. Next time we’ll be looking over Views.
Click here to download the files and don’t forget to check out some great computer and electronic deals.