Yii2实现用户认证需配置user组件并实现IdentityInterface接口，通过自定义用户类处理身份验证。首先在config/web.php中设置identityClass指向用户模型；该模型须实现findIdentity、findIdentityByAccessToken、getId、getAuthKey和validateAuthKey方法，用于根据ID或令牌查找用户及验证密钥有效性。接着创建LoginForm表单模型，定义用户名密码字段及验证规则，其中validatePassword调用用户模型的密码验证逻辑。在SiteController的actionLogin中处理登录提交，使用Yii::$app->user->login()完成登录。用户模型中使用Yii::$app->security进行密码哈希存储与校验，并提供findByUsername方法支持凭据查询。为提升用户体验，可在rules中自定义错误提示信息。对于API场景，可通过重写findIdentityByAccessToken实现Token认证，在登录后生成随机access_token并返回客户端，后续请求通过Bearer Token方式携带凭证，框架自动调用对应方法识别用户身份。整个流程结合RBAC可进一步实现细粒度权限控制。
Yii2框架实现用户认证，核心在于配置user组件，并结合IdentityInterface接口实现自定义用户类。简而言之，就是告诉Yii2，用户是谁，以及如何验证他们的身份。
解决方案：
-
配置
user组件： 在config/web.php或config/console.php（如果需要在控制台进行用户认证）中配置user组件。核心是identityClass属性，指向你自定义的用户类。例如：'components' => [ 'user' => [ 'identityClass' => 'app\models\User', // 替换成你的用户类 'enableAutoLogin' => true, ], // ... 其他组件 ], -
实现
IdentityInterface接口： 你的用户类（例如app\models\User）需要实现yii\web\IdentityInterface接口。这个接口定义了用于用户认证的核心方法：-
public static function findIdentity($id): 根据用户ID查找用户。 -
public static function findIdentityByAccessToken($token, $type = null): 根据访问令牌查找用户（用于API认证）。 -
public function getId(): 返回用户的ID。 -
public function getAuthKey(): 返回用户的认证密钥（用于cookie认证）。 -
public function validateAuthKey($authKey): 验证认证密钥是否有效。
一个简单的例子：
namespace app\models; use yii\web\IdentityInterface; class User extends \yii\db\ActiveRecord implements IdentityInterface { public static function findIdentity($id) { return static::findOne($id); } public static function findIdentityByAccessToken($token, $type = null) { // 实现你的逻辑，例如从数据库中查找 return static::findOne(['access_token' => $token]); } public function getId() { return $this->id; } public function getAuthKey() { return $this->auth_key; } public function validateAuthKey($authKey) { return $this->auth_key === $authKey; } } -
-
创建登录表单和控制器： 创建一个登录表单（例如
LoginForm）和一个控制器（例如SiteController）来处理用户登录。LoginForm应该包含用户名和密码字段，并实现验证逻辑。SiteController的actionLogin方法应该处理表单提交，验证用户身份，并使用Yii::$app->user->login()方法登录用户。// LoginForm.php namespace app\models; use yii\base\Model; use app\models\User; class LoginForm extends Model { public $username; public $password; private $_user = false; public function rules() { return [ [['username', 'password'], 'required'], ['password', 'validatePassword'], ]; } public function validatePassword($attribute, $params) { if (!$this->hasErrors()) { $user = $this->getUser(); if (!$user || !$user->validatePassword($this->password)) { $this->addError($attribute, 'Incorrect username or password.'); } } } public function getUser() { if ($this->_user === false) { $this->_user = User::findByUsername($this->username); } return $this->_user; } } // SiteController.php namespace app\controllers; use Yii; use yii\filters\AccessControl; use yii\web\Controller; use app\models\LoginForm; class SiteController extends Controller { public function actionLogin() { $model = new LoginForm(); if ($model->load(Yii::$app->request->post()) && $model->login()) { return $this->goBack(); } return $this->render('login', [ 'model' => $model, ]); } } -
用户模型中的密码验证： 在你的用户模型（
app\models\User）中，你需要添加密码验证的逻辑。这通常涉及到密码哈希存储和验证。// app\models\User.php public function validatePassword($password) { return Yii::$app->security->validatePassword($password, $this->password_hash); } public static function findByUsername($username) { return static::findOne(['username' => $username]); } // 在用户注册时，需要哈希密码 public function setPassword($password) { $this->password_hash = Yii::$app->security->generatePasswordHash($password); }
Yii2用户认证流程详解：从登录到权限控制
用户认证不仅仅是登录，还包括权限控制。Yii2提供了强大的RBAC（Role-Based Access Control）机制。在用户成功登录后，可以根据用户的角色或权限来控制他们对不同资源的访问。 例如，你可以创建一个管理员角色，并赋予其管理所有用户的权限。
如何自定义Yii2用户认证的错误信息？
默认情况下，Yii2的错误信息可能不够友好。你可以通过修改LoginForm的rules()方法，或者在控制器中手动添加错误信息，来自定义错误信息。例如：
// LoginForm.php
public function rules()
{
return [
[['username', 'password'], 'required', 'message' => 'Please fill in this field.'], // 自定义必填字段的错误信息
['password', 'validatePassword', 'message' => 'Incorrect username or password.'], // 自定义密码验证的错误信息
];
}Yii2中基于Token的API认证如何实现？
对于API，通常使用Token认证。 findIdentityByAccessToken() 方法就派上用场了。你需要：
- 生成Token： 在用户登录成功后，生成一个唯一的Token，并将其存储在数据库中。
- 发送Token： 将Token作为API请求的Header或参数发送。
-
验证Token： 在
findIdentityByAccessToken()方法中，根据Token查找用户。
一个简单的例子：
// app\models\User.php
public static function findIdentityByAccessToken($token, $type = null)
{
return static::findOne(['access_token' => $token]);
}
// 在用户登录成功后
$user = User::findByUsername($username);
$user->access_token = Yii::$app->security->generateRandomString();
$user->save();
// API请求
// Authorization: Bearer <token> 
