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..