Implemented by | yii\debug\models\search\UserSearchInterface |
---|---|
Available since version | 2.0 |
Source Code | https://github.com/yiisoft/yii2/blob/master/framework/web/IdentityInterface.php |
IdentityInterface is the interface that should be implemented by a class providing identity information.
This interface can typically be implemented by a user model class. For example, the following code shows how to implement this interface by a User ActiveRecord class:
class User extends 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->authKey; } public function validateAuthKey($authKey) { return $this->authKey === $authKey; } }
Method | Description | Defined By |
---|---|---|
findIdentity() | Finds an identity by the given ID. | yii\web\IdentityInterface |
findIdentityByAccessToken() | Finds an identity by the given token. | yii\web\IdentityInterface |
getAuthKey() | Returns a key that can be used to check the validity of a given identity ID. | yii\web\IdentityInterface |
getId() | Returns an ID that can uniquely identify a user identity. | yii\web\IdentityInterface |
validateAuthKey() | Validates the given auth key. | yii\web\IdentityInterface |
Finds an identity by the given ID.
public abstract static yii\web\IdentityInterface findIdentity ( $id ) | ||
---|---|---|
$id | string|integer |
The ID to be looked for |
return | yii\web\IdentityInterface |
The identity object that matches the given ID. Null should be returned if such an identity cannot be found or the identity is not in an active state (disabled, deleted, etc.) |
Finds an identity by the given token.
public abstract static yii\web\IdentityInterface findIdentityByAccessToken ( $token, $type = null ) | ||
---|---|---|
$token | mixed |
The token to be looked for |
$type | mixed |
The type of the token. The value of this parameter depends on the implementation. For example, yii\filters\auth\HttpBearerAuth will set this parameter to be |
return | yii\web\IdentityInterface |
The identity object that matches the given token. Null should be returned if such an identity cannot be found or the identity is not in an active state (disabled, deleted, etc.) |
Returns a key that can be used to check the validity of a given identity ID.
The key should be unique for each individual user, and should be persistent so that it can be used to check the validity of the user identity.
The space of such keys should be big enough to defeat potential identity attacks.
This is required if yii\web\User::$enableAutoLogin is enabled.
See also validateAuthKey().
public abstract string getAuthKey ( ) | ||
---|---|---|
return | string |
A key that is used to check the validity of a given identity ID. |
Returns an ID that can uniquely identify a user identity.
public abstract string|integer getId ( ) | ||
---|---|---|
return | string|integer |
An ID that uniquely identifies a user identity. |
Validates the given auth key.
This is required if yii\web\User::$enableAutoLogin is enabled.
See also getAuthKey().
public abstract boolean validateAuthKey ( $authKey ) | ||
---|---|---|
$authKey | string |
The given auth key |
return | boolean |
Whether the given auth key is valid. |
© 2008–2017 by Yii Software LLC
Licensed under the three clause BSD license.
http://www.yiiframework.com/doc-2.0/yii-web-identityinterface.html