Files
Gnuboard7/app/Rules/LocaleRequiredTranslatable.php
HeuJung 7f8fb6870f fix(core,board,ecommerce): 조건부 검증 결함 패밀리 일괄 수정 및 실패 안내 노출
여러 화면에서 조건부(FormRequest) 검증이 우회되거나 과도하게 제한되던 결함을 한 계열로 묶어 수정한다.

- 검증 규칙 확장 필터 이름 10개를 나머지 92개와 동일 규칙으로 통일
- 설명 길이를 바이트가 아닌 글자 수로 계산(한글 오검출 해소)
- 비활성 언어팩 번역 보존한 채 수정 허용
- 알림 템플릿 제목 nullable 존중, 미지원 발송 수단 저장 차단
- 일정/실행 이력 목록 조회 검증 정합
- 게시판 첨부 미사용 시 빈 확장자 통과, new_display_hours/최소 길이 0 허용, 일괄 적용 override_values 범위 검증(SSoT)
- 이커머스 클레임 사유 조회 검증, 용어 정정
- 원문 i18n 키 노출 다수 해소, 저장/삭제 실패 시 사유 화면 노출
- 아이콘 크기/다크모드 대비 회귀 수정

번들 확장(모듈3·플러그인6·템플릿2·언어팩5) 버전 new-bump 및 CHANGELOG 반영, ja 언어팩 동기.
2026-07-23 10:54:17 +09:00

121 lines
4.2 KiB
PHP

<?php
namespace App\Rules;
use Closure;
use Illuminate\Contracts\Validation\ValidationRule;
/**
* 현재 로케일 필수 다국어 필드 검증 규칙
*
* 현재 로케일(또는 지정된 로케일)의 값만 필수로 검증하고,
* 다른 로케일은 선택적으로 검증합니다.
*/
class LocaleRequiredTranslatable implements ValidationRule
{
/**
* LocaleRequiredTranslatable 생성자
*
* @param int $maxLength 각 번역의 최대 길이
* @param int $minLength 각 번역의 최소 길이 (기본: 0)
* @param string|null $requiredLocale 필수 로케일 (null이면 현재 로케일 사용)
* @param bool $strictLocales 지원 목록 밖 로케일 키를 실패로 처리할지 여부
*/
public function __construct(
private int $maxLength = 255,
private int $minLength = 0,
private ?string $requiredLocale = null,
private bool $strictLocales = false
) {}
/**
* 검증 규칙 실행
*
* @param string $attribute 필드명
* @param mixed $value 검증 값
* @param Closure $fail 실패 콜백
*/
public function validate(string $attribute, mixed $value, Closure $fail): void
{
// 배열이 아닌 경우
if (! is_array($value)) {
$fail(__('validation.translatable.must_be_array'));
return;
}
// 허용된 언어 목록 가져오기
$allowedLanguages = config('app.translatable_locales', ['ko', 'en']);
// 필수 로케일 결정 (지정된 값 또는 현재 로케일)
$requiredLocale = $this->requiredLocale ?? app()->getLocale();
// 필수 로케일이 지원 언어에 없으면 첫 번째 언어 사용
if (! in_array($requiredLocale, $allowedLanguages)) {
$requiredLocale = $allowedLanguages[0];
}
// 필수 로케일 값 검증
$requiredValue = $value[$requiredLocale] ?? null;
if (is_null($requiredValue) || (is_string($requiredValue) && trim($requiredValue) === '')) {
$fail(__('validation.translatable.current_locale_required', [
'locale' => $requiredLocale,
]));
return;
}
// 각 언어별 검증
foreach ($value as $lang => $text) {
// 지원 목록 밖 로케일 키
//
// app.translatable_locales 는 활성 언어팩 기준으로 부팅마다 덮어써지는 가변 런타임
// 값이다. 언어팩을 비활성화하면 기존 레코드에 남아 있던 그 로케일 키 때문에 수정
// 자체가 차단되므로, 기본값은 "길이 검증 대상에서 제외하고 통과"로 둔다.
// 데이터를 지우지 않으므로 언어팩을 다시 켜면 번역이 그대로 복구된다.
if (! in_array($lang, $allowedLanguages)) {
if ($this->strictLocales) {
$fail(__('validation.translatable.unsupported_language', ['lang' => $lang]));
return;
}
continue;
}
// null이거나 빈 문자열이 아닌 경우에만 검증
if ($text !== null && $text !== '') {
// 문자열이 아닌 경우
if (! is_string($text)) {
$fail(__('validation.translatable.must_be_string', ['lang' => $lang]));
return;
}
$length = mb_strlen($text);
// 최소 길이 미달
if ($this->minLength > 0 && $length < $this->minLength) {
$fail(__('validation.translatable.min_length', [
'lang' => $lang,
'min' => $this->minLength,
]));
return;
}
// 최대 길이 초과
if ($length > $this->maxLength) {
$fail(__('validation.translatable.max_length', [
'lang' => $lang,
'max' => $this->maxLength,
]));
return;
}
}
}
}
}