A step by step guide to setup PHP (Laravel) environment (Linux).

Youssouf El Azizi

November 05, 2017

elazizi, dev, react

This article is a step by step tutorial to get started with PHP and laravel in Linux environment ( Ubuntu ). By installing Apache2, Mysql and PHP, your LAMP server is ready to host your PHP application.

At the end of this post, you’ll know how to add your custom domain for your local environment.

If you are familiar with Docker check My post :Laravel & Docker, Zero config with Vessel.

Let’s start !!!

As you expected from all kind of Linux tutorials you should first update and upgrade your system by running :

1sudo apt-get update
2sudo apt-get upgrade

Now your system and packages system is up to date.

Next, you need to install some basics dependencies to avoid all kind of problems in your workflow

1sudo apt-get install -y git curl wget zip unzip

Installing Apache2 server :

1sudo apt-get install apache2

To make sure that the server is running you can execute this command in your terminal

1sudo systemctl status apache2

1sudo systemctl status apache2

As you see above, the service appears to have started successfully, you can also access to your server through the http://localhost address and you will see Apache2 default home page.

It is important to know that all your web content must be under the /var/www/html directory. you can check the Bonus section to make any folder as your root web content to know how to config.

To master Appche2 config you need to master this 6 commands line:

  • a2enmod (apache2 enable mode) : To enable an Apache2 mod like rewrite mode.
  • a2dismod (apache2 disable mode) : To disable an Apache2 mod.
  • a2enconf (apache2 enable Config) : To enable a specific config.
  • a2disconf (apache2 disable config) : To disable a specific config.
  • a2ensite(apache2 enable Site) : To enable a specific app.
  • a2dissite (apache2 disable Site) : To disable a specific app.

Enable rewrite mode

1sudo a2enmod rewrite
2sudo systemctl restart apache2

This Gif take you around the most important Apache directories.

You can learn more about Apache config and Linux in this article

Install MySQL

1sudo apt-get install mysql-server

Click Enter to validate the first popup, then create a password for your Mysql root user. it’s highly recommended to secure Mysql server by running :

1mysql_secure_installation

You can read more about improving MySQL installation security

To mange database, there is a lot of SQL clients to use with MySQL like MySQL Workbench, SQuirreL, SQLECTRON or the great Google Extension Chrome MySQL Admin .

Install PHP :

1sudo add-apt-repository -y ppa:ondrej/php
2sudo apt-get update
3
4
5sudo apt-get install -y php7.1 php7.1-fpm libapache2-mod-php7.0 php7.1-cli php7.1-curl php7.1-mysql php7.1-sqlite3 php7.1-gd php7.1-xml php7.1-mcrypt php7.1-mbstring php7.1-iconv

As you see above this large command will install php, php-cli and the most important php libraries.

Install Composer :

1curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer
2sudo chown -R $USER$HOME/.composer

Now you are ready to create your first Laravel app.

Test web Server

To test your LAMP server, just create a Laravel application under Apache2 root directory.

1cd /var/www/html
2`composer create-project --prefer-dist laravel/laravel lara_app`

Open your browser and you can access to your app through :

http://localhost/lara_app/public


Bonus

In this section you will discover how you can create a Laravel application with custom domain name outside apache2 directory.

first create a config file under /etc/apache2/sites-available directory.

1cd /etc/apache2/sites-available
2sudo touch lara_app.conf

Past and update DocumentRoot and Directory with your app folder inside the file.

1<VirtualHost *:80>
2
3ServerName lara_app.dev
4
5ServerAdmin webmaster@localhost
6
7DocumentRoot /media/disk2/Work/lara_app/public/
8
9<Directory /media/disk2/Work/lara_app/public/>
10
11Options Indexes FollowSymLinks
12
13AllowOverride None
14
15Require all granted
16
17</Directory>
18
19
20</VirtualHost>

Next, give to your custom folder the permission to execute

1chmod -R 755 /media/disk2/Work/lara_app/public/

Then disable the default site and enable you new lara_app site.

1sudo a2dissite 000-default
2sudo a2ensite lara_app

At last, you can configure the lara_app.dev domain name by adding this line into /etc/hosts file.

/etc/hosts

1127.0.0.1 localhost
2127.0.0.1 lara_app.dev
3127.0.1.1 youssouf-Latitude-E6410

Now you can access to your app through your custom domain name : http://lara_app.dev


Thanks for reading! If you think other people should read this, clap for me, tweet and share the post. Remember to follow me on Medium so you can get notified about my future posts.

Share article