Prepare for the PgBouncer and IPv4 deprecations on 26th January 2024

Learn more

Getting started with Laravel and Postgres

2024-01-22

4 minute read

Every Supabase project comes with a full Postgres database, a free and open source database which is considered one of the world's most stable and advanced databases.

Postgres is an ideal choice for your Laravel PHP applications as Laravel ships with a Postgres adapter built in!

In this post we'll start from scratch, creating a new Laravel application, setting up the Laravel Breeze starter kit for user authentication, and connecting it to our Supabase Postgres database.

If you prefer video guide, you can follow along below. And make sure to subscribe to the Supabase YouTube channel!

Create a Laravel Project

Make sure your PHP and Composer versions are up to date, then use composer create-project to scaffold a new Laravel project.

See the Laravel docs for more details.

Terminal

_10
composer create-project laravel/laravel example-app

Install the Authentication template

Install Laravel Breeze, a simple implementation of all of Laravel's authentication features.

Terminal

_10
composer require laravel/breeze --dev
_10
php artisan breeze:install

Note: this template does not use Supabase Auth but rather Laravel's built in Auth system. This means that Supabase Auth pricing does not apply. You'd only be billed for Database resources used in this case.

Set up the Postgres connection details

Go to database.new and create a new Supabase project. Save your database password securely.

When your project is up and running, navigate to the database settings to find the URI connection string.

Laravel ships with a Postgres adapter out of the box, you can simply configure it via the environment variables. You can find the database URL in your Supabase Dashboard.

.env

_10
DB_CONNECTION=pgsql
_10
DATABASE_URL=postgres://postgres.xxxx:password@xxxx.pooler.supabase.com:5432/postgres

Change the default schema

By default Laravel uses the public schema. We recommend changing this as supabase exposes the public schema as a data API.

You can change the schema of your Laravel application by modifying the search_path variable app/config/database.php:

app/config/database.php

_14
'pgsql' => [
_14
'driver' => 'pgsql',
_14
'url' => env('DATABASE_URL'),
_14
'host' => env('DB_HOST', '127.0.0.1'),
_14
'port' => env('DB_PORT', '5432'),
_14
'database' => env('DB_DATABASE', 'forge'),
_14
'username' => env('DB_USERNAME', 'forge'),
_14
'password' => env('DB_PASSWORD', ''),
_14
'charset' => 'utf8',
_14
'prefix' => '',
_14
'prefix_indexes' => true,
_14
'search_path' => 'laravel',
_14
'sslmode' => 'prefer',
_14
],

Run the database migrations

Laravel ships with database migration files that set up the required tables for Laravel Authentication and User Management.

Terminal

_10
php artisan migrate

Start the app

Terminal

_10
php artisan serve

Run the development server. Go to http://127.0.0.1:8000 in a browser to see your application. You can also navigate to http://127.0.0.1:8000/register and http://127.0.0.1:8000/login to register and log in users.

Conclusion

Supabase is the ideal platform for powering your Postgres database for your Laravel applications! Every Supabase project comes with a full Postgres database and a good number of useful extension!

Try it out now at database.new!

More Supabase

Share this article

Build in a weekend, scale to millions