Setting up Laravel 4 on Linux Mint 16

I’ve been curious about Laravel and wanted to set up a virtual machine to get an environment for it. I will go over what I used and how I managed to finally get the environment working. Here is a list of what I will be using. I am including the version numbers just to add more detail. These are the versions I used at the time of writing this post. Terminal will be used to type the command and is assumed you are at your home directory.

• Virtualbox 4.3.8
• Linux Mint 16 (Cinnamon)

I will be installing LAMP on Linux Mint by using

sudo apt-get install lamp-server^

This will install the following.

• Apache 2.4.6
• PHP 5.5.3
• MySQL 5.5.35

You can install phpmyadmin if you want but those are the 3 main components. Next, head on over to the quick start guide http://laravel.com/docs/quick. You might ask, why I’m posting this when Laravel already has a tutuorial. Well, I ran into many issues and I wanted to take note of them and the solutions I found. So I’ll be referring to their guide.

First thing we’ll need to do is install composer. To install composer, you will use curl. If curl is not installed, then use the following command.

sudo apt-get install curl

You will also need json extension for PHP.

sudo apt-get install php5-json

If you have curl installed, then download composer with this command.

curl -s http://getcomposer.org/installer | php

Once download is completed, it will tell you where it downloaded and how to use it. We will move and rename composer.phar to composer and move it to /usr/local/bin.

sudo mv composer.phar /usr/local/bin/composer

You can check to see if it’s working by typing the following.

composer about

It should give you the description of composer. Now that you have composer installed, we can install Laravel. According to their guide, you need to download it from http://laravel.com/laravel.phar. We’re going to use terminal to download it, then just like composer, we’re going to move it to /usr/local/bin.

wget http://laravel.com/laravel.phar
sudo mv laravel.phar /usr/local/bin/laravel

Update: 2015-04-22: The file laravel.phar is no longer available. Essentially, you don’t need it. Composer is all you need. Thanks to @rohantapiyawala for giving me a heads up.

I will be storing my projects in the ~/Sites folder. For this tutorial, I will call the project apple. So this will sit in ~/Sites/apple.

mkdir ~/Sites
cd ~/Sites
composer create-project laravel/laravel apple --prefer-dist

You may get an error regarding the mcrypt PHP extension. The error looks like this.

Install the extension.

sudo apt-get install php5-mcrypt

Check if it is enabled.

php --ri mcrypt

If it’s not enabled/present then do the following.

sudo ln -s /etc/php5/conf.d/mcrypt.ini /etc/php5/mods-available
sudo php5enmod mcrypt
sudo service apache2 restart

Delete the apple project and use composer to create it. This time you shouldn’t get the mcrypt error. I found the solution at http://stackoverflow.com/questions/19775012/my-composer-wont-update-completely-with-laravel-4-it-gets-stuck-with-artisan.

rm -rf ~/Sites/apple
composer create-project laravel/laravel apple --prefer-dist

If you look inside the ~/Sites/apple directory, you will see public. This is the “public_html” of the project. Just set Apache virtualhost for that folder and you’re done. My file is located at /etc/apache2/sites-available/apple.conf and it looks like this…

	<Directory /home/sherwin/Sites/apple>
	Options Indexes FollowSymLinks
	AllowOverride All
	Require all granted
	</Directory>
	ServerName apple.local
	ServerAdmin webmaster@localhost
	DocumentRoot /home/sherwin/Sites/apple/public
	ErrorLog /home/sherwin/Sites/apple/error.log
	CustomLog /home/sherwin/Sites/apple/access.log combined

Next you need to enable the new site and restart Apache.

# enable new site conf
sudo a2ensite apple.conf

# restart apache
sudo service apache2 restart

If you get a blank screen, you may need to give app/storage different permissions. The article athttp://stackoverflow.com/questions/20678360/laravel-blank-white-screen explains more.

# Group Writable (Group, User Writable)
sudo chmod -R gu+w app/storage
# World-writable (Group, User, Other Writable)
sudo chmod -R guo+w app/storage

You should now be able to load http://apple.local. If it works, you will get the Laravel logo and “You have arrived.” text. Coming from Codeigniter, I felt there is a lot more tasks just to get Laravel to work. It somewhat discourages me to continue experimenting but I’ll give it another chance. It’s my curiosity that drives it.