1、Response篇
1.1 基本响应
最基本的HTTP响应只需在路由闭包或控制器动作中返回一个简单字符串即可,但是具体业务逻辑中大部分响应都是在控制器动作中返回Response实例或者视图。Response是继承自 Symfony\Component\HttpFoundation\Response
的 Illuminate\Http\Response
类的一个实例,我们可以使用该实例上的一系列方法来创建HTTP响应:
use Illuminate\Http\Response; Route::get('testResponse',function(){ $content = 'Hello LaravelAcademy!'; $status = 200; $value = 'text/html;charset=utf-8'; return (new Response($content,$status))->header('Content-Type',$value); });
在浏览器中访问,F12查看响应头信息(Chrome浏览器):
如果我们尝试修改$status=500
,则头信息如下:
为方便使用,我们还可以使用全局帮助函数response
来替代生成Response对象实例:
Route::get('testResponse',function(){ $content = 'Hello LaravelAcademy!'; $status = 500; $value = 'text/html;charset=utf-8'; return response($content,$status)->header('Content-Type',$value); });
效果一样。以后我们将默认使用这种方式,不再生成Response对象实例。
此外,需要注意的是,Illuminate\Http\Response
类中还使用了ResponseTrait
,header
方法正是该trait提供的,除了header
之外,该trait还提供了withCookie
、content
和status
方法。header
方法用于设置响应头信息,withCookie
方法用于添加cookie,这两个方法都会返回调用它的Response自身对象,所以这两个方法都支持方法链(即多次调用header
或withCookie
方法);而content
和status
方法则用于返回当前响应的响应实体内容和响应状态码。
1.2 添加Cookie
正如上面提到的,我们使用withCookie
方法为响应添加cookie,由于header
和withCookie
支持方法链,所以我们可以这样使用:
Route::get('testResponseCookie',function(){ $content = 'Hello LaravelAcademy!'; $status = 200; $value = 'text/html;charset=utf-8'; return response($content,$status)->header('Content-Type',$value) ->withCookie('site','LaravelAcademy.org'); });
在浏览器中访问,F12查看Cookie信息:
我们还可以使用该cookie的有效期、作用域等信息:
Route::get('testResponseCookie',function(){ $content = 'Hello LaravelAcademy!'; $status = 200; $value = 'text/html;charset=utf-8'; //设置cookie有效期为30分钟,作用路径为应用根目录,作用域名为laravel.app return response($content,$status)->header('Content-Type',$value) ->withCookie('site','LaravelAcademy.org',30,'/','laravel.app'); });
注:
withCookie
方法实际上是调用了全局帮助函数cookie
生成cookie,然后将cookie放到响应头中。
再次在浏览器中访问,F12查看cookie信息如下:
里面多出了有效期及作用域名等相关信息。
此外,我们还关注到该cookie是经过加密的,这一点我们在前面已经提到过,这是为了安全性考虑,如果要取消加密,在app/Http/Middleware/EncryptCookies.php
文件中将对应的cookie名添加到EncryptCookies
类属性$except
中即可:
<?php namespace App\Http\Middleware; use Illuminate\Cookie\Middleware\EncryptCookies as BaseEncrypter; class EncryptCookies extends BaseEncrypter { /** * 不被加密的cookie名 * * @var array */ protected $except = [ 'site' ]; }
再次在浏览器中访问http://laravel.app:8000/testResponseCookie
,F12查看Cookie信息如下:
当然,为了安全起见,我们不建议这么做。
2、ResponseFactory篇
response
函数如果不传入参数会返回 Illuminate\Contracts\Routing\ResponseFactory
契约的实现——Illuminate\Routing\ResponseFactory
,该类中提供了多个方法用来生成更加丰富的响应类型,比如视图响应、JSON响应、文件下载等等。
2.1 视图响应
使用view
方法即可返回一个视图作为响应内容:
Route::get('testResponseView',function(){ $value = 'text/html;charset=utf-8'; return response()->view('hello',['message'=>'Hello LaravelAcademy']) ->header('Content-Type',$value); });
与之对应的,我们需要在resources/views
下新建一个视图文件hello.blade.php
,其内容如下:
{{$message}}
接下来我们在浏览器中访问http://laravel.app:8000/testResponseView
,页面输出:
Hello LaravelAcademy
还可以再简化,如果我们不需要自定义HTTP响应头,还可以直接使用全局帮助函数view
:
Route::get('testResponseView',function(){ $value = 'text/html;charset=utf-8'; return view('hello',['message'=>'Hello LaravelAcademy'])); });
效果和上面一样。
2.2 返回JSON/JSONP
还可以使用json
方法返回json格式数据:
Route::get('testResponseJson',function(){ return response()->json(['name'=>'LaravelAcademy','passwd'=>'LaravelAcademy.org']); });
在浏览器中访问,F12查看响应头信息:
根据输出信息可见,json
方法会自动设置Content-Type
为application/json
,并调用PHP内置函数json_encode
讲数组转化为json格式字符串。
如果返回的是JSONP响应,也很简单,只需要在json
后面再调用setCallback
即可:
Route::get('testResponseJson',function(){ return response()->json(['name'=>'LaravelAcademy','passwd'=>'LaravelAcademy.org']) ->setCallback(request()->input('callback')); });
2.3 文件下载
使用download
方法可生成用于下载给定路径文件的响应,这里我们下载上一节上传的文件:
Route::get('testResponseDownload',function(){ return response()->download( realpath(base_path('public/images')).'/laravel-5-1.jpg', 'Laravel学院.jpg' ); });
在浏览器中访问http://laravel.app:8000/testResponseDownload
,页面将会下载laravel-5-1.jpg
文件并保存为Laravel学院.jpg
。
3、 RedirectResponse篇
重定向响应是 Illuminate\Http\RedirectResponse
类的实例,我们通常使用全局帮助函数redirect
来生成 RedirectResponse
实例。和response
类似,redirect
函数如果接收参数则调用的是Illuminate\Routing\Redirector
类的to
方法,如果无参调用则返回的是Redirector
对象实例。
3.1 基本重定向
Route::get('dashboard', function () { return redirect('home/dashboard'); });
如果要重定向到上一个位置,则使用back
方法:
Route::post('user/profile', function () { // 验证请求... return back()->withInput(); });
3.2 重定向到命名路由
使用route
方法重定向到命名路由:
Route::get('/hello/laravelacademy',['as'=>'academy',function(){ return 'Hello LaravelAcademy'; }]); Route::get('testResponseRedirect',function(){ return redirect()->route('academy'); });
在浏览器中访问http://laravel.app:8000/testResponseRedirect
,页面会跳转到http://laravel.app:8000/hello/laravelacademy
并输出:
Hello LaravelAcademy
如果命名路由中有参数,那么我们可以在route
中传入参数:
Route::get('/hello/laravelacademy/{id}',['as'=>'academy',function($id){ return 'Hello LaravelAcademy '.$id; }]); Route::get('testResponseRedirect',function(){ return redirect()->route('academy',100); });
在浏览器中访问http://laravel.app:8000/testResponseRedirect
,页面会跳转到http://laravel.app:8000/hello/laravelacademy/100
并输出:
Hello LaravelAcademy 100
3.3 重定向到控制器动作
使用action
方法重定向到控制器动作:
Route::resource('post','PostController'); Route::get('testResponseRedirect',function(){ return redirect()->action('PostController@index'); });
在浏览器中访问http://laravel.app:8000/testResponseRedirect
,则页面会跳转到http://laravel.app:8000/post
并输出对应内容。
当然也可以传递参数到action
方法:
Route::get('testResponseRedirect',function(){ return redirect()->action('PostController@show',[1]); });
3.4 带一次性Session数据的重定向
使用with
方法可以携带一次性session数据到重定向请求页面(一次性session数据即使用后立即销毁的session数据项):
Route::post('user/profile', function () { // 更新用户属性... return redirect('dashboard')->with('status', 'Profile updated!'); });
这种特性通常在提交表单验证失败返回错误信息时很有用。
学院君,在本章的《2.1 视图响应》倒数第二行代码,多了一个“)”吧return view(‘hello’,[‘message’=>’Hello LaravelAcademy’]));改为:return view(‘hello’,[‘message’=>’Hello LaravelAcademy’]);
return response()->download($path);里面这个$path 可以是url么?
请问下 学院君。Storage::put($dir . $name, $body)通过Storage写入的文件,可以通过 get 获取.那怎么得到他的绝对路径啊..翻了半天似乎都没有找到这个命令..因为 return response()->download( 这里需要文件的绝对路径 , 这是文件名 );
有很多辅助函数可调用:http://laravelacademy.org/post/3230.html#ipt_kb_toc_3230_21
return response()->download( realpath($dir.$name), ‘a/ddd’ );常见的 * ? | 等等 都可以替换为 -为什么 / 不替换为 -请问..下为什么~~哈哈~~不知道算不算BUG?.The filename and the fallback cannot contain the “/” and “” characters.
文件名里面肯定不能包含/或这种符号 这些都是文件夹分隔符
我知道,我是说为什么他不把 / 也一同替换为 – 这是出于什么鬼原因~~
文件下载需要开启php.ini 的 php_fileinfo 模块 否则会报错:
Unable to guess the mime type as no guessers are available (Did you enable the php_fileinfo extension?)
这个我还没注意到 估计是我的PHP版本都默认开启了这个扩展
我没有做取消加密操作,但是我的Cookie没有加密是什么情况
你设置APP_KEY了吗
我的也是这样,貌似 route里面设置的 Cookie都不会加密,控制器里面的会加密,已经设置了App_key
`->setCallback($request->input(‘callback’));`
改为:
`->setCallback(request()->input(‘callback’));`
才不会报错,否则会报$request 未定义错误。
恩 我疏忽了 已修正