# Deploy your Laravel app on Heroku

Learn how to deploy your Laravel application along with a database on Heroku.

###### Abdush Shakoor ● November 29th, 2019

In my previous article, I talked about how to setup your environment for developing your Laravel applications. Today, I'll be talking about deploying your application along with a database on Heroku.

I wrote a simple CRUD application using Laravel but didn't understand on how to host it. I tried to host it on free shared hosting service but apparently, most of them don't support PHP system calls like proc_open(). However, if it was a VPS hosting service, it's supported but ain't nobody got time for shelling out cash for a test drive.

As an alternative, I went on google and discovered that Heroku does support my requirements and it worked flawlessly, which is why I thought of sharing this information to others as well.

## Prerequisites

You'll be doing some minor configurations, so you should be fine as long as you have a stable internet connection, familiar with using the CLI (Command Line Interface) and have some PHP knowledge.

If you're a Windows user, please Git for Windows. Else, if you're a Linux or macOS user, you should be fine.

## How to deploy?

You can ignore the first two steps if you already know about Heroku and how to work with it but please follow the rest of the steps:

### Install Heroku CLI

You can install this directly from the command line by typing the following:

    
sudo snap install heroku --classic



### Create a Heroku repository

If you don't have a Heroku account yet, create an account now and once you're done with that, type the following:

    



Once, you're done with that, create a repository by doing the following:

    
heroku create



In a few seconds, you'll get a randomly generated domain address, which is the link to your Heroku repository. If you can't remember the link, it's fine, you can make changes to it in your Heroku account.

### Define Procfile

In case, you don't know what's a Procfile, it's a file that specifies the commands that needs to be executed by the application on startup. You can declare a variety of process types, click here to learn more.

Since our application is PHP based, we need to add some specific command that selects the server on boot, I chose Apache server for this project:

    
cd your_laravel_project
touch Procfile
echo "web: vendor/bin/heroku-php-apache2 web/" > Procfile



### Push Laravel app to repository

It's similar to pushing your code into your GitHub, except this time, it's your Heroku repository. Type the following in your command line:

    
git commit -m "pushing application to repo"
git push heroku master



To check if your application is launched, type the following:

    
heroku open



At this stage, you might face Error 500, that's normal because we'll take care of that in the next step.

We need to add some config variables that changes the way your app behaves. So, let's start adding it:

    
heroku config:set APP_DEBUG=true
heroku config:set APP_KEY=yourlaravelapplicationkey
heroku config:set APP_URL=https://yourwebsite.herokuapp.com
heroku config:set REDIRECT_HTTPS=true



In this configuration, you have done the following: - Enabled debug mode - Set your Laravel application's base64 encrypted key - The website's URL - Force HTTPS redirect (Useful, when you're calling external assets that uses HTTPS protocol)

Initially, I built the database on MySQL but I later learnt that Heroku gives a free PostgreSQL starter database. I've never tried PostgreSQL before but it's quite similar to MySQL, so you shouldn't worry about your schema as Laravel supports PostgreSQL and MySQL databases by default.

Type the following in the command line:

    



This will create a PostgreSQL database and sets a DATABASE_URL, which contains the username and password to the database. To check it, type the following:

    
heroku config



Now, go to your project directory and open the config/database.php file and add the following:

    
// Place these variables above
$url = parse_url(getenv("DATABASE_URL"));$host = $url["host"]??null;$username = $url["user"]??null;$password = $url["pass"]??null;$database = substr($url["path"], 1)??null; // Replace the default connection 'default' => env('DB_CONNECTION', 'pgsql_prod'), // Under the connections attribute, create a new connection called 'pgsql_prod' 'pgsql_production' => [ 'driver' => 'pgsql', 'host' =>$host,
'database' => $database, 'username' =>$username,
'charset' => 'utf-8',
'prefix' => '',
'schema' => 'public',
],



Push the new changes to your repository:

    
git commit -m "configured database"
git push heroku master



One last step, we need to create the tables from your schema, so type the following:

    
heroku run php /app/artisan migrate --seed



Follow the command line prompt and voila, you have successfully deployed your Laravel application with a database on Heroku.

## Conclusion

Well, I hope you found this article really useful especially if you're a beginner. If you do find this useful, please share it with others too!

Stay tuned for more!