Laradoc

Appearance

HTTP 重新導向 ​

建立重新導向 ​

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

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

有時您可能希望將使用者重新導向到他們之前的位置，例如當提交的表單無效時。您可以使用全域 back 輔助函數來執行此操作。由於此功能利用了 Session，請確保呼叫 back 函數的路由使用 web 中介層群組或已應用所有 Session 中介層：

php
Route::post('/user/profile', function () {
    // Validate the request...

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

重新導向至具名路由 ​

當您在不帶參數的情況下呼叫 redirect 輔助函數時，會回傳一個 Illuminate\Routing\Redirector 實例，讓您可以在 Redirector 實例上呼叫任何方法。例如，要產生一個指向具名路由的 RedirectResponse，您可以使用 route 方法：

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

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

php
// For a route with the following URI: profile/{id}

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

為了方便起見，Laravel 也提供了全域 to_route 函數：

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

透過 Eloquent 模型填充參數 ​

如果您正在重新導向到一個帶有「ID」參數的路由，且該參數是由 Eloquent 模型填充的，您可以直接傳遞該模型本身。ID 將會自動提取：

php
// For a route with the following URI: profile/{id}

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

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

php
/**
 * Get the value of the model's route key.
 */
public function getRouteKey(): mixed
{
    return $this->slug;
}

重新導向至 Controller 動作 ​

您也可以產生重新導向至 Controller 動作。為此，請將 Controller 和動作名稱傳遞給 action 方法：

php
use App\Http\Controllers\HomeController;

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

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

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

重新導向並帶有快閃 Session 資料 ​

重新導向到一個新的 URL 並 將資料快閃到 Session 通常是同時進行的。通常，這是在成功執行某個動作後，當您將成功訊息快閃到 Session 時完成的。為了方便起見，您可以建立一個 RedirectResponse 實例，並在一個單一、流暢的方法鏈中將資料快閃到 Session：

php
Route::post('/user/profile', function () {
    // Update the user's profile...

    return redirect('/dashboard')->with('status', 'Profile updated!');
});

您可以使用 RedirectResponse 實例提供的 withInput 方法，在將使用者重新導向到新位置之前，將當前請求的輸入資料快閃到 Session。一旦輸入資料已快閃到 Session，您可以在下一個請求期間輕鬆地 檢索它：

php
return back()->withInput();

在使用者被重新導向後，您可以從 Session 顯示快閃訊息。例如，使用 Blade 語法：

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