HTTP 重新導向

建立重新導向

重新導向回應是 Illuminate\Http\RedirectResponse 類別的實例，包含將使用者重新導向至另一個 URL 所需的正確標頭。有幾種方法可以產生 RedirectResponse 實例。最簡單的方法是使用全域的 redirect 輔助函式：

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

有時您可能希望將使用者重新導向至其先前的位置，例如當提交的表單無效時。您可以使用全域的 back 輔助函式來實現。由於此功能使用了 session，請確保呼叫 back 函式的路由使用 web 中介層群組或應用了所有的 session 中介層：

Route::post('/user/profile', function () {
    // 驗證請求...

    return back()->withInput();
});

當您使用 redirect 輔助函式而不帶參數時，將返回 Illuminate\Routing\Redirector 的實例，使您可以在 Redirector 實例上調用任何方法。例如，要生成到命名路由的 RedirectResponse，您可以使用 route 方法：

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

如果您的路由有參數，您可以將它們作為第二個參數傳遞給 route 方法：

// 對於具有以下 URI 的路由：profile/{id}

return redirect()->route('profile', ['id' => 1]);

為了方便起見，Laravel 還提供了全域的 to_route 函式：

return to_route('profile', ['id' => 1]);

如果您正在重新導向至一個帶有從 Eloquent 模型填充的 "ID" 參數的路由，您可以傳遞模型本身。ID 將被自動提取：

// 對於具有以下 URI 的路由：profile/{id}

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

如果您想自定義放置在路由參數中的值，您應該在您的 Eloquent 模型上覆蓋 getRouteKey 方法：

/**
 * 獲取模型的路由鍵值。
 */
public function getRouteKey(): mixed
{
    return $this->slug;
}

您也可以生成重定向到控制器行為。為此，將控制器和行為名稱傳遞給 action 方法：

use App\Http\Controllers\HomeController;

return redirect()->action([HomeController::class, 'index']);

如果您的控制器路由需要參數，您可以將它們作為第二個參數傳遞給 action 方法：

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

重定向到新的 URL 並將數據傳遞到會話通常是同時進行的。通常，在成功執行操作後，當您向會話中傳遞成功消息時，會這樣做。為方便起見，您可以創建一個 RedirectResponse 實例並在單個流暢的方法鏈中將數據傳遞到會話：

Route::post('/user/profile', function () {
    // 更新用戶的個人資料...

    return redirect('/dashboard')->with('status', '個人資料已更新！');
});

您可以使用 RedirectResponse 實例提供的 withInput 方法將當前請求的輸入數據傳遞到會話，然後將用戶重定向到新位置。一旦將輸入數據傳遞到會話，您可以在下一個請求期間輕鬆檢索它：

return back()->withInput();

用戶被重定向後，您可以從會話中顯示閃存的消息。例如，使用Blade 語法：


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