Laravel 13.31.0 업데이트

요약

13.31.0은 breaking change 없이 다수의 버그 수정과 소규모 기능 추가로 구성된 정기 마이너 릴리스입니다. 인증, 큐, Eloquent, Http Client 등 여러 영역에서 실사용 중 발견된 결함이 패치되었습니다.

주요 변경

• 인증: 저장된 쿠키의 비밀번호 해시를 검증 후 인증하도록 수정, recaller 미매칭 시 TypeError 수정 (#61386, #61397)
• 큐: Redis 큐 드라이버 클러스터 안전성 개선(bulk MULTI, allQueueNames KEYS 사용), RateLimited 미들웨어가 제한을 무시하던 버그 수정, JobInterrupted 이벤트 추가, Queue에 totalSize() 메서드 추가 (#61198, #61449, #61412, #61373)
• Eloquent: lazy()/lazyById()가 limit()/offset()을 무시하던 버그 수정, BelongsToMany pivot 모델 chaperone 지원 추가, wherePivot() 클로저 스코프 무시 버그 수정, soft delete 컬럼에 테이블 별칭 적용 (#61402, #61152, #61488, #61456)
• Http Client 메모리 누수 수정 (#61438)
• 세션: ArraySessionHandler에 PHP 9.0 대비 create_sid() 메서드 추가 (#61469)
• 라우트 캐싱 시 컨테이너 인스턴스 복원 문제 수정, 특정 상황의 라우트 URL 생성 버그 수정 (#61405, #61475)

하위 호환성

릴리스 노트에 공개 API의 시그니처 변경이나 문서화된 동작의 breaking change는 명시되어 있지 않습니다. 다만 버그 수정 성격상 이전에 잘못 동작하던 기능(RateLimited 미들웨어, lazy()/lazyById() limit 처리 등)에 의존해 우회 코드를 작성한 경우 동작 차이를 체감할 수 있습니다.

패키지 관리자가 확인할 것

• illuminate/http: Http Client 메모리 누수 수정으로 장기 실행 프로세스에서 이점이 있으나 코드 변경 불필요
• laravel/scout: lazy()/lazyById() limit/offset 수정이 임포트 로직에 영향을 줄 수 있어 결과 건수 확인 권장
• 그 외 등록된 패키지(Socialite, Sanctum류 관련 없음)에는 직접적인 언급이 없습니다

대응 체크리스트

• Redis 클러스터로 큐를 운영 중이면 업그레이드 검토
• RateLimited 큐 미들웨어 사용 시 업그레이드 후 제한 동작 재확인
• 커스텀 SessionHandlerInterface 구현체에 create_sid() 존재 여부 점검
• 'remember me' 쿠키 인증 플로우 업그레이드 후 회귀 테스트
• 특별한 이슈가 없다면 일반 마이너 업그레이드로 진행 가능