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!
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.
_10
composer create-project laravel/laravel example-app
Install Laravel Breeze, a simple implementation of all of Laravel's authentication features.
_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 project connect page 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.
_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 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
],
Laravel ships with database migration files that set up the required tables for Laravel Authentication and User Management.
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.
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!