Laravel 13.7.0 업데이트

요약

Laravel 13.7.0은 마이너 릴리스로, 대부분 버그 수정, enum 지원 확대, PHPDoc/타입 정리로 구성되어 있습니다. 공개 API를 깨는 변경은 릴리스 노트 상 확인되지 않았습니다. 다만 서명된 URL 검증 우회 방지 수정과 큐 워커 시그널 처리 변경은 실사용 영향이 있을 수 있어 점검을 권장합니다.

주요 변경

• 서명된 URL 검증 강화: 배열 쿼리 파라미터로 서명 검증을 우회할 수 있던 문제를 수정했습니다 (#59860). 보안 관련 수정이므로 서명 URL을 쓰는 앱은 주의가 필요합니다.
• 큐 워커 시그널 대응: 잡(Job)이 워커 시그널에 반응할 수 있게 되었고, WorkerInterrupted 이벤트가 도입되었습니다 (#59833, #59848). 관리형 큐 워커에서는 일시정지(pausing)가 비활성화되도록 변경되었습니다 (#59870).
• enum 지원 확대: LazyCollection::keyBy(), ConcurrencyManager 드라이버, RateLimitedWithRedis의 $limiterName, Cache touch(), QueueManager/LogManager/SessionManager의 setDefaultDriver, RedisManager::purge() 등 여러 곳에 UnitEnum 지원이 추가되었습니다. 이는 기존 문자열 사용을 깨지 않는 추가 기능입니다.
• 테스트 헬퍼 개선: assertSoftDeleted/assertNotSoftDeleted에 배열 지원, TestResponse에 JSON 경로 벌크 assertion 추가.
• 기타 버그 수정: 도메인 스코프 라우트 등록 문제, LazyCollection::has() 중복 키 false positive, SqsConnector 자격 증명 메모이제이션, 팩토리 hasAttached pivot JSON 처리 등.
• 다수의 PHPDoc/타입 정리 및 rector 리팩토링: 실제 동작 변경 없는 내부 정리성 PR이 다수 포함되어 있습니다.

하위 호환성

릴리스 노트 상 공개 API를 깨는 변경(behaviour breaking change)은 명시되어 있지 않습니다. enum 지원 추가는 기존 문자열/값 기반 사용을 그대로 지원하면서 선택적으로 enum도 받는 방식이므로 하위 호환됩니다. 서명 URL 검증 수정은 보안을 강화하는 방향이라 기존에 우회 가능했던 잘못된 사용 패턴만 영향을 받습니다.

패키지 관리자가 확인할 것

• Http (illuminate/http): 서명된 URL 검증 로직을 사용하는 코드가 배열 쿼리 파라미터에 의존하고 있었다면 동작이 달라질 수 있습니다.
• 등록된 다른 패키지(Scout, Socialite, Inertia Laravel, Image 등)에 대해서는 이번 릴리스 노트에서 직접적인 영향 근거가 없습니다.

대응 체크리스트

• 서명된 URL(signedRoute, hasValidSignature)을 사용하는 라우트에서 배열 쿼리 파라미터 사용 여부 확인
• 큐 워커 종료/일시정지 로직이나 WorkerInterrupted 이벤트 관련 커스텀 처리가 있는지 확인
• composer update laravel/framework 후 CI 전체 테스트 실행
• 특별한 조치가 필요 없는 경우, 이번 릴리스는 일반 업그레이드로 충분함