基础验证例子
传递给 make 函数的第一个参数是待验证的数据,第二个参数是对该数据需要应用的验证规则。
多个验证规则可以通过 "|" 字符进行隔开,或者作为数组的一个单独的元素。
通过数组指定验证规则
一旦一个 Validator 实例被创建,可以使用 fails (或者 passes)函数执行这个验证。
文件验证
Validator 类提供了一些验证规则用于验证文件,比如 size、mimes等。在验证文件的时候,您可以和其他验证一样传递给验证器。
附带错误消息
在一个 Validator 实例上调用 messages 函数之后,将会得到一个 MessageBag 实例,该实例拥有很多处理错误消息的方便的函数。
获取一个域的第一个错误消息
获取一个域的全部错误消息
获取全部域的全部错误消息
检查一个域是否存在消息
以某种格式获取所有错误消息
错误消息 & 视图
一旦您执行了验证,您需要一种简单的方法向视图反馈错误消息。这在 Lavavel 中能够方便的处理。以下面的路由作为例子:
然而,注意我们没有必要明确的在 GET 路由中绑定错误消息到路由。这是因为 Laravel 总会检查 Session 中的错误,并自动绑定它们到视图如果它们是可用的。所以,对于每个请求,一个 $errors 变量在所有视图中总是可用的,允许您方便的认为 $errors 总是被定义并可以安全使用的。$errors 变量将是一个 MessageBag 类的实例。
所以,在跳转之后,您可以在视图中使用自动绑定的 $errors 变量:
下面是一个所有可用的验证规则的列表以及它们的功能:
accepted
验证此规则的值必须是 yes、 on 或者是 1。这在验证是否同意"服务条款"的时候非常有用。
active_url
验证此规则的值必须是一个合法的 URL,根据 PHP 函数 checkdnsrr。
after:date
验证此规则的值必须在给定日期之后,日期将通过 PHP 函数 strtotime 传递。
alpha
验证此规则的值必须全部由字母字符构成。
alpha_dash
验证此规则的值必须全部由字母、数字、中划线或下划线字符构成。
alpha_num
验证此规则的值必须全部由字母和数字构成。
before:date
验证此规则的值必须在给定日期之前,日期将通过 PHP 函数 strtotime 传递。
between:min,max
验证此规则的值必须在给定的 min 和 max 之间。字符串、数字以及文件都将使用大小规则进行比较。
confirmed
验证此规则的值必须和 foo_confirmation 的值相同。比如,需要验证此规则的域是 password,那么在输入中必须有一个与之相同的 password_confirmation 域。
date
验证此规则的值必须是一个合法的日期,根据 PHP 函数 strtotime。
date_format:format
验证此规则的值必须符合给定的 format 的格式,根据 PHP 函数 date_parse_from_format。
different:field
验证此规则的值必须与指定的 field 域的值不同。
email
验证此规则的值必须是一个合法的电子邮件地址。
exists:table,column
验证此规则的值必须在指定的数据库的表中存在。
Exists 规则的基础使用
image
验证此规则的值必须是一个图片 (jpeg, png, bmp 或者 gif)。
in:foo,bar,...
验证此规则的值必须在给定的列表中存在。
integer
验证此规则的值必须是一个整数。
验证此规则的值必须是一个合法的 IP 地址。
max:value
验证此规则的值必须小于最大值 value。字符串、数字以及文件都将使用大小规则进行比较。
mimes:foo,bar,...
验证此规则的文件的 MIME 类型必须在给定的列表中。
MIME 规则的基础使用
min:value
验证此规则的值必须大于最小值 value。字符串、数字以及文件都将使用大小规则进行比较。
not_in:foo,bar,...
验证此规则的值必须在给定的列表中不存在。
numeric
验证此规则的值必须是一个数字。
regex:pattern
验证此规则的值必须符合给定的正则表达式。
注意: 当使用 regex 模式的时候,有必要使用数组指定规则,而不是管道分隔符,特别是正则表达式中包含一个管道字符的时候。
required
验证此规则的值必须在输入数据中存在。
required_if:field,value
当指定的域为某个值的时候,验证此规则的值必须存在。
required_with:foo,bar,...
仅当指定的域存在的时候,验证此规则的值必须存在。
required_without:foo,bar,...
仅当指定的域不存在的时候,验证此规则的值必须存在。
same:field
验证此规则的值必须与给定域的值相同。
size:value
验证此规则的值的大小必须与给定的 value 相同。对于字符串,value 代表字符的个数;对于数字,value 代表它的整数值,对于文件,value 代表文件以KB为单位的大小。
unique:table,column,except,idColumn
验证此规则的值必须在给定的数据库的表中唯一。如果 column 没有被指定,将使用该域的名字。
Unique 规则的基础使用
url
验证此规则的值必须是一个合法的 URL。
定制错误消息
如果有需要,您可以使用定制的错误消息代替默认的消息。这里有好几种定制错误消息的方法。
传递定制消息到验证器
注意: :attribute 占位符将被实际的进行验证的域的名字代替,您也可以在错误消息中使用其他占位符。
其他验证占位符
对一个指定的域指定定制的错误消息
在语言文件中指定错误消息
定制验证规则
Laravel 提供了一系列的有用的验证规则;但是,您可能希望添加自己的验证规则。其中一种方法是使用 Validator::extend 函数注册定制的验证规则:
注册一个定制的验证规则
注意: 传递给 extend 函数的规则的名字必须符合 "snake cased" 命名规则。
定制的验证器接受三个参数:待验证属性的名字、待验证属性的值以及传递给这个规则的参数。
您也可以传递一个类的函数到 extend 函数,而不是使用闭包:
您也可以扩展 Validator 类本身,而不是使用闭包回调扩展验证器。为了实现这个目的,添加一个继承自 Illuminate/Validation/Validator 的验证器类。您可以添加在类中添加以 validate 开头的验证函数:
扩展验证器类
下面,您需要注册定制的验证器扩展:
您需要注册定制的验证器扩展
当创建一个定制的验证规则,您有时需要为错误消息定义一个定制的占位符。为了实现它,您可以像上面那样创建一个定制的验证器,并且在验证器中添加一个 replaceXXX 函数:
新闻热点
疑难解答