Complex classes like Plugin 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 Plugin, and based on these observations, apply Extract Interface, too.
1 | <?php |
||
29 | class Plugin implements PluginInterface, EventSubscriberInterface |
||
30 | { |
||
31 | const YII2_PACKAGE_TYPE = 'yii2-extension'; |
||
32 | const EXTRA_OPTION_NAME = 'config-plugin'; |
||
33 | |||
34 | /** |
||
35 | * @var PackageInterface[] the array of active composer packages |
||
36 | */ |
||
37 | protected $packages; |
||
38 | |||
39 | /** |
||
40 | * @var string absolute path to the package base directory |
||
41 | */ |
||
42 | protected $baseDir; |
||
43 | |||
44 | /** |
||
45 | * @var string absolute path to vendor directory |
||
46 | */ |
||
47 | protected $vendorDir; |
||
48 | |||
49 | /** |
||
50 | * @var Filesystem utility |
||
51 | */ |
||
52 | protected $filesystem; |
||
53 | |||
54 | /** |
||
55 | * @var array config name => list of files |
||
56 | */ |
||
57 | protected $files = [ |
||
58 | 'defines' => [], |
||
59 | 'params' => [], |
||
60 | ]; |
||
61 | |||
62 | protected $aliases = []; |
||
63 | |||
64 | protected $extensions = []; |
||
65 | |||
66 | /** |
||
67 | * @var array array of not yet merged params |
||
68 | */ |
||
69 | protected $rawParams = []; |
||
70 | |||
71 | /** |
||
72 | * @var Composer instance |
||
73 | */ |
||
74 | protected $composer; |
||
75 | |||
76 | /** |
||
77 | * @var IOInterface |
||
78 | */ |
||
79 | public $io; |
||
80 | |||
81 | /** |
||
82 | * Initializes the plugin object with the passed $composer and $io. |
||
83 | * @param Composer $composer |
||
84 | * @param IOInterface $io |
||
85 | */ |
||
86 | 2 | public function activate(Composer $composer, IOInterface $io) |
|
91 | |||
92 | /** |
||
93 | * Returns list of events the plugin is subscribed to. |
||
94 | * @return array list of events |
||
95 | */ |
||
96 | 1 | public static function getSubscribedEvents() |
|
97 | { |
||
98 | return [ |
||
99 | 1 | ScriptEvents::POST_AUTOLOAD_DUMP => [ |
|
100 | 1 | ['onPostAutoloadDump', 0], |
|
101 | 1 | ], |
|
102 | 1 | ]; |
|
103 | } |
||
104 | |||
105 | /** |
||
106 | * This is the main function. |
||
107 | * @param Event $event |
||
108 | */ |
||
109 | public function onPostAutoloadDump(Event $event) |
||
122 | |||
123 | protected function scanPackages() |
||
131 | |||
132 | /** |
||
133 | * Scans the given package and collects extensions data. |
||
134 | * @param PackageInterface $package |
||
135 | */ |
||
136 | protected function processPackage(CompletePackageInterface $package) |
||
159 | |||
160 | protected function processFiles(CompletePackageInterface $package, array $files) |
||
171 | |||
172 | /** |
||
173 | * Collects package aliases. |
||
174 | * @param CompletePackageInterface $package |
||
175 | * @return array collected aliases |
||
176 | */ |
||
177 | protected function collectAliases(CompletePackageInterface $package) |
||
192 | |||
193 | /** |
||
194 | * Prepare aliases. |
||
195 | * @param PackageInterface $package |
||
196 | * @param string 'psr-0' or 'psr-4' |
||
197 | * @return array |
||
198 | */ |
||
199 | protected function prepareAliases(PackageInterface $package, $psr, $dev = false) |
||
223 | |||
224 | /** |
||
225 | * Builds path inside of a package. |
||
226 | * @param PackageInterface $package |
||
227 | * @param mixed $path can be absolute or relative |
||
228 | * @return string absolute pathes will stay untouched |
||
229 | */ |
||
230 | public function preparePath(PackageInterface $package, $path) |
||
246 | |||
247 | /** |
||
248 | 1 | * Sets [[packages]]. |
|
249 | * @param PackageInterface[] $packages |
||
250 | */ |
||
251 | public function setPackages(array $packages) |
||
255 | |||
256 | /** |
||
257 | * Gets [[packages]]. |
||
258 | * @return \Composer\Package\PackageInterface[] |
||
259 | */ |
||
260 | public function getPackages() |
||
268 | |||
269 | /** |
||
270 | * Plain list of all project dependencies (including nested) as provided by composer. |
||
271 | * The list is unordered (chaotic, can be different after every update). |
||
272 | */ |
||
273 | protected $plainList = []; |
||
274 | |||
275 | /** |
||
276 | * Ordered list of package. Order @see findPackages. |
||
277 | */ |
||
278 | protected $orderedList = []; |
||
279 | |||
280 | /** |
||
281 | * Returns ordered list of packages: |
||
282 | * - listed earlier in the composer.json will get earlier in the list |
||
283 | * - childs before parents. |
||
284 | * @return \Composer\Package\PackageInterface[] |
||
285 | */ |
||
286 | public function findPackages() |
||
308 | |||
309 | /** |
||
310 | * Iterates through package dependencies. |
||
311 | * @param PackageInterface $package to iterate |
||
312 | * @param bool $includingDev process development dependencies, defaults to not process |
||
313 | */ |
||
314 | public function iteratePackage(PackageInterface $package, $includingDev = false) |
||
334 | |||
335 | /** |
||
336 | * Iterates dependencies of the given package. |
||
337 | * @param PackageInterface $package |
||
338 | * @param bool $dev which dependencies to iterate: true - dev, default - general |
||
339 | */ |
||
340 | public function iterateDependencies(PackageInterface $package, $dev = false) |
||
356 | |||
357 | /** |
||
358 | * Get absolute path to package base dir. |
||
359 | * @return string |
||
360 | */ |
||
361 | public function getBaseDir() |
||
369 | |||
370 | /** |
||
371 | * Get absolute path to composer vendor dir. |
||
372 | * @return string |
||
373 | */ |
||
374 | public function getVendorDir() |
||
383 | |||
384 | /** |
||
385 | * Getter for filesystem utility. |
||
386 | * @return Filesystem |
||
387 | */ |
||
388 | public function getFilesystem() |
||
396 | } |
||
397 |
This check looks from parameters that have been defined for a function or method, but which are not used in the method body.