优化 Laravel 用户角色查询：避免重复数据库操作

class User extends Authenticatable
{
    // ... 其他属性和方法

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

    public function hasRole($role)
    {
        // 每次调用都会执行一次数据库查询
        if ($this->roles()->where('name', 'customer')->first() !== null) {
            return true;
        }

        // 每次调用都会执行一次数据库查询
        return null !== $this->roles()->where('name', $role)->first();
    }

    public function isCustomer()
    {
        // 每次调用都会触发 hasRole 内部的数据库查询
        return $this->hasRole('customer');
    }
}

class User extends Authenticatable
{
    // ...

    public function hasRole($role)
    {
        // 将对 'customer' 和 $role 的检查合并为一次数据库查询
        return null !== $this->roles()->whereIn('name', ['customer', $role])->first();
    }

    // isCustomer 方法可以简化为直接调用 hasRole
    public function isCustomer()
    {
        return $this->hasRole('customer');
    }
}

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Collection;

class User extends Authenticatable
{
    // ...

    // 用于缓存用户角色的私有属性
    protected ?Collection $cachedRoles = null;

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

    public function hasRole(string $roleName): bool
    {
        // 如果角色尚未加载，则从数据库加载并缓存
        if (is_null($this->cachedRoles)) {
            $this->cachedRoles = $this->roles()->get(); // 加载所有关联角色
        }

        // 从缓存中检查角色
        return $this->cachedRoles->contains('name', $roleName);
    }

    public function isCustomer(): bool
    {
        return $this->hasRole('customer');
    }

    /**
     * 清除缓存的角色信息。
     * 在极少数情况下，如果用户角色在单个请求中动态变化，可能需要调用此方法。
     * 通常情况下，一个请求的生命周期内角色不会改变，因此不需要手动调用。
     */
    public function clearCachedRoles(): void
    {
        $this->cachedRoles = null;
    }
}

// 在控制器或服务中
$user = auth()->user(); // 假设用户已认证
// 或者 $user = User::with('roles')->find($userId);

// 如果 auth()->user() 没有预加载 roles，可以在这里手动加载一次
if (!$user->relationLoaded('roles')) {
    $user->load('roles');
}

// 现在，后续对 $user->roles 的访问将不会触发新的查询
// 结合上述 hasRole 方法，如果 $this->roles()->get() 已经被 $user->load('roles') 填充，
// 那么 $this->roles()->get() 会直接返回已加载的关系，而不会再次查询。
// 但模型内部的 $cachedRoles 机制更为直接，因为它直接在 hasRole 内部管理。