Use Supabase with Laravel

Learn how to create a PHP Laravel project, connect it to your Supabase Postgres database, and configure user authentication.

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.

1
composer create-project laravel/laravel example-app

Install the Authentication template

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

1
2
composer require laravel/breeze --devphp artisan breeze:install

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. Make sure Use connection pooling is checked and Session mode is selected. Then copy the URI. Replace the password placeholder with your saved database password.

If your network supports IPv6 connections, you can also use the direct connection string. Uncheck Use connection pooling and copy the new URI.

1
2
DB_CONNECTION=pgsqlDB_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.

The schema you specify in search_path has to exist on Supabase. You can create a new schema from the Table Editor.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
'pgsql' => [    'driver' => 'pgsql',    'url' => env('DB_URL'),    'host' => env('DB_HOST', '127.0.0.1'),    'port' => env('DB_PORT', '5432'),    'database' => env('DB_DATABASE', 'laravel'),    'username' => env('DB_USERNAME', 'root'),    'password' => env('DB_PASSWORD', ''),    'charset' => env('DB_CHARSET', 'utf8'),    'prefix' => '',    'prefix_indexes' => true,    'search_path' => 'laravel',    'sslmode' => 'prefer',],

Run the database migrations

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

Note: Laravel does not use Supabase Auth but rather implements its own authentication system!

1
php artisan migrate

Start the app

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.

1
php artisan serve