Kohana 3 :: How to Install Manually or Through the Command Line

Installing Kohana is a breeze. It’s so easy, this whole page might be pointless.

Installing Manually

Download the zip and unzip the files inside the DocumentRoot of your localhost.
Next, fire up http://localhost in your favorite browser. What you’ll see is the installation page, a script that runs a bunch of checks to make sure you have everything required in order to run Kohana. You’re expecting green lights; if you get a red light, proceed to debugging red lights.
Ok, assuming everything went fine, go ahead and delete the install.php file, as well as the lines that check for its existence in index.php:

// Not needed anymore, delete if you want
if (file_exists('install'.EXT))
    // Load the installation check
    return include 'install'.EXT;

Refresh your localhost, you should see the “hello world” text. Nice! You’re not done yet though. If you navigate to localhost/welcome/index, you’ll get a big fat error, ouch! That’s due to “pretty URLs” being disabled by default! You can enable them by following these steps:

Rename example.htaccess to .htaccess (or whatever name you specified in the AccessFileName directive of your Apache configuration file.)
Open .htaccess, and change the RewriteBase to / (assuming index.php is at the root of your localhost.)
Make sure you have mod_rewrite enabled.
Make sure AllowOverride is set to All in your Apache conf file (it most likely is.)

    'index_file'   => FALSE,

in your bootstrap, otherwise Kohana will auto inject index.php in the URL everytime it redirects.

Once you’ve made these changes, refresh localhost/welcome/index. You should see the “hello world” text again. If so, congrats, you’ve successfully installed Kohana! (now would be a good time to have a beer )

Did you run into a problem? I’ve recorded a video demonstrating the steps above; see if it helps:

Command line Installation

Time for some fun, let’s install Kohana through the command line on a DreamHost account!

cd documentroot
git clone git://github.com/kohana/kohana.git
# The kohana project contains a bunch of submodules (which are basically git projects within git projects,)
# and the files they contain aren't downloaded by default, which explains why your system folder is empty.
# Yeah, the system folder is its own git project.
# To download the submodules’ files:
# Initialize your local configuration file
git submodule init
# Fetch all the data from that project
git submodule update

… that’s pretty much it. Actually, I decided to do the rest in a video: (Sorry for the abrupt halt, but such a dry subject, makes text narration painful.)



Blogger said...

DreamHost is definitely the best web-hosting company for any hosting plans you require.

Post a Comment