PHP Class yii\mongodb\rbac\MongoDbManager

Manager uses 3 collections for the RBAC data storage: - [[itemCollection]] - stores item data and item parents list - [[assignmentCollection]] - stores assignments info - [[ruleCollection]] - stores rule data These collection are better to be pre-created with search fields indexed.
Since: 2.0.5
Author: Paul Klimov ([email protected])
Inheritance: extends yii\rbac\BaseManager
Afficher le fichier Open project: yiisoft/yii2-mongodb

Méthodes publiques

Свойство Type Description
$assignmentCollection the name of the collection storing authorization item assignments. Defaults to "auth_assignment".
$cache the cache used to improve RBAC performance. This can be one of the following: - an application component ID (e.g. cache) - a configuration array - a Cache object When this is not set, it means caching is not enabled. Note that by enabling RBAC cache, all auth items, rules and auth item parent-child relationships will be cached and loaded into memory. This will improve the performance of RBAC permission check. However, it does require extra memory and as a result may not be appropriate if your RBAC system contains too many auth items. You should seek other RBAC implementations (e.g. RBAC based on Redis storage) in this case. Also note that if you modify RBAC items, rules or parent-child relationships from outside of this component, you have to manually call MongoDbManager::invalidateCache to ensure data consistency.
$cacheKey the key used to store RBAC data in cache
$db the MongoDB connection object or the application component ID of the MongoDB connection. After the MongoDbManager object is created, if you want to change this property, you should only assign it with a MongoDB connection object.
$itemCollection the name of the collection storing authorization items. Defaults to "auth_item".
$ruleCollection the name of the collection storing rules. Defaults to "auth_rule".

Protected Properties

Свойство Type Description
$items all auth items (name => Item)
$rules all auth rules (name => Rule)

Méthodes publiques

Méthode Description
addChild ( $parent, $child )
assign ( $role, $userId )
canAddChild ( $parent, $child )
checkAccess ( $userId, $permissionName, $params = [] )
getAssignment ( $roleName, $userId )
getAssignments ( $userId )
getChildRoles ( $roleName )
getChildren ( $name )
getPermissionsByRole ( $roleName )
getPermissionsByUser ( $userId )
getRolesByUser ( $userId )
getRule ( $name )
getRules ( )
getUserIdsByRole ( $roleName )
hasChild ( $parent, $child )
init ( ) Initializes the application component.
invalidateCache ( ) Invalidates RBAC related cache
loadFromCache ( ) Loads data from cache
removeAll ( )
removeAllAssignments ( )
removeAllPermissions ( )
removeAllRoles ( )
removeAllRules ( )
removeChild ( $parent, $child )
removeChildren ( $parent )
revoke ( $role, $userId )
revokeAll ( $userId )

Méthodes protégées

Méthode Description
addItem ( $item )
addRule ( $rule )
checkAccessFromCache ( string | integer $user, string $itemName, array $params, Assignment[] $assignments ) : boolean Performs access check for the specified user based on the data loaded from cache.
checkAccessRecursive ( string | integer $user, string $itemName, array $params, Assignment[] $assignments ) : boolean Performs access check for the specified user.
detectLoop ( Item $parent, Item $child ) : boolean Checks whether there is a loop in the authorization item hierarchy.
getChildrenList ( ) : array Returns the children for every parent.
getChildrenRecursive ( string $name, array $childrenList, array &$result ) Recursively finds all children and grand children of the specified item.
getItem ( $name )
getItems ( $type )
populateItem ( array $row ) : Item Populates an auth item with the data fetched from collection
removeAllItems ( integer $type ) Removes all auth items of the specified type.
removeItem ( $item )
removeRule ( $rule )
updateItem ( $name, $item )
updateRule ( $name, $rule )

Method Details

addChild() public méthode

public addChild ( $parent, $child )

addItem() protected méthode

protected addItem ( $item )

addRule() protected méthode

protected addRule ( $rule )

assign() public méthode

public assign ( $role, $userId )

canAddChild() public méthode

public canAddChild ( $parent, $child )

checkAccess() public méthode

public checkAccess ( $userId, $permissionName, $params = [] )

checkAccessFromCache() protected méthode

This method is internally called by MongoDbManager::checkAccess when [[cache]] is enabled.
protected checkAccessFromCache ( string | integer $user, string $itemName, array $params, Assignment[] $assignments ) : boolean
$user string | integer the user ID. This should can be either an integer or a string representing the unique identifier of a user. See [[\yii\web\User::id]].
$itemName string the name of the operation that need access check
$params array name-value pairs that would be passed to rules associated with the tasks and roles assigned to the user. A param with name 'user' is added to this array, which holds the value of `$userId`.
$assignments yii\rbac\Assignment[] the assignments to the specified user
Résultat boolean whether the operations can be performed by the user.

checkAccessRecursive() protected méthode

This method is internally called by MongoDbManager::checkAccess.
protected checkAccessRecursive ( string | integer $user, string $itemName, array $params, Assignment[] $assignments ) : boolean
$user string | integer the user ID. This should can be either an integer or a string representing the unique identifier of a user. See [[\yii\web\User::id]].
$itemName string the name of the operation that need access check
$params array name-value pairs that would be passed to rules associated with the tasks and roles assigned to the user. A param with name 'user' is added to this array, which holds the value of `$userId`.
$assignments yii\rbac\Assignment[] the assignments to the specified user
Résultat boolean whether the operations can be performed by the user.

detectLoop() protected méthode

Checks whether there is a loop in the authorization item hierarchy.
protected detectLoop ( Item $parent, Item $child ) : boolean
$parent yii\rbac\Item the parent item
$child yii\rbac\Item the child item to be added to the hierarchy
Résultat boolean whether a loop exists

getAssignment() public méthode

public getAssignment ( $roleName, $userId )

getAssignments() public méthode

public getAssignments ( $userId )

getChildRoles() public méthode

Since: 2.1.2
public getChildRoles ( $roleName )

getChildren() public méthode

public getChildren ( $name )

getChildrenList() protected méthode

Returns the children for every parent.
protected getChildrenList ( ) : array
Résultat array the children list. Each array key is a parent item name, and the corresponding array value is a list of child item names.

getChildrenRecursive() protected méthode

Recursively finds all children and grand children of the specified item.
protected getChildrenRecursive ( string $name, array $childrenList, array &$result )
$name string the name of the item whose children are to be looked for.
$childrenList array the child list built via [[getChildrenList()]]
$result array the children and grand children (in array keys)

getItem() protected méthode

protected getItem ( $name )

getItems() protected méthode

protected getItems ( $type )

getPermissionsByRole() public méthode

public getPermissionsByRole ( $roleName )

getPermissionsByUser() public méthode

public getPermissionsByUser ( $userId )

getRolesByUser() public méthode

public getRolesByUser ( $userId )

getRule() public méthode

public getRule ( $name )

getRules() public méthode

public getRules ( )

getUserIdsByRole() public méthode

public getUserIdsByRole ( $roleName )

hasChild() public méthode

public hasChild ( $parent, $child )

init() public méthode

This method overrides the parent implementation by establishing the MongoDB connection.
public init ( )

invalidateCache() public méthode

Invalidates RBAC related cache
public invalidateCache ( )

loadFromCache() public méthode

Loads data from cache
public loadFromCache ( )

populateItem() protected méthode

Populates an auth item with the data fetched from collection
protected populateItem ( array $row ) : Item
$row array the data from the auth item collection
Résultat yii\rbac\Item the populated auth item instance (either Role or Permission)

removeAll() public méthode

public removeAll ( )

removeAllAssignments() public méthode

removeAllItems() protected méthode

Removes all auth items of the specified type.
protected removeAllItems ( integer $type )
$type integer the auth item type (either Item::TYPE_PERMISSION or Item::TYPE_ROLE)

removeAllPermissions() public méthode

removeAllRoles() public méthode

public removeAllRoles ( )

removeAllRules() public méthode

public removeAllRules ( )

removeChild() public méthode

public removeChild ( $parent, $child )

removeChildren() public méthode

public removeChildren ( $parent )

removeItem() protected méthode

protected removeItem ( $item )

removeRule() protected méthode

protected removeRule ( $rule )

revoke() public méthode

public revoke ( $role, $userId )

revokeAll() public méthode

public revokeAll ( $userId )

updateItem() protected méthode

protected updateItem ( $name, $item )

updateRule() protected méthode

protected updateRule ( $name, $rule )

Property Details

$assignmentCollection public_oe property

the name of the collection storing authorization item assignments. Defaults to "auth_assignment".
public $assignmentCollection

$cache public_oe property

the cache used to improve RBAC performance. This can be one of the following: - an application component ID (e.g. cache) - a configuration array - a Cache object When this is not set, it means caching is not enabled. Note that by enabling RBAC cache, all auth items, rules and auth item parent-child relationships will be cached and loaded into memory. This will improve the performance of RBAC permission check. However, it does require extra memory and as a result may not be appropriate if your RBAC system contains too many auth items. You should seek other RBAC implementations (e.g. RBAC based on Redis storage) in this case. Also note that if you modify RBAC items, rules or parent-child relationships from outside of this component, you have to manually call MongoDbManager::invalidateCache to ensure data consistency.
public $cache

$cacheKey public_oe property

the key used to store RBAC data in cache
See also: cache
public $cacheKey

$db public_oe property

the MongoDB connection object or the application component ID of the MongoDB connection. After the MongoDbManager object is created, if you want to change this property, you should only assign it with a MongoDB connection object.
public $db

$itemCollection public_oe property

the name of the collection storing authorization items. Defaults to "auth_item".
public $itemCollection

$items protected_oe property

all auth items (name => Item)
protected $items

$ruleCollection public_oe property

the name of the collection storing rules. Defaults to "auth_rule".
public $ruleCollection

$rules protected_oe property

all auth rules (name => Rule)
protected $rules