Laravel 13.34.0 업데이트

요약

13.34.0(13.x 브랜치)은 다수의 버그 수정과 소규모 신규 기능이 포함된 정기 마이너 릴리스입니다. 릴리스 노트에는 공개 API를 깨뜨리는 변경으로 명시된 항목이 없으며, 대부분 내부 버그 수정 및 편의 기능 추가입니다.

주요 변경

• 큐: JobProcessed 이벤트에 처리 시간 포함, 타임아웃 예정 시 알림, queue:flush --queue 옵션 추가, maxExceptions에 워커 크래시 반영, queue:restart에서 재시작 불가 시 오류 표시.
• Eloquent: whereMorphedTo/whereNotMorphedTo가 관계의 owner key를 존중하도록 수정, 폴리모픽 관계 읽기 시 morph map 강제 적용, wherePivotBetween()이 sync()/detach()/updateExistingPivot()에서 무시되던 버그 수정, whereNot() 배열 조건의 이중 부정 버그 수정, increment/decrement 후 refreshed 속성 원본 상태 동기화, replicate 시 refreshed 속성 제외.
• 헬퍼/컬렉션: Number::parseInt() 32비트 초과 값 버그, Number::format/percentage/currency의 -0 반환 버그, Collection::mode()가 존재하지 않는 값을 반환하던 버그, sortBy() + SORT_NUMERIC 소수점 절삭 버그, LazyCollection::combine() 길이 불일치 시 ValueError throw.
• 락/캐시: PhpRedisLock::refresh() phpredis 직렬화 활성 시 버그, Memcached 락 30일 초과 시 즉시 만료되던 버그, DatabaseLock이 트랜잭션 내 데드락을 삼키던 문제 수정, 태그된 캐시 memoized many()의 숫자 키 처리 버그, ArrayStore::touch()에서 점(dot) 표기 키를 리터럴로 처리.
• 기타: trans_choice() 음수 복수형 선택 오류 수정, S3 named credential provider 및 Cloud IAM 디스크 지원 추가, Schema\Builder::getColumn() 메서드 신규 추가, multipart 요청 재시도 시 스트림 내용 손실 버그 수정, assertDatabaseCount가 배열을 받을 수 있도록 확장.

하위 호환성

릴리스 노트에 하위 호환성을 깨는 변경으로 명시된 항목은 없습니다. 다만 여러 항목이 "버그 수정"으로 기존의 잘못된 동작에 의존하고 있었다면 결과 값이나 쿼리 결과가 달라질 수 있습니다(특히 whereMorphedTo, wherePivotBetween, whereNot 배열 조건 관련).

패키지 관리자가 확인할 것

• Horizon / Laravel Queue Rabbitmq: 큐 워커의 타임아웃 알림, 크래시 카운트, 재시작 오류 처리 변경 사항이 대시보드나 커스텀 워커 로직과 상호작용하는지 확인.
• Laravel Permission: whereNot() 배열 조건 이중 부정 수정이 권한/역할 조회 쿼리에 영향을 주는지 확인.
• Laravel Medialibrary: 모델 replicate 시 refreshed 속성 제외 변경이 미디어 연관 모델 복제에 영향을 주는지 확인.
• 그 외 등록된 패키지들에는 이번 릴리스 노트상 직접적인 영향 근거가 없습니다.

대응 체크리스트

• composer update laravel/framework로 업그레이드 후 전체 테스트 스위트 실행
• whereMorphedTo/whereNotMorphedTo, morph map, wherePivotBetween 사용 코드 재검토
• Number:: 및 Collection::mode()/sortBy() 사용처의 결과값 재확인
• 큐 워커 타임아웃/재시작/크래시 관련 커스텀 로직이 있다면 동작 재확인
• 긴급 대응 불필요 — 보안 패치나 강제 마이그레이션 항목 없음