Laravel 유효성 검증 편집하기

==개요==
[[분류: Laravel]]
[[분류: validation]]
;Laravel Validation
;라라벨 밸리데이션, 유효성 검증, 유효성 검사
https://laravel.com/docs/11.x/validation
{{작성중}}

==소개==
Laravel은 애플리케이션으로 들어오는 데이터를 검증하기 위해 여러 가지 접근 방식을 제공합니다. 가장 일반적으로는 모든 들어오는 HTTP 요청에서 사용할 수 있는 <code>validate</code> 메소드를 사용하는 방법이 있습니다. 그러나 여기서는 다른 검증 접근 방식들도 함께 논의할 것입니다.

Laravel은 데이터에 적용할 수 있는 다양한 편리한 검증 규칙을 포함하고 있으며, 특정 데이터베이스 테이블에서 값이 고유한지 검증할 수 있는 기능도 제공합니다. Laravel의 모든 검증 기능에 익숙해질 수 있도록 각 검증 규칙을 자세히 다룰 것입니다.

==유효성 검증 빠른 시작==
Laravel의 강력한 유효성 검사 기능을 배우기 위해, 폼을 검증하고 사용자에게 오류 메시지를 표시하는 전체 예제를 살펴보겠습니다. 이 고수준 개요를 통해 Laravel을 사용하여 들어오는 요청 데이터를 검증하는 방법에 대한 좋은 일반적인 이해를 얻을 수 있을 것입니다:

===라우트 정의===
먼저, <code>routes/web.php</code> 파일에 다음과 같은 라우트가 정의되어 있다고 가정해 보겠습니다:

<syntaxhighlight lang='php'>
use App\Http\Controllers\PostController;
 
Route::get('/post/create', [PostController::class, 'create']);
Route::post('/post', [PostController::class, 'store']);
</syntaxhighlight>

<code>GET</code> 라우트는 사용자가 새로운 블로그 포스트를 작성할 수 있는 폼을 표시하고, <code>POST</code> 라우트는 새로운 블로그 포스트를 데이터베이스에 저장합니다.

===컨트롤러 생성===
다음으로, 이러한 경로로 들어오는 요청을 처리하는 간단한 컨트롤러를 살펴보겠습니다. <code>store</code> 메소드는 아직 비워둡니다:

<syntaxhighlight lang='php'>
<?php

namespace App\Http\Controllers;

use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\View\View;

class PostController extends Controller
{
    /**
     * 새 블로그 게시물을 작성하는 폼을 보여줍니다.
     */
    public function create(): View
    {
        return view('post.create');
    }

    /**
     * 새 블로그 게시물을 저장합니다.
     */
    public function store(Request $request): RedirectResponse
    {
        // 블로그 게시물을 검증하고 저장합니다...

        $post = /** ... */

        return to_route('post.show', ['post' => $post->id]);
    }
}

</syntaxhighlight>

===유효성 검증 로직 작성===
이제 새 블로그 게시물을 유효성 검증할 로직을 <code>store</code> 메소드에 작성할 준비가 되었습니다. 이를 위해 <code>Illuminate\Http\Request</code> 객체에서 제공하는 <code>validate</code> 메소드를 사용할 것입니다. 유효성 검증 규칙을 통과하면 코드가 정상적으로 계속 실행됩니다. 그러나 유효성 검증이 실패하면 <code>Illuminate\Validation\ValidationException</code> 예외가 발생하고 사용자에게 적절한 오류 응답이 자동으로 반환됩니다.

전통적인 HTTP 요청 중 유효성 검증이 실패하면 이전 URL로 리디렉션 응답이 생성됩니다. 들어오는 요청이 XHR 요청인 경우 [[#유효성 검증 오류 응답 형식|유효성 검증 오류 메시지를 포함한 JSON 응답]]이 반환됩니다.

<code>validate</code> 메소드를 더 잘 이해하기 위해 <code>store</code> 메소드로 돌아가 봅시다:

<syntaxhighlight lang='php'>
/**
 * 새로운 블로그 게시물 저장.
 */
public function store(Request $request): RedirectResponse
{
    $validated = $request->validate([
        'title' => 'required|unique:posts|max:255',
        'body' => 'required',
    ]);

    // 블로그 게시물 유효성 검증 통과...

    return redirect('/posts');
}
</syntaxhighlight>

보다시피, 검증 규칙이 <code>validate</code> 메소드에 전달됩니다. 모든 사용 능한 검증 규칙은 문서화되어 있으니 걱정하지 마십시오. 검증에 실패하면 적절한 응답이 자동으로 생성됩니다. 검증에 성공하면 컨트롤러는 정상적으로 실행을 계속합니다.

또한 검증 규칙은 <code>|</code>로 구분된 문자열 대신 규칙 배열로 지정할 수 있습니다:

<syntaxhighlight lang='php'>
$validatedData = $request->validate([
    'title' => ['required', 'unique:posts', 'max:255'],
    'body' => ['required'],
]);
</syntaxhighlight>


또한, <code>validateWithBag</code> 메소드를 사용하여 요청을 검증하고, 오류 메시지를 [[#명명된 오류 백|명명된 오류 백]]에 저장할 수 있습니다:

<syntaxhighlight lang='php'>
$validatedData = $request->validateWithBag('post', [
    'title' => ['required', 'unique:posts', 'max:255'],
    'body' => ['required'],
]);
</syntaxhighlight>

;첫 번째 유효성 검증 실패 시 중지하기
때로는 첫 번째 유효성 검증 실패 후 해당 속성에 대한 유효성 검증 규칙 실행을 중지하고 싶을 수 있습니다. 이를 위해 속성에 <code>bail</code> 규칙을 할당할 수 있습니다:

<syntaxhighlight lang='php'>
$request->validate([
    'title' => 'bail|required|unique:posts|max:255',
    'body' => 'required',
]);
</syntaxhighlight>

이 예시에서, <code>title</code> 속성의 <code>unique</code> 규칙이 실패하면 <code>max</code> 규칙은 검증하지 않습니다. 규칙은 할당된 순서대로 유효성이 검증됩니다.

;중첩된 속성에 관한 노트
만약 들어오는 HTTP 요청에 "중첩된" 필드 데이터가 포함되어 있다면, "점(dot)" 구문을 사용하여 이 필드들을 유효성 검증 규칙을 지정할 수 있습니다:

<syntaxhighlight lang='php'>
$request->validate([
    'title' => 'required|unique:posts|max:255',
    'author.name' => 'required',
    'author.description' => 'required',
]);
</syntaxhighlight>

반면에, 필드 이름에 실제 점(점 문자)이 포함된 경우에는, 백슬래시로 점을 이스케이프하여 "점(dot)" 구문으로 해석되는 것을 명시적으로 방지할 수 있습니다:

<syntaxhighlight lang='php'>
$request->validate([
    'title' => 'required|unique:posts|max:255',
    'v1\.0' => 'required',
]);
</syntaxhighlight>

===유효성 검증 오류 표시===
그래서 들어오는 요청 필드가 주어진 유효성 검증 규칙을 통과하지 못하면 어떻게 될까요? 앞서 언급한 바와 같이, Laravel은 자동으로 사용자를 이전 위치로 리디렉션합니다. 또한, 모든 유효성 검증 오류와 [https://laravel.com/docs/11.x/requests#retrieving-old-input 요청 입력]이 자동으로 [https://laravel.com/docs/11.x/session#flash-data 세션에 플래시]됩니다.

<code>Illuminate\View\Middleware\ShareErrorsFromSession</code> 미들웨어는 <code>$errors</code> 변수를 애플리케이션의 모든 뷰와 공유하는데, 이 미들웨어는 웹 미들웨어 그룹에 의해 제공됩니다. 이 미들웨어가 적용되면 <code>$errors</code> 변수는 항상 뷰에서 사용할 수 있으며, 이를 통해 <code>$errors</code> 변수가 항상 정의되어 안전하게 사용할 수 있다고 가정할 수 있습니다. <code>$errors</code> 변수는 <code>Illuminate\Support\MessageBag</code>의 인스턴스가 됩니다. 이 객체를 사용하는 방법에 대한 자세한 정보는 [[#오류 메시지 다루기|해당 문서]]를 참고하세요.

이 예제에서, 유효성 검증이 실패하면 사용자는 컨트롤러의 <code>create</code> 메소드로 리디렉션되어 뷰에서 오류 메시지를 표시할 수 있게 됩니다:

{{소스헤더|/resources/views/post/create.blade.php}}
<syntaxhighlight lang='php'>
<h1>Create Post</h1>

@if ($errors->any())
    <div class="alert alert-danger">
        <ul>
            @foreach ($errors->all() as $error)
                <li>{{ $error }}</li>
            @endforeach
        </ul>
    </div>
@endif

<!-- 게시물 작성 폼 -->
</syntaxhighlight>

;오류 메시지 커스터마이징
Laravel의 빌트인 유효성 검증 규칙 각각에는 애플리케이션의 <code>lang/en/validation.php</code> 파일에 위치한 오류 메시지가 있습니다. 애플리케이션에 <code>lang</code> 디렉토리가 없다면, <code>lang:publish</code> Artisan 명령어를 사용하여 Laravel에게 이를 생성하도록 지시할 수 있습니다.

<code>lang/en/validation.php</code> 파일 안에서는 각 유효성 검증 규칙에 대한 번역 항목을 찾을 수 있습니다. 애플리케이션의 필요에 따라 이 메시지들을 자유롭게 변경하거나 수정할 수 있습니다.

또한, 이 파일을 다른 언어 디렉토리로 복사하여 애플리케이션의 언어에 맞게 메시지를 번역할 수도 있습니다. Laravel 현지화에 대해 더 알고 싶다면, 전체 [https://laravel.com/docs/11.x/localization 현지화 문서]를 참고하세요.

{{WARNING}}
기본적으로, Laravel 애플리케이션 스켈레톤에는 <code>lang</code> 디렉토리가 포함되어 있지 않습니다. Laravel의 언어 파일을 커스터마이징하려면, <code>lang:publish</code> Artisan 명령어를 통해 이를 게시할 수 있습니다.
{{/WARNING}}

;XHR 요청 및 유효성 검증
이 예제에서는 전통적인 폼을 사용하여 데이터를 애플리케이션으로 전송했습니다. 그러나 많은 애플리케이션은 JavaScript 기반 프론트엔드에서 XHR 요청을 받습니다. XHR 요청 중에 <code>validate</code> 메소드를 사용할 때, Laravel은 리디렉션 응답을 생성하지 않습니다. 대신, Laravel은 [[#유효성 검사 응답 형식|모든 유효성 검증 오류를 포함하는 JSON 응답]]을 생성합니다. 이 JSON 응답은 422 HTTP 상태 코드와 함께 전송됩니다.

;<code>@error</code> 지시어
<code>@error</code> [[Laravel Blade|Blade]] 지시어를 사용하여 주어진 속성에 대한 유효성 검증 오류 메시지가 존재하는지 빠르게 확인할 수 있습니다. <code>@error</code> 지시어 내에서 <code>$message</code> 변수를 출력하여 오류 메시지를 표시할 수 있습니다:

{{소스헤더|/resources/views/post/create.blade.php}}
<syntaxhighlight lang='php'>
<label for="title">Post Title</label>

<input id="title"
    type="text"
    name="title"
    class="@error('title') is-invalid @enderror">

@error('title')
    <div class="alert alert-danger">{{ $message }}</div>
@enderror
</syntaxhighlight>

[[#명명된 오류 백|명명된 오류 백]]을 사용하는 경우, <code>@error</code> 지시어의 두 번째 인수로 오류 백의 이름을 전달할 수 있습니다:

<syntaxhighlight lang='php'>
<input ... class="@error('title', 'post') is-invalid @enderror">
</syntaxhighlight>

===폼 다시 채우기===
Laravel이 유효성 검증 오류로 인해 리디렉션 응답을 생성할 때, 프레임워크는 자동으로 요청의 모든 입력을 세션에 플래시합니다. 이렇게 하면 다음 요청 시 입력을 편리하게 액세스하고 사용자가 제출하려고 했던 폼을 다시 채울 수 있습니다.

이전 요청에서 플래시된 입력을 검색하려면 <code>Illuminate\Http\Request</code> 인스턴스에서 <code>old</code> 메소드를 호출합니다. <code>old</code> 메소드는 세션에서 이전에 플래시된 입력 데이터를 가져옵니다:

<syntaxhighlight lang='php'>
$title = $request->old('title');
</syntaxhighlight>

Laravel은 또한 글로벌 <code>old</code> 헬퍼를 제공합니다. 블레이드 템플릿 내에서 이전 입력을 표시하는 경우, <code>old</code> 헬퍼를 사용하여 폼을 다시 채우는 것이 더 편리합니다. 주어진 필드에 대한 이전 입력이 없는 경우 <code>null</code>이 반환됩니다:

<syntaxhighlight lang='php'>
<input type="text" name="title" value="{{ old('title') }}">
</syntaxhighlight>

===선택적 필드 참고사항===
기본적으로, Laravel은 <code>TrimStrings</code>과 <code>ConvertEmptyStringsToNull</code> 미들웨어를 애플리케이션의 글로벌 미들웨어 스택에 포함시킵니다. 이로 인해, <code>null</code> 값을 유효하지 않은 것으로 간주하지 않도록 하려면 "선택적(optional)" 요청 필드를 <code>nullable</code>로 표시해야 할 때가 많습니다. 예를 들면 다음과 같습니다:

<syntaxhighlight lang='php'>
$request->validate([
    'title' => 'required|unique:posts|max:255',
    'body' => 'required',
    'publish_at' => 'nullable|date',
]);
</syntaxhighlight>

이 예시에서는 <code>publish_at</code> 필드가 <code>null</code>이거나 유효한 날짜 표현일 수 있음을 명시하고 있습니다. 규칙 정의에 <code>nullable</code> 수정자를 추가하지 않으면, 유효성 검증기는 <code>null</code>을 유효하지 않은 날짜로 간주할 것입니다.

===유효성 검증 오류 응답 형식===
애플리케이션에서 <code>Illuminate\Validation\ValidationException</code> 예외가 발생하고 들어오는 HTTP 요청이 JSON 응답을 예상하는 경우, Laravel은 자동으로 오류 메시지를 형식화하여 <code>422 Unprocessable Entity</code> HTTP 응답을 반환합니다.

아래에서는 유효성 검증 오류에 대한 JSON 응답 형식의 예시를 볼 수 있습니다. 중첩된 오류 키는 "점" 표기법 형식으로 평탄화된다는 점에 유의하세요.

<syntaxhighlight lang='json'>
{
    "message": "The team name must be a string. (and 4 more errors)",
    "errors": {
        "team_name": [
            "The team name must be a string.",
            "The team name must be at least 1 characters."
        ],
        "authorization.role": [
            "The selected authorization.role is invalid."
        ],
        "users.0.email": [
            "The users.0.email field is required."
        ],
        "users.2.email": [
            "The users.2.email must be a valid email address."
        ]
    }
}
</syntaxhighlight>

==폼 요청 유효성 검증==
===폼 요청 생성===
더 복잡한 검증 시나리오에서는 "폼 요청"을 생성하고 싶을 수 있습니다. 폼 요청은 자체 검증 및 인가 로직을 캡슐화하는 커스텀 요청 클래스입니다. 폼 요청 클래스를 생성하려면 <code>make:request</code> Artisan CLI 명령어를 사용할 수 있습니다:

<syntaxhighlight lang='bash'>
php artisan make:request StorePostRequest
</syntaxhighlight>

생성된 폼 요청 클래스는 <code>app/Http/Requests</code> 디렉토리에 배치됩니다. 이 디렉토리가 존재하지 않으면 <code>make:request</code> 명령어를 실행할 때 생성됩니다. Laravel에서 생성된 각 폼 요청에는 <code>authorize</code>와 <code>rules</code>라는 두 가지 메소드가 있습니다.

<code>authorize</code> 메소드는 현재 인증된 사용자가 요청에서 나타내는 작업을 수행할 수 있는지를 결정하는 역할을 하며, <code>rules</code> 메소드는 요청 데이터에 적용할 검증 규칙을 반환합니다:

<syntaxhighlight lang='php'>
/**
 * 요청에 적용할 검증 규칙을 가져옵니다.
 *
 * @return array<string, \Illuminate\Contracts\Validation\Rule|array|string>
 */
public function rules(): array
{
    return [
        'title' => 'required|unique:posts|max:255',
        'body' => 'required',
    ];
}
</syntaxhighlight>

{{NOTE}}
rules 메소드의 시그니처에 필요한 모든 의존성을 타입 힌트할 수 있습니다. 이는 [[Laravel 서비스 컨테이너]]를 통해 자동으로 해결됩니다.
{{/NOTE}}

그렇다면 검증 규칙은 어떻게 평가될까요? 컨트롤러 메소드에서 요청을 타입 힌트하면 됩니다. 들어오는 폼 요청은 컨트롤러 메소드가 호출되기 전에 검증되므로 컨트롤러에 검증 로직을 추가할 필요가 없습니다:

<syntaxhighlight lang='php'>
/**
 * 새 블로그 게시물을 저장합니다.
 */
public function store(StorePostRequest $request): RedirectResponse
{
    // 들어오는 요청은 유효합니다...
 
    // 검증된 입력 데이터를 검색합니다...
    $validated = $request->validated();
 
    // 검증된 입력 데이터의 일부를 검색합니다...
    $validated = $request->safe()->only(['name', 'email']);
    $validated = $request->safe()->except(['name', 'email']);
 
    // 블로그 게시물을 저장합니다...
 
    return redirect('/posts');
}
</syntaxhighlight>

검증이 실패하면 사용자를 이전 위치로 되돌리기 위해 리디렉션 응답이 생성됩니다. 오류는 세션에 플래시되어 표시할 수 있도록 제공됩니다. 요청이 XHR 요청인 경우, [[#유효성 검증 오류 응답 형식|검증 오류의 JSON 표현]]을 포함하는 422 상태 코드의 HTTP 응답이 사용자에게 반환됩니다.

{{NOTE}}
Inertia 기반 Laravel 프론트엔드에 실시간 폼 요청 검증을 추가하려고 하나요? [[Laravel Precognition]]을 확인해 보세요.
{{/NOTE}}

;추가 유효성 검증 수행
초기 검증이 완료된 후 추가 검증이 필요할 때가 있습니다. 이를 위해 폼 요청의 <code>after</code> 메소드를 사용할 수 있습니다.

<code>after</code> 메소드는 검증이 완료된 후 호출될 콜러블 또는 클로저 배열을 반환해야 합니다. 지정된 콜러블은 <code>Illuminate\Validation\Validator</code> 인스턴스를 받아 필요 시 추가 오류 메시지를 발생시킬 수 있습니다:

<syntaxhighlight lang='php'>
use Illuminate\Validation\Validator;

/**
 * 요청에 대한 "after" 검증 콜러블을 가져옵니다.
 */
public function after(): array
{
    return [
        function (Validator $validator) {
            if ($this->somethingElseIsInvalid()) {
                $validator->errors()->add(
                    'field',
                    'Something is wrong with this field!'
                );
            }
        }
    ];
}
</syntaxhighlight>

언급된 것처럼, <code>after</code> 메소드가 반환하는 배열에는 호출가능한(invokable) 클래스도 포함될 수 있습니다. 이러한 클래스의 <code>__invoke</code> 메소드는 <code>Illuminate\Validation\Validator</code> 인스턴스를 받게 됩니다:

<syntaxhighlight lang='php'>
use App\Validation\ValidateShippingTime;
use App\Validation\ValidateUserStatus;
use Illuminate\Validation\Validator;

/**
 * 요청에 대한 "after" 검증 콜러블을 가져옵니다.
 */
public function after(): array
{
    return [
        new ValidateUserStatus,
        new ValidateShippingTime,
        function (Validator $validator) {
            //
        }
    ];
}
</syntaxhighlight>

;첫 번째 검증 실패 시 중지
요청 클래스에 <code>stopOnFirstFailure</code> 속성을 추가하면 단일 검증 실패가 발생할 때 모든 속성 검증을 중지하도록 유효성 검증기에 알릴 수 있습니다:

<syntaxhighlight lang='php'>
/**
 * 유효성 검증기가 첫 번째 규칙 실패 시 중지해야 하는지 여부를 나타냅니다.
 *
 * @var bool
 */
protected $stopOnFirstFailure = true;
</syntaxhighlight>

;리디렉션 위치 커스터마이징

앞서 논의한 바와 같이, 폼 요청 검증이 실패할 때 사용자를 이전 위치로 되돌리기 위한 리디렉션 응답이 생성됩니다. 그러나 이 동작을 커스터마이징할 수 있습니다. 이를 위해 폼 요청에 <code>$redirect</code> 속성을 정의하세요:

<syntaxhighlight lang='php'>
/**
 * 검증 실패 시 사용자가 리디렉션되어야 하는 URI입니다.
 *
 * @var string
 */
protected $redirect = '/dashboard';
</syntaxhighlight>

또는, 사용자를 명명된 라우트로 리디렉션하고 싶다면 <code>$redirectRoute</code> 속성을 정의할 수 있습니다:

<syntaxhighlight lang='php'>
/**
 * 검증 실패 시 사용자가 리디렉션되어야 하는 라우트입니다.
 *
 * @var string
 */
protected $redirectRoute = 'dashboard';
</syntaxhighlight>

===폼 요청 인가===
폼 요청 클래스에는 <code>authorize</code> 메소드도 포함되어 있습니다. 이 메소드 내에서 인증된 사용자가 실제로 특정 리소스를 업데이트할 권한이 있는지 확인할 수 있습니다. 예를 들어, 사용자가 업데이트하려고 하는 블로그 댓글을 실제로 소유하고 있는지 확인할 수 있습니다. 대부분의 경우, 이 메소드 내에서 [[Laravel 인가|인가 게이트와 정책]]을 사용하여 상호작용하게 될 것입니다:

<syntaxhighlight lang='php'>
use App\Models\Comment;
 
/**
 * 사용자가 이 요청을 수행할 권한이 있는지 확인합니다.
 */
public function authorize(): bool
{
    $comment = Comment::find($this->route('comment'));
 
    return $comment && $this->user()->can('update', $comment);
}
</syntaxhighlight>

모든 폼 요청은 기본 Laravel 요청 클래스를 확장하므로, <code>user</code> 메소드를 사용하여 현재 인증된 사용자에 접근할 수 있습니다. 또한, 위 예제에서 <code>route</code> 메소드 호출에 주목하세요. 이 메소드는 호출 중인 라우트에 정의된 URI 파라미터에 접근할 수 있게 해줍니다. 예를 들어 아래 예제의 <code>{comment}</code> 파라미터에 접근할 수 있습니다:

<syntaxhighlight lang='php'>
Route::post('/comment/{comment}');
</syntaxhighlight>

따라서, 애플리케이션이 [[Laravel 라우팅#라우트 모델 바인딩|라우트 모델 바인딩]]을 활용하고 있다면, 요청의 속성으로 해결된 모델에 접근하여 코드를 더욱 간결하게 만들 수 있습니다:

<syntaxhighlight lang='php'>
return $this->user()->can('update', $this->comment);
</syntaxhighlight>

<code>authorize</code> 메소드가 <code>false</code>를 반환하면 HTTP 403 상태 코드가 자동으로 반환되고 컨트롤러 메소드는 실행되지 않습니다.

만약 요청의 인가 로직을 애플리케이션의 다른 부분에서 처리하려는 경우, <code>authorize</code> 메소드를 완전히 제거하거나 단순히 <code>true</code>를 반환할 수 있습니다:

<syntaxhighlight lang='php'>
/**
 * 사용자가 이 요청을 수행할 권한이 있는지 확인합니다.
 */
public function authorize(): bool
{
    return true;
}
</syntaxhighlight>

{{NOTE}}
<code>authorize</code> 메서드의 시그니처 내에서 필요한 의존성을 타입 힌트로 지정할 수 있습니다. 이 의존성들은 Laravel 서비스 컨테이너를 통해 자동으로 해결됩니다.
{{/NOTE}}

===오류 메시지 커스터마이징===
===유효성 검증 입력 준비===

==수동 유효성 검증기 생성==
===자동 리디렉션===
===명명된 오류 백===
===오류 메시지 커스터마이징===
===추가 유효성 검증 수행===

==유효성 검증된 입력 다루기==
==오류 메시지 다루기==
===언어 파일에서 사용자 정의 메시지 지정===
===언어 파일에서 속성 지정===
Laravel의 많은 기본 오류 메시지에는 <code>:attribute</code> 자리표시자가 포함되어 있으며, 이는 유효성 검증 중인 필드 또는 속성의 이름으로 대체됩니다. 유효성 검증 메시지에서 <code>:attribute</code> 부분을 커스텀 값으로 대체하려면 <code>lang/xx/validation.php</code> 언어 파일의 <code>attributes</code> 배열에 커스텀 속성 이름을 지정할 수 있습니다:

<syntaxhighlight lang='php'>
'attributes' => [
    'email' => 'email address',
],
</syntaxhighlight>

{{WARNING}}
기본적으로 Laravel 애플리케이션 스켈레톤에는 <code>lang</code> 디렉토리가 포함되어 있지 않습니다. Laravel의 언어 파일을 커스터마이즈하려면 <code>lang:publish</code> Artisan 명령어를 통해 이를 게시할 수 있습니다.
{{/WARNING}}

===언어 파일에서 값 지정===
==사용가능한 유효성 검증 규칙==
==조건부 규칙 추가==
==배열 유효성 검증==
===중첩 배열 입력 유효성 검증===
===오류 메시지 인덱스 및 위치===
==파일 유효성 검증==
==패스워드 유효성 검증==
==커스텀 유효성 검증 규칙==
===규칙 객체 사용===
===클로저 사용===
===암시적 규칙===
@@ 444번째 줄: / 444번째 줄: @@
 {{NOTE}}
-<code>authorize</code> 메소드의 시그니처 내에서 필요한 의존성을 타입 힌트로 지정할 수 있습니다. 이 의존성들은 [[Laravel 서비스 컨테이너]]를 통해 자동으로 해결됩니다.
+<code>authorize</code> 메서드의 시그니처 내에서 필요한 의존성을 타입 힌트로 지정할 수 있습니다. 이 의존성들은 Laravel 서비스 컨테이너를 통해 자동으로 해결됩니다.
 {{/NOTE}}
 ===오류 메시지 커스터마이징===
-폼 요청에 사용되는 오류 메시지를 커스터마이징하려면 <code>messages</code> 메소드를 오버라이드하면 됩니다. 이 메소드는 속성 / 규칙 쌍과 해당하는 오류 메시지를 반환하는 배열을 리턴해야 합니다:
-<syntaxhighlight lang='php'>
-/**
- * 정의된 유효성 검증 규칙에 대한 오류 메시지를 가져옵니다.
- *
- * @return array<string, string>
- */
-public function messages(): array
-{
-    return [
-        'title.required' => 'A title is required',
-        'body.required' => 'A message is required',
-    ];
-}
-</syntaxhighlight>
-;유효성 검증 속성 커스터마이징
-Laravel의 많은 기본 유효성 검증 규칙 오류 메시지에는 <code>:attribute</code> 플레이스홀더가 포함되어 있습니다. 유효성 검사 메시지의 <code>:attribute</code> 플레이스홀더를 커스텀 속성 이름으로 교체하려면 <code>attributes</code> 메소드를 오버라이드하여 커스텀 이름을 지정할 수 있습니다. 이 메소드는 속성 / 이름 쌍의 배열을 반환해야 합니다:
-<syntaxhighlight lang='php'>
-/**
- * 유효성 검증 오류에 대한 커스텀 속성을 가져옵니다.
- *
- * @return array<string, string>
- */
-public function attributes(): array
-{
-    return [
-        'email' => 'email address',
-    ];
-}
-</syntaxhighlight>
 ===유효성 검증 입력 준비===
-검증 규칙을 적용하기 전에 요청에서 데이터를 준비하거나 위생처리해야 하는 경우, <code>prepareForValidation</code> 메소드를 사용할 수 있습니다:
-<syntaxhighlight lang='php'>
-use Illuminate\Support\Str;
-/**
- * 유효성 검증을 위한 데이터를 준비합니다.
- */
-protected function prepareForValidation(): void
-{
-    $this->merge([
-        'slug' => Str::slug($this->slug),
-    ]);
-}
-</syntaxhighlight>
-마찬가지로, 검증이 완료된 후 요청 데이터를 정규화해야 하는 경우, <code>passedValidation</code> 메소드를 사용할 수 있습니다:
-<syntaxhighlight lang='php'>
-/**
- * 유효성 검증 시도가 통과된 후 처리를 합니다.
- */
-protected function passedValidation(): void
-{
-    $this->replace(['name' => 'Taylor']);
-}
-</syntaxhighlight>
 ==수동 유효성 검증기 생성==
-요청에서 <code>validate</code> 메소드를 사용하지 않으려면, <code>Validator</code> 파사드를 사용하여 수동으로 Validator 인스턴스를 생성할 수 있습니다. 파사드의 <code>make</code> 메소드는 새로운 Validator 인스턴스를 생성합니다:
-<syntaxhighlight lang='php'>
-<?php
-namespace App\Http\Controllers;
-use Illuminate\Http\RedirectResponse;
-use Illuminate\Http\Request;
-use Illuminate\Support\Facades\Validator;
-class PostController extends Controller
-{
-    /**
-     * 새로운 블로그 포스트를 저장합니다.
-     */
-    public function store(Request $request): RedirectResponse
-    {
-        $validator = Validator::make($request->all(), [
-            'title' => 'required|unique:posts|max:255',
-            'body' => 'required',
-        ]);
-        if ($validator->fails()) {
-            return redirect('post/create')
-                        ->withErrors($validator)
-                        ->withInput();
-        }
-        // 유효성 검증된 입력값을 가져옵니다...
-        $validated = $validator->validated();
-        // 유효성 검증된 입력값의 일부를 가져옵니다...
-        $validated = $validator->safe()->only(['name', 'email']);
-        $validated = $validator->safe()->except(['name', 'email']);
-        // 블로그 포스트를 저장합니다...
-        return redirect('/posts');
-    }
-}
-</syntaxhighlight>
-<code>make</code> 메소드에 전달되는 첫 번째 인수는 유효성 검증를 할 데이터입니다. 두 번째 인수는 데이터에 적용할 유효성 검증 규칙의 배열입니다.
-요청의 유효성 검증 실패 여부를 확인한 후, <code>withErrors</code> 메소드를 사용하여 오류 메시지를 세션에 플래시할 수 있습니다. 이 메소드를 사용할 때, <code>$errors</code> 변수는 리디렉션 후 자동으로 뷰와 공유되어 사용자에게 쉽게 오류 메시지를 표시할 수 있습니다. <code>withErrors</code> 메소드는 validator, <code>MessageBag</code> 또는 PHP <code>array</code>를 인수로 받을 수 있습니다.
-;첫 번째 유효성 검증 실패 시 중지하기
-<code>stopOnFirstFailure</code> 메소드는 단일 유효성 검증 실패가 발생하면 모든 속성의 유효성 검증을 중지하도록 Validator에 알립니다:
-<syntaxhighlight lang='php'>
-if ($validator->stopOnFirstFailure()->fails()) {
-    // ...
-}
-</syntaxhighlight>
 ===자동 리디렉션===
-HTTP 요청의 <code>validate</code> 메소드가 제공하는 자동 리디렉션 기능을 활용하면서도 수동으로 유효성 검증 인스턴스를 생성하려면, 기존 유효성 검증 인스턴스에서 <code>validate</code> 메소드를 호출할 수 있습니다. 유효성 검증이 실패하면 사용자는 자동으로 리디렉션되거나, XHR 요청의 경우 [[#유효성 검증 오류 응답 형식|JSON 응답이 반환]]됩니다:
-<syntaxhighlight lang='php'>
-Validator::make($request->all(), [
-    'title' => 'required|unique:posts|max:255',
-    'body' => 'required',
-])->validate();
-</syntaxhighlight>
-유효성 검증이 실패했을 때 에러 메시지를 [[#명명된 오류 백|명명된 오류 백]]에 저장하려면 <code>validateWithBag</code> 메소드를 사용할 수 있습니다:
-<syntaxhighlight lang='php'>
-Validator::make($request->all(), [
-    'title' => 'required|unique:posts|max:255',
-    'body' => 'required',
-])->validateWithBag('post');
-</syntaxhighlight>
 ===명명된 오류 백===
-한 페이지에 여러 개의 폼이 있는 경우, 유효성 검증 오류를 포함하는 <code>MessageBag</code>의 이름을 지정하여 특정 폼에 대한 오류 메시지를 조회할 수 있습니다. 이를 위해 <code>withErrors</code>에 두 번째 인수로 이름을 전달합니다:
-<syntaxhighlight lang='php'>
-return redirect('register')->withErrors($validator, 'login');
-</syntaxhighlight>
-그런 다음 <code>$errors</code> 변수에서 명명된 <code>MessageBag</code> 인스턴스에 접근할 수 있습니다:
-<syntaxhighlight lang='php'>
-{{ $errors->login->first('email') }}
-</syntaxhighlight>
 ===오류 메시지 커스터마이징===
-필요에 따라, Laravel에서 제공하는 기본 오류 메시지 대신 커스텀 오류 메시지를 사용하도록 유효성 검증기 인스턴스를 설정할 수 있습니다. 커스텀 메시지를 지정하는 방법에는 여러 가지가 있습니다. 먼저, <code>Validator::make</code> 메소드의 세 번째 인자로 커스텀 메시지를 전달할 수 있습니다:
-<syntaxhighlight lang='php'>
-$validator = Validator::make($input, $rules, $messages = [
-    'required' => 'The :attribute field is required.',
-]);
-</syntaxhighlight>
-이 예제에서 <code>:attribute</code> 플레이스홀더는 실제로 검증되는 필드의 이름으로 대체됩니다. 또한, 검증 메시지에서 다른 플레이스홀더도 사용할 수 있습니다. 예를 들어:
-<syntaxhighlight lang='php'>
-$messages = [
-    'same' => 'The :attribute and :other must match.',
-    'size' => 'The :attribute must be exactly :size.',
-    'between' => 'The :attribute value :input is not between :min - :max.',
-    'in' => 'The :attribute must be one of the following types: :values',
-];
-</syntaxhighlight>
-;특정 속성에 대한 커스텀 메시지 지정
-때때로 특정 속성에 대해서만 커스텀 오류 메시지를 지정하고 싶을 수 있습니다. 이 경우 "점(dot)" 표기법을 사용하여 지정할 수 있습니다. 속성 이름을 먼저 지정하고, 그 다음에 규칙을 지정합니다:
-<syntaxhighlight lang='php'>
-$messages = [
-    'email.required' => 'We need to know your email address!',
-];
-</syntaxhighlight>
-;커스텀 속성 값 지정
-Laravel의 많은 기본 오류 메시지에는 <code>:attribute</code> 플레이스홀더가 포함되어 있으며, 이는 검증 중인 필드나 속성의 이름으로 대체됩니다. 특정 필드에 대해 이 플레이스홀더를 대체하는 값을 커스터마이징하려면, <code>Validator::make</code> 메소드의 네 번째 인자로 커스텀 속성 배열을 전달할 수 있습니다:
-<syntaxhighlight lang='php'>
-$validator = Validator::make($input, $rules, $messages, [
-    'email' => 'email address',
-]);
-</syntaxhighlight>
 ===추가 유효성 검증 수행===
-초기 검증이 완료된 후 추가 검증이 필요할 때가 있습니다. 이를 위해 validator의 <code>after</code> 메소드를 사용할 수 있습니다. <code>after</code> 메소드는 클로저나 호출가능(callable) 배열을 인자로 받아, 검증이 완료된 후 호출됩니다. 주어진 호출가능 객체들은 <code>Illuminate\Validation\Validator</code> 인스턴스를 전달받아, 필요한 경우 추가적인 오류 메시지를 발생시킬 수 있습니다:
-<syntaxhighlight lang='php'>
-use Illuminate\Support\Facades\Validator;
-$validator = Validator::make(/* ... */);
-$validator->after(function ($validator) {
-    if ($this->somethingElseIsInvalid()) {
-        $validator->errors()->add(
-            'field', 'Something is wrong with this field!'
-        );
-    }
-});
-if ($validator->fails()) {
-    // ...
-}
-</syntaxhighlight>
-언급했듯이, <code>after</code> 메소드는 호출가능 객체의 배열도 받을 수 있습니다. 이는 "검증 후" 로직이 호출가능 클래스에 캡슐화되어 있을 때 특히 유용합니다. 이 클래스들은 <code>__invoke</code> 메소드를 통해 <code>Illuminate\Validation.Validator</code> 인스턴스를 전달받습니다:
-<syntaxhighlight lang='php'>
-use App\Validation\ValidateShippingTime;
-use App\Validation\ValidateUserStatus;
-$validator->after([
-    new ValidateUserStatus,
-    new ValidateShippingTime,
-    function ($validator) {
-        // ...
-    },
-]);
-</syntaxhighlight>
 ==유효성 검증된 입력 다루기==
-폼 요청이나 수동으로 생성한 유효성 검증기 인스턴스를 사용하여 들어오는 요청 데이터를 유효성 검증한 후, 실제로 유효성 검증을 거친 요청 데이터를 조회하고 싶을 수 있습니다. 이는 여러 가지 방법으로 가능합니다. 먼저, 폼 요청이나 유효성 검증기 인스턴스에서 <code>validated</code> 메소드를 호출할 수 있습니다. 이 메소드는 유효성 검증을 거친 데이터를 배열 형태로 반환합니다:
+==오류 메시지 다루기==
+===언어 파일에서 사용자 정의 메시지 지정===
-<syntaxhighlight lang='php'>
-$validated = $request->validated();
-$validated = $validator->validated();
-</syntaxhighlight>
-또는, 폼 요청이나 유효성 검증기 인스턴스에서 <code>safe</code> 메소드를 호출할 수 있습니다. 이 메소드는 <code>Illuminate\Support\ValidatedInput</code> 인스턴스를 반환합니다. 이 객체는 <code>only</code>, <code>except</code>, <code>all</code> 메소드를 노출하여 유효성 검증을 거친 데이터의 일부 또는 전체 배열을 조회할 수 있습니다:
-<syntaxhighlight lang='php'>
-$validated = $request->safe()->only(['name', 'email']);
-$validated = $request->safe()->except(['name', 'email']);
-$validated = $request->safe()->all();
-</syntaxhighlight>
-또한, <code>Illuminate\Support\ValidatedInput</code> 인스턴스는 배열처럼 반복할 수 있고 접근할 수 있습니다:
-<syntaxhighlight lang='php'>
-// 유효성 검증된 데이터를 반복할 수 있습니다...
-foreach ($request->safe() as $key => $value) {
-    // ...
-}
-// 유효성 검증된 데이터에 배열처럼 접근할 수 있습니다...
-$validated = $request->safe();
-$email = $validated['email'];
-</syntaxhighlight>
-유효성 검증된 데이터에 추가 필드를 추가하고 싶다면 <code>merge</code> 메소드를 호출할 수 있습니다:
-<syntaxhighlight lang='php'>
-$validated = $request->safe()->merge(['name' => 'Taylor Otwell']);
-</syntaxhighlight>
-유효성 검증된 데이터를 콜렉션 인스턴스로 조회하고 싶다면 <code>collect</code> 메소드를 호출할 수 있습니다:
-<syntaxhighlight lang='php'>
-$collection = $request->safe()->collect();
-</syntaxhighlight>
-==오류 메시지 작업하기==
-<code>Validator</code> 인스턴스에서 <code>errors</code> 메소드를 호출한 후에는 다양하고 편리한 메소드가 포함된 <code>Illuminate\Support\MessageBag</code> 인스턴스를 받게 됩니다. 모든 뷰에서 자동으로 제공되는 <code>$errors</code> 변수도 <code>MessageBag</code> 클래스의 인스턴스입니다.
-;필드의 첫 번째 오류 메시지 가져오기
-주어진 필드에 대한 첫 번째 오류 메시지를 가져오려면 <code>first</code> 메소드를 사용합니다:
-<syntaxhighlight lang='php'>
-$errors = $validator->errors();
-echo $errors->first('email');
-</syntaxhighlight>
-;필드의 모든 오류 메시지 가져오기
-주어진 필드에 대한 모든 메시지의 배열을 가져와야 하는 경우, <code>get</code> 메소드를 사용합니다:
-<syntaxhighlight lang='php'>
-foreach ($errors->get('email') as $message) {
-    // ...
-}
-</syntaxhighlight>
-배열 형식의 폼 필드를 검증하는 경우, <code>*</code> 문자를 사용하여 각 배열 요소에 대한 모든 메시지를 가져올 수 있습니다:
-<syntaxhighlight lang='php'>
-foreach ($errors->get('attachments.*') as $message) {
-    // ...
-}
-</syntaxhighlight>
-;모든 필드의 모든 오류 메시지 가져오기
-모든 필드의 모든 메시지 배열을 가져오려면 <code>all</code> 메소드를 사용합니다:
-<syntaxhighlight lang='php'>
-foreach ($errors->all() as $message) {
-    // ...
-}
-</syntaxhighlight>
-;필드에 대한 메시지가 존재하는지 확인하기
-<code>has</code> 메소드를 사용하여 주어진 필드에 대한 오류 메시지가 존재하는지 확인할 수 있습니다:
-<syntaxhighlight lang='php'>
-if ($errors->has('email')) {
-    // ...
-}
-</syntaxhighlight>
-===언어 파일에 커스텀 메시지 지정===
-Laravel의 내장된 검증 규칙은 각각 애플리케이션의 <code>lang/en/validation.php</code> 파일에 위치한 오류 메시지를 가지고 있습니다. 애플리케이션에 <code>lang</code> 디렉토리가 없을 경우, <code>lang:publish</code> Artisan 명령어를 사용하여 Laravel이 해당 디렉토리를 생성하도록 지시할 수 있습니다.
-<code>lang/en/validation.php</code> 파일 내에서 각 검증 규칙에 대한 번역 항목을 찾을 수 있습니다. 애플리케이션의 필요에 따라 이러한 메시지를 자유롭게 변경하거나 수정할 수 있습니다.
-또한, 이 파일을 다른 언어 디렉터리로 복사하여 애플리케이션의 언어에 맞게 메시지를 번역할 수 있습니다. Laravel 현지화에 대해 더 자세히 알고 싶다면, 전체 [[Laravel 현지화|현지화 문서]]를 참조하십시오.
-{{WARNING}}
-기본적으로 Laravel 애플리케이션 스켈레톤에는 <code>lang</code> 디렉토리가 포함되어 있지 않습니다. Laravel의 언어 파일을 커스터마이즈하려면 <code>lang:publish</code> Artisan 명령어를 통해 이를 게시할 수 있습니다.
-{{/WARNING}}
-;특정 속성에 대한 커스텀 메시지
-애플리케이션의 검증 언어 파일에서 특정 속성과 규칙 조합에 사용되는 오류 메시지를 사용자 지정할 수 있습니다. 이를 위해 애플리케이션의 <code>lang/xx/validation.php</code> 언어 파일의 <code>custom</code> 배열에 메시지 커스터마이징을 추가하면 됩니다:
-<syntaxhighlight lang='php'>
-'custom' => [
-    'email' => [
-        'required' => 'We need to know your email address!',
-        'max' => 'Your email address is too long!'
-    ],
-],
-</syntaxhighlight>
 ===언어 파일에서 속성 지정===
 Laravel의 많은 기본 오류 메시지에는 <code>:attribute</code> 자리표시자가 포함되어 있으며, 이는 유효성 검증 중인 필드 또는 속성의 이름으로 대체됩니다. 유효성 검증 메시지에서 <code>:attribute</code> 부분을 커스텀 값으로 대체하려면 <code>lang/xx/validation.php</code> 언어 파일의 <code>attributes</code> 배열에 커스텀 속성 이름을 지정할 수 있습니다:
@@ 803번째 줄: / 473번째 줄: @@
 ===언어 파일에서 값 지정===
 ==사용가능한 유효성 검증 규칙==
 ==조건부 규칙 추가==