如何在Laravel Blade视图中避免重复查库判断用户是否为管理员

问题背景 #

现有数据库结构如下：

• user表：id、email、name
• role表：id、name
• user_role表：id、user_id、role_id

当前通过User模型的isAdministrator()方法判断用户是否为管理员，但页面多处调用该方法时会重复触发数据库查询。尝试过控制器传递、基类构造器处理、视图共享等方案，均因认证时机问题或需要修改大量代码而无法解决。

解决方案 #

方案1：优化模型方法，缓存查询结果 #

在User模型中添加缓存属性，避免重复查询数据库：

class User extends Model
{
    private $isAdmin = null;

    public function roles()
    {
        return $this->belongsToMany(Role::class);
    }

    public function isAdministrator()
    {
        // 若已缓存结果，直接返回
        if ($this->isAdmin !== null) {
            return $this->isAdmin;
        }

        // 首次查询后缓存结果
        $this->isAdmin = $this->roles()->where('role_id', 1)->exists();
        return $this->isAdmin;
    }
}

方案2：预加载用户角色，转为内存判断 #

添加中间件预加载用户角色，将数据库查询转为内存集合操作：

1. 创建PreloadUserRoles中间件：

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;

class PreloadUserRoles
{
    public function handle(Request $request, Closure $next)
    {
        if (auth()->check()) {
            // 预加载用户角色，后续操作直接用集合
            auth()->user()->load('roles');
        }

        return $next($request);
    }
}

2. 在app/Http/Kernel.php的web中间件组中注册该中间件（放在Authenticate之后）：

protected $middlewareGroups = [
    'web' => [
        // ...其他中间件
        \App\Http\Middleware\Authenticate::class,
        \App\Http\Middleware\PreloadUserRoles::class,
        // ...
    ],
];

3. 修改User模型的isAdministrator()方法：

private $isAdmin = null;

public function isAdministrator()
{
    if ($this->isAdmin !== null) {
        return $this->isAdmin;
    }

    // 利用预加载的角色集合判断，无额外数据库查询
    $this->isAdmin = $this->roles->contains('id', 1);
    return $this->isAdmin;
}

方案3：全局共享管理员状态到所有视图 #

通过视图组合器或中间件，将管理员状态全局传递给所有视图，避免重复调用模型方法：

方式A：使用视图组合器

在app/Providers/AppServiceProvider.php的boot方法中添加：

public function boot()
{
    view()->composer('*', function ($view) {
        $isAdmin = auth()->check() ? auth()->user()->isAdministrator() : false;
        $view->with('isAdmin', $isAdmin);
    });
}

之后在所有视图中直接使用$isAdmin变量：

@if($isAdmin)
    <!-- 管理员专属内容 -->
@endif

方式B：使用中间件共享

创建ShareAdminStatus中间件：

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;

class ShareAdminStatus
{
    public function handle(Request $request, Closure $next)
    {
        $isAdmin = auth()->check() ? auth()->user()->isAdministrator() : false;
        view()->share('isAdmin', $isAdmin);
        
        return $next($request);
    }
}

在web中间件组中注册该中间件（放在Authenticate之后），即可在所有视图中直接使用$isAdmin。

方案4：自定义全局辅助函数 #

创建全局辅助函数，利用静态变量缓存结果：

1. 在app/Helpers.php中添加：

<?php

function is_admin()
{
    static $isAdmin = null;

    if ($isAdmin !== null) {
        return $isAdmin;
    }

    if (!auth()->check()) {
        return $isAdmin = false;
    }

    return $isAdmin = auth()->user()->isAdministrator();
}

2. 在composer.json的autoload中添加该文件：

"autoload": {
    "files": [
        "app/Helpers.php"
    ],
    // ...其他自动加载配置
}

3. 执行composer dump-autoload生效，之后在视图中直接使用：

@if(is_admin())
    <!-- 管理员专属内容 -->
@endif

内容的提问来源于stack exchange，提问作者DadoH