스타터 키트

• 소개
• Laravel Breeze
  • 설치
  • Breeze 및 Blade
  • Breeze 및 Livewire
  • Breeze 및 React / Vue
  • Breeze 및 Next.js / API
• Laravel Jetstream

소개

새로운 Laravel 애플리케이션을 구축하는 데 유리한 출발점을 제공하기 위해, 인증 및 애플리케이션 스타터 키트를 제공하게 되어 기쁩니다. 이러한 키트는 애플리케이션 사용자를 등록하고 인증하는 데 필요한 경로, 컨트롤러 및 뷰로 애플리케이션을 자동으로 스캐폴딩합니다.

이러한 스타터 키트를 자유롭게 사용할 수 있지만 필수는 아닙니다. Laravel의 새로운 사본을 설치하여 처음부터 자신의 애플리케이션을 자유롭게 구축할 수 있습니다. 어느 쪽이든, 여러분이 멋진 것을 만들 것이라고 확신합니다!

Laravel Breeze

Laravel Breeze는 로그인, 등록, 비밀번호 재설정, 이메일 확인 및 비밀번호 확인을 포함한 모든 Laravel의 인증 기능을 최소한으로 간단하게 구현한 것입니다. 또한 Breeze에는 사용자가 이름, 이메일 주소 및 비밀번호를 업데이트할 수 있는 간단한 "프로필" 페이지가 포함되어 있습니다.

Laravel Breeze의 기본 뷰 레이어는 Tailwind CSS로 스타일이 지정된 간단한 Blade 템플릿으로 구성됩니다. 또한 Breeze는 Livewire 또는 Inertia를 기반으로 스캐폴딩 옵션을 제공하며, Inertia 기반 스캐폴딩에 Vue 또는 React를 사용할 수 있습니다.

Laravel Bootcamp

Laravel을 처음 접하는 경우 Laravel Bootcamp에 참여해 보세요. Laravel Bootcamp는 Breeze를 사용하여 첫 번째 Laravel 애플리케이션을 구축하는 과정을 안내합니다. Laravel과 Breeze가 제공하는 모든 것을 둘러볼 수 있는 좋은 방법입니다.

설치

먼저, 새로운 Laravel 애플리케이션을 생성해야 합니다. Laravel 설치 프로그램을 사용하여 애플리케이션을 생성하는 경우, 설치 과정에서 Laravel Breeze를 설치하라는 메시지가 표시됩니다. 그렇지 않으면 아래의 수동 설치 지침을 따라야 합니다.

스타터 키트 없이 새로운 Laravel 애플리케이션을 이미 생성한 경우, Composer를 사용하여 Laravel Breeze를 수동으로 설치할 수 있습니다.

composer require laravel/breeze --dev

Composer가 Laravel Breeze 패키지를 설치한 후에는 breeze:install Artisan 명령어를 실행해야 합니다. 이 명령어는 인증 뷰, 라우트, 컨트롤러 및 기타 리소스를 애플리케이션에 게시합니다. Laravel Breeze는 모든 코드를 애플리케이션에 게시하여 기능 및 구현에 대한 완전한 제어 및 가시성을 확보할 수 있도록 합니다.

breeze:install 명령어는 선호하는 프론트엔드 스택 및 테스트 프레임워크를 묻는 메시지를 표시합니다.

php artisan breeze:install
 
php artisan migrate
npm install
npm run dev

Breeze 및 Blade

기본 Breeze "스택"은 Blade 스택으로, 애플리케이션의 프론트엔드를 렌더링하기 위해 간단한 Blade 템플릿을 사용합니다. Blade 스택은 추가 인수 없이 breeze:install 명령어를 호출하고 Blade 프론트엔드 스택을 선택하여 설치할 수 있습니다. Breeze 스캐폴딩이 설치된 후에는 애플리케이션의 프론트엔드 자산도 컴파일해야 합니다.

php artisan breeze:install
 
php artisan migrate
npm install
npm run dev

다음으로, 웹 브라우저에서 애플리케이션의 /login 또는 /register URL로 이동할 수 있습니다. Breeze의 모든 경로는 routes/auth.php 파일 내에 정의되어 있습니다.

Breeze 및 Livewire

Laravel Breeze는 Livewire 스캐폴딩도 제공합니다. Livewire는 PHP만 사용하여 동적이고 반응적인 프런트엔드 UI를 구축하는 강력한 방법입니다.

Livewire는 주로 Blade 템플릿을 사용하고 Vue 및 React와 같은 JavaScript 기반 SPA 프레임워크에 대한 더 간단한 대안을 찾는 팀에 적합합니다.

Livewire 스택을 사용하려면 breeze:install Artisan 명령을 실행할 때 Livewire 프런트엔드 스택을 선택할 수 있습니다. Breeze의 스캐폴딩이 설치된 후에는 데이터베이스 마이그레이션을 실행해야 합니다.

php artisan breeze:install
 
php artisan migrate

Breeze 및 React / Vue

Laravel Breeze는 Inertia 프런트엔드 구현을 통해 React 및 Vue 스캐폴딩도 제공합니다. Inertia를 사용하면 클래식 서버 측 라우팅 및 컨트롤러를 사용하여 최신 단일 페이지 React 및 Vue 애플리케이션을 구축할 수 있습니다.

Inertia를 사용하면 Laravel의 놀라운 백엔드 생산성과 매우 빠른 Vite 컴파일과 결합된 React 및 Vue의 프런트엔드 성능을 누릴 수 있습니다. Inertia 스택을 사용하려면 breeze:install Artisan 명령을 실행할 때 Vue 또는 React 프런트엔드 스택을 선택할 수 있습니다.

Vue 또는 React 프런트엔드 스택을 선택할 때 Breeze 설치 프로그램은 Inertia SSR 또는 TypeScript 지원 여부를 결정하라는 메시지도 표시합니다. Breeze의 스캐폴딩이 설치된 후에는 애플리케이션의 프런트엔드 자산도 컴파일해야 합니다.

php artisan breeze:install
 
php artisan migrate
npm install
npm run dev

다음으로 웹 브라우저에서 애플리케이션의 /login 또는 /register URL로 이동할 수 있습니다. Breeze의 모든 경로는 routes/auth.php 파일 내에 정의되어 있습니다.

Breeze 및 Next.js / API

Laravel Breeze는 Next, Nuxt 등으로 구동되는 최신 JavaScript 애플리케이션을 인증할 준비가 된 인증 API를 스캐폴딩할 수도 있습니다. 시작하려면 breeze:install Artisan 명령을 실행할 때 원하는 스택으로 API 스택을 선택하십시오.

php artisan breeze:install
 
php artisan migrate

설치하는 동안 Breeze는 애플리케이션의 .env 파일에 FRONTEND_URL 환경 변수를 추가합니다. 이 URL은 JavaScript 애플리케이션의 URL이어야 합니다. 로컬 개발 중에는 일반적으로 http://localhost:3000입니다. 또한 APP_URL이 http://localhost:8000으로 설정되어 있는지 확인해야 합니다. 이는 serve Artisan 명령에서 사용하는 기본 URL입니다.

Next.js 참조 구현

이제 선택한 프런트엔드와 이 백엔드를 페어링할 준비가 되었습니다. Breeze 프런트엔드의 Next 참조 구현은 GitHub에서 제공됩니다. 이 프런트엔드는 Laravel에서 유지 관리하며 Breeze에서 제공하는 기존 Blade 및 Inertia 스택과 동일한 사용자 인터페이스를 포함합니다.

Laravel Jetstream

Laravel Breeze는 Laravel 애플리케이션 구축을 위한 간단하고 최소한의 시작점을 제공하지만 Jetstream은 더 강력한 기능과 추가 프런트엔드 기술 스택으로 해당 기능을 보강합니다. Laravel을 처음 접하는 사람들에게는 Laravel Jetstream으로 넘어가기 전에 Laravel Breeze를 사용하여 기본을 배우는 것이 좋습니다.

Jetstream은 Laravel용으로 아름답게 디자인된 애플리케이션 스캐폴딩을 제공하며 로그인, 등록, 이메일 확인, 2단계 인증, 세션 관리, Laravel Sanctum을 통한 API 지원 및 선택적 팀 관리를 포함합니다. Jetstream은 Tailwind CSS를 사용하여 설계되었으며 Livewire 또는 Inertia 기반 프런트엔드 스캐폴딩 중에서 선택할 수 있습니다.

Laravel Jetstream 설치에 대한 전체 문서는 공식 Jetstream 문서에서 확인할 수 있습니다.