릴리스 정책

• 버전 관리 체계
• 지원 정책
• Laravel 12

버전 관리 체계

Laravel과 공식 1st-party 패키지들은 시맨틱 버전 관리(Semantic Versioning)를 따릅니다. 메이저 버전은 매년 1회(대략 1분기)에 출시되며, 마이너·패치 버전은 매주 출시될 수도 있습니다. 마이너·패치 버전은 절대로 하위 호환성을 깨는 변경 사항을 포함하지 않습니다.

애플리케이션이나 패키지에서 Laravel 프레임워크 또는 관련 컴포넌트를 참조할 때는 항상 ^12.0과 같은 형태로 버전 제약을 지정하세요. 메이저 버전에는 하위 호환성을 깨는 변경이 포함될 수 있기 때문입니다. 다만 Laravel 팀은 새로운 메이저 버전으로의 업그레이드 작업이 하루 이내에 완료될 수 있도록 항상 노력하고 있습니다.

네임드 아규먼트(Named Arguments)

PHP의 네임드 아규먼트는 Laravel의 하위 호환성 보장 범위에 포함되지 않습니다. 코드베이스 개선을 위해 필요한 경우 함수 인자의 이름이 변경될 수 있습니다. 따라서 Laravel 메서드를 호출할 때 네임드 아규먼트를 사용하려면, 파라미터 이름이 향후 바뀔 수 있다는 점을 충분히 인지한 후 신중하게 사용하세요.

지원 정책

모든 Laravel 릴리스는 출시 후 18개월간 버그 수정, 2년간 보안 패치를 제공합니다. 추가 라이브러리(공식 1st-party 패키지)의 경우, 최신 메이저 버전에 한해서만 버그 수정이 이루어집니다. 또한 Laravel이 지원하는 데이터베이스 버전은 데이터베이스 문서에서 확인하세요.

(*) 지원되는 PHP 버전

Laravel 12

Laravel 12는 Laravel 11.x에서 이루어진 개선 사항을 이어받아, 의존성 패키지를 업데이트하고 React, Svelte, Vue, Livewire를 위한 새로운 스타터 킷을 도입합니다. 각 스타터 킷에는 WorkOS AuthKit을 활용한 사용자 인증 옵션이 포함되어 있으며, WorkOS 기반 스타터 킷은 소셜 로그인, 패스키(Passkey), SSO를 지원합니다.

최소화된 하위 호환성 변경

이번 릴리스 사이클의 핵심 목표는 하위 호환성을 깨는 변경을 최대한 줄이는 것이었습니다. 그 대신, 기존 애플리케이션에 영향을 주지 않으면서 꾸준히 사용성을 개선하는 데 집중했습니다.

따라서 Laravel 12는 기존 의존성을 업그레이드하는 비교적 소규모의 "유지보수 릴리스"에 가깝습니다. 대부분의 Laravel 애플리케이션은 별도의 코드 수정 없이 Laravel 12로 업그레이드할 수 있습니다.

새로운 애플리케이션 스타터 킷

Laravel 12는 React, Svelte, Vue, Livewire를 위한 새로운 애플리케이션 스타터 킷을 제공합니다. React, Svelte, Vue 스타터 킷은 Inertia 2, TypeScript, shadcn/ui, Tailwind를 기반으로 하며, Livewire 스타터 킷은 Tailwind 기반의 Flux UI 컴포넌트 라이브러리와 Laravel Volt를 활용합니다.

모든 스타터 킷(React, Svelte, Vue, Livewire)은 Laravel의 내장 인증 시스템을 사용하여 로그인, 회원가입, 비밀번호 재설정, 이메일 인증 등의 기능을 기본으로 제공합니다. 또한 각 스타터 킷에는 WorkOS AuthKit 기반의 변형 버전도 함께 제공되며, 소셜 로그인, 패스키, SSO를 지원합니다. WorkOS는 월간 활성 사용자 100만 명까지 무료로 인증 서비스를 제공합니다.

새로운 스타터 킷 사용 방법은 스타터 킷 문서를 참고하세요.