Validation

• 기본적인 사용법
• 컨트롤러 단위 유효성 검사
• 폼 요청 유효성 검사
• 오류 메시지 사용하기
• 오류 메시지 & 뷰
• 유효성 검사 룰
• 조건부 룰 추가하기
• 사용자 정의 오류 메시지
• 커스텀 유효성 검사 룰

기본적인 사용법

라라벨은 Validation 클래스를 통해 데이터의 유효성을 검사하고, 유효성 검사 실패 시 출력될 오류 메시지를 구성할 수 있는 간단하고, 편리한 기능을 제공합니다.

기본적인 유효성 검사의 예

$validator = Validator::make(
    ['name' => 'Dayle'],
    ['name' => 'required|min:5']
);

make 메소드는 첫 번째 인자로 유효성 검사를 할 데이터를 받습니다. 두 번째 인자로는 그 데이터에 적용되어야 하는 유효성 검사 룰을 전달받습니다.

배열을 사용하여 룰 지정하기

두개 이상의 룰은 "pipe" 문자나, 배열의 각 엘레먼트로 구분할 수 있습니다.

$validator = Validator::make(
    ['name' => 'Dayle'],
    ['name' => ['required', 'min:5']]
);

여러 필드의 유효성 검사

$validator = Validator::make(
    [
        'name' => 'Dayle',
        'password' => 'lamepassword',
        'email' => 'email@example.com'
    ],
    [
        'name' => 'required',
        'password' => 'required|min:8',
        'email' => 'required|email|unique:users'
    ]
);

Validator 인스턴스를 생성한 후, fails(또는 passes) 메소드를 사용하여 유효성 검사를 실행할 수 있습니다.

if ($validator->fails())
{
    // The given data did not pass validation
}

만약 유효성 검사가 실패하면, validator 인스턴스로부터 오류 메시지를 얻을 수 있습니다.

$messages = $validator->messages();

또한, 오류 메시지가 제외된, 실패한 유효성 검사 룰을 배열 형태로 얻을 수도 있습니다:

$failed = $validator->failed();

파일 유효성 검사

Validation 클래스는 파일 유효성 검사를 위한 size, mimes 등의 몇 가지 룰을 제공합니다. 파일의 유효성을 검사할 때, 간단히 그 파일들을 다른 데이터들과 함께 validator에 전달하십시오.

유효성검사 후킹하기

유효성 검사가 완료된 후에 실행하고자 하는 콜백함수를 validator에 추가할 수 있습니다. 이를 통하면 손쉽게 더 많은 유효성 검사를 실행할 수 있도록 하고, 오류 메시지 모음에 오류 메시지를 더 추가할 수 도 있습니다. 다음처럼 validator 인스턴스의 after 메소드를 사용하면 됩니다:

$validator = Validator::make(...);

$validator->after(function($validator)
{
    if ($this->somethingElseIsInvalid())
    {
        $validator->errors()->add('field', 'Something is wrong with this field!');
    }
});

if ($validator->fails())
{
    //
}

필요한 경우 after 콜백에 validator에 추가할 수도 있습니다.

컨트롤러 단위 유효성 검사

유효성 검사를 실행할 때마다 수동으로 Validator 인스턴스를 생성하고 체크한다면 정말 번거로울 것입니다. 하지만 걱정하지 마십시오. 방법이 있습니다. 라라벨에 포함된 App\Http\Controllers\Controller 기본 클래스는 ValidatesRequests trait을 사용합니다. 이 trait은 들어오는 HTTP 요청의 유효성 검사를 위하여 편리한 하나의 메소드를 제공합니다. 그 메소드는 아래와 같습니다:

/**
 * Store the incoming blog post.
 *
 * @param  Request  $request
 * @return Response
 */
public function store(Request $request)
{
    $this->validate($request, [
        'title' => 'required|unique|max:255',
        'body' => 'required',
    ]);

    //
}

만약 유효성검사가 성공하면, 코드는 정상적으로 실행될 것입니다. 하지만 유효성 검사가 실패하면, Illuminate\Contracts\Validation\ValidationException이 발생할 것입니다. 이 예외는 자동으로 catch되고 사용자 페이지는 이전 페이지로 리다이렉트됩니다. 유효성 검사 오류들 역시 자동으로 세션에 기록됩니다!

만약 들어온 요청이 AJAX 요청이라면, 리다이렉트는 실행되지 않습니다. 대신, 422 상태코드의 HTTP 응답이 JSON 형식으로 유효성 검사 오류를 포함한 채 브라우저로 반환될 것입니다.

이와 같은 작동을 하는 코드를 수동으로 작성한 예입니다:

/**
 * Store the incoming blog post.
 *
 * @param  Request  $request
 * @return Response
 */
public function store(Request $request)
{
    $v = Validator::make($request->all(), [
        'title' => 'required|unique|max:255',
        'body' => 'required',
    ]);

    if ($v->fails())
    {
        return redirect()->back()->withErrors($v->errors());
    }

    //
}

오류 형식 커스터마이징 하기

만약 유효성 검사가 실패했을 때 세션에 기록되는 유효성 검사 오류의 형식을 커스터마이징하고 싶다면, base 컨트롤러의 formatValidationErrors 메소드를 재정의 하십시오. 이때, 파일 상단에서 Illuminate\Validation\Validator를 임포트하는 것을 잊지 마십시오:

/**
 * {@inheritdoc}
 */
protected function formatValidationErrors(Validator $validator)
{
    return $validator->errors()->all();
}

폼 요청 유효성 검사

여러분은 "폼 요청(form request)" 클래스를 만들고 싶을수도 있습니다. 폼 요청은 유효성검사 로직을 내장하는 사용자가 정의한 요청 클래스입니다. 폼 요청 클래스를 만드려면, make:request 아티즌 명령을 사용하십시오.

php artisan make:request StoreBlogPostRequest

생성된 요청 클래스는 app/Http/Requests 디렉토리에 위치합니다. 유효성 검사 룰 몇개를 rules 메소드에 추가해봅시다:

/**
 * Get the validation rules that apply to the request.
 *
 * @return array
 */
public function rules()
{
    return [
        'title' => 'required|unique|max:255',
        'body' => 'required',
    ];
}

그럼 어떻게 이 유효성 검사 룰이 실행되도록 할 수 있을까요? 여러분의 컨트롤러 메소드에 해당 요청 클래스의 타입힌트를 넣어주기만 하면 됩니다.

/**
 * Store the incoming blog post.
 *
 * @param  StoreBlogPostRequest  $request
 * @return Response
 */
public function store(StoreBlogPostRequest $request)
{
    // The incoming request is valid...
}

들어온 폼 요청은 컨트롤러 메소드가 실행되기 전에 미리 유효성 검사를 거칩니다. 이는 유효성 검사 로직으로 여러분의 컨트롤러를 지저분하게 할 필요가 없다는 것을 의미합니다. 이미 유효성 검사는 실행된 후입니다!

만약 유효성 검사가 실패하면 이전 페이지로의 리다이렉트 응답이 생성되어 사용자에게 보내집니다. 오류들 또한, 화면에 출력될 수 있도록 세션에 기록될 것입니다. 만약 요청이 AJAX 요청이면, 422 상태 코드의 HTTP 응답이 JSON 형식의 오류 메시지를 포함한 채 사용자에게 반환됩니다.

폼 요청 권한 확인하기

또한, 폼 요청 클래스는 authorize 메소드를 가지고 있습니다. 이 메소드 안에서 여러분은 사용자가 실제로 주어진 리소스를 업데이트할 권한을 가졌는지 확인할 수 있습니다. 다음은 만약 사용자가 블로그 포스트의 댓글을 업데이트하려고 시도할 때, 실제로 그들이 그 댓글의 소유자인가를 확인하는 예제입니다:

/**
 * Determine if the user is authorized to make this request.
 *
 * @return bool
 */
public function authorize()
{
    $commentId = $this->route('comment');

    return Comment::where('id', $commentId)
                  ->where('user_id', Auth::id())->exists();
}

이 예제에서 route메소드를 호출하는 것에 주목하십시오. 이 메소드는 아래의 예제에서 {comment} 파라미터와 같이 호출된 라우트에 정의된 URI 파라미터에 여러분이 접근할 수 있는지 권한을 확인합니다:

Route::post('comment/{comment}');

만약 authorize 메소드가 false를 리턴하면, 403 HTTP 응답이 자동적으로 반환되고 컨트롤러 메소드는 실행되지 않을 것입니다.

여러분이 어플리케이션의 다른 부분에 있는 인증로직을 사용할 계획이라면, 그냥 authorize 메소드에서 true를 리턴하면 됩니다.

/**
 * Determine if the user is authorized to make this request.
 *
 * @return bool
 */
public function authorize()
{
    return true;
}

세션에 기록되는 오류 형식 커스터마이징 하기

만약 유효성 검사가 실패했을 때 세션에 기록될 유효성 검사 오류의 형식을 커스터마이징하고 싶다면, base 요청 클래스(App\Http\Requests\Request)의 formatErrors 메소드를 오버라이딩하십시오. 이때, 파일 상단에서 Illuminate\Validation\Validator를 임포트하는 것을 잊지 마십시오.

/**
 * {@inheritdoc}
 */
protected function formatErrors(Validator $validator)
{
    return $validator->errors()->all();
}

오류 메시지 사용하기

Validator 인스턴스의 messages 메소드를 실행하면, 오류 메시지를 편하게 사용할 수 있는 다양한 메소드를 가진 MessageBag 인스턴스를 받을 수 있습니다.

하나의 필드에 대한 첫 번째 오류 메시지 조회하기

echo $messages->first('email');

하나의 필드에 대한 모든 오류 메시지 조회하기

foreach ($messages->get('email') as $message)
{
    //
}

모든 필드에 대한 모든 오류 메시지 조회하기

foreach ($messages->all() as $message)
{
    //
}

하나의 필드에 대하여 오류 메시지가 존재하는지 검사하기

if ($messages->has('email'))
{
    //
}

특정 형식으로 오류 메시지 조회해 오기

echo $messages->first('email', '<p>:message</p>');

참고: 기본적으로 메시지들은 Bootstrap에 호환되는 구문을 사용하여 구성되어 있습니다.

특정 형식으로 모든 오류 메시지 조회해 오기

foreach ($messages->all('<li>:message</li>') as $message)
{
    //
}

오류 메시지 & 뷰

여러분이 유효성 검사를 실행하면, 뷰에서 오류 메시지를 쉽게 얻을 수 있는 방법이 필요할 것입니다. 라라벨에서는 이 것을 손쉽게 할 수 있도록 제공하고 있습니다. 아래의 라우트를 예로 들어 봅시다:

Route::get('register', function()
{
    return View::make('user.register');
});

Route::post('register', function()
{
    $rules = [...];

    $validator = Validator::make(Input::all(), $rules);

    if ($validator->fails())
    {
        return redirect('register')->withErrors($validator);
    }
});

유효성 검사가 실패했을 때, 우리는 withErrors 메소드를 사용하여 리다이렉트에 Validator 인스턴스를 전달합니다. 이 메소드는 오류 메시지를 다음 요청에서 사용할 수 있도록 세션에 기록합니다.

명시적으로 오류메시지를 GET 라우트의 뷰에 바인딩하지 말아야 하는 것을 유념해야 합니다. 왜냐하면 라라벨은 항상 세션 데이터에 유효성 검사 오류가 있는지 체크하고, 자동으로 오류들을 뷰에 바인딩하기 때문입니다. 따라서, $errors 변수는 항상 모든 뷰에서 사용될 수 있다는 것을 알고 있는 것이 중요합니다. 이는 여러분이 $errors 변수가 항상 정의돼 있고 아무 지장없이 사용될 수 있다고 가정할 수 있도록 합니다. $errors 변수는 MessageBag의 인스턴스입니다.

그렇기 때문에, 리다이렉트된 후 여러분은 자동으로 바인딩 된 $errors 변수를 뷰에서 활용할 수 있습니다.

<?php echo $errors->first('email'); ?>

이름이 지정된 오류 메시지 백

만약 여러개의 폼을 단일 페이지에서 사용한다면, 여러분은 오류의 MessageBag에 이름을 지정하고 싶을지도 모릅니다. 이는 여러분이 특정 폼에 대한 오류 메시지를 조회할 수 있도록 해줍니다. withErrors 메소드의 두 번째 파라메터로 이름을 전달하기만 하면 됩니다.

return redirect('register')->withErrors($validator, 'login');

그 다음 $errors 변수로부터 이름이 지정된 MessageBag 인스턴스에 접근할 수 있습니다.

<?php echo $errors->login->first('email'); ?>

유효성 검사 룰

다음은 모든 유효성 검사 룰과 그들의 함수 목록입니다.

• Accepted
• Active URL
• After (Date)
• Alpha
• Alpha Dash
• Alpha Numeric
• Array
• Before (Date)
• Between
• Boolean
• Confirmed
• Date
• Date Format
• Different
• Digits
• Digits Between
• E-Mail
• Exists (Database)
• Image (File)
• In
• Integer
• IP Address
• Max
• MIME Types
• Min
• Not In
• Numeric
• Regular Expression
• Required
• Required If
• Required With
• Required With All
• Required Without
• Required Without All
• Same
• Size
• String
• Timezone
• Unique (Database)
• URL

accepted

필드의 값이 yes, on, 1, 또는 true이어야 합니다. 이 것은 "이용약관" 동의와 같은 필드의 검사에 유용합니다.

active_url

필드의 값이 PHP 함수 checkdnsrr에 기반하여 올바른 URL이어야 합니다.

after:date

필드의 값이 주어진 날짜 이후여야 합니다. 이때 날짜는 PHP 함수 strtotime을 통해 생성된 값입니다.

alpha

필드의 값이 완벽하게 알파벳 문자로 이루어져야 합니다.

alpha_dash

필드의 값이 알파벳 및 숫자와 dash(-), underscore(_)로 이루어져야 합니다.

alpha_num

필드의 값이 완벽하게 알파벳 및 숫자로 이루어져야 합니다.

array

필드의 값이 반드시 배열 형태이어야 합니다.

before:date

필드의 값이 반드시 주어진 날짜보다 앞서야 합니다. 날짜는 strtotime PHP 함수를 통해 비교됩니다.

between:min,max

필드의 값이 주어진 min과 max의 사이의 값이어야 합니다. 문자열, 숫자, 그리고 파일이 size 룰에 의해 같은 방식으로 평가될 수 있습니다.

boolean

필드의 값이 반드시 불리언으로 캐스팅될 수 있어야 합니다. 허용되는 값은 true, false, 1, 0, "1", "0"입니다.

confirmed

필드의 값이 foo_confirmation의 매칭되는 필드를 가져야 합니다. 예를 들어, 만약 필드가 password이면, password_confirmation 필드가 입력 중에 있어야 합니다.

date

필드의 값이 strtotime PHP 함수에 따라 올바른 날짜여야 합니다.

date_format:format

필드의 값이 반드시 정의된 format과 일지해야 합니다. date_parse_from_format PHP 함수에 따릅니다.

different:field

필드의 값이 주어진 field의 값과 달라야 합니다.

digits:value

필드의 값이 반드시 숫자여야 하고, 길이가 value이어야 합니다.

digits_between:min,max

필드의 값이 주어진 min과 max 사이의 길이를 갖는 숫자여야 합니다.

email

필드의 값이 이메일 주소 형식이어야 합니다.

exists:table,column

필드의 값이 주어진 데이터베이스 테이블의 컬럼에 존재하는 값이어야 합니다.

exists 룰의 기본 사용법

'state' => 'exists:states'

특정 컬럼명 지정하기

'state' => 'exists:states,abbreviation'

쿼리문의 "where" 구분에 추가될 더 많은 조건을 지정할 수 있습니다.

'email' => 'exists:staff,email,account_id,1'

"where" 구문에 NULL을 사용하여 데이터베이스의 NULL 값인지 체크할 수 있습니다.

'email' => 'exists:staff,email,deleted_at,NULL'

image

이미지 파일(jpeg, png, bmp, gif, svg)이어야 합니다.

in:foo,bar,...

필드의 값이 주어진 목록에 포함돼 있어야 합니다.

integer

필드의 값이 정수여야 합니다.

ip

필드의 값이 IP 주소 형식이어야 합니다.

max:value

필드의 값이 반드시 value보다 작거나 같아야 합니다. 문자열, 숫자, 그리고 파일이 size 룰에 의해 같은 방식으로 평가될 수 있습니다.

mimes:foo,bar,...

파일의 MIME 타입이 주어진 확장자 리스트중에 하나와 일치해야 합니다.

MIME 룰의 기본 사용법

'photo' => 'mimes:jpeg,bmp,png'

min:value

필드의 값이 반드시 value 보다 크거나 같아야 합니다. 문자열, 숫자, 그리고 파일이 size 룰에 의해 같은 방식으로 평가될 수 있습니다.

not_in:foo,bar,...

필드의 값이 주어진 목록에 존재하지 않아야 합니다.

numeric

필드의 값이 숫자여야 합니다.

regex:pattern

필드의 값이 주어진 정규식 표현과 일치해야 합니다.

참고: regex 패턴을 사용할 때, 특히 정규 표현식에 파이프 문자열이 있다면, 파이프 구분자를 사용하는 대신 배열 형식을 사용하여 룰을 지정할 필요가 있습니다.

required

입력 값 중에 해당 필드가 존재해야 합니다.

required_if:field,value,...

만약 filed의 값이 value중의 하나와 일치한다면, 해당 필드가 반드시 존재해야 합니다.

required_with:foo,bar,...

다른 지정된 필드중 하나라도 존재한다면, 해당 필드가 반드시 존재해야 합니다.

required_with_all:foo,bar,...

다른 지정된 필드가 모두 존재한다면, 해당 필드가 반드시 존재해야 합니다.

required_without:foo,bar,...

다른 지정된 필드중 하나라도 존재하지 않으면, 해당 필드가 반드시 존재해야 합니다.

required_without_all:foo,bar,...

다른 지정된 필드가 모두 존재하지 않으면, 해당 필드가 존재해야 합니다.

same:field

필드의 값이 주어진 field의 값과 일치해야 합니다.

size:value

필드의 값이 주어진 value와 일치하는 크기를 가져야 합니다. 문자열 데이터에서는 문자의 개수가 value와 일치해야 합니다. 숫자형식의 데이터에서는 주어진 정수값이 value와 일치해야 합니다. 파일에서는 킬로바이트 형식의 파일 사이즈가 size와 일치해야 합니다.

string

필드의 값이 반드시 문자열 형식이어야 합니다.

timezone

필드의 값이 timezone_identifiers_list PHP 함수에 따라 유효한 timezone 식별자여야 합니다.

unique:table,column,except,idColumn

필드의 값이 주어진 데이터베이스 테이블에서 고유한 값이어야 합니다. 만약 column 지정돼 있지 않다면 필드의 이름이 사용됩니다.

때때로, 여러분은 Validator에 의해서 생성되는 데이터베이스 쿼리에 사용자가 지정한 커넥션을 필요로 할지도 모릅니다. 위에서의 검증 규칙 unique:users에서는 쿼리에 대해서 기본 데이터베이스 커넥션이 사용됩니다. 이를 재지정하려면 다음과 같이 하면 됩니다:

$verifier = App::make('validation.presence');

$verifier->setConnection('connectionName');

$validator = Validator::make($input, [
    'name' => 'required',
    'password' => 'required|min:8',
    'email' => 'required|email|unique:users',
]);

$validator->setPresenceVerifier($verifier);

Unique 룰의 기본 사용법

'email' => 'unique:users'

특정 컬럼명 지정하기

'email' => 'unique:users,email_address'

주어진 ID는 unique 룰에서 무시하기

'email' => 'unique:users,email_address,10'

where 구문 추가하기

쿼리문의 "where" 구문에 추가할 조건을 더 지정할 수 있습니다:

'email' => 'unique:users,email_address,NULL,id,account_id,1'

앞서의 룰에서 오직 account_id가 1인 행만 unique 유효성 검사에 포함됩니다.

url

필드의 값이 URL 형식이어야 합니다.

참고: 이 기능은 PHP의 filter_var 함수를 사용합니다.

조건부 룰 추가하기

어떤 상황에서는 필드가 입력 배열에 존재할 때에만 그 필드의 유효성 검사를 실행하고 싶을수도 있습니다. 이를 위해서는 룰의 목록에 sometimes를 추가하기만 하면 됩니다:

$v = Validator::make($data, [
    'email' => 'sometimes|required|email',
]);

이 예제에서 $data 배열에 email 필드가 존재할 경우에만 그 필드의 유효성 검사가 실행됩니다.

복잡한 조건부 유효성 검사

때때로 여러분은 다른 필드가 100 이상의 값을 가질때에만 주어진 필드가 반드시 존재하길 바랄 수도 있습니다. 또는 다른 필드가 존재할 때에만 두 개의 필드가 주어진 값을 가질 필요가 있을수도 있습니다. 이러한 유효성 검사 룰을 추가하는 것이 어렵지 않을 수 있습니다. 우선 고정 룰을 변경할 필요 없이 그대로 사용하여 Validator 인스턴스를 생성합니다:

$v = Validator::make($data, [
    'email' => 'required|email',
    'games' => 'required|numeric',
]);

여러분의 웹 어플리케이션이 게임 수집가들을 위한 사이트라고 가정해봅시다. 만약 100개 이상의 게임을 소유하고 있는 게임 수집가가 우리 사이트에 가입을 한다면, 우리는 그들이 왜 그렇게 많은 게임을 소유하고 있는지 설명을 듣고 싶을수 있습니다. 아마 그들이 중고게임 판매점을 운영하거나, 단순히 수집을 취미로 할 수도 있습니다. 이런 요구사항을 조건부로 추가하기 위하여 Validator 인스턴스의 sometimes 메소드를 사용할 수 있습니다.

$v->sometimes('reason', 'required|max:500', function($input)
{
    return $input->games >= 100;
});

sometimes 메소드의 첫 번째 인자는 필드의 이름입니다. 두 번째 인자는 추가하려는 룰입니다. 만약 세 번째 파라메터로 전달된 Closure가 true를 리턴한다면 그 룰은 유효성 검사에 추가될 것입니다. 이 메소드는 복잡한 조건부 유효성 검사의 구성을 손쉽게 만들어 주며, 한번에 여러개의 필드에 대한 조건부 유효성 검사를 추가할 수도 있습니다.

$v->sometimes(['reason', 'cost'], 'required', function($input)
{
    return $input->games >= 100;
});

참고: Closure로 전달된 $input 파라메터는 Illuminate\Support\Fluent의 인스턴스입니다. 그리고 입력된 데이터와 파일에 접근하기 위해 이 오브젝트는 사용할 수 있습니다.

사용자 정의 오류 메시지

만약 필요하다면 유효성 검사에서 기본 오류 메시지 대신 커스터마이징한 오류 메시지를 사용할 수 있습니다. 사용자 정의 오류 메시지를 지정하는 몇개의 방법이 있습니다.

Validator로 사용자 정의 메시지 전달하기

$messages = [
    'required' => 'The :attribute field is required.',
];

$validator = Validator::make($input, $rules, $messages);

참고: :attribute place-holder는 유효성 검사 필드의 실제 이름으로 대체됩니다. 여러분은 유효성 검사 메시지에 있는 다른 place-holder를 활용할 수도 있습니다.

다른 유효성 검사 Place-Holders

$messages = [
    'same'    => 'The :attribute and :other must match.',
    'size'    => 'The :attribute must be exactly :size.',
    'between' => 'The :attribute must be between :min - :max.',
    'in'      => 'The :attribute must be one of the following types: :values',
];

주어진 필드에 대한 사용자 정의 메시지 지정하기

때때로 오직 하나의 특정 필드를 위해 커스텀 오류 메시지를 지정하고 싶을지도 모릅니다.

$messages = [
    'email.required' => 'We need to know your e-mail address!',
];

언어 파일에 사용자 정의 메시지 지정하기

어떤 경우에는 직접 Validator로 커스텀 메시지를 전달하는 대신 언어 파일에 커스텀 메시지를 지정하고 싶을 수도 있습니다. 이를 위하여, resources/lang/xx/validation.php 언어 파일의 custom 배열에 메시지를 추가하십시오.

'custom' => [
    'email' => [
        'required' => 'We need to know your e-mail address!',
    ],
],

사용자 정의 유효성 검사 룰

사용자 정의 유효성 검사 룰 등록하기

라라벨은 다양하고 유용한 유효성 검사 룰을 제공합니다; 하지만, 여러분은 여러분만의 유효성 검사 룰을 지정하길 바랄수도 있습니다. 커스텀 유효성 검사 룰을 등록하는 방법중 하나는 Validator::extend 메소드를 사용하는 것입니다:

Validator::extend('foo', function($attribute, $value, $parameters)
{
    return $value == 'foo';
});

커스텀 유효성 검사 클로저는 3개의 인자를 받습니다: 유효성 검사를 할 필드($attribute)의 이름, 필드의 값($value), 그리고 룰에 전달될 파라미터들($parameters)의 배열입니다.

또한, 클로저 대신 클래스명과 메소드명을 extend 메소드로 전달할 수도 있습니다.

Validator::extend('foo', 'FooValidator@validate');

또한, 커스텀 룰에 대한 오류 메시지를 정의할 필요가 있다는 것을 유념하십시오. 인라인 커스텀 메시지 배열을 사용할 수도 있고 validation 언어파일에 추가할 수도 있습니다.

Validator 클래스 확장하기

Validator를 확장하기 위해 클로저를 사용하는 대신에 Validator 클래스 자체를 확장할 수 있습니다. 이를 위하여, Illuminate\Validation\Validator를 상속받는 Validator 클래스를 작성하십시오. 메소드명 앞에 validate를 붙이는 방법으로 validation 메소드를 그 클래스에 추가할 수 있습니다:

<?php

class CustomValidator extends \Illuminate\Validation\Validator {

    public function validateFoo($attribute, $value, $parameters)
    {
        return $value == 'foo';
    }

}

사용자 정의 Validator Resolver 등록하기

그 다음, 확장한 사용자 정의 Validator를 등록해야 합니다.

Validator::resolver(function($translator, $data, $rules, $messages)
{
    return new CustomValidator($translator, $data, $rules, $messages);
});

사용자 정의된 유효성 검사 룰을 생성할 때, 가끔 오류 메시지에서 사용할 커스텀 place-holder를 정의할 필요가 있을수도 있습니다. 앞서 설명했던 사용자 정의 Validator를 생성하고 replaceXXX 메소드를 validator에 추가하는 방법을 사용하면 됩니다.

protected function replaceFoo($message, $attribute, $rule, $parameters)
{
    return str_replace(':foo', $parameters[0], $message);
}

만약 Validator 클래스를 확장하지 않고 사용자 정의 메시지 "replacer"를 추가하고 싶다면, Validator::replacer 메소드를 사용하면 됩니다.

Validator::replacer('rule', function($message, $attribute, $rule, $parameters)
{
    //
});