Install Yii PHP Framework on Ubuntu/Debian

Yii is an open source, fast, secure and as well as high performance PHP framework used for developing large-scale web applications. In this walk-through let us learn how to install Yii on Ubuntu/Debian and its derivatives.

Install Yii On Ubuntu

I tested this under Ubuntu 12.10 Server, although it will work on Ubuntu/Debian new editions. Well, let us get started!

If you haven’t installed Apache and PHP, install them with following command:

sk@server1:~$ sudo apt-get install apache2 php5 libapache2-mod-php5

If things goes well, you should see the Apache home page as shown below. Navigate to http://ip-address/ from your browser to see Apache home page. - Chromium_007

Create MySQL database for Yii

Let us create a database ‘yiidb‘ and a database user called ‘yiiuser‘ with password ‘ubuntu‘. Change these values as per your scenario:

sk@server1:~$ mysql -u root -p
Enter password: 
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 45
Server version: 5.5.31-0ubuntu0.12.10.1 (Ubuntu)

Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved. 

Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql> create database yiidb;

Query OK, 1 row affected (0.02 sec)

mysql> GRANT ALL PRIVILEGES ON yiidb.* TO 'yiiuser' IDENTIFIED BY 'ubuntu';

Query OK, 0 rows affected (0.00 sec)

mysql> flush privileges;

Query OK, 0 rows affected (0.01 sec)

mysql> exit


Now grab the latest version from the official download page or simply download it via terminal as shown below:

sk@server1:~$ wget

Extract the downloaded file:

sk@server1:~$ tar zxvf yii-1.1.13.e9e4a0.tar.gz

It will be extracted as a folder called “yii-1.1.13.e9e4a0” in your current directory. Change to this directory and move all contents to /var/www/ folder as shown below:

sk@server1:~$ sudo mv yii-1.1.13.e9e4a0/ /var/www/yii

Now create a directory under /var/www/yii/ directory for a sample project. Let’s call it as unixmen. So here I create a folder called unixmen under /var/www/yii/ directory:

sk@server1:~$ sudo mkdir /var/www/yii/unixmen

Assign the full permission for unixmen directory:

sk@server1:~$ sudo chmod -R 777 /var/www/yii/unixmen/

Enter the following command to begin installation:

sk@server1:~$ php /var/www/yii/framework/yiic.php webapp /var/www/yii/unixmen/
 Create a Web application under '/var/www/yii/unixmen'? (yes|no) [no]:yes
 mkdir /var/www/yii/unixmen/css
 generate css/screen.css
 generate css/bg.gif
 generate css/form.css
 generate css/ie.css
 generate css/print.css
 generate css/main.css
 generate index-test.php
 generate index.php
 mkdir /var/www/yii/unixmen/images
 mkdir /var/www/yii/unixmen/themes
 mkdir /var/www/yii/unixmen/themes/classic
 mkdir /var/www/yii/unixmen/themes/classic/views
 mkdir /var/www/yii/unixmen/themes/classic/views/system
 mkdir /var/www/yii/unixmen/themes/classic/views/layouts
 generate themes/classic/views/.htaccess
 mkdir /var/www/yii/unixmen/themes/classic/views/site
 mkdir /var/www/yii/unixmen/assets
 mkdir /var/www/yii/unixmen/protected
 mkdir /var/www/yii/unixmen/protected/data
 generate protected/data/testdrive.db
 generate protected/data/schema.sqlite.sql
 generate protected/data/schema.mysql.sql
 mkdir /var/www/yii/unixmen/protected/controllers
 generate protected/controllers/SiteController.php
 mkdir /var/www/yii/unixmen/protected/tests
 generate protected/tests/phpunit.xml
 mkdir /var/www/yii/unixmen/protected/tests/fixtures
 mkdir /var/www/yii/unixmen/protected/tests/unit
 generate protected/tests/WebTestCase.php
 mkdir /var/www/yii/unixmen/protected/tests/functional
 generate protected/tests/functional/SiteTest.php
 generate protected/tests/bootstrap.php
 mkdir /var/www/yii/unixmen/protected/tests/report
 mkdir /var/www/yii/unixmen/protected/runtime
 mkdir /var/www/yii/unixmen/protected/messages
 mkdir /var/www/yii/unixmen/protected/config
 generate protected/config/main.php
 generate protected/config/console.php
 generate protected/config/test.php
 mkdir /var/www/yii/unixmen/protected/extensions
 mkdir /var/www/yii/unixmen/protected/views
 mkdir /var/www/yii/unixmen/protected/views/layouts
 generate protected/views/layouts/main.php
 generate protected/views/layouts/column1.php
 generate protected/views/layouts/column2.php
 mkdir /var/www/yii/unixmen/protected/views/site
 generate protected/views/site/login.php
 generate protected/views/site/index.php
 generate protected/views/site/contact.php
 mkdir /var/www/yii/unixmen/protected/views/site/pages
 generate protected/views/site/pages/about.php
 generate protected/views/site/error.php
 mkdir /var/www/yii/unixmen/protected/components
 generate protected/components/UserIdentity.php
 generate protected/components/Controller.php
 mkdir /var/www/yii/unixmen/protected/commands
 mkdir /var/www/yii/unixmen/protected/commands/shell
 generate protected/yiic.php
 mkdir /var/www/yii/unixmen/protected/migrations
 mkdir /var/www/yii/unixmen/protected/models
 generate protected/models/ContactForm.php
 generate protected/models/LoginForm.php
 generate protected/.htaccess
 generate protected/yiic
 generate protected/yiic.bat

Your application has been created successfully under /var/www/yii/unixmen.

Now test the new project by navigating to http://ip-address/yii/unixmen from your browser.

My Web Application - Chromium_008

Yii Framework has been installed now.

Enable Yii code generation tool GiiModule

Starting from version 1.1.2, Yii is equipped with a web-based code generation tool called GiiModule. GiiModule is a module which provides web-based code generation capabilities.

To enable GiiModule, edit the main.php file found under /var/www/yii/unixmen/protected/config/ directory:

sk@server1:~$ sudo nano var/www/yii/unixmen/protected/config/main.php

Scroll down to modules section. It will look like as shown below:

 // uncomment the following to enable the Gii tool
 'password'=>'Enter Your Password Here',
 // If removed, Gii defaults to localhost only. Edit car$

Remove  “/*” and “*/” lines to uncomment and enter your ip address series in the ipFilters line. And specify the password to login to code generator. I use ubuntu as my password. So after modification, it will look like as follows:

 // uncomment the following to enable the Gii tool




 // If removed, Gii defaults to localhost only. Edit car$


Scroll down further, you will find db section looks like as follows:

 'connectionString' => 'mysql:host=localhost;dbname=test$
 'emulatePrepare' => true,
 'username' => 'root',
 'password' => '',
 'charset' => 'utf8',

Remove  “/*” and “*/” lines to uncomment and enter your database name, database username and password. So after the modification, it will look like as follows:

// uncomment the following to use a MySQL database
 'connectionString' => 'mysql:host=localhost;dbname=yiidb',
 'emulatePrepare' => true,
 'username' => 'root',
 'password' => 'ubuntu',
 'charset' => 'utf8',

Save and exit the file. Now try to access the GiiModule by navigating to http://ip-address/yii/unixmen/index.php?r=gii from your browser.

Enter the password to login to yii code generator. In my case its ubuntu.

Gii - Login Generator - Chromium_011

Now you will able to login to GiiModule code generator.

Gii: a Web-based code generator for Yii - Chromium_012

That;s it. Start using Yii. I highly recommend to refer the Yii Wiki page for beginners.