認(rèn)証に Hyperf フレームワークを使用する方法

最新の Web アプリケーションでは、ユーザー認(rèn)証は非常に重要な機(jī)能です。機(jī)密情報(bào)を保護(hù)し、アプリケーションのセキュリティを確保するために、認(rèn)証により、認(rèn)証されたユーザーのみが制限されたリソースにアクセスできるようになります。

Hyperf は、Swoole をベースにした高性能 PHP フレームワークで、多くの最新かつ効率的な機(jī)能とツールを提供します。 Hyperf フレームワークでは複數(shù)の方法で ID 認(rèn)証を?qū)g裝できますが、一般的に使用される 2 つの方法を以下に紹介します。

1. JWT (JSON Web トークン) の使用

JWT は、通信當(dāng)事者間で情報(bào)を安全に送信するための簡潔で自己完結(jié)型の方法を定義するオープン スタンダード (RFC 7519) です。 。 Hyperf フレームワークでは、lcobucci/jwt 拡張ライブラリを使用して、JWT の生成と検証を?qū)g現(xiàn)できます。

まず、lcobucci/jwt ライブラリの依存関係をcomposer.json ファイルに追加する必要があります:

"require": {
    "lcobucci/jwt": "^3.4"
}

次に、composer update コマンドを?qū)g行します。依存関係をインストールします。

次に、JWT を生成および検証するための JwtAuthenticator クラスを作成できます。

<?php

declare(strict_types=1);

namespace AppAuth;

use HyperfExtAuthAuthenticatable;
use HyperfExtAuthContractsAuthenticatorInterface;
use LcobucciJWTConfiguration;
use LcobucciJWTToken;

class JwtAuthenticator implements AuthenticatorInterface
{
    private Configuration $configuration;

    public function __construct(Configuration $configuration)
    {
        $this->configuration = $configuration;
    }

    public function validateToken(string $token): bool
    {
        $parsedToken = $this->configuration->parser()->parse($token);
        $isVerified = $this->configuration->validator()->validate($parsedToken, ...$this->configuration->validationConstraints());
        
        return $isVerified;
    }

    public function generateToken(Authenticatable $user): string
    {
        $builder = $this->configuration->createBuilder();
        $builder->issuedBy('your_issuer')
            ->issuedAt(new DateTimeImmutable())
            ->expiresAt((new DateTimeImmutable())->modify('+1 hour'))
            ->withClaim('sub', (string) $user->getAuthIdentifier());
        
        $token = $builder->getToken($this->configuration->signer(), $this->configuration->signingKey());
        
        return $token->toString();
    }
}

次に、それを Hyperf フレームワークのコンテナーに登録する必要があります。 JwtAuthenticator クラス:

HyperfUtilsApplicationContext::getContainer()->define(AppAuthJwtAuthenticator::class, function (PsrContainerContainerInterface $container) {
    $configuration = LcobucciJWTConfiguration::forAsymmetricSigner(
        new LcobucciJWTSignerRsaSha256(),
        LcobucciJWTSignerKeyLocalFileReference::file('path/to/private/key.pem')
    );

    return new AppAuthJwtAuthenticator($configuration);
});

最後に、認(rèn)証を必要とするルートまたはコントローラー メソッドで、

JwtAuthenticator クラスを使用してユーザーの JWT を検証できます:

<?php

declare(strict_types=1);

namespace AppController;

use AppAuthJwtAuthenticator;
use HyperfHttpServerAnnotationController;
use HyperfHttpServerAnnotationRequestMapping;

/**
 * @Controller(prefix="/api")
 */
class ApiController
{
    private JwtAuthenticator $authenticator;

    public function __construct(JwtAuthenticator $authenticator)
    {
        $this->authenticator = $authenticator;
    }

    /**
     * @RequestMapping(path="profile", methods="GET")
     */
    public function profile()
    {
        $token = $this->request->getHeader('Authorization')[0] ?? '';
        $token = str_replace('Bearer ', '', $token);
        
        if (!$this->authenticator->validateToken($token)) {
            // Token驗(yàn)證失敗，返回錯(cuò)誤響應(yīng)
            return 'Unauthorized';
        }

        // Token驗(yàn)證成功，返回用戶信息
        return $this->authenticator->getUserByToken($token);
    }
}

セッションの使用

JWT 認(rèn)証に加えて、Hyperf フレームワークは ID 認(rèn)証のためのセッションの使用もサポートしています。設(shè)定ファイルを通じてセッション認(rèn)証機(jī)能を有効にすることができます。

まず、設(shè)定ファイル

config/autoload/session.php で対応する設(shè)定を行う必要があります。例:

return [
    'handler' => [
        'class' => HyperfRedisSessionHandler::class,
        'options' => [
            'pool' => 'default',
        ],
    ],
];

次に、ルーティングまたはコントロールで、対応する設(shè)定を行う必要があります。認(rèn)証が必要なサーバー メソッドでは、Hyperf フレームワークによって提供される

AuthManager クラスを使用してユーザーのセッションを認(rèn)証できます。

<?php

declare(strict_types=1);

namespace AppController;

use HyperfHttpServerAnnotationController;
use HyperfHttpServerAnnotationRequestMapping;
use HyperfExtAuthContractsAuthManagerInterface;

/**
 * @Controller(prefix="/api")
 */
class ApiController
{
    private AuthManagerInterface $authManager;

    public function __construct(AuthManagerInterface $authManager)
    {
        $this->authManager = $authManager;
    }

    /**
     * @RequestMapping(path="profile", methods="GET")
     */
    public function profile()
    {
        if (!$this->authManager->check()) {
            // 用戶未登錄，返回錯(cuò)誤響應(yīng)
            return 'Unauthorized';
        }

        // 用戶已登錄，返回用戶信息
        return $this->authManager->user();
    }
}

上記のコードでは、

AuthManagerInterface インターフェースは多くの認(rèn)証を提供し、実際のニーズに応じてユーザー操作メソッドを呼び出すことができます。

上記は、Hyperf フレームワークを使用した ID 認(rèn)証の 2 つの一般的な方法であり、JWT またはセッションを通じてユーザー認(rèn)証を?qū)g裝します。実際のニーズとプロジェクトの特性に基づいて、アプリケーションのセキュリティとユーザー エクスペリエンスを確保するための適切な方法を選択します。実際の開発では、フレームワークが提供するドキュメントとサンプル コードに基づいて、高度な使用方法とベスト プラクティスについて詳しく學(xué)ぶことができます。

以上が認(rèn)証に Hyperf フレームワークを使用する方法の詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國語 Web サイトの他の関連記事を參照してください。