## laravel 表单验证
## 简介
默认情况下，Laravel 的基类控制器使用了一个名为`ValidatesRequests`的 trait，它提供了一种方便的方法以使用各种强大的验证规则来验证传入的 HTTP 请求。
### 创建控制器
接下来，让我们一起来看看处理这些路由的简单控制器。我们暂时留空了`store`方法。
~~~php
<?php
namespace App\Http\Controllers;
use App\Http\Controllers\Controller;
use Illuminate\Http\Request;
class PostController extends Controller
{
/**
* 显示创建博客文章的表单
*
* @return Response
*/
public function create()
{
return view('post.create');
}
/**
* 存储一篇新的博客文章
*
* @param Request $request
* @return Response
*/
public function store(Request $request)
{
// 验证并存储博客文章...
}
}
~~~
### 在控制器中编写验证逻辑
现在我们开始在`store`方法中编写用来验证新的博客文章的逻辑代码。为此，我们将使用`Illuminate\Http\Request`类提供的`validate`方法。如果验证通过，你的代码会继续正常运行。如果验证失败，则会抛出异常，并自动将对应的错误响应返回给用户。 在传统 HTTP 请求下，会生成一个重定向响应， 而对于 AJAX 请求则会发送 JSON 响应。
为了深入理解`validate`方法，让我们接着回到`store`方法中：
~~~php
/**
* 存储一篇新的博客文章
*
* @param Request $request
* @return Response
*/
public function store(Request $request)
{
$validatedData = $request->validate([
'title' => 'required|unique:posts|max:255',
'body' => 'required',
]);
// 博客文章验证通过...
}
~~~
* 如果验证失败，会自动生成一个对应的响应
* 如果验证通过，那我们的控制器会继续正常运行。
或者，验证规则可以使用数组而不是单个`|`分隔的字符串：
~~~php
$validatedData = $request->validate([
'title' => ['required', 'unique:posts', 'max:255'],
'body' => ['required'],
]);
~~~
你可以使用`validateWithBag`方法来验证请求，并将所有错误信息储存在一个[命名错误信息包](https://learnku.com/docs/laravel/8.x/validation/9374#named-error-bags)中：
~~~php
$validatedData = $request->validateWithBag('post', [
'title' => ['required', 'unique:posts', 'max:255'],
'body' => ['required'],
]);
~~~
#### 在首次验证失败时停止运行
有时候我们希望某个字段在第一次验证失败后就停止运行验证规则，只需要将`bail`添加到规则中：
~~~php
$request->validate([
'title' => 'bail|required|unique:posts|max:255',
'body' => 'required',
]);
~~~
在这个例子中，如果`title`字段没有通过`unique`规则，那么不会继续验证`max`规则。规则会按照分配时的顺序来验证。
#### 嵌套字段的说明
如果你的 HTTP 请求包含「嵌套」参数（比如数组）， 你可以在验证规则中使用「点」语法来指定这些参数：
~~~php
$request->validate([
'title' => 'required|unique:posts|max:255',
'author.name' => 'required',
'author.description' => 'required',
]);
~~~
另外，如果你的字段名称包含点，则可以通过使用反斜杠将点转义，以防止将其解释为 “点” 语法：
~~~php
$request->validate([
'title' => 'required|unique:posts|max:255',
'v1\.0' => 'required',
]);
~~~
### 显示验证错误信息
* 如果传入的请求参数未通过给定的验证规则，Laravel 会自动将用户重定向到之前的位置。
* 另外，所有的验证错误信息会自动存储到[闪存 session](https://learnku.com/docs/laravel/8.x/session#flash-data)中。
* Laravel 会检查 session 数据中的错误，会自动将其绑定到视图中去。其中的`$errors`变量是`Illuminate\Support\MessageBag`的一个实例。
> 技巧：`$errors`由`web`中间件组提供的`Illuminate\View\Middleware\ShareErrorsFromSession`中间件绑定到视图中。**当该中间件被应用后，`$errors`变量在您的视图中总是可用的**，因此您可以假设`$errors`变量总是被定义了且总是安全可用的。
所以，在如下的例子中，当表单验证失败时，用户将被重定向到控制器的`create`方法中，我们可在视图中显示错误信息：
~~~php
<!-- /resources/views/post/create.blade.php -->
<h1>Create Post</h1>
@if ($errors->any())
<div class="alert alert-danger">
<ul>
@foreach ($errors->all() as $error)
<li>{{ $error }}</li>
@endforeach
</ul>
</div>
@endif
<!-- Create Post Form -->
~~~
#### `@error`指令
您亦可使用`@error`[Blade](https://learnku.com/docs/laravel/8.x/blade)指令方便地检查给定的属性是否存在验证错误信息。在`@error`指令中，您可以输出`$message`变量以显示错误信息：
~~~php
<!-- /resources/views/post/create.blade.php -->
<label for="title">Post Title</label>
<input id="title" type="text" class="@error('title') is-invalid @enderror">
@error('title')
<div class="alert alert-danger">{{ $message }}</div>
@enderror
~~~
### 关于可选字段的注意事项
默认情况下， 在您的 Laravel 应用的全局中间件堆栈`App\Http\Kernel`类中包含了`TrimStrings`和`ConvertEmptyStringsToNull`中间件。因此，如果您不想让`null`被验证器标识为非法的话，您需要将「可选」字段标志为`nullable`：
~~~php
$request->validate([
'title' => 'required|unique:posts|max:255',
'body' => 'required',
'publish_at' => 'nullable|date',
]);
~~~
在上述例子中，我们指定了`publish_at`字段可以是空的或者是一个有效的日期格式。如果`nullable`修饰词没有被添加到规则定义中，验证器会将`null`视为无效的日期格式。
#### AJAX 请求和验证
在上述例子中，我们使用传统的表单发送数据到应用。当然，许多应用可能使用 AJAX 来进行请求，此时， Laravel 不会生成重定向响应。取而代之的， Laravel 将会生成一个包含错误信息的 JSON 响应，该响应的 HTTP 状态码将被置为 422 。
## 按条件增加规则
#### 字段包含特定值跳过验证
如果另一个字段具有给定的值，您可能偶尔希望不验证给定字段。您可以使用`exclude_if`验证规则来实现这一点。在本例中，如果`has_appointment`字段的值为`false`，则不会验证`appointment_date`和`doctor_name`字段:
~~~php
$v = Validator::make($data, [
'has_appointment' => 'required|bool',
'appointment_date' => 'exclude_if:has_appointment,false|required|date',
'doctor_name' => 'exclude_if:has_appointment,false|required|string',
]);
~~~
您可以使用`exclude_unless`规则来验证给定字段，除非另一个字段具有给定的值:
~~~php
$v = Validator::make($data, [
'has_appointment' => 'required|bool',
'appointment_date' => 'exclude_unless:has_appointment,true|required|date',
'doctor_name' => 'exclude_unless:has_appointment,true|required|string',
]);
~~~
#### 存在时则验证
在某些情况下，你可能希望将要验证的字段存在于输入数组中时，才对该字段执行验证。可以在规则列表中增加`sometimes`来实现：
~~~php
$v = Validator::make($data, [
'email' => 'sometimes|required|email',
]);
~~~
在上面的例子中，`email`字段只有在`$data`数组中存在时才会被验证。
> 技巧：如果你尝试验证应该始终存在但可能为空的字段，请查阅[可选字段的注意事项](https://learnku.com/docs/laravel/8.x/validation/9374#a-note-on-optional-fields)
#### 复杂条件验证
有时候你可能需要增加基于更复杂的条件逻辑的验证规则。例如，你可以希望某个指定字段在另一个字段的值超过 100 时才为必填。或者当某个指定字段存在时，另外两个字段才能具有给定的值。增加这样的验证条件并不难。首先，使用 静态规则 创建一个`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`的一个实例，可用于访问输入和文件。
## 验证数组
验证表单的输入为数组的字段也不再难了。 你可以使用「点」方法来验证数组中的属性。例如， 如果传入的 HTTP 请求中包含`photos[profile]`字段，可以如下验证：
~~~php
$validator = Validator::make($request->all(), [
'photos.profile' => 'required|image',
]);
~~~
我们还可以验证数组的每个元素。 例如，要验证给定数组输入中每个`email`是否是唯一的，可以这么做：
~~~php
$validator = Validator::make($request->all(), [
'person.*.email' => 'email|unique:users',
'person.*.first_name' => 'required_with:person.*.last_name',
]);
~~~
类似地，在语言文件中你也可以使用`*`字符指定验证消息，从而可以使用单个验证消息定义基于数组字段的验证规则：
~~~php
'custom' => [
'person.*.email' => [
'unique' => 'Each person must have a unique e-mail address',
]
],
~~~
- 在线文档收集
- 路由组
- 控制器
- 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 框架的底层运行原理！！！