## 可用的验证规则
以下是所有可用的验证规则清单与功能:
* [Accepted](https://learnku.com/docs/lumen/5.1/validation/1852#rule-accepted)
* [Active URL](https://learnku.com/docs/lumen/5.1/validation/1852#rule-active-url)
* [After (Date)](https://learnku.com/docs/lumen/5.1/validation/1852#rule-after)
* [Alpha](https://learnku.com/docs/lumen/5.1/validation/1852#rule-alpha)
* [Alpha Dash](https://learnku.com/docs/lumen/5.1/validation/1852#rule-alpha-dash)
* [Alpha Numeric](https://learnku.com/docs/lumen/5.1/validation/1852#rule-alpha-num)
* [Array](https://learnku.com/docs/lumen/5.1/validation/1852#rule-array)
* [Before (Date)](https://learnku.com/docs/lumen/5.1/validation/1852#rule-before)
* [Between](https://learnku.com/docs/lumen/5.1/validation/1852#rule-between)
* [Boolean](https://learnku.com/docs/lumen/5.1/validation/1852#rule-boolean)
* [Confirmed](https://learnku.com/docs/lumen/5.1/validation/1852#rule-confirmed)
* [Date](https://learnku.com/docs/lumen/5.1/validation/1852#rule-date)
* [Date Format](https://learnku.com/docs/lumen/5.1/validation/1852#rule-date-format)
* [Different](https://learnku.com/docs/lumen/5.1/validation/1852#rule-different)
* [Digits](https://learnku.com/docs/lumen/5.1/validation/1852#rule-digits)
* [Digits Between](https://learnku.com/docs/lumen/5.1/validation/1852#rule-digits-between)
* [E-Mail](https://learnku.com/docs/lumen/5.1/validation/1852#rule-email)
* [Exists (Database)](https://learnku.com/docs/lumen/5.1/validation/1852#rule-exists)
* [Image (File)](https://learnku.com/docs/lumen/5.1/validation/1852#rule-image)
* [In](https://learnku.com/docs/lumen/5.1/validation/1852#rule-in)
* [Integer](https://learnku.com/docs/lumen/5.1/validation/1852#rule-integer)
* [IP Address](https://learnku.com/docs/lumen/5.1/validation/1852#rule-ip)
* [Max](https://learnku.com/docs/lumen/5.1/validation/1852#rule-max)
* [MIME Types (File)](https://learnku.com/docs/lumen/5.1/validation/1852#rule-mimes)
* [Min](https://learnku.com/docs/lumen/5.1/validation/1852#rule-min)
* [Not In](https://learnku.com/docs/lumen/5.1/validation/1852#rule-not-in)
* [Numeric](https://learnku.com/docs/lumen/5.1/validation/1852#rule-numeric)
* [Regular Expression](https://learnku.com/docs/lumen/5.1/validation/1852#rule-regex)
* [Required](https://learnku.com/docs/lumen/5.1/validation/1852#rule-required)
* [Required If](https://learnku.com/docs/lumen/5.1/validation/1852#rule-required-if)
* [Required With](https://learnku.com/docs/lumen/5.1/validation/1852#rule-required-with)
* [Required With All](https://learnku.com/docs/lumen/5.1/validation/1852#rule-required-with-all)
* [Required Without](https://learnku.com/docs/lumen/5.1/validation/1852#rule-required-without)
* [Required Without All](https://learnku.com/docs/lumen/5.1/validation/1852#rule-required-without-all)
* [Same](https://learnku.com/docs/lumen/5.1/validation/1852#rule-same)
* [Size](https://learnku.com/docs/lumen/5.1/validation/1852#rule-size)
* [String](https://learnku.com/docs/lumen/5.1/validation/1852#rule-string)
* [Timezone](https://learnku.com/docs/lumen/5.1/validation/1852#rule-timezone)
* [Unique (Database)](https://learnku.com/docs/lumen/5.1/validation/1852#rule-unique)
* [URL](https://learnku.com/docs/lumen/5.1/validation/1852#rule-url)
#### accepted
验证字段值是否为*yes*、*on*、*1*、或*true*。这在确认「服务条款」是否同意时相当有用。
#### active\_url
验证字段值是否为一个有效的网址,会通过 PHP 的`checkdnsrr`函数来验证。
#### after:*date*
验证字段是否是在指定日期之后。这个日期将会通过`strtotime`函数来验证。
~~~php
'start_date' => 'required|date|after:tomorrow'
~~~
作为替换`strtotime`传递的日期字符串,你可以指定其它的字段来比较日期:
~~~php
'finish_date' => 'required|date|after:start_date'
~~~
#### alpha
验证字段值是否仅包含字母字符。
#### alpha\_dash
验证字段值是否仅包含字母、数字、破折号( - )以及下划线( \_ )。
#### alpha\_num
验证字段值是否仅包含字母、数字。
#### array
验证字段必须是一个 PHP`array`。
#### before:*date*
验证字段是否是在指定日期之前。这个日期将会使用 PHP`strtotime`函数来验证。
#### between:*min*,*max*
验证字段值的大小是否介于指定的*min*和*max*之间。字符串、数值或是文件大小的计算方式和[`size`](https://learnku.com/docs/lumen/5.1/validation/1852#rule-size)规则相同。
#### boolean
验证字段值是否能够转换为布尔值。可接受的参数为`true`、`false`、`1`、`0`、`"1"`以及`"0"`。
#### confirmed
验证字段值必须和`foo_confirmation`的字段值一致。例如,如果要验证的字段是`password`,就必须和输入数据里的`password_confirmation`的值保持一致。
#### date
验证字段值是否为有效日期,会根据 PHP 的`strtotime`函数来做验证。
#### date\_format:*format*
验证字段值符合定义的日期*格式*,通过 PHP 的`date_parse_from_format`函数来验证。
#### different:*field*
验证字段值是否和指定\_字段( field )\_不同。
#### digits:*value*
验证字段值是否为*numeric*且长度为*value*。
#### digits\_between:*min*,*max*
验证字段值的长度是否在*min*和*max*之间。
#### email
验证字段值是否符合 e-mail 格式。
#### exists:*table*,*column*
验证字段值是否存在指定的数据表中。
#### Exists 规则的基本使用方法
~~~php
'state' => 'exists:states'
~~~
#### 指定一个特定的字段名称
~~~php
'state' => 'exists:states,abbreviation'
~~~
也可以指定更多的条件,它们会被加到「where」查询语句中:
~~~php
'email' => 'exists:staff,email,account_id,1'
~~~
你也可以传递`NULL`或`NOT_NULL`至「where」语句:
~~~php
'email' => 'exists:staff,email,deleted_at,NULL'
'email' => 'exists:staff,email,deleted_at,NOT_NULL'
~~~
#### image
验证字段文件必须为图片格式( jpeg、png、bmp、gif、 或 svg )。
#### in:*foo*,*bar*,...
验证字段值是否有在指定的列表里面。
#### integer
验证字段值是否是整数。
#### ip
验证字段值是否符合 IP address 的格式。
#### json
验证字段是否是一个有效的 JSON 字符串。
#### max:*value*
字段值必须小于或等于*value*。字符串、数值或是文件大小的计算方式和[`size`](https://learnku.com/docs/lumen/5.1/validation/1852#rule-size)规则相同。
#### mimes:*foo*,*bar*,...
验证字段文件的 MIME 类型是否符合列表中指定的格式。
#### MIME 规则基本用法
~~~php
'photo' => 'mimes:jpeg,bmp,png'
~~~
即使你可能只需要验证指定扩展名,但此规则实际上会验证文件的 MIME 类型,其通过读取文件的内容以猜测它的 MIME 类型。
完整的 MIME 类型及对应的扩展名列表可以在下方链接找到:[svn.apache.org/repos/asf/httpd/http...](http://svn.apache.org/repos/asf/httpd/httpd/trunk/docs/conf/mime.types)
#### min:*value*
字段值必须大于或等于*value*。字符串、数值或是文件大小的计算方式和[`size`](https://learnku.com/docs/lumen/5.1/validation/1852#rule-size)规则相同。
#### not\_in:*foo*,*bar*,...
验证字段值是否不在指定的列表里。
#### numeric
验证字段值是否为数值。
#### regex:*pattern*
验证字段值是否符合指定的正则表达式。
\*\*注意:\*\*当使用`regex`规则时,你必须使用数组,而不是使用管道分隔规则,特别是当正则表达式含有管道符号时。
#### required
验证字段必须存在输入数据,且不为空。字段符合下方任一条件时即为「空」:
* 该值为`null`。
* 该值为空字符串。
* 该值为空数组或空的`可数`对象。
* 该值为没有路径的上传文件。
#### required\_if:*anotherfield*,*value*,...
如果指定的*其它字段*( anotherfield )等于任何一个*value*时,此字段为必填。
#### required\_unless:*anotherfield*,*value*,...
如果指定的*其它字段*( anotherfield )等于任何一个*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*对应的是文件大小(单位 kb )。
#### string
验证字段值的类型是否为字符串。
#### timezone
验证字段值是否是有效的时区,会根据 PHP 的`timezone_identifiers_list`函数来判断。
#### unique:*table*,*column*,*except*,*idColumn*
在指定的数据表中,验证字段必须是唯一的。如果没有指定`column`,将会使用字段本身的名称。
**指定一个特定的字段名称:**
~~~php
'email' => 'unique:users,email_address'
~~~
**自定义数据库连接**
有时候你可能需要自定义一个连接,来通过 Validator 对数据库进行查找。如上面所示,设置`unique:users`作为验证规则,通过默认数据库连接来做数据库查找。如果要重写验证规则,可在指定的连接的表单名称后面加上「.」:
~~~php
'email' => 'unique:connection.users,email_address'
~~~
**强迫 Unique 规则忽略指定 ID:**
有时候,你希望在验证字段时对指定 ID 进行忽略。例如,在「更新个人资料」页面会包含用户名、邮箱等字段。这时你会想要验证更新的 e-mail 值是否为唯一的。如果用户仅更改了名称字段而不是 e-mail 字段,就不需要抛出验证错误,因为此用户已经是这个 e-mail 的拥有者了。假设用户提供的 e-mail 已经被其他用户使用,则需要抛出验证错误。若要用指定规则来忽略用户 ID,则应该把要发送的 ID 当作第三个参数:
~~~php
'email' => 'unique:users,email_address,'.$user->id
~~~
如果你的数据表使用的主键名称不是`id`,那么你可以在第四个参数中来指定它:
~~~php
'email' => 'unique:users,email_address,'.$user->id.',user_id'
~~~
**增加额外的 Where 语句:**
你也可以指定更多的条件到「where」查询语句:
~~~php
'email' => 'unique:users,email_address,NULL,id,account_id,1'
~~~
上述规则中,只有`account_id`为`1`的数据列会被包含在 unique 规则的验证。
#### url
根据 PHP 的`filter_var`函数来验证字段是否符合 URL 格式。
## 按条件增加规则
在某些情况下,你可能**只想**在输入数据中有此字段时才进行验证。可通过增加`sometimes`规则到规则列表来实现:
~~~php
$v = Validator::make($data, [
'email' => 'sometimes|required|email',
]);
~~~
在上面的例子中,`email`字段的验证只会在`$data`数组有此字段时才会进行。
#### 复杂的条件验证
有时候你可能希望增加更复杂的验证条件,例如,你可以希望某个指定字段在另一个字段的值超过 100 时才为必填。或者当某个指定字段有值时,另外两个字段要拥有符合的特定值。增加这样的验证条件并不难。首先,利用你熟悉的*static rules*来创建一个`Validator`实例:
~~~php
$v = Validator::make($data, [
'email' => 'required|email',
'games' => 'required|numeric',
]);
~~~
假设我们有一个专为游戏收藏家所设计的网页应用程序。如果游戏收藏家收藏超过一百款游戏,我们会希望他们来说明下为什么他们会拥有这么多游戏。比如说他们有可能经营了一家二手游戏商店,或者只是为了享受收集的乐趣。为了在特定条件下加入此验证需求,可以在`Validator`实例中使用`sometimes`方法。
~~~php
$v->sometimes('reason', 'required|max:500', function($input) {
return $input->games >= 100;
});
~~~
传入`sometimes`方法的第一个参数是我们要用条件认证的字段名称。第二个参数是我们想使用的验证规则。`闭包`作为第三个参数传入,如果其返回`true`,则额外的规则就会被加入。这个方法可以轻松的创建复杂的条件式验证。你甚至可以一次对多个字段增加条件式验证:
~~~php
$v->sometimes(['reason', 'cost'], 'required', function($input) {
return $input->games >= 100;
});
~~~
> \*\*注意:\*\*传入`闭包`的`$input`参数是`Illuminate\Support\Fluent`实例,可用来访问你的输入或文件对象。
- 在线文档收集
- 路由组
- 控制器
- laravel多站点策划
- 多站点的控制器与路由
- 多站点多主题模板
- 多站点,多数据库
- 中间件或万能路由修改配置值
- laravel程序简写规则
- 路由简写
- 控制器简写
- 后台模板简写
- 模型简写
- 手机模板
- 问题与解决
- 控制器不存在
- 模型添加修改
- 隐藏不需要查询的数据表字段
- where的in条件
- laravel查看sql语句
- 子查询操作
- laravel返回图片
- 生成二维码
- 跨域请求
- 报错 Session store not set on request
- workerman报错与解决
- 为每个请求添加日志
- Ajax跨域请求,未携带cookie的解决办法
- 分文件保存日志
- 万能路由
- 合并两个数据库查询出来的集合
- Container报错跟踪程序
- 控制器调用artisan命令
- 控制器前置与后置操作
- 多个env文件
- 笔记
- laravel 安装
- Lumen安装
- 伪静态配置
- 依赖注入 & 控制器
- laravel使用中间件
- laravel设定单独的路由文件
- 视图
- 时区不对的修改
- lumen设定单独的路由文件
- lumen使用中间件
- laravel门面路径
- 常用命令
- 网站端口设置
- laravel端口设置
- laravel和lemen中间件进行端口判读
- OctoberCms中间件进行端口判读
- Nginx设置多端口
- vscode编辑器
- 命令行操作以及workerman的使用
- 查看命令行帮助信息:3种方式
- 命令行创建修改删除命令
- 命令行参数设置
- 设置可选参数
- 命令行选项设置
- 参数与选项的区别
- 输入命令行数组参数
- 选项简写
- 获取参数
- 获取选项
- 交互询问
- 在控制台输出信息
- 控制台输出标签
- 控制台输出表格信息
- 控制台输出进度条
- 程序中调用命令
- 命令行相互调用
- 检测命令行是否执行
- 添加workerman
- 定时任务
- 外部调用命令
- 模型操作
- 时间戳
- 设置默认字段的值
- lumen支持模型
- 获取模型的数据表名称
- 模型中/添加修改过滤数据表的字段
- 数据库的创建与填充
- 创建数据表
- 数据表字段类型
- 字段示例
- 数据填充
- 数据表清空
- laravel lumen 自定义函数使用
- 表单验证
- lumen验证规则
- lumen 可用验证规则
- lumen 自定义验证规则
- laravel表单验证
- laravel 自定义验证消息
- laravel 表单验证器
- laravel可用验证规则
- laravel 自定义验证规则
- 数据库操作
- 获取数据表所有的字段信息
- 获取数据库表的字段信息
- count与distinct联合
- 集合
- 数据库查询与集合操作
- 修改方法
- map方法:处理元素项目
- each方法:处理元素项目
- map与each的区别
- flatMap方法:处理集合所有的项目
- mapWithKeys方法 遍历集合并将每个值传入给定的回调。回调应该返回包含一个键值对的关联数组
- pipe方法 将集合传给给定的回调并返回结果【或许很少使用】
- pop方法 移除并返回集合中的最后一个项目
- prepend方法 将给定的值添加到集合的开头
- pull方法 把给定键对应的值从集合中移除并返回
- push方法 把给定值添加到集合的末尾
- put方法 在集合内设置给定的键值对
- shift方法 移除并返回集合的第一个项目
- splice方法 删除并返回从给定值后的内容,原集合也会受到影响
- take方法 返回给定数量项目的新集合
- tap方法 将集合传递给回调【或许很少使用】
- transform方法 迭代集合并对集合内的每个项目调用给定的回调
- concat 方法在集合的末端附加指定的 数组 或集合值:
- eachSpread 方法用于循环集合项,将每个嵌套集合项的值传递给回调函数:
- mapInto() 方法可以迭代集合,通过将值传递给构造函数来创建给定类的新实例:
- mapSpread 方法可以迭代集合,将每个嵌套项值给指定的回调函数。该回调函数可以自由修改该集合项并返回,从而生成被修改过集合项的新集合
- mapToGroups 方法通过给定的回调函数对集合项进行分组。该回调函数应该返回一个包含单个键 / 值对的关联数组,从而生成一个分组值的新集合
- pipeInto 方法创建一个给定类的新实例,并将集合传递给构造函数
- replace 方法类似于 merge ;不过, replace 不仅可以覆盖匹配到的相同字符串键的元素,而且也可以覆盖匹配到数字键的元素:
- replaceRecursive 这个方法类似 replace ,但是会以递归的形式将数组替换到具有相同键的元素中:
- 过滤方法
- diff方法
- diffAssoc方法
- diffKeys方法
- except方法:返回排除的元素的集合
- filter方法:按一定条件过滤元素
- first方法:第一个满足添加的元素
- get方法 获取指定的元素
- intersect方法 从原集合中返回给定数组或集合中的值,最终的集合会保留原集合的键
- intersectKey方法 返回原集合中存在于给定数组或集合中的元素
- last方法 返回集合中通过给定测试的最后一个元素
- only方法 返回集合中给定键的所有项目
- reject方法 使用指定的回调过滤集合。如果回调返回 true ,就会把对应的项目从集合中移除
- search方法 搜索给定的值并返回它的键。如果找不到,则返回 false
- slice方法 返回集合中给定值后面的部分
- when方法 当传入的第一个参数为 true 的时,将执行给定的回调
- where方法 通过给定的键值过滤集合
- whereStrict方法
- whereIn方法 通过给定的键值数组来过滤集合
- whereInStrict方法
- whereNotIn方法 通过集合中不包含的给定键值对进行
- whereNotInStrict方法
- zip方法 将给定数组的值与相应索引处的原集合的值合并在一起
- firstWhere 方法返回集合中含有指定键 / 值对的第一个元素:
- skipWhile 方法当回调函数返回 true 时跳过元素,然后返回集合中剩余的元素
- takeWhile 方法将返回集合中的元素直到给定的回调函数返回 false
- unless 法当传入的第一个参数不为 true 的时候,将执行给定的回调函数
- unlessEmpty()
- unlessNotEmpty()
- 静态 unwrap 方法返回集合内部的可用元素:
- whenEmpty 方法是当集合为空时,将执行给定的回调函数:
- whenNotEmpty 方法当集合不为空时,将执行给定的回调函数:
- whereBetween 方法会筛选给定范围的集合
- whereInstanceOf 方法根据给定的类来过滤集合:
- whereNotBetween 方法在指定的范围内过滤集合
- whereNotNull 方法筛选给定键不为 NULL 的项:
- whereNull 方法筛选给定键为 NULL 的项
- 集合操作方法
- avg方法:平均值
- count方法
- max方法 返回给定键的最大值
- median方法 方法返回给定键的中间值
- min方法 返回给定键的最小值
- mode方法 返回给定键的众数值
- sum方法 返回集合内所有项目的总和
- countBy 方法计算集合中每个值的出现次数。默认情况下,该方法计算每个元素的出现次数:
- 常用方法
- all方法
- chuck方法:拆分成新集合
- combine方法:将一个数组作为键另一个数组作为值组合新数组
- collapse方法:合并成新集合
- flatten方法 将多维集合转为一维
- flip方法 将集合中的键和对应的数值进行互换
- forget方法 通过给定的键来移除掉集合中对应的内容
- forPage方法 分页展示数据
- groupBy方法 按某个元素的键的值进行分组
- keyBy方法 用指定某个键的值作为新集合的键
- implode方法 合并某个键的值
- keys方法 返回集合的所有键
- merge方法 将给定数组或集合合并到原集合
- nth方法 创建由每隔n个元素组成一个新的集合
- partition方法 可以和 PHP 中的 list() 方法结合使用,来分开通过指定条件的元素以及那些不通过指定条件的元素
- pluck方法 获取集合中给定键对应的所有值
- random方法 从集合中返回一个随机项
- reduce方法 将每次迭代的结果传递给下一次迭代直到集合减少为单个值
- reverse方法 倒转集合中项目的顺序
- shuffle方法 随机排序集合中的项目
- sort方法 对集合进行排序
- sortBy方法 以给定的键对集合进行排序
- sortByDesc方法 与 sortBy 方法一样,但是会以相反的顺序来对集合进行排序
- split方法 将集合按给定的值拆分
- times方法 通过回调在给定次数内创建一个新的集合
- toArray方法 将集合转换成 PHP 数组
- toJson方法 将集合转换成 JSON 字符串
- union方法 将给定的数组添加到集合中
- unique方法 返回集合中所有唯一的项目
- uniqueStrict方法
- values方法 返回键被重置为连续编号的新集合
- chunkWhile 方法根据指定的回调值把集合分解成多个更小的集合:
- crossJoin 方法交叉连接指定数组或集合的值,返回所有可能排列的笛卡尔积:
- duplicates 方法从集合中检索并返回重复的值:
- duplicatesStrict()
- join 方法会将集合中的值用字符串连接:
- mergeRecursive 方法以递归的形式合并给定的数组或集合到原集合中,如果给定集合项的字符串键与原集合的字符串键一致,则会将给定的集合项的值以递归的形式合并到原集合的相同键中
- pad 方法将使用给定的值填充数组,直到数组达到指定的大小
- skip 方法返回除了给定的元素数目的新集合:
- skipUntil 方法将跳过元素直到给定的回调函数返回 true,然后返回集合中剩余的元素
- sortKeys 方法通过底层关联数组的键来对集合进行排序:
- sortKeysDesc 该方法与 sortKeys 方法一样,但是会以相反的顺序来对集合进行排序。
- splitIn 方法将集合分为给定数量的组,在将其余部分分配给最终组之前,完全填充非终端组:
- takeUntil 方法将返回集合中的元素,直到给定的回调函数返回 true
- wrap 方法会将给定值封装到集合中
- 判断元素是否存在
- contains方法:判断指定的元素是否存在
- containsStrict方法:严格判断指定元素是否存在
- every方法:验证集合中每一个元素都通过给定测试
- has方法 判断键值是否存在
- isEmpty() 如果集合为空, isEmpty 方法返回 true ,否则返回 false :
- isNotEmpty() 如果集合不为空,isNotEmpty 方法返回 true ,否则返回 false :
- 问题与技巧
- 两个集合合并concat
- 队列消息
- 执行步骤
- 队列消息常用命令
- 创建队列消息
- 队列程序中常用参数
- 执行流程
- 一篇文章带你彻底搞懂 Laravel 框架的底层运行原理!!!