A step by step guide to setup PHP (Laravel) environment (Linux).
Youssouf El Azizi—
November 05, 2017
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 update2sudo 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 rewrite2sudo 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
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 :
You can read more about improving MySQL installation security
Install PHP :
1sudo add-apt-repository -y ppa:ondrej/php2sudo apt-get update345sudo 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 \6 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=composer2sudo 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/html2`composer create-project --prefer-dist laravel/laravel lara_app`
Open your browser and you can access to your app through :
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-available2sudo touch lara_app.conf
Past and update DocumentRoot and Directory with your app folder inside the file.
1<VirtualHost \*:80>23ServerName lara_app.dev45ServerAdmin webmaster@localhost67DocumentRoot /media/disk2/Work/lara_app/public/89<Directory /media/disk2/Work/lara_app/public/>1011Options Indexes FollowSymLinks1213AllowOverride None1415Require all granted1617</Directory>181920</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-default2sudo a2ensite lara_app
At last, you can configure the lara_app.dev domain name by adding this line into /etc/hosts file.
1127.0.0.1 localhost2127.0.0.1 lara_app.dev3127.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.