fx/hyperf-http-auth

use auth in hyperf as in laravel

v3.0.0 2020-12-28 06:43 UTC

This package is auto-updated.

Last update: 2021-11-28 08:55:13 UTC


README

使用

安装

composer require fx/hyperf-http-auth:"^1.1"

发布配置文件

php bin/hyperf.php vendor:publish fx/hyperf-http-auth

创建用户 model 并修改为以下配置

<?php
declare (strict_types=1);

namespace App\Model;

use Fx\HyperfHttpAuth\Contract\Authenticatable;
use Hyperf\DbConnection\Model\Model;

class User extends Model implements Authenticatable
{
    use \Fx\HyperfHttpAuth\Authenticatable;
}

配置依赖扩展

  • fx/session-guard 依赖 hyperf/session 需要正确配置其相关内容 官方文档

在 controller 中使用

<?php
declare(strict_types=1);

namespace App\Controller;

use App\Model\User;
use Fx\HyperfHttpAuth\Contract\HttpAuthContract;
use Hyperf\Di\Annotation\Inject;

class IndexController extends AbstractController
{
    /**
     * @Inject()
     * @var HttpAuthContract
     */
    protected $auth;

    public function index()
    {
        return $this->data();
    }

    /**
     * 登录
     */
    public function login()
    {
        /** 方式 1 */
        // 等价于 auth()->login(User::first());
        $this->auth->login(User::first());

        /** 方式 2 */
        // 等价于 auth()->attempt(['email' => 'xxx', 'password' => '123456']);
        $this->auth->attempt(['email' => 'xxx', 'password' => '123456']);

        return $this->data();
    }

    /**
     * 登出
     */
    public function logout()
    {
        // 等价于 auth()->logout();
        $this->auth->logout();
        return $this->data();
    }

    protected function data()
    {
        return [
            'user' => auth()->user(),
            'is_login' => auth()->check(),
        ];
    }
}

扩展 UserProvider

  • 实现 Fx\HyperfHttpAuth\Contract\UserProvider 这个抽象类

  • 添加 Fx\HyperfHttpAuth\Annotation\UserProviderAnnotation 类注解, 该注解接收一个参数, 为该驱动的名称

  • 可参考: fx/eloquent-provider

扩展 Guard

  • 实现 Fx\HyperfHttpAuth\Contract\StatefulGuard 这个抽象类

  • 添加 Fx\HyperfHttpAuth\Annotation\GuardAnnotation 类注解, 该注解接收一个参数, 为该驱动的名称

  • 可参考: fx/session-guard

更新说明

  • 2020-05-12: 修复 session guard 中引用 cookie 的问题, 该问题导致登录时无法使用 记住我

  • 2019-12-26: 添加 Fx\HyperfHttpAuth\AuthenticateMiddleware 中间件, 未认证通过会抛出 Fx\HyperfHttpAuth\Exception\AuthenticationException

  • 2019-12-27: 添加自动化测试

  • 2020-01-07: 修复: Fx\HyperfHttpAuth\Contract\Guard::name(), 更新自动化测试

  • 2020-08-17: 修复收集器无法收集到自定义的注解, 该问题会导致 GuardUserProvider 无法正常使用