IUserIdentity
Package | system.base |
---|---|
Inheritance | interface IUserIdentity |
Subclasses | CBaseUserIdentity, CUserIdentity |
Since | 1.0 |
Source Code | framework/base/interfaces.php |
IUserIdentity interface is implemented by a user identity class.
An identity represents a way to authenticate a user and retrieve information needed to uniquely identity the user. It is normally used with the user application component.
An identity represents a way to authenticate a user and retrieve information needed to uniquely identity the user. It is normally used with the user application component.
Public Methods
Method | Description | Defined By |
---|---|---|
authenticate() | Authenticates the user. | IUserIdentity |
getId() | Returns a value that uniquely represents the identity. | IUserIdentity |
getIsAuthenticated() | Returns a value indicating whether the identity is authenticated. | IUserIdentity |
getName() | Returns the display name for the identity (e.g. username). | IUserIdentity |
getPersistentStates() | Returns the additional identity information that needs to be persistent during the user session. | IUserIdentity |
Method Details
authenticate() method
abstract public boolean authenticate() | ||
{return} | boolean | whether authentication succeeds. |
Authenticates the user. The information needed to authenticate the user are usually provided in the constructor.
getId() method
abstract public mixed getId() | ||
{return} | mixed | a value that uniquely represents the identity (e.g. primary key value). |
Returns a value that uniquely represents the identity.
getIsAuthenticated() method
abstract public boolean getIsAuthenticated() | ||
{return} | boolean | whether the identity is valid. |
Returns a value indicating whether the identity is authenticated.
getName() method
abstract public string getName() | ||
{return} | string | the display name for the identity. |
Returns the display name for the identity (e.g. username).
getPersistentStates() method
abstract public array getPersistentStates() | ||
{return} | array | additional identity information that needs to be persistent during the user session (excluding id). |
Returns the additional identity information that needs to be persistent during the user session.
© 2008–2017 by Yii Software LLC
Licensed under the three clause BSD license.
http://www.yiiframework.com/doc/api/1.1/IUserIdentity