Laravel自定义用户提供者？用户提供者怎样实现？-Laravel-PHP中文网

自定义用户提供者可集成非Eloquent模型与多种数据源，如NoSQL、API、LDAP或文件，通过实现UserProvider和Authenticatable接口，灵活处理用户检索与密码验证，解决认证问题需确保接口方法正确实现并合理配置。

laravel自定义用户提供者？用户提供者怎样实现？

自定义 Laravel 用户提供者允许你使用非 Eloquent 模型或数据库表来验证用户。它通过实现

Illuminate\Contracts\Auth\UserProvider

登录后复制

接口来完成。这为你提供了极大的灵活性，尤其是在需要与遗留系统或外部认证服务集成时。

解决方案

要创建一个自定义用户提供者，你需要完成以下步骤：

创建用户模型： 如果你还没有，创建一个代表用户的类。这个类不需要继承 Eloquent 模型，但它必须实现

Illuminate\Contracts\Auth\Authenticatable

登录后复制

接口。

namespace App\Models;

use Illuminate\Contracts\Auth\Authenticatable;

class CustomUser implements Authenticatable
{
    protected $id;
    protected $username;
    protected $password;
    protected $attributes = [];

    public function __construct(array $attributes = [])
    {
        $this->attributes = $attributes;
        if (isset($attributes['id'])) {
            $this->id = $attributes['id'];
        }
        if (isset($attributes['username'])) {
            $this->username = $attributes['username'];
        }
        if (isset($attributes['password'])) {
            $this->password = $attributes['password'];
        }
    }

    public function getAuthIdentifierName()
    {
        return 'id';
    }

    public function getAuthIdentifier()
    {
        return $this->id;
    }

    public function getAuthPassword()
    {
        return $this->password;
    }

    public function getRememberToken()
    {
        return $this->attributes['remember_token'] ?? null;
    }

    public function setRememberToken($value)
    {
        $this->attributes['remember_token'] = $value;
    }

    public function getRememberTokenName()
    {
        return 'remember_token';
    }

    public function setAttribute($key, $value) {
        $this->attributes[$key] = $value;
    }

    public function getAttribute($key) {
        return $this->attributes[$key] ?? null;
    }

    public function __get($key) {
        return $this->getAttribute($key);
    }

    public function __set($key, $value) {
        $this->setAttribute($key, $value);
    }
}

登录后复制

创建用户提供者： 创建一个类来实现

Illuminate\Contracts\Auth\UserProvider

登录后复制

接口。这个类负责从你的数据源检索用户，并验证他们的凭据。

namespace App\Providers;

use Illuminate\Contracts\Auth\Authenticatable;
use Illuminate\Contracts\Auth\UserProvider;
use App\Models\CustomUser; // 替换为你的用户模型
use Illuminate\Support\Facades\Hash;

class CustomUserProvider implements UserProvider
{
    protected $model;

    public function __construct(string $model)
    {
        $this->model = $model;
    }

    public function retrieveById($identifier)
    {
        // 从你的数据源检索用户，例如数据库、API等
        // 这里只是一个示例，你需要根据你的实际情况进行修改
        $user = $this->getUserFromDataSource(['id' => $identifier]);
        if ($user) {
            return new $this->model($user);
        }

        return null;
    }

    public function retrieveByToken($identifier, $token)
    {
        // 从你的数据源检索用户，并验证令牌
        // 同样，这里只是一个示例
        $user = $this->getUserFromDataSource(['id' => $identifier, 'remember_token' => $token]);

        if ($user) {
            return new $this->model($user);
        }

        return null;
    }

    public function updateRememberToken(Authenticatable $user, $token)
    {
        // 更新用户的记住我令牌
        // 同样，这里只是一个示例
        $this->updateUserRememberToken($user->getAuthIdentifier(), $token);
    }

    public function retrieveByCredentials(array $credentials)
    {
        // 从你的数据源检索用户，基于提供的凭据
        // 同样，这里只是一个示例
        if (empty($credentials) ||
            (count($credentials) === 1 &&
             array_key_exists('password', $credentials))) {
            return null;
        }

        $query = [];
        foreach ($credentials as $key => $value) {
            if (! str_contains($key, 'password')) {
                $query[$key] = $value;
            }
        }

        $user = $this->getUserFromDataSource($query);

        if ($user) {
            return new $this->model($user);
        }

        return null;
    }

    public function validateCredentials(Authenticatable $user, array $credentials)
    {
        // 验证用户提供的凭据是否正确
        // 同样，这里只是一个示例
        $plain = $credentials['password'];

        return Hash::check($plain, $user->getAuthPassword());
    }

    // 模拟从数据源获取用户数据
    private function getUserFromDataSource(array $credentials)
    {
        // 替换为你的实际数据源逻辑
        // 例如，从数据库查询、调用API等
        $users = [
            [
                'id' => 1,
                'username' => 'testuser',
                'password' => Hash::make('password'),
                'remember_token' => null,
            ],
            [
                'id' => 2,
                'username' => 'anotheruser',
                'password' => Hash::make('anotherpassword'),
                'remember_token' => null,
            ],
        ];

        foreach ($users as $user) {
            $match = true;
            foreach ($credentials as $key => $value) {
                if ($user[$key] != $value) {
                    $match = false;
                    break;
                }
            }
            if ($match) {
                return $user;
            }
        }

        return null;
    }

    // 模拟更新用户记住我令牌
    private function updateUserRememberToken($id, $token)
    {
        // 替换为你的实际数据源更新逻辑
        // 例如，更新数据库记录、调用API等
        // 这里只是一个示例，没有实际更新操作
    }
}

登录后复制

注册用户提供者： 在

config/auth.php

登录后复制

文件中，注册你的自定义用户提供者。

'providers' => [
    'users' => [
        'driver' => 'custom',
        'model' => App\Models\CustomUser::class, // 替换为你的用户模型
    ],
],

登录后复制

配置认证守卫： 在

config/auth.php

登录后复制

文件中，配置你的认证守卫以使用你的自定义用户提供者。

'guards' => [
    'web' => [
        'driver' => 'session',
        'provider' => 'users',
    ],

    'api' => [
        'driver' => 'token',
        'provider' => 'users',
        'hash' => false,
    ],
],

登录后复制

自定义用户提供者可以处理哪些类型的用户数据源？

自定义用户提供者最大的优势在于其灵活性。它可以处理几乎任何类型的用户数据源，包括：

非关系型数据库 (NoSQL): 例如 MongoDB, Redis 等。你可以编写用户提供者来从这些数据库中检索用户数据。
外部 API: 如果你的用户数据存储在外部 API 中，你可以使用用户提供者来调用 API 并验证用户。
LDAP 服务器: 用户提供者可以连接到 LDAP 服务器并验证用户凭据。
平面文件: 虽然不常见，但你甚至可以使用用户提供者从平面文件中读取用户数据。

关键在于

retrieveById

登录后复制

retrieveByToken

登录后复制

retrieveByCredentials

登录后复制

和

validateCredentials

登录后复制

方法的实现。这些方法定义了如何从你的数据源检索用户以及如何验证他们的凭据。

如何处理用户密码的加密和验证？

Laravel 提供了

Hash

登录后复制

facade 来处理密码的加密和验证。你应该始终使用

Hash::make()

登录后复制

来加密用户密码，并使用

Hash::check()

登录后复制

来验证密码。

AppMall应用商店

AI应用商店，提供即时交付、按需付费的人工智能应用服务

查看详情

在

CustomUserProvider

登录后复制

类的

validateCredentials

登录后复制

方法中，你可以使用

Hash::check()

登录后复制

来验证用户提供的密码是否与存储在数据源中的加密密码匹配。

public function validateCredentials(Authenticatable $user, array $credentials)
{
    $plain = $credentials['password'];

    return Hash::check($plain, $user->getAuthPassword());
}

登录后复制

确保在用户注册或更新密码时使用

Hash::make()

登录后复制

来加密密码。

使用自定义用户提供者进行身份验证时，常见的错误以及如何解决？

在使用自定义用户提供者时，可能会遇到一些常见的错误：

```
Target [Illuminate\Contracts\Auth\Authenticatable] is not instantiable
```
登录后复制
: 这通常意味着你的用户模型没有正确实现
```
Illuminate\Contracts\Auth\Authenticatable
```
登录后复制
接口，或者你没有正确地将你的用户模型绑定到容器中。检查你的用户模型是否实现了所有必需的方法，并确保在
```
config/auth.php
```
登录后复制
文件中正确配置了
```
model
```
登录后复制
选项。
```
Call to undefined method
```
登录后复制
: 这通常意味着你的用户模型缺少
```
Illuminate\Contracts\Auth\Authenticatable
```
登录后复制
接口中定义的方法。确保你的用户模型实现了
```
getAuthIdentifierName
```
登录后复制
,
```
getAuthIdentifier
```
登录后复制
,
```
getAuthPassword
```
登录后复制
,
```
getRememberToken
```
登录后复制
,
```
setRememberToken
```
登录后复制
, 和
```
getRememberTokenName
```
登录后复制
方法。
身份验证失败： 这可能是由于多种原因造成的。首先，确保你的
```
retrieveByCredentials
```
登录后复制
方法正确地从你的数据源检索用户。然后，确保你的
```
validateCredentials
```
登录后复制
方法正确地验证用户提供的凭据。使用
```
dd()
```
登录后复制
函数来调试这些方法，以确保它们按预期工作。
```
Class 'App\Providers\CustomUserProvider' not found
```
登录后复制
: 这通常意味着你没有正确地注册你的用户提供者。确保你在
```
config/app.php
```
登录后复制
文件的
```
providers
```
登录后复制
数组中注册了你的用户提供者。
Remember Me 功能不起作用： 确保你的用户模型实现了
```
getRememberToken
```
登录后复制
,
```
setRememberToken
```
登录后复制
, 和
```
getRememberTokenName
```
登录后复制
方法，并且你的
```
updateRememberToken
```
登录后复制
方法正确地更新了数据源中的 remember token。

总而言之，自定义用户提供者为 Laravel 身份验证提供了极大的灵活性。通过正确实现

Illuminate\Contracts\Auth\UserProvider

登录后复制

和

Illuminate\Contracts\Auth\Authenticatable

登录后复制

接口，你可以将 Laravel 身份验证与任何类型的用户数据源集成。

以上就是Laravel自定义用户提供者？用户提供者怎样实现？的详细内容，更多请关注php中文网其它相关文章！

大家都在看：

Laravel中的全局作用域(Global Scopes)怎么用 Laravel怎么使用查询构造器(Query Builder)执行复杂查询 laravel怎么使用Redis HyperLogLog进行高效基数统计_laravel Redis HyperLogLog高效基数统计方法 Laravel如何发送邮件和配置邮件驱动 Laravel如何处理多对多关系和中间表