CPU|3分钟短文：Laravel请求对象方法极多，可不是花拳绣腿刘海屏

引言
web服务无外乎两点，一个是请求，一个是相应。中间经过一系列的处理，我们是为一个sandbox 。无论是请求Request ，还是响应Response ，每个框架都会浓墨重彩地进行深度设计。

本文我们来说一下laravel的请求对象。
代码时间
一个网络请求在到达应用程序之前，经历了http的路由匹配，握手连接，数据发送等等或简单，或复杂的步骤。也同样有多重请求方式，如GET POST PUT OPTION DELETE 等等标准协议里的内容。
laravel提供了一个助手函数request() ，暴露了一个上下文的 Request 对象可全局操作。我们本文重点说说用于的请求数据。
比如有一条路由，我们这样便捷地定义：
Route::post('form' function (Illuminate\\Http\\Request $request) {
// $request->input());

【CPU|3分钟短文：Laravel请求对象方法极多，可不是花拳绣腿】在匿名函数中，使用强制类型Request进行注入，变量$request就是一个实例化后的Request对象，可以访问其属性和方法。
为了演示表单数据的提交，我们构建一个表单：
<form method=\"post\" action=\"/post-route?utm=12345\">
{{ csrf_field()
<input type=\"text\" name=\"firstName\">
<input type=\"submit\"></form>

在此之前先定义路由，初步把请求体的数据全部打印出来：
Route::post('/post-route' function (Request $request) {
var_dump($request->all()););

调用请求Request的all方法，返回所有字段的值，并格式化为数组，输出内容类似于
[
'_token' => 'CSRF token here'
'firstName' => 'value'
'utm' => 12345

其中要注意的是，为了显示区别， utm参数是querystring内传送的，而firstName字段，是表单内通过POST方法传送的。两者的请求方法不一样。
那么对于用于csrf拦截的字段_token ，系统生成，系统自检，我们在表单中并不使用，可以使用 except 方法将其排除在外。路由内这样做：
Route::post('/post-route' function (Request $request) {
var_dump($request->except('_token')););

那么返回数组中，就不会展示 _token 字段了。这类似与黑名单的功能。相对应地使用白名单，手动指定哪些字段需要展示。需要调用 only 方法：
Route::post('/post-route' function (Request $request) {
var_dump($request->only(['firstName' 'utm'
)););

对于单个字段，如何判断是否存在呢？有两个方法，一个是has() ，一个是exists() 。这两者是有细微区别的， has方法要求键名存在，且数值不为空；exists方法仅要求键名存在。
if ($request->has('invalid_key')) {

比如上方的代码键名不存在，所以返回 false 。如果表单字段 firstName 不填任何值，也即是空字符串。
$request->has('firstName'); // false$request->exists('firstName'); // true

所以对于大多数的场景，我们其实是在判断是否存在键名，对值并未判断，所以exists方法更为合适。
上述的all方法返回所有字段的值，如果用于单一字段值的获取，要使用input()方法：
Route::post('/post-route' function (Request $request) {
$userName = $request->input('name' 'anonymous'););

第二个参数是指定如果键名不存在时的默认值。
有了input方法，我们来看更复杂的表单提交数组数据的处理办法。首先构造一个表单，并提交数组数据：
<form method=\"post\" action=\"/post-route\">
{{ csrf_field()
<input type=\"text\" name=\"employees[0
[firstName
\">
<input type=\"text\" name=\"employees[0
[lastName
\">
<input type=\"text\" name=\"employees[1
[firstName
\">
<input type=\"text\" name=\"employees[1
[lastName
\">
<input type=\"submit\"></form>

这样的表单真是shit对不对，可是框架需要满足这样的需求。处理起来也没问题。PHP就是最为擅长处理数组，所以轻快。 laravel对请求体进行数组操作，还有更高阶的用法，下面是示例：
Route::post('/post-route' function (Request $request) {
$employeeZeroFirstName = $request->input('employees.0.firstName');
$allLastNames = $request->input('employees.*.lastName');
$employeeOne = $request->input('employees.1'););

我们可以使用明确的键名进行访问，也可以使用通配符进行匹配。上面的方法返回值如下，大家看看不同的写法，输出会有不同。
假设4个输入框传入的值分别是\"Jim\" \"Smith\" \"Bob\" \"Jones\" ，那么打印如下：
$employeeZeroFirstName = 'Jim';$allLastNames = ['Smith' 'Jones'
;$employeeOne = ['firstName' => 'Bob' 'lastName' => 'Jones'
;

laravel按照数组的层级，完整地返回了。整个数组结构大致如下：
[
'employees' => [
0 => [
'firstName' => 'Jim'
'lastName' => 'Smith'

1 => [
'firstName' => 'Bob'
'lastName' => 'Jones'

只不过在访问的时候，使用点的方法；也可以使用通配符进行键名匹配。非常灵活。
写在最后
本文通过示例演示了laravel Request请求常用的方法获取表单数据，最重要也用的最少的数组数据的解析，可以加深大家对于表单数据处理的逻辑。
Happy coding :-)