tindak balas

Perisian tengah kawalan cache

Tambah Kuki
Cookies kepada respons
Ubah hala
Ubah hala ke laluan yang dinamakan

Lompat dengan nilai Sesi dipindahkan

http Response

Create Response
Redirect
- 名 Reset ke laluan penamaan
- Kekalkan kepada tingkah laku pengawal
- ubah hala ke nama domain luaran
- ubah hala dan gunakan data memori kilat
Balas balas e
- JSON Response
- Fail Muat Turun
- Fail Response
- Respons Makro

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

Route::get('/', function () { 
   return [1, 2, 3];
 });
{tip} Adakah anda tahu anda juga boleh mengembalikan koleksi Eloquent daripada laluan atau pengawal? Ia juga ditukar secara automatik kepada respons JSON.

IlluminateHttpResponse 实例或视图。

返回完整的 Response 实例允许你自定义响应的 HTTP 状态码和响应头信息。 Response 实例继承自 SymfonyComponentHttpFoundationResponse 类，该类提供了各种构建 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');

或者，你可以使用 withHeadersBiasanya, kami tidak hanya mengembalikan rentetan dan tatasusunan daripada tindakan penghalaan, dalam kebanyakan kes, contoh atau paparan IlluminateHttpResponse yang lengkap dikembalikan.

Mengembalikan contoh Respons lengkap yang membolehkan anda menyesuaikan kod status HTTP dan maklumat pengepala respons bagi respons. Kejadian Response mewarisi daripada kelas SymfonyComponentHttpFoundationResponse, yang menyediakan pelbagai kaedah untuk membina respons HTTP:

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

🎜Tambah pengepala respons🎜🎜Kebanyakan kaedah tindak balas boleh dirantai, menjadikan proses mencipta tika respons lebih mudah dibaca. Sebagai contoh, anda boleh menggunakan kaedah header untuk menambah satu siri maklumat pengepala pada respons sebelum ia dikembalikan kepada pengguna: 🎜

Route::middleware('cache.headers:public;max_age=2628000;etag')->group(function() {  
  Route::get('privacy', function () {      
    // ...   
   });    
Route::get('terms', function () {     
   // ...    
  });
});

🎜 Sebagai alternatif, anda boleh menggunakan withHeader kaedah untuk menentukan bahawa anda ingin menambah Tatasusunan maklumat pengepala pada respons: 🎜

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

🎜🎜🎜🎜🎜🎜

Cache Control Middleware

Laravel mempunyai cache.headers middleware terbina dalam yang boleh digunakan untuk menetapkan maklumat pengepala Cache-Control untuk kumpulan penghalaan dengan cepat. Jika etag diisytiharkan dalam set arahan, Laravel akan secara automatik menetapkan pengecam ETag kepada cincang MD5 kandungan respons: cache.headers 中间件，可以用来快速地为路由组设置 Cache-Control 头信息。如果在指令集中声明了 etag，Laravel 会自动将 ETag 标识符设置为响应内容的 MD5 哈希值：

->cookie($name, $value, $minutes, $path, $domain, $secure, $httpOnly)

添加 Cookies 到响应

你可以使用响应上的 cookie 方法轻松地将为响应增加 Cookies。例如，你可以像这样使用 cookie 方法生成一个 cookie 并轻松地将其附加到响应上：

Cookie::queue(Cookie::make('name', 'value', $minutes));
Cookie::queue('name', 'value', $minutes);

cookie 方法还接受一些不太频繁使用的参数。通常，这些参数与原生 PHP 的 setcookie 方法的参数有着相同的目的和含义：

/**
 * 不需要被加密的cookies名称
 *
 * @var array
 */
 protected $except = [  
   'cookie_name',
  ];

或者，你可以使用 Cookie facade 「队列」， Cookie 以附加到应用程序的传出响应。 queue 方法接受一个 Cookie 实例或创建 Cookie 实例所需的参数。这些 cookie 在发送到浏览器之前会附加到传出响应中：

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

Cookies & 加密

默认情况下，Laravel 生成的所有 Cookie 都是经过加密和签名，因此不能被客户端修改或读取。如果你想要应用程序生成的部分 Cookie 不被加密，那么可以使用在 app/Http/Middleware 目录中 AppHttpMiddlewareEncryptCookies 中间件的 $except 属性：

Route::post('user/profile', function () {  
  //验证请求   
  return back()->withInput();
});

重定向

重定向响应是 IlluminateHttpRedirectResponse 类的实例，并且包含用户需要重定向至另一个 URL 所需的头信息。Laravel 提供了几种方法用于生成 RedirectResponse 实例。其中最简单的方法是使用全局辅助函数 redirect：

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

有时候你可能希望将用户重定向到之前的位置，比如提交的表单无效时。这时你可以使用全局辅助函数 back 来执行此操作。由于这个功能利用了会话控制，请确保调用 back 函数的路由使用 web

// 对于具有以下 URI 的路由: profile/{id}
return redirect()->route('profile', ['id' => 1]);

Tambah Kuki pada respons

Anda boleh menambahkan kuki pada respons dengan mudah menggunakan kaedah cookie pada respons. Sebagai contoh, anda boleh menjana kuki dan melampirkannya dengan mudah pada respons menggunakan kaedah cookie seperti ini: 🎜

//对于具有以下 URI 的路由: profile/{id}
return redirect()->route('profile', [$user]);

🎜 Kaedah cookie juga menerima beberapa parameter yang kurang kerap digunakan . Secara amnya, parameter ini mempunyai tujuan dan makna yang sama seperti parameter kaedah setcookie PHP asli: 🎜

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

🎜 Sebagai alternatif, anda boleh menggunakan fasad Cookie "queue", Cookie untuk menambah respons Keluar pada permohonan itu. Kaedah queue menerima tika Cookie atau parameter yang diperlukan untuk membuat tika Cookie. Kuki ini dilampirkan pada respons keluar sebelum dihantar ke penyemak imbas: 🎜

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

🎜🎜🎜

🎜🎜 Cookies & Penyulitan🎜🎜Secara lalai, semua kuki yang dijana oleh Laravel disulitkan dan ditandatangani dan oleh itu tidak boleh diubah suai atau dibaca oleh pelanggan. Jika anda mahu beberapa kuki yang dijana oleh aplikasi tidak disulitkan, anda boleh menggunakan perisian tengah $except dalam direktori app/Http/Middleware Atribut: 🎜

return redirect()->action(  
  'UserController@profile', ['id' => 1]
 );

🎜🎜🎜

🎜

Redirects

🎜Respons ubah hala ialah

 Satu contoh IlluminateHttpRedirectResponse kelas dan mengandungi maklumat pengepala yang diperlukan untuk mengubah hala pengguna ke URL lain. Laravel menyediakan beberapa kaedah untuk menjana contoh RedirectResponse. Kaedah paling mudah ialah menggunakan fungsi pembantu global ubah hala

: 🎜

return redirect()->away('https://www.google.com');

🎜 Kadangkala anda mungkin mahu mengubah hala pengguna ke lokasi sebelumnya, seperti apabila borang yang diserahkan tidak sah. Anda kemudiannya boleh menggunakan fungsi pembantu global back untuk melaksanakan operasi ini. Memandangkan ciri ini memanfaatkan kawalan sesi, pastikan bahawa laluan memanggil fungsi back menggunakan kumpulan middleware web atau semua middleware Sesi: 🎜

Route::post('user/profile', function () { 
   // Update the user's profile...    
   return redirect('dashboard')->with('status', 'Profile updated!');
 });

🎜🎜🎜🎜🎜🎜

Ubah hala ke laluan yang dinamakan

Jika fungsi pembantu redirect dipanggil tanpa parameter, contoh IlluminateRoutingRedirector akan dikembalikan. Kejadian ini membolehkan anda memanggil sebarang kaedah pada Redirector. Contohnya, untuk menjana RedirectResponse untuk laluan bernama, anda boleh menggunakan kaedah route: redirect 时，会返回 IlluminateRoutingRedirector 实例。这个实例允许你调用 Redirector 上的任何方法。例如为命名路由生成 RedirectResponse，可以使用 route 方法：

@if (session('status'))    
  <div class="alert alert-success">        
       {{ session('status') }}    
  </div>
@endif

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

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

通过 Eloquent 模型填充参数

如果你要重定向到使用从 Eloquent 模型填充「ID」参数的路由，可以简单地传递模型本身。ID 会被自动提取：

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

如果你想要自定义这个路由参数中的默认参数名，需要重写模型实例上的 getRouteKey 方法：

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

跳转到控制器 Action

还可以生成到 controller action 的跳转。要达到这个目的，只要把控制器和 action 的名称传递给 action 方法。记住，不需要传递控制器的全部命名空间，Laravel 的 RouteServiceProvider 会自动将其设置为基本控制器的命名空间：

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

如果控制器路由需要参数，可以将其作为 action 方法的第二个参数：

return response()->streamDownload(function () { 
   echo GitHub::api('repo')              
     ->contents()                
     ->readme('laravel', 'laravel')['contents'];
 }, 'laravel-readme.md');

跳转到外部域名

有时候你需要跳转到应用外的域名。调用 away 方法可以达到此目的，它会创建一个不带有任何额外的 URL 编码、有效性校验和检查的 RedirectResponse 实例：

return response()->file($pathToFile);
return response()->file($pathToFile, $headers);

带有传送 Session 值的跳转

跳转到新的 URL 的同时传送数据给 session 是很常见的。通常会在成功执行一个动作并传送消息给 session 之后这样做。为了方便起见，你可以创建一个 RedirectResponse 实例并在链式方法调用中将数据传送给 session ：

<?php
   namespace App\Providers;
   use Illuminate\Support\ServiceProvider;
   use Illuminate\Support\Facades\Response;
   class ResponseMacroServiceProvider extends ServiceProvider{   
    /**
     * 注册应用程序的响应宏
     *
     * @return void
     */   
    public function boot()  
      {        
          Response::macro('caps', function ($value) {         
          return Response::make(strtoupper($value));        
       });   
      }
   }

在用户跳转后，可以显示 session 中的传送数据。比如使用 Blade syntax ：

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

其它的响应类型

response 助手可以用于生成其它类型的响应实例。当还带参数调用 response 助手时，返回 IlluminateContractsRoutingResponseFactoryrrreee

Jika terdapat parameter dalam laluan, anda boleh melepasinya sebagai yang kedua parameter ke laluan Kaedah:

rrreee

Isi parameter melalui model Eloquent

Jika anda ingin mengubah hala untuk menggunakan "ID" diisi daripada model Eloquent Untuk penghalaan parameter, anda boleh lulus model itu sendiri. ID akan diekstrak secara automatik:

rrreee

Jika anda ingin menyesuaikan nama parameter lalai dalam parameter laluan ini, anda perlu mengatasi kaedah getRouteKey pada contoh model:

rrreee🎜🎜🎜

🎜🎜Lompat ke Tindakan pengawal🎜🎜Anda juga boleh menjana lompatan ke tindakan pengawal. Untuk melakukan ini, hanya hantar pengawal dan nama tindakan kepada kaedah action. Ingat, anda tidak perlu melepasi ruang nama penuh pengawal, RouteServiceProvider Laravel akan secara automatik menetapkannya kepada ruang nama pengawal asas: 🎜rrreee🎜Jika laluan pengawal memerlukan parameter, anda boleh lulus mereka sebagai Parameter kedua kaedah tindakan: 🎜rrreee🎜🎜🎜

🎜 🎜lompat Pergi ke domain luaran 🎜🎜 Kadangkala anda perlu melompat ke domain di luar apl. Ini dicapai dengan memanggil kaedah jauh, yang mencipta contoh RedirectResponse tanpa sebarang pengekodan URL tambahan, semakan semak kesahan: 🎜rrreee🎜🎜🎜

🎜🎜Lompat dengan nilai Sesi yang dipindahkan🎜🎜Lompat ke URL baharu Ia adalah perkara biasa untuk menghantar data ke sesi pada masa yang sama masa. Ini biasanya dilakukan selepas berjaya melaksanakan tindakan dan menghantar mesej ke sesi. Untuk kemudahan, anda boleh mencipta contoh RedirectResponse dan memindahkan data ke sesi dalam panggilan kaedah berantai: 🎜rrreee🎜Selepas pengguna melompat, data yang dipindahkan dalam sesi boleh dipaparkan. Contohnya, gunakan sintaks Blade: 🎜rrreee🎜🎜🎜

🎜

Jenis respons lain

🎜 Pembantu respons boleh digunakan untuk menjana jenis contoh respons yang lain. Apabila pembantu response dipanggil dengan argumen, mengembalikan pelaksanaan kontrak IlluminateContractsRoutingResponseFactory. Kontrak ini menyediakan beberapa kaedah untuk menjana respons: 🎜🎜🎜🎜🎜🎜🎜

Lihat respons

Jika anda perlu mengembalikan paparan sebagai kandungan respons sambil mengawal status respons dan maklumat pengepala, anda perlu memanggil kaedah view: view 方法：

rrreee

如果不需要传递自定义的 HTTP 状态码和自定义头信息，还可以使用全局的 view 辅助函数。

JSON 响应

json 自动将 Content-Type 头信息设置为 application/json，同时使用 PHP 的 json_encode 函数将给定的数组转换为 JSON ：

rrreee

如果想要创建 JSONP 响应，可以结合 withCallback 方法使用 json 方法：

rrreee

文件下载

download 方法可以用于生成强制用户浏览器下载给定路径文件的响应。 download 方法文件名作为其第二个参数，它将作为用户下载文件的文件名。最后，你可以传递 HTTP 头信息数组作为其第三个参数：

rrreee

{note} 用于管理文件下载的 Symfony HttpFoundation 要求下载的文件有一个 ASCII 文件名。

流下载

有时，你可能希望将给定操作的字符串响应转换为下载响应，而不需要将其写入磁盘。此时可以使用 streamDownload 方法。这个方法接受回调、文件名和可选的头信息数组作为参数：

rrreee

文件响应

file 方法用于直接在用户浏览器显示一个图片或 PDF 之类的文件，而不是下载。这个方法接受文件路径作为第一个参数，头信息数组作为第二个参数：

rrreee

响应宏

如果你想要定义一个自定义的可以在多个路由和控制器中复用的响应，可以使用 Response 门面上的 macro 方法。例如，在某个服务提供者的 boot 方法编写如下代码：

rrreee

macro 方法接受一个名称作为第一个参数，闭包函数作为的第二个参数。响应宏的闭包在 ResponseFactory 实现类或辅助函数 responserrreee

Jika anda tidak perlu lulus kod status HTTP tersuai dan Untuk menyesuaikan maklumat pengepala, anda juga boleh menggunakan fungsi pembantu view global.

🎜JSON response🎜🎜json menukarkan Content- secara automatik Maklumat pengepala Type ditetapkan kepada application/json dan fungsi json_encode PHP digunakan untuk menukar tatasusunan yang diberikan kepada JSON: 🎜rrreee🎜Jika anda ingin mencipta JSONP Response, anda boleh menggunakan kaedah json dalam kombinasi dengan kaedah withCallback: 🎜rrreee🎜🎜🎜