Laravel 13.18.1 업데이트
릴리스: 2026년 7월 3일
평가: 2026년 8월 28일
이번 13.18.1 릴리스는 patch 버전으로, 신규 기능 추가와 버그 수정 위주입니다. 하위 호환성을 깨는 변경은 릴리스 노트상 확인되지 않으며, 대부분의 애플리케이션은 별도 조치 없이 업데이트해도 됩니다.
대응 체크리스트
- Maintenance(점검) 모드에서 API/JSON 라우트 처리 변경 확인선택
davidrushton의 PR(#60595)에서 Down 커맨드가 api/json 라우트를 다르게 처리하도록 개선되었습니다. 점검 모드를 사용 중이며 API 응답 포맷에 의존하는 경우 동작을 확인하세요.
- on-demand 로그 스택의 채널명 처리 변경 확인선택
maltf0의 PR(#60635)에서 on-demand 로그 스택이 채널 이름을 올바르게 반영하도록 수정되었습니다. Log::stack()을 커스텀 채널명과 함께 사용 중이라면 로그 출력을 확인하세요.
- Str::mask() 인코딩 처리 변경 확인선택
iammcoding의 PR(#60646)에서 Str::mask()가 문자열 끝부분을 구성할 때 인코딩을 존중하도록 수정되었습니다. 멀티바이트 문자열에 mask()를 사용 중이라면 출력 결과를 확인하세요.
자동 생성상세 평가
요약
13.18.1은 patch 릴리스로, 새로운 기능 추가(콘솔 input() 메서드, Release 큐 미들웨어, 지연된 잡 검사 등)와 몇 가지 버그 수정이 포함되어 있습니다. 릴리스 노트에 명시된 내용만으로는 하위 호환성을 깨는 변경 사항이 없습니다.
주요 변경
assertDatabaseEmpty가 iterable을 처리할 수 있도록 개선- 콘솔 커맨드에
input()메서드 추가 - 점검(Down) 모드에서 API/JSON 라우트 처리 개선
- on-demand 로그 스택의 채널명 처리 버그 수정
- 큐 페이크(fake)에서 지연된 잡 검사 지원 추가
- 새로운
Release큐 미들웨어 추가 Str::mask()의 인코딩 처리 버그 수정- Predis retry 설정의 scalar 값 지원으로
config:cache호환성 개선 - Blueprint의
foreignUuid/foreignUlid독블록 수정 (문서만 변경)
하위 호환성
릴리스 노트에 명시된 변경 사항들은 모두 버그 수정 또는 기능 추가이며, 공개 API의 동작이 문서화된 방식과 다르게 깨졌다는 근거는 없습니다. 다만 로그 채널명 처리와 Str::mask() 인코딩 처리는 기존 동작에 의존하던 코드가 있다면 결과값이 달라질 수 있으므로 참고하시기 바랍니다.
패키지 관리자가 확인할 것
제공된 패키지 목록 중 이번 릴리스 노트 내용과 직접적으로 연관된 패키지는 없습니다.
대응 체크리스트
- 점검 모드(Down)에서 API 응답을 처리하는 로직이 있다면 동작 확인
-
Log::stack()으로 on-demand 로그를 사용 중이라면 채널명 출력 확인 -
Str::mask()를 멀티바이트 문자열에 사용 중이라면 결과 확인 - 그 외에는 특별한 조치 없이 업데이트 가능
GitHub 릴리스 노트를 근거로 언어 모델 (claude-sonnet-5)이 작성했으며, 사람이 검수하지 않았습니다. 실제 적용 전에는 공식 릴리스 노트와 업그레이드 가이드를 함께 확인하세요.
GitHub 원문 릴리스 노트 보기
- [13.x] Allow assertDatabaseEmpty to handle iterable by @jackbayliss in https://github.com/laravel/framework/pull/60621
- [13.x] Add
input()method to console commands by @stevebauman in https://github.com/laravel/framework/pull/60607 - [13.x] Handle api / json routes with Down (Maintenance) command by @davidrushton in https://github.com/laravel/framework/pull/60595
- [13.x] fix: respect channel name for on-demand log stacks by @maltf0 in https://github.com/laravel/framework/pull/60635
- [13.x] Support inspecting delayed jobs on the queue fake by @jackbayliss in https://github.com/laravel/framework/pull/60636
- Add
Releasequeue middleware by @mgcodeur in https://github.com/laravel/framework/pull/60630 - [13.x] Update docblocks of Blueprint foreignUuid and foreignUlid to match foreignId by @LiddleDev in https://github.com/laravel/framework/pull/60643
- Respect the encoding in Str::mask() when building the end of the string by @iammcoding in https://github.com/laravel/framework/pull/60646
- [13.x] Supports scalar Predis retry config to allows
config:cacheby @crynobone in https://github.com/laravel/framework/pull/60642