Duplicate code is one of the most pungent code smells. A rule that is often used is to re-structure code once it is duplicated in three or more places.
Common duplication problems, and corresponding solutions are:
1 | <?php |
||
19 | class LayoutHelper extends Base |
||
20 | { |
||
21 | /** |
||
22 | * Render a template without the layout if Ajax request. |
||
23 | * |
||
24 | * @param string $template Template name |
||
25 | * @param array $params Template parameters |
||
26 | * |
||
27 | * @return string |
||
28 | */ |
||
29 | public function app($template, array $params = []) |
||
42 | |||
43 | /** |
||
44 | * Common layout for profile views. |
||
45 | * |
||
46 | * @param string $template Template name |
||
47 | * @param array $params Template parameters |
||
48 | * @param string $subside |
||
49 | * |
||
50 | * @return string |
||
51 | */ |
||
52 | public function profile($template, array $params, $subside = 'profile/_partials/subnav') |
||
60 | |||
61 | /** |
||
62 | * Common layout for task views. |
||
63 | * |
||
64 | * @param string $template Template name |
||
65 | * @param array $params Template parameters |
||
66 | * |
||
67 | * @return string |
||
68 | */ |
||
69 | public function task($template, array $params) |
||
76 | |||
77 | /** |
||
78 | * Common layout for project views. |
||
79 | * |
||
80 | * @param string $template |
||
81 | * @param array $params |
||
82 | * @param string $subside |
||
83 | * |
||
84 | * @return string |
||
85 | */ |
||
86 | public function project($template, array $params, $subside = 'manage/project_settings/subside') |
||
96 | |||
97 | /** |
||
98 | * Common layout for project user views. |
||
99 | * |
||
100 | * @param string $template |
||
101 | * @param array $params |
||
102 | * |
||
103 | * @return string |
||
104 | */ |
||
105 | public function projectUser($template, array $params) |
||
111 | |||
112 | /** |
||
113 | * Common layout for admin views. |
||
114 | * |
||
115 | * @param string $template |
||
116 | * @param array $params |
||
117 | * @param string $subside |
||
118 | * |
||
119 | * @return string |
||
120 | */ |
||
121 | public function admin($template, array $params, $subside = 'admin/setting/subside') |
||
133 | |||
134 | /** |
||
135 | * Common layout for dashboard views. |
||
136 | * |
||
137 | * @param string $template |
||
138 | * @param array $params |
||
139 | * @param string $subside |
||
140 | * |
||
141 | * @return string |
||
142 | */ |
||
143 | public function dashboard($template, array $params, $subside = 'dashboard/_partials/subnav') |
||
147 | |||
148 | /** |
||
149 | * Common layout for analytic views. |
||
150 | * |
||
151 | * @param string $template |
||
152 | * @param array $params |
||
153 | * |
||
154 | * @return string |
||
155 | */ |
||
156 | public function analytic($template, array $params, $subside = 'project/analytic/_partials/subside') |
||
157 | { |
||
158 | View Code Duplication | if (isset($params['project']['name'])) { |
|
159 | $params['title'] = $params['project']['name'].' » '.$params['title']; |
||
160 | } |
||
161 | |||
162 | return $this->subLayout('project/analytic/layout', $subside, $template, $params); |
||
163 | } |
||
164 | |||
165 | /** |
||
166 | * Common method to generate a sub-layout. |
||
167 | * |
||
168 | * @param string $sublayout |
||
169 | * @param string $subside |
||
170 | * @param string $template |
||
171 | * @param array $params |
||
172 | * |
||
173 | * @return string |
||
174 | */ |
||
175 | protected function subLayout($sublayout, $subside, $template, array $params = []) |
||
188 | } |
||
189 |
Since your code implements the magic getter
_get
, this function will be called for any read access on an undefined variable. You can add the@property
annotation to your class or interface to document the existence of this variable.If the property has read access only, you can use the @property-read annotation instead.
Of course, you may also just have mistyped another name, in which case you should fix the error.
See also the PhpDoc documentation for @property.