Laravel 8：精细化控制中间件，确保公共路由可匿名访问

本文旨在解决 laravel 8 应用中，公共前端页面在用户登出后被错误重定向至登录页面的问题。通过深入分析 auth 中间件的作用机制，并演示如何利用控制器构造器中的 except 方法，实现对特定公共方法的精准排除，确保网站根路径及其他指定路由无需认证即可正常访问，从而优化用户体验。

理解 Laravel 中间件与认证流程

在 Laravel 应用程序中，中间件（Middleware）扮演着 HTTP 请求的“守门员”角色。它们可以在请求到达应用程序的核心逻辑（如控制器方法）之前或之后执行特定的任务。auth 中间件是 Laravel 认证系统中的核心组件，其主要职责是验证用户是否已登录。如果用户未登录且尝试访问受 auth 中间件保护的路由，系统通常会将其重定向到登录页面。

本案例中，问题的核心在于网站的根页面 (/) 和文章阅读页面 (/read/{id}) 在用户登出后，本应公共可访问，却被强制重定向到登录页。这通常是由于 HomeController 中不当的中间件配置所导致。

识别问题根源：HomeController 中的 auth 中间件

根据提供的代码，HomeController 的构造函数中包含了以下代码：

<?php
namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Article;
use App\Comment;
use Illuminate\Support\Facades\Auth;

class HomeController extends Controller
{
    /**
     * Create a new controller instance.
     *
     * @return void
     */
    public function __construct()
    {
        $this->middleware('auth'); // 问题所在
    }

    // ... 其他方法
}

$this-youjiankuohaophpcnmiddleware('auth'); 这行代码的含义是，HomeController 中的所有方法都将受到 auth 中间件的保护。这意味着，无论是 index() 方法（对应 / 路由）还是 read() 方法（对应 /read/{id} 路由），都要求用户必须登录才能访问。当用户登出后，由于不再处于认证状态，访问这些公共页面时便会被 auth 中间件拦截并重定向至登录页。

而 LoginController 中的 $this->middleware('guest')->except('logout'); 配置是正确的，它确保未登录用户可以访问登录页面，已登录用户无法再次访问登录页。这与公共页面重定向问题无关。

解决方案：利用 except() 方法排除特定方法

为了解决这个问题，我们需要修改 HomeController 的构造函数，明确指定哪些方法可以跳过 auth 中间件的验证。Laravel 提供了 except() 方法来实现这一目的。

except() 方法允许你传递一个或多个方法名（字符串或数组），这些方法将不会应用当前定义的中间件。

修改 HomeController 的构造函数：

AI-Text-Classifier

OpenAI官方出品，可以区分人工智能书写的文本和人类书写的文本

59

查看详情

<?php
namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Article;
use App\Comment;
use Illuminate\Support\Facades\Auth;

class HomeController extends Controller
{
    /**
     * Create a new controller instance.
     *
     * @return void
     */
    public function __construct()
    {
        // 排除 'index' 和 'read' 方法，使其无需认证即可访问
        $this->middleware('auth')->except(['index', 'read']);
    }

    /**
     * Show the application dashboard.
     *
     * @return \Illuminate\Http\Response
     */
    public function index()
    {
        $articles = Article::all();
        $ar=Array('articles'=>$articles);
        return view('site.home',$ar);
    }

    // ... 其他方法，包括 read()
    public function read(Request $request,$id){
        if($request ->isMethod('post')){
            $ar = new Comment();
            $ar->Comment=$request->input('body');
            $ar->article_id=$id;
            $ar->save();
         }
        $article = Article::find($id);
        $ar=Array('article'=>$article);
        return view('site.read',$ar);
    }
}

通过将 index 和 read 方法添加到 except() 数组中，我们指示 Laravel 对这两个方法不应用 auth 中间件。这样，用户即使在未登录状态下，也能正常访问网站的根页面 (/) 和文章阅读页面 (/read/{id})。

注意事项与最佳实践

1. 方法名的准确性： 确保 except() 方法中列出的方法名与控制器中的实际方法名完全一致。

2. 细粒度控制： except() 方法提供了非常灵活的中间件控制方式。如果只有少数方法需要认证，而大部分方法是公共的，也可以考虑使用 only() 方法，它只对指定的方法应用中间件。例如：$this->middleware('auth')->only(['admin_index', 'AddArticle', 'DeleteArticle', 'Edit']);

3. 路由文件中的中间件： 对于大量公共路由，另一种策略是将它们放在路由文件中不包含 auth 中间件的路由组中。例如：

   // site.php
   Route::get('/', 'HomeController@index')->name('home');
   Route::get('/read/{id}', 'HomeController@read')->name('read');
   Route::post('/read/{id}', 'HomeController@read')->name('postread');
   
   // 受认证保护的路由组
   Route::group(['prefix' => 'dashboard', 'middleware' => 'auth'], function () {
       Route::get('/', 'HomeController@admin_index')->name('dashboard');
       // ... 其他管理后台路由
   });

   登录后复制

   在这种情况下，HomeController 的构造函数就不需要 except() 方法了，因为它里面的 auth 中间件只对控制器内部的方法生效，而路由文件中的 auth 中间件会更早地对请求进行拦截。但在本例中，由于 HomeController 既处理公共页面又处理部分管理后台逻辑（如 admin_index），在控制器层面使用 except() 是一个简洁有效的方案。

4. 清晰的职责划分： 尽量保持控制器的职责单一。如果一个控制器既处理公共逻辑又处理认证逻辑，使用 except() 是合理的。但如果业务逻辑变得复杂，可以考虑将公共逻辑和认证逻辑拆分到不同的控制器中，以提高代码的可维护性。

总结

通过在 HomeController 的构造函数中，利用 auth 中间件的 except() 方法排除 index 和 read 等公共方法，我们成功解决了 Laravel 应用程序中公共页面在用户登出后被错误重定向至登录页面的问题。这种方法提供了对中间件应用范围的精细化控制，确保了应用程序的公共部分能够按预期对外开放，同时保持了需要认证的页面安全可靠。在开发过程中，理解并合理运用 Laravel 的中间件机制，是构建健壮且用户友好的应用程序的关键。

以上就是Laravel 8：精细化控制中间件，确保公共路由可匿名访问的详细内容，更多请关注php中文网其它相关文章！