Complex classes like UserPermissionsComponent often do a lot of different things. To break such a class down, we need to identify a cohesive component within that class. A common approach to find such a component is to look for fields/methods that share the same prefixes, or suffixes. You can also have a look at the cohesion graph to spot any un-connected, or weakly-connected components.
Once you have determined the fields that belong together, you can apply the Extract Class refactoring. If the component makes sense as a sub-class, Extract Subclass is also a candidate, and is often faster.
While breaking up the class, it is a good idea to analyze how other classes use UserPermissionsComponent, and based on these observations, apply Extract Interface, too.
| 1 | <?php |
||
| 12 | class UserPermissionsComponent extends Component { |
||
| 13 | |||
| 14 | /** |
||
| 15 | * Controller name |
||
| 16 | * |
||
| 17 | * @var string |
||
| 18 | */ |
||
| 19 | public $controller = null; |
||
| 20 | |||
| 21 | /** |
||
| 22 | * Session |
||
| 23 | * |
||
| 24 | * @var string |
||
| 25 | */ |
||
| 26 | public $session = null; |
||
| 27 | |||
| 28 | /** |
||
| 29 | * Components array |
||
| 30 | * |
||
| 31 | * @var array |
||
| 32 | */ |
||
| 33 | public $components = ['Flash']; |
||
| 34 | |||
| 35 | private $actions; |
||
| 36 | |||
| 37 | private $allow; |
||
| 38 | |||
| 39 | private $redirect; |
||
| 40 | |||
| 41 | private $params; |
||
| 42 | |||
| 43 | private $message; |
||
| 44 | |||
| 45 | private $userType; |
||
| 46 | |||
| 47 | private $action; |
||
| 48 | |||
| 49 | /** |
||
| 50 | * Boolean value which holds the configuration for the behavior in case of |
||
| 51 | * missing handlers. |
||
| 52 | */ |
||
| 53 | private $throwEx; |
||
| 54 | |||
| 55 | /** |
||
| 56 | * Boolean value true if an redirect is already invoked. |
||
| 57 | */ |
||
| 58 | private $isRedirecting; |
||
| 59 | |||
| 60 | /** |
||
| 61 | * Initialization to get controller variable |
||
| 62 | * |
||
| 63 | * For this component available settings: |
||
| 64 | 7 | * bool throwEx - default false - if set to true, an exception will be |
|
| 65 | * thrown, if a handler is about to be called but does not exist. |
||
| 66 | 7 | * |
|
| 67 | * @param array $config Configuration array for the component. |
||
| 68 | 7 | */ |
|
| 69 | 7 | public function initialize(array $config) |
|
| 70 | { |
||
| 71 | 7 | parent::initialize($config); |
|
| 72 | 7 | ||
| 73 | 7 | $this->controller = $this->_registry->getController(); |
|
|
|
|||
| 74 | 7 | $this->session = $this->controller->request->session(); |
|
| 75 | 7 | ||
| 76 | 7 | $this->actions = array(); |
|
| 77 | 7 | $this->allow = true; |
|
| 78 | 7 | $this->redirect = null; |
|
| 79 | 7 | $this->params = ''; |
|
| 80 | $this->message = ''; |
||
| 81 | $this->userType = ''; |
||
| 82 | $this->action = null; |
||
| 83 | $this->throwEx = isset($config["throwEx"]) && $config["throwEx"]; |
||
| 84 | $this->isRedirecting = false; |
||
| 85 | } |
||
| 86 | |||
| 87 | 7 | /** |
|
| 88 | 7 | * Initialization to get controller variable |
|
| 89 | 7 | * |
|
| 90 | * @param array $rules Array of rules for permissions. |
||
| 91 | 7 | * @return bool false if user / group doesn't have permission, true if has permission |
|
| 92 | 7 | */ |
|
| 93 | public function allow ($rules) { |
||
| 94 | $this->setUserValues(); |
||
| 95 | 6 | $this->bindConfiguration($rules); |
|
| 96 | |||
| 97 | if (!$this->applyGroupsRules($rules)) { |
||
| 98 | 7 | $this->applyViewsRules($rules); |
|
| 99 | } |
||
| 100 | 7 | ||
| 101 | return $this->allow; |
||
| 102 | 7 | } |
|
| 103 | 7 | ||
| 104 | private function setUserValues() |
||
| 105 | 7 | { |
|
| 106 | $userId = $this->session->read('Auth.User.id'); |
||
| 107 | 7 | ||
| 108 | if (!isset($userId)) { |
||
| 109 | 7 | $this->userType = 'guest'; |
|
| 110 | } |
||
| 111 | 7 | } |
|
| 112 | 7 | ||
| 113 | 7 | private function bindConfiguration(array $rules) |
|
| 114 | 7 | { |
|
| 115 | 7 | foreach($rules as $key => $value){ |
|
| 116 | 7 | switch($key){ |
|
| 117 | 7 | case "user_type": |
|
| 118 | 7 | $this->userType = $value; |
|
| 119 | 7 | break; |
|
| 120 | 7 | case "redirect": |
|
| 121 | 7 | $this->redirect = $value; |
|
| 122 | 7 | break; |
|
| 123 | case "action": |
||
| 124 | $this->action = $value; |
||
| 125 | 7 | break; |
|
| 126 | 7 | case "controller": |
|
| 127 | 7 | $this->controller = $value; |
|
| 128 | 7 | if(!is_object($value)) { |
|
| 129 | Log::write("warning", sprintf("controller is not an object (%s)", gettype($value))); |
||
| 130 | } |
||
| 131 | break; |
||
| 132 | 7 | case "message": |
|
| 133 | 7 | $this->message = $value; |
|
| 134 | 7 | break; |
|
| 135 | 7 | } |
|
| 136 | } |
||
| 137 | |||
| 138 | foreach($rules['groups'] as $key => $value){ |
||
| 139 | 7 | if($key == $this->userType){ |
|
| 140 | foreach($value as $v){ |
||
| 141 | 7 | array_push($this->actions, $v); |
|
| 142 | } |
||
| 143 | 7 | } |
|
| 144 | } |
||
| 145 | 7 | } |
|
| 146 | 7 | ||
| 147 | 7 | private function applyGroupsRules(array $rules) |
|
| 159 | |||
| 160 | 2 | private function searchForApplyGroupRules($key) |
|
| 161 | { |
||
| 162 | if($key == $this->userType){ |
||
| 163 | 7 | if ($this->notInArrayAction()) { |
|
| 164 | $this->redirectIfIsSet(); |
||
| 165 | 7 | ||
| 166 | $this->allow = false; |
||
| 167 | 7 | } |
|
| 168 | } |
||
| 169 | } |
||
| 170 | 7 | ||
| 171 | private function notInArrayAction() |
||
| 172 | 7 | { |
|
| 173 | 4 | return ((!in_array('*', $this->actions)) && (!in_array($this->action, $this->actions))); |
|
| 174 | 4 | } |
|
| 175 | |||
| 176 | private function applyViewsRules(array $rules) |
||
| 184 | |||
| 185 | 2 | private function searchForApplyViewRules($key, $value) |
|
| 195 | 2 | ||
| 196 | 2 | private function checkForHandler($controller, $handler) |
|
| 197 | 2 | { |
|
| 198 | if(!method_exists($controller, $handler)) { |
||
| 199 | 2 | $msg = sprintf( |
|
| 200 | 2 | "Controller %s=%s has no method called '%s'", |
|
| 201 | 1 | is_object($controller) ? "class" : "type", |
|
| 214 | |||
| 215 | private function redirectIfIsSet() |
||
| 232 | } |
||
| 233 |
Our type inference engine has found an assignment to a property that is incompatible with the declared type of that property.
Either this assignment is in error or the assigned type should be added to the documentation/type hint for that property..