interface/modules/zend_modules/library/Zend/Permissions/Rbac/AbstractRole.php

   1 <?php
   2 /**
   3  * Zend Framework (http://framework.zend.com/)
   4  *
   5  * @link      http://github.com/zendframework/zf2 for the canonical source repository
   6  * @copyright Copyright (c) 2005-2013 Zend Technologies USA Inc. (http://www.zend.com)
   7  * @license   http://framework.zend.com/license/new-bsd New BSD License
   8  */
   9
  10 namespace Zend\Permissions\Rbac;
  11
  12 use RecursiveIteratorIterator;
  13
  14 abstract class AbstractRole extends AbstractIterator implements RoleInterface
  15 {
  16     /**
  17      * @var null|RoleInterface
  18      */
  19     protected $parent;
  20
  21     /**
  22      * @var string
  23      */
  24     protected $name;
  25
  26     /**
  27      * @var array
  28      */
  29     protected $permissions = array();
  30
  31     /**
  32      * Get the name of the role.
  33      *
  34      * @return string
  35      */
  36     public function getName()
  37     {
  38         return $this->name;
  39     }
  40
  41     /**
  42      * Add permission to the role.
  43      *
  44      * @param $name
  45      * @return RoleInterface
  46      */
  47     public function addPermission($name)
  48     {
  49         $this->permissions[$name] = true;
  50
  51         return $this;
  52     }
  53
  54     /**
  55      * Checks if a permission exists for this role or any child roles.
  56      *
  57      * @param  string $name
  58      * @return bool
  59      */
  60     public function hasPermission($name)
  61     {
  62         if (isset($this->permissions[$name])) {
  63             return true;
  64         }
  65
  66         $it = new RecursiveIteratorIterator($this, RecursiveIteratorIterator::CHILD_FIRST);
  67         foreach ($it as $leaf) {
  68             /** @var RoleInterface $leaf */
  69             if ($leaf->hasPermission($name)) {
  70                 return true;
  71             }
  72         }
  73
  74         return false;
  75     }
  76
  77     /**
  78      * Add a child.
  79      *
  80      * @param  RoleInterface|string $child
  81      * @return Role
  82      */
  83     public function addChild($child)
  84     {
  85         if (is_string($child)) {
  86             $child = new Role($child);
  87         }
  88         if (!$child instanceof RoleInterface) {
  89             throw new Exception\InvalidArgumentException(
  90                 'Child must be a string or implement Zend\Permissions\Rbac\RoleInterface'
  91             );
  92         }
  93
  94         $child->setParent($this);
  95         $this->children[] = $child;
  96
  97         return $this;
  98     }
  99
 100     /**
 101      * @param  RoleInterface $parent
 102      * @return RoleInterface
 103      */
 104     public function setParent($parent)
 105     {
 106         $this->parent = $parent;
 107
 108         return $this;
 109     }
 110
 111     /**
 112      * @return null|RoleInterface
 113      */
 114     public function getParent()
 115     {
 116         return $this->parent;
 117     }
 118 }