laravel 入门（5）获取请求

注入请求对象#

在 Laravel 中，访问用户输入数据最常用的方式，就是通过注入到控制器方法中的 Illuminate\Http\Request 对象实例，通过该实例，我们可以访问所有用户请求数据，不管是什么方式，什么格式：

Copy Highlighter-hljs
<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class RequestController extends Controller
{
    public function form(Request $request)
    {
        // 通过 $request 实例获取请求数据
    }
}

然后在路由文件中定义一个指向该控制器方法的路由

Copy Highlighter-hljs
Route::post('form', 'RequestController@form');

注：除此之外，Laravel 还提供了 Request 门面和全局辅助函数 request()，本质都是调用 Illuminate\Http\Request 对象实例，只不过形式不一样而已，所以我一般就是用 Request 对象实例。

接下来，我们就可以在控制器方法中通过 $request 对象实例获取用户请求了，Request 类提供了多种方法来访问用户请求数据。

获取用户请求数据#

获取所有请求数据#

我们可以通过 $request->all() 获取所有请求数据：

Copy Highlighter-hljs
public function form(Request $request)
{
    // 通过 $request 实例获取请求数据
    dd($request->all());
}

只获取部分请求数据#

如果只想获取部分请求数据，可以通过 $request 实例上的 except 或 only 方法，这两个方法是相反的，一个用于排除指定字段，一个用于获取指定字段：

Copy Highlighter-hljs
$request->except('id');
$request->only(['name', 'site', 'domain']);

判断是否包含指定字段#

除此之外，我们还可以通过 $request 实例上的 has 或 exists 方法判断某个字段是否存在：

Copy Highlighter-hljs
$id = $request->has('id') ? $request->get('id') : 0;

exists 方法是 has 方法的别名，两者调用方式一样，功能完全等效。

获取指定请求字段值#

上面我们已经给出了获取指定字段值的一个方法 get，该方法只能获取通过 GET 请求传递的参数，同理，如果是 POST 请求的话，我们可以通过 post 方法获取对应字段值，此次之外，我们还可以通过 input 方法值，该方法可以从所有请求方式中获取给定字段的值，所以更加通用：

Copy Highlighter-hljs
$id = $request->input('id');
$name = $request->input('name');

我们还可以为 input 方法传递第二个参数作为默认值，如果请求字段为空的话，则使用该默认值：

Copy Highlighter-hljs
$site = $request->input('site', 'Laravel学院');

获取数组输入字段值#

有的时候，我们在表单中传递给后端的可能是一个数组，比如一些复选框选中项，这些表单输入框的 name 值通常是 name[]，如 books[]，这个时候传递到后端的 books 数据就是数组格式
我们可以通过「.」来分别获取每个数组元素：

Copy Highlighter-hljs
$request->input('books.0');
$request->input('books.1');

甚至还支持更深层级的嵌套：

Copy Highlighter-hljs
dump($request->input('books.0.author'));
dump($request->input('books.1'));

获取 JSON 输入字段值#

随着基于 JavaScript 的单页面应用（SPA）应用的流行，除了传统表单请求提交的 POST/GET 数据之外，JSON 格式的请求数据也越来越常见，Laravel 支持对 JSON 格式请求数据的处理

获取 JSON 请求数据中的字段值和正常表单请求并无二致：

Copy Highlighter-hljs
dump($request->input('site'));
dump($request->input('books.0.author'));
dump($request->input('books.1'));

所以说，$request->input() 确实足够智能，无愧于「获取任何请求输入字段值」的称号。

注：需要注意的是，如果发起 POST 请求提交 JSON 格式请求数据时，请求头没有设置为 application/json 的话，$request->input() 方法将不会以 JSON 格式解析数据。这个时候，我们需要显式地通过 $request->json() 来获取 JSON 格式数据。

获取路由参数值#

除了 URL 查询字符串以及表单提交数据之外，你可能会忽视还有一种形式的输入参数，就是路由参数，我们一般显式将其作为控制器方法参数或者定义路由的匿名函数参数传入，以便在代码中获取。作为定义路由的匿名函数参数之间已经见过很多了，这里我们来演示下作为控制器方法参数传入，以及如何通过 Request 对象实例获取。

首先改写 /form 路由定义如下：

Copy Highlighter-hljs
Route::post('form/{id}', 'RequestController@form');

然后我们在对应控制器方法中传入这个路由参数（要放到 $request 注入参数后面）：

Copy Highlighter-hljs
public function form(Request $request, $id)
{
    // ...
}

这样，我们就可以在控制器方法中使用这个 $id 参数了，它的值会随着路由参数值传递过来。除此之外，我们还可以通过 $request->segment() 方法获取 $id 的值：

Copy Highlighter-hljs
dump($request->segments());
dump($id == $request->segment(2));  # 索引基数从1开始

我们通过 $request->segments() 可以看到 $id 对应索引值，然后将该索引值+1传入 $request->segment() 函数即可获取到路由参数 $id 的值。