验证

基本用法

Laravel 通过 Validation 类让您可以简单、方便的验证数据正确性及查看相应的验证错误信息。

基本验证例子

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

上文中通过 make 这个方法来的第一个参数来设定所需要被验证的数据名称,第二个参数设定该数据可被接受的规则。

使用数组来定义规则

多个验证规则可以使用"|"符号分隔,或是单一数组作为单独的元素分隔。

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

验证多个字段

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

当一个 Validator 实例被建立,fails(或 passes) 这两个方法就可以在验证时使用,如下:

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

假如验证失败,您可以从验证器中接收错误信息。

$messages = $validator->messages();

您可能不需要错误信息,只想取得无法通过验证的规则,您可以使用 'failed' 方法:

$failed = $validator->failed();

验证文件

Validator 类提供了一些规则用来验证文件,例如 size, mimes 等等。当需要验证文件时,您仅需将它们和您其他的数据一同送给验证器即可。

使用错误信息

当您调用一个 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)
{
    //
}

错误信息 & 视图

当您开始进行验证数据时,您会需要一个简易的方法去取得错误信息并回传到您的视图中,在 Laravel 中您可以很方便的处理这些操作,您可以通过下面的路由例子来了解:

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

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

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

    if ($validator->fails())
    {
        return Redirect::to('register')->withErrors($validator);
    }
});

需要记住的是,当验证失败后,我们会使用 withErrors 方法来将 Validator 实例进行重新导向。这个方法会将错误信息存入 session 中,这样才能在下个请求中被使用。

然而,我们并不需要特别去将错误信息绑定在我们 GET 路由的视图中。因为 Laravel 会确认在 Session 数据中检查是否有错误信息,并且自动将它们绑定至视图中。**所以请注意,$errors 变量存在于所有的视图中,所有的请求里,**让您可以直接假设 $errors 变量已被定义且可以安全地使用。$errors 变量是 MessageBag 类的一个实例。

所以,重新导向之后,您可以自然的在视图中使用 $errors 变量:

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

命名错误清单

假如您在一个页面中有许多的表单, 您可能希望为错误命名一个MessageBag. 这样能方便您针对特定的表单查看其错误信息, 我们只要简单的在 withErrors 的第二个参数设定名称即可:

return Redirect::to('register')->withErrors($validator, 'login');

接着您可以从一个 $errors 变量中取得已命名的 MessageBag 实例:

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

现有的的验证规则

以下是现有的的验证规则清单与他们的函数名称:

accepted

字段值为 yes, on, 或是 1 时,验证才会通过。这在确认"服务条款"是否同意时很有用。

active_url

字段值通过 PHP 函数 checkdnsrr 来验证是否为一个有效的网址。

after:date

验证字段是否是在指定日期之后。这个日期将会使用 PHP strtotime 函数验证。

alpha

字段仅全数为字母字串时通过验证。

alpha_dash

字段值仅允许字母、数字、破折号(-)以及底线(_)

alpha_num

字段值仅允许字母、数字

array

字段值仅允许为数组

before:date

验证字段是否是在指定日期之前。这个日期将会使用 PHP strtotime 函数验证。

between:min,max

字段值需介于指定的 minmax 值之间。字串、数值或是文件都是用同样的方式来进行验证。

boolean

需要验证的字段必须可以转换为 boolean 类型的值。可接受的输入是truefalse10"1""0"

confirmed

字段值需与对应的字段值 foo_confirmation 相同。例如,如果验证的字段是 password ,那对应的字段 password_confirmation 就必须存在且与 password 字段相符。

date

字段值通过 PHP strtotime 函数验证是否为一个合法的日期。

date_format:format

字段值通过 PHP date_parse_from_format 函数验证符合 format 制定格式的日期是否为合法日期。

different:field

字段值需与指定的字段 field 值不同。

digits:value

字段值需为数字且长度需为 value

digits_between:min,max

字段值需为数字,且长度需介于 minmax 之间。

email

字段值需符合 email 格式。

exists:table,column

字段值需与存在于数据库 table 中的 column 字段值其一相同。

Exists 规则的基本使用方法

'state' => 'exists:states'

指定一个自定义的字段名称

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

您可以指定更多条件且那些条件将会被新增至 "where" 查询里:

'email' => 'exists:staff,email,account_id,1'
/* 这个验证规则为 email 需存在于 staff 这个数据库表中 email 字段中且 account_id=1 */

通过NULL搭配"where"的缩写写法去检查数据库的是否为NULL

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

image

文件必需为图片(jpeg, png, bmp 或 gif)

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,...

字段值在 field 字段值为 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 是其整数部分的值;对于文件来说,value 为此文件的大小(以单位 kb)。

timezone

字段值通过 PHP timezone_identifiers_list 函数来验证是否为有效的时区。

unique:table,column,except,idColumn

字段值在给定的数据库中需为唯一值。如果 column(字段) 选项没有指定,将会使用字段名称。

唯一(Unique)规则的基本用法

'email' => 'unique:users'

指定一个自定义的字段名称

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

强制唯一规则忽略指定的 ID

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

增加额外的 Where 条件

您也可以指定更多的条件式到 "where" 查询语句中:

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

上述规则为只有 account_id1 的数据列会做唯一规则的验证。

url

字段值需符合 URL 的格式。

注意: 此函数会使用 PHP filter_var 方法验证。

添加条件验证规则

某些情况下,您可能 只想 当字段有值时,才进行验证。这时只要增加 sometimes 条件进条件列表中,就可以快速达成:

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

在上述例子中,email 字段只会在当其在 $data 数组中有值的情况下才会被验证。

复杂的条件式验证

有时,您可以希望给指定字段在其他字段长度有超过 100 时才验证是否为必填。或者您希望有两个字段,当其中一字段有值时,另一字段将会有一个默认值。增加这样的验证条件并不复杂。首先,利用您尚未更动的 静态规则 创建一个 Validator 实例:

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

假设我们的网页应用程序是专为游戏收藏家所设计。如果游戏收藏家收藏超过一百款游戏,我们希望他们说明为什么他们拥有这么多游戏。如,可能他们经营一家二手游戏商店,或是他们可能只是享受收集的乐趣。有条件的加入此需求,我们可以在 Validator 实例中使用 sometimes 方法。

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

传递至 sometimes 方法的第一个参数是我们要条件式认证的字段名称。第二个参数是我们想加入验证规则。 闭包(Closure) 作为第三个参数传入,如果回传值为 true 那该规则就会被加入。这个方法可以轻而易举的建立复杂的条件式验证。您也可以一次对多个字段增加条件式验证:

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

注意: 传递至您的 Closure$input 参数为 Illuminate\Support\Fluent 的实例且用来作为获取您的输入及文件的对象。

自定义错误信息

如果有需要,您可以设置自定义的错误信息取代默认错误信息。这里有几个方式可以设定自定义消息。

传递自定义消息进验证器

$messages = array(
    'required' => 'The :attribute field is required.',
);

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

注意: 在验证中,:attribute 占位符会被字段的实际名称给取代。您也可以在验证信息中使用其他的占位符。

其他的验证占位符

$messages = array(
    '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 = array(
    'email.required' => 'We need to know your e-mail address!',
);

在语言包文件中指定自定义消息

某些状况下,您可能希望在语言包文件中设定您的自定义消息,而非直接将他们传递给 Validator。要达到目的,将您的信息增加至 app/lang/xx/validation.php 文件的 custom 数组中。

'custom' => array(
    'email' => array(
        'required' => 'We need to know your e-mail address!',
    ),
),

自定义验证规则

注册自定义验证规则

Laravel 提供了各种有用的验证规则,但是,您可能希望可以设定自定义验证规则。注册生成自定义的验证规则的方法之一就是使用 Validator::extend 方法:

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

自定义验证器闭包接收三个参数:要被验证的 $attribute(属性) 的名称,属性的值 $value,传递至验证规则的 $parameters 数组。

您同样可以传递一个类和方法到 extend 方法中,取代原本的闭包:

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

注意,您同时需要为您的自定义规则订立一个错误信息。您可以使用行内自定义信息数组或是在认证语言文件里新增。

扩展 Validator 类

除了使用闭包回呼(Closure callbacks)来扩展 Validator 外,您一样可以直接扩展 Validator 类。您可以写一个扩展自 Illuminate\Validation\Validator 的验证器类。您也可以增加验证方法到以 validate 为开头的类中:

<?php

class CustomValidator extends Illuminate\Validation\Validator {

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

}

拓展自定义验证器

接下来,您需要注册您自定义验证器扩展:

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

当创建自定义验证规则时,您可能有时需要为错误信息定义自定义的占位符。您可以如上所述创建一个自定义的验证器,然后增加 replaceXXX 函数进验证器中。

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

如果您想要增加一个自定义信息 "replacer" 但不扩展 Validator 类,您可以使用 Validator::replacer 方法:

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