릴리스 정책

업데이트됨

번역일: 2026년 6월 20일

이 페이지는 원문이 업데이트되어 번역이 갱신되었습니다.

원문 수정: 2026년 6월 20일
번역 갱신: 2026년 6월 20일

릴리스 정책

버전 관리 체계
지원 정책
Laravel 13

버전 관리 체계

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

애플리케이션이나 패키지에서 Laravel 프레임워크 또는 구성 요소를 참조할 때는 항상 ^13.0과 같이 메이저 버전 제약을 사용하세요. 메이저 버전에는 하위 호환성을 깨는 변경 사항이 포함될 수 있기 때문입니다. 다만 Laravel 팀은 새 메이저 버전으로의 업그레이드가 하루 이내에 완료될 수 있도록 항상 노력합니다.

Named Arguments(이름 있는 인수)

PHP의 Named Arguments는 Laravel의 하위 호환성 보장 범위에 포함되지 않습니다. 코드베이스 개선을 위해 함수 인수의 이름이 변경될 수 있으므로, Laravel 메서드를 호출할 때 Named Arguments를 사용하는 경우에는 향후 파라미터 이름이 바뀔 수 있다는 점을 염두에 두고 신중하게 사용해야 합니다.

지원 정책

모든 Laravel 릴리스에 대해 버그 수정은 18개월, 보안 수정은 2년간 제공됩니다. 추가 라이브러리의 경우 최신 메이저 버전만 버그 수정을 받습니다. 또한 Laravel이 지원하는 데이터베이스 버전은 데이터베이스 문서에서 확인하세요.

버전	PHP (*)	릴리스	버그 수정 종료	보안 수정 종료
10	8.1 - 8.3	2023년 2월 14일	2024년 8월 6일	2025년 2월 4일
11	8.2 - 8.4	2024년 3월 12일	2025년 9월 3일	2026년 3월 12일
12	8.2 - 8.5	2025년 2월 24일	2026년 8월 13일	2027년 2월 24일
13	8.3 - 8.5	2026년 3월 17일	2027년 3분기	2028년 3월 17일

지원 종료

보안 수정만 제공

(*) 지원되는 PHP 버전

Laravel 13

Laravel 13은 매년 진행되는 릴리스 주기에 따라 출시되며, AI 네이티브 워크플로우, 강화된 기본값, 더욱 표현력 있는 개발자 API에 중점을 두고 있습니다. 이번 릴리스에는 1st-party AI 기능, JSON:API 리소스, 시맨틱/벡터 검색, 그리고 큐·캐시·보안 전반에 걸친 점진적 개선 사항이 포함됩니다.

최소한의 하위 호환성 변경

이번 릴리스 주기에서 팀이 가장 집중한 부분은 하위 호환성을 깨는 변경을 최소화하는 것이었습니다. 대신 기존 애플리케이션에 영향을 주지 않으면서도 개발 편의를 높이는 품질 개선 사항을 꾸준히 제공하는 데 힘썼습니다.

따라서 Laravel 13은 업그레이드 부담 면에서는 비교적 가볍지만, 실질적인 새 기능은 충분히 담고 있습니다. 대부분의 Laravel 애플리케이션은 애플리케이션 코드를 거의 수정하지 않고도 Laravel 13으로 업그레이드할 수 있습니다.

PHP 8.3

Laravel 13.x는 PHP 8.3 이상을 요구합니다.

Laravel AI SDK

Laravel 13은 공식 1st-party Laravel AI SDK를 도입합니다. 이 SDK는 텍스트 생성, 도구 호출 에이전트, 임베딩, 오디오, 이미지, 벡터 스토어 연동을 위한 통합 API를 제공합니다.

AI SDK를 사용하면 특정 AI 공급자(provider)에 종속되지 않으면서도 Laravel 네이티브 개발 경험을 그대로 유지할 수 있습니다.

예를 들어, 에이전트에 프롬프트를 전달하는 기본적인 사용법은 다음과 같습니다.

use App\Ai\Agents\SalesCoach;

$response = SalesCoach::make()->prompt('이 영업 통화 기록을 분석해 주세요...');

return (string) $response;

AI SDK는 이미지, 오디오, 임베딩도 생성할 수 있습니다.

이미지 생성이 필요한 경우, 자연어 프롬프트로 이미지를 만드는 깔끔한 API를 사용할 수 있습니다.

use Laravel\Ai\Image;

$image = Image::of('주방 카운터 위에 놓인 도넛')->generate();

$rawContent = (string) $image;

음성 경험이 필요한 경우, 텍스트를 자연스러운 오디오로 합성할 수 있어 어시스턴트, 내레이션, 접근성 기능 등에 활용할 수 있습니다.

use Laravel\Ai\Audio;

$audio = Audio::of('Laravel로 개발하는 것이 정말 즐겁습니다.')->generate();

$rawContent = (string) $audio;

시맨틱 검색 및 검색 증강 생성(RAG) 워크플로우에서는 문자열로부터 직접 임베딩을 생성할 수 있습니다.

use Illuminate\Support\Str;

$embeddings = Str::of('나파 밸리에는 훌륭한 와인이 있습니다.')->toEmbeddings();

JSON:API 리소스

Laravel에 공식 JSON:API 리소스 지원이 추가되었습니다. 이를 통해 JSON:API 규격을 준수하는 응답을 손쉽게 반환할 수 있습니다.

JSON:API 리소스는 리소스 객체 직렬화, 관계(relationship) 포함, 스파스 필드셋(sparse fieldsets), 링크, JSON:API 규격 응답 헤더를 자동으로 처리합니다.

요청 위조 방지 강화

보안 측면에서 Laravel의 요청 위조 방지 미들웨어가 PreventRequestForgery로 공식화되고 강화되었습니다. 기존 토큰 기반 CSRF 보호와의 호환성을 유지하면서, 요청 출처(origin)를 검증하는 기능이 추가되었습니다.

큐 라우팅

Laravel 13에서는 Queue::route(...)를 통해 클래스별 큐 라우팅을 지원합니다. 특정 Job에 대한 기본 큐와 커넥션 라우팅 규칙을 한 곳에서 중앙 집중식으로 정의할 수 있습니다.

Queue::route(ProcessPodcast::class, connection: 'redis', queue: 'podcasts');

PHP 어트리뷰트 지원 확대

Laravel 13은 프레임워크 전반에 걸쳐 1st-party PHP 어트리뷰트 지원을 지속적으로 확대하고 있습니다. 덕분에 일반적인 설정과 동작 제어를 더 선언적으로, 그리고 클래스·메서드와 가까운 위치에서 표현할 수 있습니다.

주요 추가 항목으로는 컨트롤러 및 인가 관련 어트리뷰트인 #[Middleware], #[Authorize]와 큐 Job 제어용 #[Tries], #[Backoff], #[Timeout], #[FailOnTimeout]이 있습니다.

예를 들어, 컨트롤러 미들웨어와 정책(policy) 검사를 클래스·메서드에 직접 선언할 수 있습니다.

<?php

namespace App\Http\Controllers;

use App\Models\Comment;
use App\Models\Post;
use Illuminate\Routing\Attributes\Controllers\Authorize;
use Illuminate\Routing\Attributes\Controllers\Middleware;

#[Middleware('auth')]
class CommentController
{
    #[Middleware('subscribed')]
    #[Authorize('create', [Comment::class, 'post'])]
    public function store(Post $post)
    {
        // ...
    }
}

Eloquent, 이벤트, 알림, 유효성 검사, 테스팅, 리소스 직렬화 API 등 다양한 영역에도 추가 어트리뷰트가 도입되어, 프레임워크의 더 많은 곳에서 어트리뷰트 우선 방식을 일관되게 사용할 수 있습니다.

캐시 TTL 연장

Cache::touch(...)가 추가되어, 캐시 항목의 값을 다시 읽고 저장하지 않고도 TTL(만료 시간)만 연장할 수 있게 되었습니다.

시맨틱 / 벡터 검색

Laravel 13은 네이티브 벡터 쿼리 지원, 임베딩 워크플로우 등을 통해 시맨틱 검색 기능을 한층 강화합니다. 관련 내용은 검색, 쿼리 빌더, AI SDK 문서에서 확인할 수 있습니다.

이 기능들을 활용하면 PostgreSQL + pgvector 조합으로 AI 기반 검색 경험을 손쉽게 구축할 수 있으며, 문자열에서 직접 생성한 임베딩을 대상으로 유사도 검색을 실행할 수 있습니다.

예를 들어, 쿼리 빌더에서 직접 시맨틱 유사도 검색을 실행하는 방법은 다음과 같습니다.

$documents = DB::table('documents')
    ->whereVectorSimilarTo('embedding', '나파 밸리 최고의 와이너리')
    ->limit(10)
    ->get();