Yii框架中的RESTful API認(rèn)證機(jī)制

Yii框架是一個(gè)高性能的PHP框架，用于開(kāi)發(fā)Web 2.0應(yīng)用。在Yii中實(shí)現(xiàn)RESTful API認(rèn)證有多種方法，這里我們將討論兩種常用的方法：基本認(rèn)證和OAuth 2.0認(rèn)證。

1. 基本認(rèn)證（Basic Authentication）

基本認(rèn)證是一種簡(jiǎn)單的認(rèn)證方式，客戶端需要提供一個(gè)用戶名和密碼，這些信息將作為HTTP請(qǐng)求頭的一部分發(fā)送給服務(wù)器。服務(wù)器會(huì)解碼這些請(qǐng)求頭并驗(yàn)證用戶名和密碼是否正確。

在Yii中實(shí)現(xiàn)基本認(rèn)證的步驟如下：

步驟1：創(chuàng)建一個(gè)認(rèn)證過(guò)濾器（AuthFilter）

首先，創(chuàng)建一個(gè)繼承自yii\filters\auth\AuthFilter的類，并重寫(xiě)authenticate()方法。例如：

namespace app\filters;

use yii\filters\auth\AuthFilter;

class BasicAuthFilter extends AuthFilter
{
    protected function authenticate()
    {
        if (!$this->request->user) {
            $this->request->user = \Yii::$app->user->loginByToken();
        }

        if ($this->request->user === false) {
            $credentials = $this->request->post('credentials');
            if ($credentials && $this->validateCredentials($credentials)) {
                $this->request->user = \Yii::$app->user->loginByToken($credentials['username'], $credentials['password']);
            }
        }

        return $this->request->user;
    }

    protected function validateCredentials($credentials)
    {
        return \Yii::$app->user->findIdentity($credentials['username']) !== null && \Yii::$app->user->validatePassword($credentials['password']);
    }
}

步驟2：配置認(rèn)證過(guò)濾器

在config/web.php文件中，將新創(chuàng)建的BasicAuthFilter添加到urlManager的auth屬性中：

'urlManager' => [
    // ...
    'auth' => [
        'class' => 'app\filters\BasicAuthFilter',
    ],
],

現(xiàn)在，當(dāng)客戶端向受保護(hù)的API發(fā)起請(qǐng)求時(shí)，需要在HTTP請(qǐng)求頭中添加Authorization字段，格式為Basic base64_encode(username:password)。例如：

Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=

2. OAuth 2.0認(rèn)證

OAuth 2.0是一種更現(xiàn)代且安全的認(rèn)證方式，允許第三方應(yīng)用在用戶授權(quán)的情況下訪問(wèn)受保護(hù)的資源。Yii框架支持OAuth 2.0認(rèn)證，可以通過(guò)使用yii2-oauth2-server擴(kuò)展來(lái)實(shí)現(xiàn)。

首先，安裝yii2-oauth2-server擴(kuò)展：

composer require "voku/helper"
composer require "yiisoft/yii2-oauth2-server"

接下來(lái)，配置OAuth 2.0服務(wù)器組件：

在config/web.php文件中，添加以下配置：

'components' => [
    // ...
    'oauth2Server' => [
        'class' => 'yii\oauth2server\OAuth2Server',
        'tokenParamName' => 'access_token',
        'tokenExpiration' => 3600,
        'refreshTokenExpiration' => 2592000,
        'scope' => ['read', 'write'],
        'user' => function ($id) {
            return \Yii::$app->user->findIdentity($id);
        },
    ],
],

現(xiàn)在，你可以使用OAuth 2.0客戶端（如Postman）來(lái)獲取訪問(wèn)令牌。在請(qǐng)求受保護(hù)的API時(shí)，需要在HTTP請(qǐng)求頭中添加Authorization字段，格式為Bearer {access_token}。例如：

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

這就是在Yii框架中實(shí)現(xiàn)RESTful API認(rèn)證的基本方法。你可以根據(jù)自己的需求選擇合適的認(rèn)證方式。