Laravel框架表单验证详解


Posted in PHP onSeptember 04, 2014

基础验证例子

$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 实例被创建,可以使用 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)

{

//

}

错误消息 & 视图

一旦您执行了验证,您需要一种简单的方法向视图反馈错误消息。这在 Lavavel 中能够方便的处理。以下面的路由作为例子:

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 实例传递给 Redirect。这个函数将刷新 Session 中保存的错误消息,使得在下次请求中能够可用。

然而,注意我们没有必要明确的在 GET 路由中绑定错误消息到路由。这是因为 Laravel 总会检查 Session 中的错误,并自动绑定它们到视图如果它们是可用的。所以,对于每个请求,一个 $errors 变量在所有视图中总是可用的,允许您方便的认为 $errors 总是被定义并可以安全使用的。$errors 变量将是一个 MessageBag 类的实例。

所以,在跳转之后,您可以在视图中使用自动绑定的 $errors 变量:

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

可用的验证规则

下面是一个所有可用的验证规则的列表以及它们的功能:

Accepted

 Active URL

 After (Date)

 Alpha

 Alpha Dash

 Alpha Numeric

 Before (Date)

 Between

 Confirmed

 Date

 Date Format

 Different

 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 Without

 Same

 Size

 Unique (Database)

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 规则的基础使用

'state' => 'exists:states'

指定列名
'state' => 'exists:states,abbreviation'

您也可以指定更多的条件,将以 "where" 的形式添加到查询。
'email' => 'exists:staff,email,account_id,1'

image

验证此规则的值必须是一个图片 (jpeg, png, bmp 或者 gif)。

in:foo,bar,...

验证此规则的值必须在给定的列表中存在。

integer

验证此规则的值必须是一个整数。

 

验证此规则的值必须是一个合法的 IP 地址。

max:value

验证此规则的值必须小于最大值 value。字符串、数字以及文件都将使用大小规则进行比较。

mimes:foo,bar,...

验证此规则的文件的 MIME 类型必须在给定的列表中。

MIME 规则的基础使用

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

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 规则的基础使用

'email' => 'unique:users'

指定列名

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

强制忽略一个给定的 ID

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

url

验证此规则的值必须是一个合法的 URL。

定制错误消息

如果有需要,您可以使用定制的错误消息代替默认的消息。这里有好几种定制错误消息的方法。

传递定制消息到验证器

$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';

});

注意: 传递给 extend 函数的规则的名字必须符合 "snake cased" 命名规则。

定制的验证器接受三个参数:待验证属性的名字、待验证属性的值以及传递给这个规则的参数。

您也可以传递一个类的函数到 extend 函数,而不是使用闭包:

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

注意您需要为您的定制规则定义错误消息。您既可以使用一个行内的定制消息数组,也可以在验证语言文件中进行添加。

您也可以扩展 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);

}

PHP 相关文章推荐
在IIS7.0下面配置PHP 5.3.2运行环境的方法
Apr 13 PHP
memcached 和 mysql 主从环境下php开发代码详解
May 16 PHP
学习php笔记 字符串处理
Oct 19 PHP
php Ubb代码编辑器函数代码
Jul 05 PHP
简单的方法让你的后台登录更加安全(php中加session验证)
Aug 22 PHP
PHP 正则表达式常用函数
Aug 17 PHP
php、java、android、ios通用的3des方法(推荐)
Sep 09 PHP
PHP实现打包zip并下载功能
Jun 12 PHP
PHP的mysqli_sqlstate()函数讲解
Jan 23 PHP
Laravel如何创建服务器提供者实例代码
Apr 15 PHP
PHP单元测试配置与使用方法详解
Dec 27 PHP
phpQuery解析HTML乱码问题(补充官网未列出的乱码解决方案)
Apr 01 PHP
Laravel框架中扩展函数、扩展自定义类的方法
Sep 04 #PHP
深入分析PHP引用(&amp;)
Sep 04 #PHP
Laravel框架路由配置总结、设置技巧大全
Sep 03 #PHP
CodeIgniter框架URL路由总结
Sep 03 #PHP
Yii 快速,安全,专业的PHP框架
Sep 03 #PHP
Laravel框架数据库CURD操作、连贯操作总结
Sep 03 #PHP
Yii中render和renderPartial的区别
Sep 03 #PHP
You might like
PHP中的命名空间相关概念浅析
2015/01/22 PHP
Symfony2在Nginx下的配置方法图文教程
2016/02/04 PHP
php对微信支付回调处理的方法
2018/08/23 PHP
基于Javascript实现弹出页面效果
2016/01/01 Javascript
Ionic如何创建APP项目
2016/06/03 Javascript
AngularJS基础 ng-dblclick 指令用法
2016/08/01 Javascript
AngularJS教程之环境设置
2016/08/16 Javascript
vue router仿天猫底部导航栏功能
2017/10/18 Javascript
jQuery 防止相同的事件快速重复触发方法
2018/02/08 jQuery
Vuex中mutations与actions的区别详解
2018/03/01 Javascript
react 实现页面代码分割、按需加载的方法
2018/04/03 Javascript
基于Vue实现电商SKU组合算法问题
2019/05/29 Javascript
原生js实现移动小球(碰撞检测)
2020/12/17 Javascript
[02:00]DOTA2英雄COSPLAY闹市街头巡游助威2015国际邀请赛
2015/08/02 DOTA
[01:24:16]2018DOTA2亚洲邀请赛 4.6 全明星赛
2018/04/10 DOTA
Python基于更相减损术实现求解最大公约数的方法
2018/04/04 Python
Python3.7 基于 pycryptodome 的AES加密解密、RSA加密解密、加签验签
2019/12/04 Python
python输出数组中指定元素的所有索引示例
2019/12/06 Python
keras tensorflow 实现在python下多进程运行
2020/02/06 Python
在keras里实现自定义上采样层
2020/06/28 Python
Python安装Bs4的多种方法
2020/11/28 Python
详解Django关于StreamingHttpResponse与FileResponse文件下载的最优方法
2021/01/07 Python
HTML5视频播放插件 video.js介绍
2018/09/29 HTML / CSS
移动端html5模拟长按事件的实现方法
2018/09/30 HTML / CSS
MVMT手表官方网站:时尚又实惠的高品质手表
2016/12/04 全球购物
HOTEL INFO英国:搜索全球酒店
2019/08/08 全球购物
JPA的特点
2014/10/25 面试题
市场拓展计划书
2014/05/03 职场文书
教育基金募捐倡议书
2014/05/14 职场文书
建筑结构施工求职信
2014/07/11 职场文书
学生未请假就回家检讨书
2014/09/22 职场文书
2015年酒店前台工作总结
2015/04/20 职场文书
认识实习感想
2015/08/10 职场文书
2016年秋季趣味运动会开幕词
2016/03/04 职场文书
css实现文章分割线样式的多种方法总结
2021/04/21 HTML / CSS
Win11 Beta 22621.601 和 22622.601今日发布 KB5017384修复内容汇总
2022/09/23 数码科技