Laravel 12 새로운 기능 총정리: 스타터 킷, WorkOS AuthKit, 업그레이드 가이드 및 면접 질문 (2026)

Laravel 12는 2025년 2월 24일에 공식 출시되었으며, 프레임워크의 스타터 킷을 전면 개편하고 의도적으로 브레이킹 체인지를 최소화한 것이 핵심입니다. 기존의 Breeze와 Jetstream을 대체하는 새로운 스타터 킷은 React 19, Vue 3, Svelte 5, Livewire 4를 기반으로 구축되었습니다. Laravel 12의 릴리스 철학은 안정성을 최우선으로 하며, 대부분의 Laravel 11 애플리케이션은 코드 변경 없이 업그레이드가 가능합니다.

새로운 스타터 킷: Breeze와 Jetstream의 완전한 대체

Laravel 12에서 가장 눈에 띄는 변화는 Breeze와 Jetstream을 네 가지 전용 스타터 킷으로 대체한 것입니다. 기존 패키지가 이미 존재하는 프로젝트에 설치되는 방식이었다면, 새로운 스타터 킷은 처음부터 모든 코드가 노출되고 수정 가능한 상태로 완전히 새로운 프로젝트를 스캐폴딩합니다.

각 스타터 킷에는 인증, 회원가입, 비밀번호 재설정, 이메일 인증, 사용자 프로필 관리 기능이 기본으로 포함되어 있습니다.

| 스타터 킷 | 스택 | UI 라이브러리 | |------------|-------|------------| | React | Inertia 2, React 19, TypeScript | shadcn/ui | | Vue | Inertia 2, Vue 3, TypeScript | shadcn-vue | | Svelte | Inertia 2, Svelte 5, TypeScript | shadcn-svelte | | Livewire | Livewire 4, Laravel Volt | Flux UI |

네 가지 스타터 킷 모두 Tailwind CSS 4, 다크/라이트/시스템 모드 지원, 인증 페이지를 위한 다양한 레이아웃 변형(심플, 카드, 분할)을 포함합니다.

# Install a new Laravel project with the React starter kit
laravel new my-app

# Or specify a community starter kit
laravel new my-app --using=vendor/custom-starter-kit

Laravel 12는 누구나 커스텀 스타터 킷을 만들어 배포할 수 있는 기능도 도입했습니다. --using 플래그를 통해 커뮤니티에서 제작한 스타터 킷을 등록하고 사용할 수 있습니다.

이러한 접근 방식의 장점은 명확합니다. 개발자가 프로젝트 초기 단계에서 인증 관련 코드를 직접 소유하게 되므로, 패키지 업데이트에 의존하지 않고 자유롭게 커스터마이징할 수 있습니다. 또한 TypeScript가 기본으로 적용되어 프론트엔드 코드의 타입 안전성이 크게 향상되었습니다.

WorkOS AuthKit 통합: 엔터프라이즈급 인증

각 스타터 킷은 WorkOS AuthKit 변형을 제공하며, 별도의 구현 없이 엔터프라이즈급 인증 기능을 추가할 수 있습니다.

• 소셜 인증: Google, GitHub, Microsoft 등 다양한 OAuth 프로바이더를 지원합니다
• 패스키(Passkeys): 생체 인식을 통한 비밀번호 없는 로그인이 가능합니다
• 싱글 사인온(SSO): SAML 및 OIDC 프로바이더와의 연동을 지원합니다

WorkOS 무료 티어는 월간 활성 사용자 100만 명까지 지원하므로, 규모에 관계없이 모든 프로젝트에서 활용할 수 있습니다.

'workos' => [
    'client_id' => env('WORKOS_CLIENT_ID'),
    'api_key' => env('WORKOS_API_KEY'),
    'redirect_url' => env('WORKOS_REDIRECT_URL'),
],

기존에는 소셜 로그인이나 SSO를 구현하려면 Laravel Socialite 또는 서드파티 패키지를 별도로 설정해야 했습니다. WorkOS AuthKit 통합으로 이러한 과정이 대폭 간소화되었으며, 특히 B2B SaaS 애플리케이션을 개발하는 팀에게 실질적인 생산성 향상을 제공합니다.

의존성 업데이트 및 PHP 요구사항

Laravel 12는 PHP 8.2부터 8.5까지 지원하며, 모든 날짜 및 시간 연산에 Carbon 3을 필수로 요구합니다.

// Carbon 3 enforces stricter typing
use Carbon\Carbon;

$now = Carbon::now(); // Returns CarbonImmutable by default in strict mode
$future = $now->addDays(30);

// $now remains unchanged — immutability enforced

Carbon 3의 가장 중요한 변화는 불변성(immutability)의 강화입니다. 엄격 모드에서 Carbon::now()는 기본적으로 CarbonImmutable 인스턴스를 반환하며, 이는 날짜 연산 시 발생할 수 있는 의도치 않은 부작용을 방지합니다. Carbon 2에서 마이그레이션하는 경우, 기존 코드에서 가변적(mutable) 동작에 의존하는 부분을 점검할 필요가 있습니다.

패치 릴리스의 주요 개선 사항

Laravel 12는 메이저 릴리스 이후에도 패치 버전을 통해 지속적으로 유용한 기능을 추가해 왔습니다. 실무에서 즉시 활용할 수 있는 헬퍼와 개선 사항을 살펴봅니다.

배열 및 컬렉션 헬퍼

use Illuminate\Support\Arr;

// Filter by values instead of keys (added in 12.46.0)
$filtered = Arr::onlyValues(['admin', 'editor', 'viewer'], ['admin', 'editor']);
// Result: ['admin', 'editor']

$excluded = Arr::exceptValues(['admin', 'editor', 'viewer'], ['viewer']);
// Result: ['admin', 'editor']

// Check if a collection has multiple items
$users = collect([/* ... */]);
if ($users->containsManyItems()) {
    // Handle bulk operation
}

Arr::onlyValues()와 Arr::exceptValues()는 키가 아닌 값을 기준으로 배열을 필터링할 수 있는 메서드입니다. 역할 기반 접근 제어(RBAC)나 권한 관리 로직에서 특히 유용하게 활용됩니다.

Gate 및 인가 기능 개선

use Illuminate\Support\Facades\Gate;

// UnitEnum support in Gate::has() (added in 12.45.2)
enum Permission {
    case ViewDashboard;
    case ManageUsers;
}

if (Gate::has(Permission::ViewDashboard)) {
    // Ability is defined — more type-safe than string-based checks
}

Gate::has() 메서드에 PHP의 UnitEnum 지원이 추가되면서, 문자열 기반의 권한 확인보다 타입 안전한 방식으로 인가 로직을 작성할 수 있게 되었습니다. 이는 대규모 애플리케이션에서 권한 관련 오타나 불일치를 컴파일 타임에 방지하는 데 효과적입니다.

스키마 및 컨테이너 수정

Schema::getTables(), Schema::getViews(), Schema::getTypes() 메서드는 이제 기본적으로 모든 스키마의 결과를 반환합니다. 멀티 스키마 환경에서 데이터베이스를 관리하는 개발팀에게 더 일관된 동작을 제공합니다.

업그레이드 가이드: Laravel 11에서 Laravel 12로

Laravel 11에서 12로의 업그레이드는 프레임워크 역사상 가장 간단한 메이저 버전 업그레이드 중 하나입니다. 다음 단계를 따라 진행합니다.

1단계 — composer.json 업데이트:

{
    "require": {
        "php": "^8.2",
        "laravel/framework": "^12.0",
        "nesbot/carbon": "^3.0"
    }
}

2단계 — Composer 업데이트 실행:

composer update

3단계 — 엣지 케이스 확인:

1. Concurrency::run 연관 배열 사용 시 키가 포함된 결과를 반환하도록 변경되었습니다
2. 로컬 디스크 기본 경로가 storage/app에서 storage/app/private으로 변경되었습니다
3. Carbon 2 호출을 Carbon 3 API에 맞게 업데이트해야 합니다
4. 스키마 메서드가 크로스 스키마 결과를 반환하도록 변경되었습니다
5. 네임드 인자를 사용하는 Laravel 메서드 호출에서 매개변수 이름 변경으로 인한 오류 가능성이 있습니다

대부분의 프로젝트에서는 composer.json 수정과 composer update 실행만으로 업그레이드가 완료됩니다. 다만 파일 스토리지 경로 변경이나 Carbon 2 의존성이 있는 경우에는 추가 점검이 필요합니다.

2026년 Laravel 12 면접 질문 가이드

2026년 현재 Laravel 개발자 채용 면접에서 자주 출제되는 질문 유형을 난이도별로 정리합니다.

주니어 레벨 질문

Laravel 12의 스타터 킷은 Breeze와 비교하여 어떤 점이 변경되었습니까?

Breeze와 Jetstream은 기존 프로젝트에 설치하는 방식이었습니다. Laravel 12의 스타터 킷은 인증 코드를 애플리케이션에 직접 포함한 완전히 새로운 프로젝트를 생성합니다. 이를 통해 개발자는 인증 관련 코드를 패키지 의존성 없이 직접 소유하고 수정할 수 있습니다.

// The container resolves dependencies automatically
class OrderService
{
    public function __construct(
        private PaymentGateway $gateway,  // Auto-resolved
        private int $retryLimit = 3       // Default respected in Laravel 12
    ) {}
}

Laravel의 서비스 컨테이너는 의존성을 자동으로 해결하며, 기본값이 지정된 매개변수도 올바르게 처리합니다. 이는 면접에서 서비스 컨테이너의 동작 원리를 설명할 때 함께 언급하면 좋은 포인트입니다.

중급 레벨 질문

Laravel의 미들웨어는 어떻게 동작하며, 최근 버전에서 어떤 변화가 있었습니까?

미들웨어는 HTTP 요청이 애플리케이션에 도달하기 전후에 필터링 메커니즘을 제공합니다. Laravel 11에서 미들웨어 등록 방식이 Kernel.php에서 bootstrap/app.php로 이전되었으며, Laravel 12에서도 이 구조가 유지됩니다.

// Dispatching a job to the queue
use App\Jobs\ProcessInvoice;

ProcessInvoice::dispatch($order)
    ->onQueue('invoices')
    ->delay(now()->addMinutes(5));

큐(Queue)와 잡(Job) 디스패치 역시 중급 면접에서 빈출되는 주제입니다. 지연 디스패치, 큐 지정, 재시도 로직 등 실무에서 자주 사용하는 패턴을 명확히 설명할 수 있어야 합니다.

시니어 레벨 질문

Laravel 애플리케이션에서 리포지토리 패턴과 직접적인 Eloquent 사용을 비교하여 설명하십시오.

리포지토리 패턴은 데이터 접근 계층을 추상화하여 비즈니스 로직과 데이터베이스 쿼리를 분리합니다. 테스트 용이성과 유지보수성이 향상되지만, 소규모 프로젝트에서는 불필요한 복잡성을 추가할 수 있습니다. 시니어 면접에서는 각 접근 방식의 트레이드오프를 프로젝트 규모와 팀 상황에 맞게 판단하는 능력이 평가됩니다.

Laravel 12 애플리케이션을 Laravel 13 업그레이드에 대비하려면 어떻게 해야 합니까?

Laravel 12에서 13으로의 업그레이드는 브레이킹 체인지가 없으므로, 기본적으로 의존성 버전만 업데이트하면 됩니다. 다만 PHP 최소 요구 버전이 8.3으로 상향되므로, 서버 환경의 PHP 버전을 사전에 확인하고 업데이트해야 합니다. 또한 deprecation 경고를 지속적으로 모니터링하고, 서드파티 패키지의 호환성을 검증하는 것이 권장됩니다.

Laravel 12 vs Laravel 13: 업그레이드 시점 판단

현재 Laravel 12를 사용 중인 팀이라면 Laravel 13으로의 업그레이드 시점을 고민할 수 있습니다. 두 버전의 주요 차이점을 비교합니다.

| 항목 | Laravel 12 | Laravel 13 | |---------|-----------|------------| | PHP 요구사항 | 8.2 - 8.5 | 8.3 - 8.5 | | 스타터 킷 | React/Vue/Svelte/Livewire | 동일 + 팀 멀티테넌시 | | AI SDK | 베타 (laravel/ai) | 안정 버전, 프로덕션 준비 완료 | | 벡터 검색 | 미지원 | 네이티브 pgvector 지원 | | 패스키 | WorkOS 경유만 가능 | Fortify 네이티브 지원 | | Laravel 11 대비 브레이킹 체인지 | 최소 | 12 대비 없음 | | 버그 수정 기간 | 2026년 8월까지 | 2027년 3분기까지 |

Laravel 13은 AI SDK의 안정화, 네이티브 벡터 검색, Fortify 기반 패스키 지원 등 주목할 만한 기능을 추가했습니다. AI 기능이나 벡터 검색이 필요한 프로젝트라면 Laravel 13으로의 업그레이드가 실질적인 가치를 제공합니다. 반면, 현재 Laravel 12로 안정적으로 운영 중인 프로젝트라면 2026년 8월 버그 수정 종료 시점 전에 업그레이드를 계획하는 것이 합리적입니다.

결론

• Laravel 12는 Breeze와 Jetstream을 React, Vue, Svelte, Livewire 기반의 네 가지 모던 스타터 킷으로 대체했습니다
• WorkOS AuthKit 통합으로 소셜 로그인, 패스키, SSO를 간편하게 구현할 수 있습니다
• Laravel 11에서의 업그레이드는 대부분의 애플리케이션에서 코드 변경 없이 가능합니다
• 패치 릴리스를 통해 배열 헬퍼, Gate 개선 등 실용적인 기능이 지속적으로 추가되었습니다
• 면접 준비 시 스타터 킷의 변화와 버전 간 업그레이드 경로를 반드시 숙지해야 합니다
• Laravel 13은 네이티브 AI SDK, 벡터 검색, 패스키 지원을 제공하며, 프로젝트 요구사항에 따라 업그레이드 시점을 결정할 수 있습니다