Release Notes

• Versioning Scheme
• Support Policy
• Laravel 11

Versioning Scheme

Laravel과 그 외의 공식 패키지들은 Semantic Versioning을 따릅니다. 주요 프레임워크 릴리스는 매년(대략 1분기)에, 마이너 및 패치 릴리스는 매주 나올 수 있습니다. 마이너 버전과 패치 버전에는 절대로 하위 호환성이 깨지는 변경 사항이 포함되어서는 안 됩니다.

애플리케이션이나 패키지에서 Laravel 프레임워크 또는 그 구성 요소를 참조할 때는 반드시 ^11.0과 같이 버전 제약 조건을 사용해야 합니다. 이는 Laravel의 주요 버전 업데이트에는 호환성에 영향을 주는 변경이 포함될 수 있기 때문입니다. 하지만, 새로운 주요 릴리스로의 마이그레이션이 하루 이내에 끝날 수 있도록 항상 최선을 다하고 있습니다.

Named Arguments

Named arguments는 Laravel의 하위 호환성 가이드라인에 포함되지 않습니다. Laravel 코드베이스의 개선을 위해 필요하다면 함수 인수명의 변경이 있을 수 있습니다. 따라서, Laravel 메서드를 호출할 때 네임드 인수를 사용하는 경우 인수명이 향후 변경될 수 있음을 반드시 인지하고 신중히 사용해야 합니다.

Support Policy

모든 Laravel 릴리스에 대해 버그 수정은 18개월, 보안 패치는 2년 동안 제공됩니다. Lumen을 포함한 추가 라이브러리들은 최신 주요 릴리스만 버그 수정을 받습니다. 또한, Laravel이 지원하는 데이터베이스 버전에 대해서는 supported by Laravel에서 반드시 확인하세요.

버전	PHP (*)	출시일	버그 수정 지원 종료	보안 패치 지원 종료
9	8.0 - 8.2	2022년 2월 8일	2023년 8월 8일	2024년 2월 6일
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.4	2025년 2월 24일	2026년 8월 13일	2027년 2월 24일

End of life

Security fixes only

(*) 지원되는 PHP 버전

Laravel 11

Laravel 11은 간결해진 애플리케이션 구조, 초 단위의 속도 제한, 헬스 라우팅, 안전한 암호화 키 교체, 큐 테스트 기능 개선, Resend 메일 전송 지원, Prompt 유효성 검증 통합, 새로운 아티즌 명령어 등 다양한 개선을 통해 Laravel 10.x에서 더욱 진화하였습니다. 또한, 공식적으로 확장 가능한 웹소켓 서버인 Laravel Reverb가 도입되어, 애플리케이션에 강력한 실시간 기능을 제공합니다.

PHP 8.2

Laravel 11.x는 최소 PHP 8.2 버전이 필요합니다.

Streamlined Application Structure

이 간결한 애플리케이션 구조는 Taylor Otwell과 Nuno Maduro가 개발했습니다.

Laravel 11에서는 새로운 Laravel 애플리케이션을 위한 더욱 간결한 프로젝트 구조가 도입되었습니다. 기존 애플리케이션의 수정 없이 적용 가능하며, Laravel 개발자들이 익숙한 주요 개념들을 그대로 유지하면서도 더 현대적이고 가벼운 개발 경험을 제공합니다. 아래에서는 Laravel의 새로운 애플리케이션 구조의 핵심 사항을 살펴봅니다.

The Application Bootstrap File

bootstrap/app.php 파일은 코드 기반의 애플리케이션 설정 파일로 새롭게 개선되었습니다. 이제 이 파일에서 라우팅, 미들웨어, 서비스 프로바이더, 예외 처리 등 애플리케이션의 다양한 요소를 직접 구성할 수 있습니다. 이 파일을 통해 기존에는 애플리케이션 파일 구조 곳곳에 분산되어 있던 여러 상위 수준의 설정들을 한 곳에서 관리하게 되었습니다.

return Application::configure(basePath: dirname(__DIR__))
    ->withRouting(
        web: __DIR__.'/../routes/web.php',
        commands: __DIR__.'/../routes/console.php',
        health: '/up',
    )
    ->withMiddleware(function (Middleware $middleware) {
        //
    })
    ->withExceptions(function (Exceptions $exceptions) {
        //
    })->create();

Service Providers

이전에는 Laravel 기본 애플리케이션 구조에 5개의 서비스 프로바이더가 포함되어 있었으나, Laravel 11에서는 이제 하나의 AppServiceProvider만 포함됩니다. 나머지 프로바이더들의 기능은 bootstrap/app.php로 통합되었거나, 프레임워크에서 자동 처리되며, 필요한 경우 AppServiceProvider에 직접 작성할 수 있습니다.

예를 들어, 이벤트 디스커버리(event discovery)는 기본적으로 활성화되어 있어, 이벤트와 리스너의 수동 등록이 거의 필요하지 않습니다. 하지만 수동 등록이 필요한 경우에는 AppServiceProvider에 추가하면 됩니다. 이와 마찬가지로, 이전에 AuthServiceProvider에 등록하던 라우트 모델 바인딩 또는 인가 게이트(Gate)도 이제 AppServiceProvider에서 처리할 수 있습니다.

Opt-in API and Broadcast Routing

이제 api.php와 channels.php 라우트 파일은 기본적으로 포함되지 않으며, 많은 애플리케이션에서 필요하지 않기 때문입니다. 이 파일들이 필요할 경우, 아래와 같이 간단한 아티즌 명령어로 생성할 수 있습니다.

php artisan install:api

php artisan install:broadcasting

Middleware

이전에는 새 Laravel 애플리케이션에 9개의 미들웨어가 포함되어 있었으며, 이는 인증, 입력 문자열 트림, CSRF 토큰 검증 등 다양한 작업을 수행했습니다.

Laravel 11에서는 이 미들웨어들이 프레임워크 내부로 이동하여, 애플리케이션 구조를 단순화하였습니다. 미들웨어 동작을 커스터마이즈하는 새로운 메서드가 추가되어, 애플리케이션의 bootstrap/app.php 파일에서 쉽게 설정할 수 있습니다.

->withMiddleware(function (Middleware $middleware) {
    $middleware->validateCsrfTokens(
        except: ['stripe/*']
    );

    $middleware->web(append: [
        EnsureUserIsSubscribed::class,
    ])
})

이제 모든 미들웨어를 bootstrap/app.php에서 손쉽게 커스터마이즈할 수 있으므로, 별도의 HTTP "커널" 클래스가 필요하지 않습니다.

Scheduling

새로운 Schedule 파사드를 이용하면, 스케줄된 작업을 애플리케이션의 routes/console.php 파일에 직접 정의할 수 있게 되어, 별도의 콘솔 "커널" 클래스가 필요 없어졌습니다.

use Illuminate\Support\Facades\Schedule;

Schedule::command('emails:send')->daily();

Exception Handling

라우팅이나 미들웨어와 마찬가지로, 예외 처리 역시 기존의 독립적인 예외 처리기 클래스를 사용하는 대신, 이제 bootstrap/app.php 파일에서 직접 커스터마이즈할 수 있어, 새 애플리케이션의 파일 수가 줄어듭니다.

->withExceptions(function (Exceptions $exceptions) {
    $exceptions->dontReport(MissedFlightException::class);

    $exceptions->report(function (InvalidOrderException $e) {
        // ...
    });
})

Base Controller Class

새로운 Laravel 애플리케이션에 포함되는 기본 컨트롤러가 간소화되었습니다. 더 이상 Laravel 내부의 Controller 클래스를 상속하지 않으며, AuthorizesRequests 및 ValidatesRequests 트레잇도 제거되었습니다. 이 트레잇들은 필요할 경우 개별 컨트롤러에서 직접 사용하면 됩니다.

<?php

namespace App\Http\Controllers;

abstract class Controller
{
    //
}

Application Defaults

이제 새로 생성하는 Laravel 애플리케이션은 기본적으로 데이터베이스 저장소로 SQLite를, 그리고 세션, 캐시, 큐에는 database 드라이버를 사용합니다. 이를 통해 추가 소프트웨어 설치나 별도의 데이터베이스 마이그레이션을 진행하지 않고도 바로 개발을 시작할 수 있습니다.

또한 시간이 흐르면서, 이러한 Laravel 서비스의 database 드라이버들도 실제 운영 환경에서 충분히 사용할 수 있을 정도로 견고해졌기 때문에, 로컬 개발 뿐만 아니라 프로덕션에서도 일관된 선택지가 됩니다.

Laravel Reverb

Laravel Reverb는 Joe Dixon이 개발했습니다.

Laravel Reverb는 놀라울 정도로 빠르고 확장 가능한 실시간 WebSocket 통신을 Laravel 애플리케이션에 직접 제공하며, Laravel의 기존 이벤트 브로드캐스팅 도구인 Laravel Echo와도 매끄럽게 통합됩니다.

php artisan reverb:start

또한, Reverb는 Redis의 발행/구독 기능을 이용한 수평 확장(horizontally scaling)을 지원합니다. 이로써 여러 대의 백엔드 Reverb 서버가 하나의 대규모 애플리케이션의 WebSocket 트래픽을 분산 처리할 수 있습니다.

자세한 내용은 Reverb documentation를 참고하세요.

Per-Second Rate Limiting

초 단위 속도 제한 기능은 Tim MacDonald가 기여했습니다.

Laravel은 이제 모든 속도 제한기(HTTP 요청, 큐 작업 등)에서 "초 단위" 속도 제한을 지원합니다. 이전까지는 분 단위로만 제한할 수 있었습니다.

RateLimiter::for('invoices', function (Request $request) {
    return Limit::perSecond(1);
});

Laravel의 속도 제한에 대한 자세한 내용은 rate limiting documentation를 참고하세요.

Health Routing

헬스 라우팅 기능은 Taylor Otwell이 기여했습니다.

새로운 Laravel 11 애플리케이션에는 health 라우팅 지시문이 포함되어, Kubernetes와 같은 오케스트레이션 시스템 또는 외부 애플리케이션 헬스 모니터링 서비스가 호출할 수 있는 간단한 헬스 체크 엔드포인트(/up 경로)를 제공합니다.

->withRouting(
    web: __DIR__.'/../routes/web.php',
    commands: __DIR__.'/../routes/console.php',
    health: '/up',
)

이 라우트에 HTTP 요청이 오면 Laravel은 DiagnosingHealth 이벤트도 디스패치하므로, 애플리케이션별로 추가적인 헬스 체크를 수행할 수도 있습니다.

Graceful Encryption Key Rotation

안전한 암호화 키 교체 기능은 Taylor Otwell이 기여했습니다.

Laravel은 세션 쿠키를 포함해 모든 쿠키를 암호화합니다. 즉, Laravel 애플리케이션에 들어오는 거의 모든 요청이 암호화에 의존합니다. 이런 구조에서 암호화 키를 교체하면 모든 사용자가 로그아웃되고, 이전 키로 암호화된 데이터는 복호화가 불가능해집니다.

Laravel 11에서는 APP_PREVIOUS_KEYS 환경변수에 이전 암호화 키들을 쉼표로 구분해 지정할 수 있습니다.

값을 암호화할 때는 항상 APP_KEY 환경변수에 있는 현재 키가 사용됩니다. 값을 복호화할 때는 먼저 현재 키로 시도하고, 실패할 경우 이전 키들을 순차적으로 시도해 복호화가 성공하면 그 값을 사용합니다.

이 방식 덕분에, 암호화 키를 교체하더라도 사용자는 로그아웃되지 않고 기존 데이터를 계속 사용할 수 있습니다.

Laravel의 암호화 기능에 대한 자세한 내용은 encryption documentation를 참고하세요.

Automatic Password Rehashing

자동 비밀번호 재해시 기능은 Stephen Rees-Carter가 기여했습니다.

Laravel의 기본 비밀번호 해시 알고리즘은 bcrypt입니다. bcrypt 해시의 "work factor"(연산 횟수)는 config/hashing.php 파일이나 BCRYPT_ROUNDS 환경변수로 조절할 수 있습니다.

보통 CPU나 GPU 성능이 발전함에 따라 bcrypt work factor를 높여 주어야 합니다. Laravel 11에서는 애플리케이션의 work factor가 변경된 경우, 사용자가 인증할 때마다 자동으로 비밀번호를 재해시합니다.

Prompt Validation

Prompt 유효성 검증 통합은 Andrea Marco Sartori가 기여했습니다.

Laravel Prompts는 명령줄 애플리케이션에서 아름답고 직관적인 폼을 만들 수 있게 해주는 PHP 패키지로, 플레이스홀더 텍스트 및 유효성 검증 등 브라우저와 유사한 기능을 지원합니다.

Laravel Prompts는 클로저를 통한 입력값 검증을 지원합니다.

$name = text(
    label: 'What is your name?',
    validate: fn (string $value) => match (true) {
        strlen($value) < 3 => 'The name must be at least 3 characters.',
        strlen($value) > 255 => 'The name must not exceed 255 characters.',
        default => null
    }
);

하지만 많은 입력값이나 복잡한 유효성 검증이 필요한 경우 이 방식이 번거로울 수 있습니다. 이에 따라, Laravel 11에서는 프롬프트 입력값 유효성 검증에 validator의 전체 기능을 그대로 사용할 수 있습니다.

$name = text('What is your name?', validate: [
    'name' => 'required|min:3|max:255',
]);

Queue Interaction Testing

큐 상호작용 테스트 기능은 Taylor Otwell이 기여했습니다.

이전에는 큐에 등록된 작업이 다시 반환, 삭제, 수동 실패 처리됐는지를 테스트하기 위해 커스텀 큐 페이크(fake)와 스텁을 작성해야 했습니다. 이제 Laravel 11에서는 withFakeQueueInteractions 메서드를 통해 이러한 큐 동작을 손쉽게 테스트할 수 있습니다.

use App\Jobs\ProcessPodcast;

$job = (new ProcessPodcast)->withFakeQueueInteractions();

$job->handle();

$job->assertReleased(delay: 30);

큐에 등록된 작업 테스트에 대한 더 자세한 정보는 queue documentation를 참고하세요.

New Artisan Commands

클래스 생성 관련 아티즌 명령어는 Taylor Otwell이 기여했습니다.

아티즌에서 클래스, 열거형(Enum), 인터페이스, 트레잇을 빠르게 생성할 수 있는 새로운 명령어들이 추가되었습니다.

php artisan make:class
php artisan make:enum
php artisan make:interface
php artisan make:trait

Model Casts Improvements

모델 cast 개선은 Nuno Maduro가 기여했습니다.

Laravel 11부터는 모델의 cast(cast)를 속성이 아니라 메서드로 정의할 수 있습니다. 이를 통해, 특히 인수(arguments)를 사용하는 cast 정의가 훨씬 더 간결하고 직관적으로 바뀝니다.

/**
 * Get the attributes that should be cast.
 *
 * @return array<string, string>
 */
protected function casts(): array
{
    return [
        'options' => AsCollection::using(OptionCollection::class),
                  // AsEncryptedCollection::using(OptionCollection::class),
                  // AsEnumArrayObject::using(OptionEnum::class),
                  // AsEnumCollection::using(OptionEnum::class),
    ];
}

attribute casting에 대한 자세한 내용은 Eloquent documentation를 참고하세요.

The once Function

once 헬퍼 함수는 Taylor Otwell과 Nuno Maduro가 기여했습니다.

once 헬퍼 함수는 주어진 콜백을 실행하고 해당 요청이 진행되는 동안 그 결과를 메모리에 캐싱합니다. 같은 콜백으로 once 함수를 다시 호출하면 이전에 캐시된 결과를 그대로 반환합니다.

function random(): int
{
    return once(function () {
        return random_int(1, 1000);
    });
}

random(); // 123
random(); // 123 (cached result)
random(); // 123 (cached result)

once 헬퍼에 대한 자세한 정보는 helpers documentation를 참고하세요.

Improved Performance When Testing With In-Memory Databases

인메모리 데이터베이스 테스트 성능 개선은 Anders Jenbo가 기여했습니다.

Laravel 11에서는 테스트 시 :memory: SQLite 데이터베이스를 사용할 때 성능이 크게 향상되었습니다. 이는 Laravel이 PHP의 PDO 객체 참조를 유지하고, 여러 커넥션 간에 재사용하도록 개선했기 때문입니다. 실제로 전체 테스트 실행 시간이 절반가량 단축되는 경우도 많습니다.

Improved Support for MariaDB

MariaDB 지원 개선은 Jonas Staudenmeir와 Julius Kiekbusch가 기여했습니다.

Laravel 11에서는 MariaDB 지원이 더욱 발전했습니다. 이전 버전에서는 MySQL 드라이버를 통해 MariaDB를 사용할 수 있었지만, 이제는 전용 MariaDB 드라이버가 새로 도입되어 해당 데이터베이스에 더 적합한 기본 설정을 제공합니다.

Laravel의 데이터베이스 드라이버에 대해 더 알아보려면 database documentation를 참고하세요.

Inspecting Databases and Improved Schema Operations

스키마 작업 및 데이터베이스 인스펙션 개선은 Hafez Divandari가 기여했습니다.

Laravel 11에는 데이터베이스 스키마 작업과 인스펙션 관련 다양한 새 메서드가 추가되었습니다. 이제 컬럼의 직접 수정/이름 변경/삭제 등이 기본적으로 지원되며, 고급 공간 타입(spatial type), 기본값이 아닌 스키마명, 테이블/뷰/컬럼/인덱스/외래키 등 다양한 객체에 대한 네이티브 스키마 메서드도 사용할 수 있습니다.

use Illuminate\Support\Facades\Schema;

$tables = Schema::getTables();
$views = Schema::getViews();
$columns = Schema::getColumns('users');
$indexes = Schema::getIndexes('users');
$foreignKeys = Schema::getForeignKeys('users');