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