Laravel 13.6.0 업데이트

예상되는 하위 호환성 문제

• 암호화 시 모든 키에 대해 MAC 검증심각도 보통

  PR #59742에서 'Validate MAC across all decryption keys'로 변경되어, 이전에는 특정 키 하나만으로 통과하던 검증 로직이 여러 키(previousKeys 등)를 모두 대상으로 MAC을 검사하도록 바뀌었습니다. 키 로테이션을 사용 중인 앱에서 복호화 성공/실패 여부가 달라질 수 있습니다.

  영향 범위: APP_KEY/APP_PREVIOUS_KEYS를 통한 암호화 키 로테이션을 사용하는 애플리케이션

• digits_between, decimal, max_digits, min_digits 검증 규칙의 타입 처리 변경심각도 낮음

  PR #59717, #59739에서 문자열이 아닌 값이 들어올 때 TypeError가 발생하던 것을 수정하고 preg_match 호출 전 문자열로 캐스팅하도록 변경했습니다. 기존에 예외로 실패 처리되던 입력이 이제 정상적으로 검증을 통과하거나 다른 결과를 낼 수 있습니다.

  영향 범위: digits_between/decimal/max_digits/min_digits 검증 규칙을 숫자가 아닌 값(배열, 객체 등)에 적용하는 폼 요청/유효성 검사 로직

• Cursor::fromEncoded가 잘못된 페이로드에 대해 null 반환심각도 낮음

  PR #59699에 따라 malformed 커서 문자열을 넘겼을 때 예외 대신 null을 반환하도록 변경되었습니다. 이전에 예외를 캐치해 처리하던 코드가 있다면 null 체크로 바꿔야 합니다.

  영향 범위: 커스텀 페이지네이션/커서 처리 로직에서 Cursor::fromEncoded를 직접 사용하는 코드

대응 체크리스트

• 암호화 키 로테이션 사용 여부 확인가까운 시일

  config/app.php의 previous_keys(APP_PREVIOUS_KEYS)를 사용 중이라면, 업그레이드 후 기존 암호화된 데이터의 복호화가 정상 동작하는지 테스트하세요.

• 숫자 관련 커스텀 유효성 검사 재확인선택

  digits_between, decimal, max_digits, min_digits 규칙에 문자열이 아닌 값(예: 배열, null이 아닌 객체)을 전달하는 폼이 있다면 동작이 바뀌었는지 테스트 스위트로 확인하세요.

• Cursor::fromEncoded 직접 사용 코드 점검선택

  커스텀 페이지네이션에서 Cursor::fromEncoded 호출 후 예외 처리를 하고 있었다면 null 반환에 대응하도록 코드를 점검하세요.

자동 생성상세 평가

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