HTTP响应

---

1、基本响应

所有路由和控制器都会返回某种被发送到用户浏览器的响应，Lumen提供了多种不同的方式来返回响应，最基本的响应就是从路由或控制器返回一个简单的字符串：

$app->get('/', function () {
    return 'Hello World';
});

给定的字符串会被框架自动转化为HTTP响应。

响应对象

但是大多数路由和控制器动作都会返回一个完整的Illuminate\Http\Response实例，返回一个完整的Response实例允许你自定义响应的HTTP状态码和头信息，Response实例继承自Symfony\Component\HttpFoundation\Response类，该类提供了一系列方法用于创建HTTP响应：

use Illuminate\Http\Response;

$app->get('home', function () {
    return (new Response($content, $status))
        ->header('Content-Type', $value);
});

为方便起见，还可以使用辅助函数response：

$app->get('home', function () {
    return response($content, $status)
        ->header('Content-Type', $value);
});

注：查看完整的Response方法列表，请移步相应的API文档以及Symfony AP文档

添加响应头到响应

大部分响应方法都是可以链式调用的，从而使得可以平滑的构建响应。例如，可以使用header方法来添加一系列响应头：

return response($content)
    ->header('Content-Type', $type)
    ->header('X-Header-One', 'Header Value')
    ->header('X-Header-Two', 'Header Value');

或者，你可以使用 withHeaders 方法来指定添加到响应的数组头：

return response($content)
    ->withHeaders([
        'Content-Type' => $type,
        'X-Header-One' => 'Header Value',
        'X-Header-Two' => 'Header Value',
    ]);

2、其它响应类型

辅助函数response可以用来方便地生成其他类型的响应实例，当无参数调用response时会返回Illuminate\Contracts\Routing\ResponseFactory契约的一个实现，该契约提供了一些有用的方法来生成响应。

JSON响应

json方法会自动将Content-Type头设置为application/json，并使用PHP函数json_encode方法将给定数组转化为JSON：

return response()->json(['name' => 'Abigail', 'state' => 'CA']);

还可以提供状态码和额外头数据数组：

return response()->json(['error' => 'Unauthorized'], 401, ['X-Header-One' => 'Header Value']);

如果你想要创建一个JSONP响应，可是添加setCallback到json方法后面：

return response()->json(['name' => 'Abigail', 'state' => 'CA'])
                 ->setCallback($request->input('callback'));

文件下载

download方法用于生成强制用户浏览器下载给定路径文件的响应。download方法接受文件名作为第二个参数，该参数决定用户下载文件的显示名称，你还可以将HTTP头信息作为第三个参数传递到该方法：

return response()->download($pathToFile);
return response()->download($pathToFile, $name, $headers);

注：管理文件下载的Symfony HttpFoundation类要求被下载文件有一个ASCII文件名。

3、重定向

重定向响应是Illuminate\Http\RedirectResponse类的实例，其中包含了必须的头信息将用户重定向到另一个URL，有很多方式来生成RedirectResponse实例，最简单的方法就是使用全局辅助函数redirect：

$app->get('dashboard', function () {
    return redirect('home/dashboard');
});

重定向到命名路由

如果调用不带参数的redirect方法，会返回一个Illuminate\Routing\Redirector实例，从而可以调用该实例上的任何方法。比如，为了生成一个RedirectResponse到命名路由，可以使用route方法：

return redirect()->route('login');

如果路由中有参数，可以将其作为第二个参数传递到route方法：

// For a route with the following URI: profile/{id}
return redirect()->route('profile', [1]);

如果要重定向到带ID参数的路由，并从Eloquent模型中取数据填充表单，可以传递模型本身，ID会被自动解析出来：

return redirect()->route('profile', [$user]);