[supabase 번역] Supabase와 Laravel 함께 사용하기 (Use Supabase with Laravel)

출처: https://supabase.com/docs/guides/getting-started/quickstarts/laravel

Supabase와 Laravel을 함께 사용하는 방법을 알아봅니다. PHP Laravel 프로젝트를 생성하고, Supabase Postgres 데이터베이스에 연결하며, 사용자 인증을 설정하는 방법을 안내합니다.

1. Laravel 프로젝트 생성하기

PHP와 Composer 버전이 최신인지 확인한 후, composer create-project 명령어로 새로운 Laravel 프로젝트를 생성하세요.

자세한 내용은 Laravel 공식 문서를 참고하세요.

composer create-project laravel/laravel example-app

2. 인증 템플릿 설치하기

Laravel의 인증 기능을 간단하게 구현할 수 있는 Breeze를 설치하세요.

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

3. Postgres 연결 정보 설정하기

database.new에 접속하여 새로운 Supabase 프로젝트를 생성하세요. 데이터베이스 비밀번호는 안전하게 보관하세요.

프로젝트가 준비되면 대시보드에서 Connect로 이동하여 Session Pooler 연결 문자열을 복사하세요. 비밀번호는 저장한 값으로 교체해야 합니다. 비밀번호를 잊었다면 데이터베이스 설정에서 재설정할 수 있습니다.

IPv6 환경이거나 IPv4 Add-On이 있다면 Supavisor 대신 직접 연결 문자열을 사용할 수 있습니다.

.env 파일 예시:

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

4. 기본 스키마 변경하기

Laravel은 기본적으로 public 스키마를 사용합니다. Supabase는 public 스키마를 데이터 API로 노출하므로, 별도의 스키마 사용을 권장합니다.

app/config/database.php 파일에서 search_path 변수를 수정하여 스키마를 변경할 수 있습니다. 지정한 스키마는 Supabase에 반드시 존재해야 하며, Table Editor에서 새 스키마를 생성할 수 있습니다.

'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',
],

5. 데이터베이스 마이그레이션 실행하기

Laravel에는 인증 및 사용자 관리를 위한 기본 마이그레이션 파일이 포함되어 있습니다.

참고: Laravel은 Supabase Auth를 사용하지 않고 자체 인증 시스템을 구현합니다!

php artisan migrate

6. 앱 실행하기

개발 서버를 실행한 뒤, 브라우저에서 http://127.0.0.1:8000으로 접속하면 애플리케이션을 확인할 수 있습니다. http://127.0.0.1:8000/register와 http://127.0.0.1:8000/login에서 회원가입 및 로그인을 테스트할 수 있습니다.