HTTP层 —— 响应

1、创建响应

字符串&数组

所有路由和控制器都会返回一个被发送到用户浏览器的响应,Laravel 提供了多种不同的方式来返回响应,最基本的响应就是从路由或控制器返回一个简单的字符串,框架会将这个字符串转化为一个完整的HTTP响应:

Route::get(‘/‘, function () {
    return ‘Hello World‘;
});

除了从路由或控制器返回字符串之外,还可以返回数组。框架会自动将数组转化为一个JSON响应:

Route::get(‘/‘, function () {
    return [1, 2, 3];
});

注:你知道还可以从路由或控制器返回Eloquent集合吗?这也会被自动转化为JSON,试一试吧。

Response 对象

通常,我们并不只是从路由动作简单返回字符串和数组,大多数情况下,都会返回一个完整的 Illuminate\Http\Response 实例或视图

返回一个完整的 Response 实例允许你自定义响应的 HTTP 状态码和头信息。Response 实例继承自Symfony\Component\HttpFoundation\Response 类,该类提供了一系列方法用于创建 HTTP 响应:

Route::get(‘home‘, function () {
    return response(‘Hello World‘, $status)
        ->header(‘Content-Type‘, $value);
});

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

添加响应头

大部分响应方法都是可以以方法链形式调用的,从而可以平滑地构建响应(流接口模式)。例如,在发送响应给用户前可以使用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‘,
    ]);
添加 Cookie 到响应

使用响应实例上的 cookie 方法可以轻松添加 Cookie 到响应:

return response($content)
    ->header(‘Content-Type‘, $type)
    ->cookie(‘name‘, ‘value‘, $minutes);

cookie 方法还可以接收更多使用频率较低的额外可选参数,一般来说,这些参数和PHP原生提供的setcookie方法目的和意义差不多:

->cookie($name, $value, $minutes, $path, $domain, $secure, $httpOnly)
Cookie & 加密

默认情况下,Laravel 框架生成的 Cookie 都经过了加密和签名,以免在客户端被篡改。如果你想要让特定的 Cookie 子集在生成时取消加密,可以使用app/Http/Middleware目录下的中间件  App\Http\Middleware\EncryptCookies 提供的 $except 属性来排除这些 Cookie:

/**
 * 不需要被加密的cookies名称
 *
 * @var array
 */
protected $except = [
    ‘cookie_name‘,
];
2、重定向

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

Route::get(‘dashboard‘, function () {
    return redirect(‘home/dashboard‘);
});

有时候你想要将用户重定向到上一个请求的位置,比如,表单提交后,验证不通过,你就可以使用辅助函数 back 返回到前一个 URL(使用该方法之前确保路由使用了 web 中间件组或者都使用了 session 中间件):

Route::post(‘user/profile‘, function () {
    // 验证请求...
    return back()->withInput();
});
重定向到命名路由

如果调用不带参数的 redirect 方法,会返回一个 Illuminate\Routing\Redirector 实例,然后就可以调用Redirector实例上的所有方法。例如,要生成一个  RedirectResponse 到命名路由,可以使用 route 方法:

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

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

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

通过Eloquent模型填充参数

如果要重定向到带 ID 参数的路由( Eloquent 模型绑定 ),可以传递模型本身,ID 会被自动解析出来:

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

如果你想要自定义这个路由参数中的默认值(默认是id),需要重写模型实例上的getRouteKey方法:

/**
 * Get the value of the model‘s route key.
 *
 * @return mixed
 */
public function getRouteKey()
{
    return $this->slug;
}
重定向到控制器动作

你还可以生成重定向到控制器动作,只需简单传递控制器和动作名到 action 方法即可。记住,你不需要指定控制器的完整命名空间,因为 Laravel 的  RouteServiceProvider 将会自动设置默认的控制器命名空间:

return redirect()->action(‘[email protected]‘);

当然,如果控制器路由要求参数,你可以将参数作为第二个参数传递给 action 方法:

return redirect()->action(‘[email protected]‘, [‘id‘=>1]);
带一次性 Session 数据的重定向

重定向到一个新的 URL 并将数据存储到一次性 Session 中通常是同时完成的,为了方便,可以创建一个RedirectResponse 实例然后在同一个方法链上将数据存储到 Session,这种方式在 action 之后存储状态信息时特别方便:

Route::post(‘user/profile‘, function () {
    // 更新用户属性...
    return redirect(‘dashboard‘)->with(‘status‘, ‘Profile updated!‘);
});

当然,用户重定向到新页面之后,你可以从 Session 中取出并显示这些一次性信息,例如,使用 Blade 语法实现如下:

@if (session(‘status‘))
    <div class="alert alert-success">
        {{ session(‘status‘) }}
    </div>
@endif
3、其它响应类型

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

视图响应

如果你需要控制响应状态和响应头,并且还需要返回一个视图作为响应内容,可以使用 view 方法:

return response()->view(‘hello‘, $data, 200)->header(‘Content-Type‘, $type);

当然,如果你不需要传递自定义的 HTTP 状态码和头信息,只需要简单使用全局辅助函数 view 即可。

JSON响应

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

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

如果你想要创建一个 JSONP 响应,可以在 json 方法之后调用 setCallback 方法:

return response()->json([‘name‘ => ‘Abigail‘, ‘state‘ => ‘CA‘])
    ->withCallback($request->input(‘callback‘));
文件下载

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

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

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

文件响应

file方法可用于直接在用户浏览器显示文件,例如图片或PDF,而不需要下载,该方法接收文件路径作为第一个参数,头信息数组作为第二个参数:

return response()->file($pathToFile);
return response()->file($pathToFile, $headers);
4、响应宏

如果你想要定义一个自定义的可以在多个路由和控制器中复用的响应,可以使用 Response 门面上的  macro 方法。

例如,在某个服务提供者的 boot 方法中编写代码如下:

<?php

namespace App\Providers;

use Response;
use Illuminate\Support\ServiceProvider;

class ResponseMacroServiceProvider extends ServiceProvider
{
    /**
     * Perform post-registration booting of services.
     *
     * @return void
     */
    public function boot()
    {
        Response::macro(‘caps‘, function ($value) {
            return Response::make(strtoupper($value));
        });
    }
}

macro 方法接收响应名称作为第一个参数,闭包函数作为第二个参数,macro 的闭包在 ResponseFactory 实现类或辅助函数 response 中调用 macro 名称的时候被执行:

return response()->caps(‘foo‘);

时间: 2024-10-29 19:07:32

HTTP层 —— 响应的相关文章

前端资源教程合集

综合类 前端知识体系 前端知识结构 Web前端开发大系概览 Web前端开发大系概览-中文版 Web Front-end Stack v2.2 En类资源汇总 免费的编程中文书籍索引 前端书籍 前端免费书籍大全 前端知识体系 免费的编程中文书籍索引 智能社 - 精通JavaScript开发 重新介绍 JavaScript(JS 教程) 麻省理工学院公开课:计算机科学及编程导论 JavaScript中的this陷阱的最全收集--没有之一 JS函数式编程指南 JavaScript Promise迷你书

前端涉及的所有知识体系

资源教程: 综合类 前端知识体系 前端知识结构 Web前端开发大系概览 Web前端开发大系概览-中文版 Web Front-end Stack v2.2 免费的编程中文书籍索引 前端书籍 前端免费书籍大全 前端知识体系 免费的编程中文书籍索引 智能社 - 精通JavaScript开发 重新介绍 JavaScript(JS 教程) 麻省理工学院公开课:计算机科学及编程导论 JavaScript中的this陷阱的最全收集--没有之一 JS函数式编程指南 JavaScript Promise迷你书(中

【CSS进阶】伪元素的妙用2 - 多列均匀布局及title属性效果

最近无论是工作还是自我学习提升都很忙,面对长篇大论的博文总是心有余而力不足,但又不断的接触学习到零碎的但是很有意义的知识点,很想分享给大家,所以本篇可能会很短. 本篇接我另一篇讲述 CSS 伪元素的文章: [CSS进阶]伪元素的妙用–单标签之美,看完本文觉得有意思的可以再去看看上一篇,分享了一些伪元素的妙用. 正文从这里开始: 哪些标签不支持伪元素? 我也是才知道这个姿势.为了不误导读者,就赶紧补充一下. 伪元素虽然强大,但是还是有一些特定的标签是不支持伪元素 before 和 after 的.

《Unity_API解析》 第二章(上) Camera类实例属性

aspect属性:设置摄像机视口比例 public float aspect{ get ; set; } 功能说明:此属性用于获取或设置Camera视口的宽高比例值. cameraToWorldMatrix属性:变换矩阵 public Matrix4x4 cameraToWorldMatrix{ get; } 功能说明:此属性的功能是返回从摄像机的局部坐标系到世界坐标系的变化矩阵. Camera中的forward方向为其自身坐标系的-z轴方向,一般其他对象的forward方向为自身坐标系的z轴方

自组织特征映射神经网络(SOFM)

1981年芬兰 Helsink 大学的 T·Kohonen 教授提出一种自组织特征映射网 (Self-Organizing Feature Map , SOFM ), 又称 Kohonen 网 . Kohonen 认为 ,一个神经网络接受外界输入模式时, 将会分为不同的对应区域, 各区域对输入模式具有不同的响应特征,而且这个过程是自动完成的. 自组织特征映射正是根据这一看法提出来的 ,其特点与人脑的自组织特性相类似. 一.SOFM网生物学基础 生物学研究表明,在人脑感觉通道上,神经元的组织原理是

asp.net 三层架构图文详解

什么是三层架构? 先说说饭店中的三层结构 服务员:待客/提交菜单 厨 师:取材/炒菜/交菜 采购员:采购 三层结构分析 (1)表示层 为用户提供交互式操作界面. (2)业务逻辑层 负责关键业务的处理,负责与表示层和数据访问层的数据传递. (3)数据访问层 实现对数据的保存和读取操作. 三层结构各层间的依整关系 -----高层依赖低层 三层结构各层间的数据传递关系 ---高层请求低层.低层响应高层 三层结构搭建方法 1.搭建表示层(创建一个Windows应用程序) 2.搭建业务逻辑层(类库) 3.

残差网络resnet学习

Deep Residual Learning for Image Recognition 微软亚洲研究院的何凯明等人 论文地址 https://arxiv.org/pdf/1512.03385v1.pdf Abstract 更深层次的神经网络训练更加困难.我们提出一个 Residual的学习框架来缓解训练的网比之前所使用的网络深得多.我们提供全面的经验证据显示这些残余网络更容易优化,并可以从显着增加的深度获得准确性.在ImageNet数据集上我们评估深度达152层残留网比VGG网[41]更深,但

前端知识体系2

Raw Blame History 1226 lines (983 sloc) 67.4 KB QQ联盟群交流(492107297)群规 GITHUB在线地址 http://t.cn/RL2NtqX 看云在线地址 http://t.cn/RUdaGHn 这是我们联盟群的组织结构,加入等级参考JS高级前端开发群加群说明. 这本来是我QQ群内部的一份公共约定的日常交流规则,后来得到大伙的一致认可,并用实际行动来捍卫它,使我倍受感动. 后来想:传播使爱更有力量,阅读使内心更为坚强,沉淀使生活更为醇香,

前端资料QQ群交流

转:https://github.com/jsfront/src/blob/master/qq.md 这本来是我QQ群内部的一份公共约定的日常交流规则,后来得到大伙的一致认可,并用实际行动来捍卫它,使我倍受感动. 后来想:传播使爱更有力量,阅读使内心更为坚强,沉淀使生活更为醇香,分享使人更为谦卑或快乐.因为快乐,所以分享. 知识资源来源于互联网,应该返回给互联网,使看到的每一个人受益,也可以供其它各个行业的群主参考. 规则会不断的修改调整,你不在是一个受益者,更是一个项目参与者内容规则的创造者,