Laravel 的 HTTP 重定向 Redirect

创建重定向

重定向响应是类 Illuminate\Http\RedirectResponse 的实例, 包含了重定向用户到其他 URL 所需要的合适头信息。有很多方式生成 RedirectResponse 实例。最简单的方法是使用全局的 redirect 辅助函数：

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

有时候你希望将用户重定向到他们的上一个访问位置，例如当提交的表单不合法时，你就可以通过全局的 back 辅助函数来这样做。 因为该特性使用了 session，请确保路由调用 back 函数时使用了 web 中间件组或者应用了全部的 session 中间件：

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

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

重定向到命名路由

当你不带参数调用 redirect 辅助函数时，会返回一个 Illuminate\Routing\Redirector 实例，它允许你调用 Redirector 实例上的任何方法。例如，你可以这样使用 route 方法为命名路由生成一个 RedirectResponse ：

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

如果你的路由包含参数，你可以把它们当做第二参数传给 route 方法：

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

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

通过 Eloquent 模型填充参数

如果你要携带一个从 Eloquent 模型中填充过来的 "ID" 参数进行重定向，你可以简单的把该模型本身传进去。 ID 会被自动解析：

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

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

如果你想自定义路由参数的值，你应该在 Eloquent 模型中重写 getRouteKey 方法：

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

重定向到控制器动作

你也可以生成重定向到 控制器动作。要达到这个目的，传递控制器名和动作名到 action 方法即可。记住，你不需要指定完整的控制器命名空间，因为 Laravel 的 RouteServiceProvider 会自动设置基础的控制器命名空间：

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

如果你的控制器路由需要参数，你可以把它们当做第二个参数传递给 action 方法：

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

闪存 Session 数据重定向

重定向到新的 URL 并且 闪存数据到 session 常常在同时完成。 通常的，这会在你成功的执行一个动作、闪存消息到 session 后完成。方便起见，你可以创建一个 RedirectResponse 实例并在单个的、流畅的方法链上闪存数据到 session ：

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

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

用户被重定向后，你可以从 session 中显示闪存消息。例如，使用 Blade 语法:

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

译者署名

用户名 头像 职能 签名
@limxx 翻译 Winter is coming.

{note} 欢迎任何形式的转载，但请务必注明出处，尊重他人劳动共创开源社区。

转载请注明：本文档由 Laravel China 社区 laravel-china.org 组织翻译，详见 翻译召集帖。

文档永久地址： https://d.laravel-china.org