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 |
||
10 | abstract class AbstractObject implements ObjectInterface |
||
11 | { |
||
12 | private $recordType; |
||
13 | |||
14 | /** |
||
15 | * @param string $method |
||
16 | * @param string $url |
||
17 | * @param array $options |
||
18 | * |
||
19 | * @return string |
||
20 | */ |
||
21 | private function sendRequest(string $method, string $url, array $options = []): string |
||
41 | |||
42 | /** |
||
43 | * Get latest version. |
||
44 | * |
||
45 | * @return mixed |
||
46 | */ |
||
47 | protected function getVersion() |
||
51 | |||
52 | /** |
||
53 | * Get all organisation limits. |
||
54 | */ |
||
55 | protected function listOrganisationLimits() |
||
59 | |||
60 | /** |
||
61 | * List all available resources. |
||
62 | * |
||
63 | * @return mixed |
||
64 | */ |
||
65 | protected function listAvailableResources() |
||
69 | |||
70 | /** |
||
71 | * List all objects. |
||
72 | * |
||
73 | * @return mixed |
||
74 | */ |
||
75 | protected function listObjects() |
||
79 | |||
80 | /** |
||
81 | * Describe an object. |
||
82 | * |
||
83 | * @param $objectName |
||
84 | * |
||
85 | * @return mixed |
||
86 | */ |
||
87 | protected function describeObject($objectName) |
||
91 | |||
92 | /** |
||
93 | * Describe basic object. |
||
94 | * |
||
95 | * @param $objectName |
||
96 | * |
||
97 | * @return mixed |
||
98 | */ |
||
99 | protected function describeBasicObject($objectName) |
||
103 | |||
104 | /** |
||
105 | * Run Salesforce query. |
||
106 | * |
||
107 | * @param $query |
||
108 | * |
||
109 | * @return mixed |
||
110 | */ |
||
111 | protected function query($query) |
||
117 | |||
118 | /** |
||
119 | * Get record. |
||
120 | * |
||
121 | * @param $id |
||
122 | * @param array $fields |
||
123 | * |
||
124 | * @return bool|mixed |
||
125 | */ |
||
126 | public function get($id, array $fields = []) |
||
140 | |||
141 | /** |
||
142 | * Update. |
||
143 | * |
||
144 | * @param $id |
||
145 | * @param $params |
||
146 | * @return bool|mixed |
||
147 | * @throws SalesforceException |
||
148 | */ |
||
149 | public function update($id, array $params) |
||
173 | |||
174 | /** |
||
175 | * Insert new account. |
||
176 | * |
||
177 | * @param $params |
||
178 | * |
||
179 | * @return bool |
||
180 | * @throws SalesforceException |
||
181 | */ |
||
182 | View Code Duplication | public function create($params) |
|
198 | |||
199 | /** |
||
200 | * Delete a given record |
||
201 | * |
||
202 | * @param string $type |
||
203 | * @param string $id |
||
204 | * @return bool |
||
205 | * @throws SalesforceException |
||
206 | */ |
||
207 | View Code Duplication | public function delete(string $type, string $id) |
|
221 | |||
222 | } |
||
223 |
In PHP it is possible to write to properties without declaring them. For example, the following is perfectly valid PHP code:
Generally, it is a good practice to explictly declare properties to avoid accidental typos and provide IDE auto-completion: