Laravel 13.22.0영향도 낮음마이너13.x

Laravel 13.22.0 업데이트

릴리스: 2026년 7월 25일

평가: 2026년 8월 28일

13.22.0은 통상적인 마이너 릴리스로, 새 기능(RateLimiter Macroable, BindWhen 속성, queue:clear 다중 큐 지원 등)과 여러 버그 수정(Cache::touch, Arr::every/some/last의 iterable 지원, Mailer::later 큐 이름 등)이 포함되어 있습니다. 공개 API를 깨는 변경은 명시되어 있지 않으며, 대부분 내부 개선이거나 하위 호환되는 버그 수정이므로 즉시 대응은 필요 없습니다.

패키지 관리자가 확인할 것

  • Scout (laravel/scout)위험도 낮음

    이번 릴리스 노트에 Scout 관련 변경은 없음. 큐 관련 변경(queue:clear 다중 큐 지원, Mailer::later 큐 이름 수정)이 Scout의 큐 기반 인덱싱을 사용하는 경우 간접적으로 관련될 수 있으니 큐 처리 로직만 참고삼아 확인 권장.

대응 체크리스트

  • Cache::touch() 사용처 점검선택

    PR #60878에서 Cache::touch()의 만료 시간 처리 버그가 수정됨. touch()로 TTL을 갱신하는 코드가 있다면 동작이 의도대로 바뀌었는지 확인.

  • Arr::every, Arr::some, Arr::last에 iterable 전달하는 코드 확인선택

    PR #60876, #60881에서 배열이 아닌 iterable(Generator 등)을 넘겼을 때의 동작이 복원/수정됨. 해당 헬퍼에 배열이 아닌 값을 넘기는 코드가 있다면 결과 재확인.

  • Mailer::later() 큐 이름 파라미터 확인선택

    PR #60865에서 큐 이름 지정 버그가 수정됨. later()에 큐 이름을 명시적으로 넘기는 메일 발송 코드가 있다면 큐 라우팅이 올바른지 확인.

  • 신규 #[BindWhen] 속성 검토선택

    PR #60862에서 조건부 컨테이너 바인딩을 위한 #[BindWhen()] 속성이 추가됨. 환경별/조건별 서비스 바인딩 로직을 단순화하고 싶다면 도입 검토.

자동 생성상세 평가

요약

13.22.0은 라라벨 13.x 라인의 통상적인 마이너 릴리스입니다. 새로운 기능 추가와 여러 버그 수정이 포함되어 있으며, 릴리스 노트상 공개 API를 깨는 변경 사항은 없습니다. 대부분의 애플리케이션은 별도 조치 없이 업그레이드 가능합니다.

주요 변경

  • RateLimiter가 Macroable을 지원하게 됨 (#60869)
  • 조건부 컨테이너 바인딩을 위한 #[BindWhen()] 속성 추가 (#60862)
  • queue:clear 명령에 다중 큐 지원 추가 (#60873)
  • Bus::batch 및 벌크 디스패치에서 Delay 속성 지원 (#60766)
  • HTTP 페이크 응답에서 스트림 바디 지원 (#60834)
  • 검증 규칙에서 DNS 조회 페이킹 지원 (#60879)
  • 버그 수정: Cache::touch() 만료 처리(#60878), Arr::every/Arr::some/Arr::last의 iterable 지원 복원(#60876, #60881), Mailer::later() 큐 이름 파라미터(#60865)
  • HTTP 테스트 자격 증명을 sensitive로 표시 (#60880)
  • 나머지는 CI/워크플로 개선, Rector 룰 적용, 내부 리팩터링 등 내부 변경 (#60850, #60851, #60852, #60854, #60872)

하위 호환성

릴리스 노트에 공개 API를 깨는 변경 사항으로 명시된 항목은 없습니다. 다만 Arr::every, Arr::some, Arr::last, Cache::touch(), Mailer::later() 등은 기존 동작의 버그를 수정한 것이므로, 해당 버그에 의존한 코드가 있었다면(드문 경우) 동작 차이를 체감할 수 있습니다.

패키지 관리자가 확인할 것

등록된 패키지 목록 중 이번 릴리스 노트에서 직접 언급되거나 명백히 연관된 패키지는 없습니다. 큐 관련 변경(queue:clear, Mailer::later, Bus::batch Delay 속성)을 사용하는 경우, 큐 기반 기능을 제공하는 패키지(예: Scout의 큐 인덱싱)를 참고 삼아 큐 이름/지연 처리 로직을 가볍게 확인하는 정도면 충분합니다.

대응 체크리스트

  • Cache::touch()로 TTL 갱신하는 코드가 있다면 만료 동작 재확인
  • Arr::every/Arr::some/Arr::last에 배열이 아닌 iterable을 넘기는 코드가 있다면 결과 확인
  • Mailer::later()에 큐 이름을 지정하는 메일 발송 로직이 있다면 큐 라우팅 확인
  • 조건부 바인딩이 필요하다면 신규 #[BindWhen()] 속성 도입 검토 (선택)
  • queue:clear를 다중 큐 환경에서 활용할지 검토 (선택)

GitHub 릴리스 노트를 근거로 언어 모델 (claude-sonnet-5)이 작성했으며, 사람이 검수하지 않았습니다. 실제 적용 전에는 공식 릴리스 노트와 업그레이드 가이드를 함께 확인하세요.

GitHub 원문 릴리스 노트 보기
GitHub 공식 릴리스 노트 보기 →