HTTP レスポンス

• レスポンスの作成
  • レスポンス ヘッダーの追加
  • キャッシュ制御ミドルウェア
  • 応答に Cookie を追加
  • Cookie と暗号化
• ヘビー ダイレクト
  • 名前付きルートへのリダイレクト
  • コントローラーの動作へのリダイレクト
  • 外部ドメイン名へのリダイレクト
  • フラッシュされたセッション データをリダイレクトして使用する
• その他の応答タイプ
  • レスポンスの表示
  • JSON レスポンス
  • ファイルのダウンロード
  • ファイル レスポンス
• #応答マクロ

すべてのルートとコントローラーは、ビジネス ロジックの処理後にユーザーのブラウザに送信された応答を返します。Laravel では、応答を返すさまざまな方法が提供されています。最も基本的な応答は、ルートまたはコントローラーから単純な文字列を返すことです。フレームワークは、この文字列を完全な HTTP 応答に自動的に変換します:

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

ルートまたはコントローラーから応答を返すことに加えて、文字列のほか、コントローラーは配列を返すこともできます。フレームワークは配列を JSON レスポンスに自動的に変換します:

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

通常、ルーティング アクションから単に文字列と配列を返すだけではなく、ほとんどの場合、完全な

インスタンスまたはビュー。 完全な

インスタンスを返します。これにより、応答の HTTP ステータス コードと応答ヘッダー情報をカスタマイズできます。 Response インスタンスは、HTTP レスポンスを構築するためのさまざまなメソッドを提供する Symfony\Component\HttpFoundation\Response クラスを継承します。

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

ほとんどの応答メソッドはチェーン可能であり、応答インスタンスを作成するプロセスがより読みやすくなります。たとえば、

メソッドを使用して、応答がユーザーに返される前に一連のヘッダー情報を応答に追加できます。

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

応答に追加するヘッダーの配列を指定するメソッド:

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

キャッシュ制御ミドルウェア

Laravelには、ルーティンググループのCache-Controlヘッダー情報を素早く設定するために使用できる組み込みのcache.headersミドルウェアがあります。 etag がディレクティブセットで宣言されている場合、Laravel は ETag 識別子を応答コンテンツの MD5 ハッシュに自動的に設定します:

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

応答への 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 ファサード "queue"、Cookie# を使用することもできます。 ## アプリケーションの送信応答に添付されます。 queue メソッドは、Cookie インスタンス、または Cookie インスタンスの作成に必要なパラメーターを受け入れます。これらの Cookie は、ブラウザに送信される前に発信応答に追加されます:

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

app/Http/Middleware ディレクトリにある App\Http\Middleware\EncryptCookies ミドルウェアを使用できます。 ## プロパティ:

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

Illuminate\Http \ のインスタンスRedirectResponse

RedirectResponse インスタンスを生成するためのメソッドがいくつか用意されています。最も簡単な方法は、グローバル ヘルパー関数 redirect:

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

back 関数を呼び出すルートが web ミドルウェア グループまたはすべてのセッション ミドルウェアを使用していることを確認してください:

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

名前付きルートへのリダイレクト

ヘルパー関数 redirect をパラメーターなしで呼び出すと、Illuminate\Routing\Redirector インスタンスが返されます。このインスタンスにより、Redirector 上の任意のメソッドを呼び出すことができます。たとえば、名前付きルートの RedirectResponse を生成するには、route メソッドを使用します。

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

ルートにパラメータがある場合は、それらを渡すことができます。 ルート の 2 番目のパラメータとしてメソッド:

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

Eloquent モデルを通じてパラメータを入力します。

次のルートにリダイレクトする場合は、 Eloquent モデルから「ID」パラメータを入力した場合は、モデル自体を渡すだけで済みます。 ID は自動的に抽出されます:

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

このルート パラメーターのデフォルトのパラメーター名をカスタマイズする場合は、モデル インスタンスの getRouteKey メソッドをオーバーライドする必要があります:

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

コントローラー アクションへのジャンプ

コントローラーへのジャンプ アクションを生成することもできます。これを行うには、コントローラーの名前とアクションを action メソッドに渡すだけです。コントローラーの完全な名前空間を渡す必要はないことに注意してください。Laravel の RouteServiceProvider は、それをベース コントローラーの名前空間に自動的に設定します:

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

コントローラー ルートにパラメーターが必要な場合は、これを action メソッドの 2 番目のパラメータとして使用できます:

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

外部ドメイン名にジャンプ

アプリケーションの外部のドメイン名にジャンプする必要がある場合があります。これは、away メソッドを呼び出すことで実現されます。このメソッドは、追加の URL エンコードや有効性チェックサム チェックを行わずに、RedirectResponse インスタンスを作成します。

##セッション値を転送してジャンプ

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

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

その他の応答タイプ

response

Illuminate\Contracts\Routing\ResponseFactory コントラクトの実装が返されます。このコントラクトは、応答を生成するためのいくつかのメソッドを提供します:

View 応答

ビューを応答コンテンツとして返し、応答ステータスとヘッダー情報を制御する必要がある場合は、view メソッドを呼び出す必要があります:

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

そうでない場合は、カスタム HTTP ステータス コードとカスタム ヘッダー情報を渡す必要があります。また、グローバル view ヘルパー関数を使用することもできます。

は自動的に Content-Type を変更します。ヘッダー情報は application/json に設定され、指定された配列は PHP の json_encode 関数を使用して JSON に変換されます。

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

メソッドと組み合わせて、json メソッドを使用できます:

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

download

download メソッドのファイル名は 2 番目のパラメータとして使用され、ユーザーがダウンロードするファイルのファイル名として使用されます。最後に、HTTP ヘッダーの配列を 3 番目のパラメーターとして渡すことができます。

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

streamDownload

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

##ファイル応答

このメソッドは、画像や PDF などのファイルをダウンロードするのではなく、ユーザーのブラウザーに直接表示するために使用されます。このメソッドは、最初のパラメータとしてファイル パスを、2 番目のパラメータとしてヘッダー情報配列を受け入れます。

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

Response Macro

ファサードで

メソッドを使用できます。たとえば、サービス プロバイダーの boot メソッドに次のコードを記述します。

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

実装クラスまたはヘルパー関数 response:

<?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));        
       });   
      }
   }