Laravel Http层 响应

1、创建响应

所有路由和控制器都会返回一个被发送到用户浏览器的响应,Laravel 提供了多种不同的方式来返回响应。

字符串 & 数组
最基本的响应就是从路由或控制器返回一个简单的字符串,框架会将这个字符串转化为一个完整的 HTTP 响应:

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

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

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

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

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

Route::get('home', function () {
    return response('Hello World', 200)
        ->header('Content-Type', 'text/plain');
});

添加响应头

大部分响应方法都是可以以方法链形式调用的,从而可以平滑地构建响应(流接口模式)。例如,在发送响应给用户前可以使用 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 到响应。例如,你可以使用 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(由于该功能使用了 Session,使用该方法之前确保路由使用了 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方法:

/**
 * 获取模型路由键的值
 *
 * @return mixed
 */
public function getRouteKey(){
 return $this->slug;
}

重定向到控制器动作

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

return redirect()->action('HomeController@index');

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

return redirect()->action('UserController@profile', ['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 Illuminate\Support\Facades\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 方法接收响应名称作为第一个参数,闭包函数作为第二个参数,响应宏的闭包在 ResponseFactory
实现类或辅助函数 response 中调用宏名称的时候被执行:

return response()->caps('foo');
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 201,681评论 5 474
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,710评论 2 377
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 148,623评论 0 334
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,202评论 1 272
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,232评论 5 363
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,368评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,795评论 3 393
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,461评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,647评论 1 295
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,476评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,525评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,226评论 3 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,785评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,857评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,090评论 1 258
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,647评论 2 348
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,215评论 2 341

推荐阅读更多精彩内容