| Total Complexity | 50 |
| Total Lines | 284 |
| Duplicated Lines | 0 % |
| Changes | 2 | ||
| Bugs | 1 | Features | 0 |
Complex classes like FindFiles 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.
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 FindFiles, and based on these observations, apply Extract Interface, too.
| 1 | <?php |
||
| 5 | class FindFiles |
||
| 6 | { |
||
| 7 | protected $myMu = null; |
||
| 8 | |||
| 9 | protected $defaultOptions = ''; |
||
| 10 | |||
| 11 | protected static $inst = null; |
||
| 12 | |||
| 13 | //generic search settings |
||
| 14 | |||
| 15 | private $needToFillFileCache = true; |
||
| 16 | |||
| 17 | private $searchPath = ''; |
||
| 18 | |||
| 19 | private $relevantFolders = []; |
||
| 20 | |||
| 21 | private $defaultIgnoreFolderArray = [ |
||
| 22 | '.svn', |
||
| 23 | '.git', |
||
| 24 | ]; |
||
| 25 | |||
| 26 | private $ignoreFolderArray = []; |
||
| 27 | |||
| 28 | private $extensions = ['php', 'ss', 'yml', 'yaml', 'json', 'js', 'md']; |
||
| 29 | |||
| 30 | private $findAllExts = false; |
||
| 31 | |||
| 32 | private $recursive = true; |
||
| 33 | |||
| 34 | private $ignoreHiddenFilesAndFolders = true; |
||
| 35 | |||
| 36 | // files |
||
| 37 | |||
| 38 | /** |
||
| 39 | * array of all the files we are searching |
||
| 40 | * @var array |
||
| 41 | */ |
||
| 42 | private $fileArray = []; |
||
| 43 | |||
| 44 | private $flatFileArray = []; |
||
| 45 | |||
| 46 | public static function inst(): self |
||
| 52 | } |
||
| 53 | |||
| 54 | /** |
||
| 55 | * Sets folders to ignore |
||
| 56 | */ |
||
| 57 | public function setIgnoreFolderArray(?array $ignoreFolderArray = []): FindFiles |
||
| 58 | { |
||
| 59 | if ($this->ignoreFolderArray === $ignoreFolderArray) { |
||
| 60 | //do nothing |
||
| 61 | } else { |
||
| 62 | $this->ignoreFolderArray = $ignoreFolderArray; |
||
| 63 | $this->resetFileCache(); |
||
| 64 | } |
||
| 65 | |||
| 66 | return $this; |
||
| 67 | } |
||
| 68 | |||
| 69 | /** |
||
| 70 | * Sets folders to ignore |
||
| 71 | */ |
||
| 72 | public function addToIgnoreFolderArray(?array $ignoreFolderArray = []): FindFiles |
||
| 73 | { |
||
| 74 | $oldIgnoreFolderArray = $this->ignoreFolderArray; |
||
| 75 | $this->ignoreFolderArray = array_unique( |
||
| 76 | array_merge( |
||
| 77 | $ignoreFolderArray, |
||
| 78 | $this->defaultIgnoreFolderArray |
||
| 79 | ) |
||
| 80 | ); |
||
| 81 | if ($oldIgnoreFolderArray !== $this->ignoreFolderArray) { |
||
| 82 | $this->resetFileCache(); |
||
| 83 | } |
||
| 84 | |||
| 85 | return $this; |
||
| 86 | } |
||
| 87 | |||
| 88 | /** |
||
| 89 | * remove ignore folders |
||
| 90 | */ |
||
| 91 | public function resetIgnoreFolderArray(): FindFiles |
||
| 92 | { |
||
| 93 | $this->ignoreFolderArray = []; |
||
| 94 | $this->resetFileCache(); |
||
| 95 | |||
| 96 | return $this; |
||
| 97 | } |
||
| 98 | |||
| 99 | /** |
||
| 100 | * Sets extensions to look |
||
| 101 | * @param bool $boolean - optional |
||
| 102 | */ |
||
| 103 | public function setFindAllExts(bool $boolean = true): FindFiles |
||
| 109 | } |
||
| 110 | |||
| 111 | public function setSearchPath(string $pathLocation): FindFiles |
||
| 112 | { |
||
| 113 | if ($pathLocation !== $this->searchPath) { |
||
| 114 | $this->searchPath = $pathLocation; |
||
| 115 | $this->resetFileCache(); |
||
| 116 | } |
||
| 117 | |||
| 118 | return $this; |
||
| 119 | } |
||
| 120 | |||
| 121 | /** |
||
| 122 | * Sets extensions to look |
||
| 123 | * @param array $extensions - optional |
||
| 124 | */ |
||
| 125 | public function setExtensions(?array $extensions = []): FindFiles |
||
| 126 | { |
||
| 127 | $this->extensions = $extensions; |
||
| 128 | if (count($this->extensions)) { |
||
| 129 | $this->findAllExts = false; |
||
| 130 | } else { |
||
| 131 | $this->findAllExts = true; |
||
| 132 | } |
||
| 133 | $this->resetFileCache(); |
||
| 134 | |||
| 135 | return $this; |
||
| 136 | } |
||
| 137 | |||
| 138 | public function setRecursive(bool $bool): FindFiles |
||
| 144 | } |
||
| 145 | |||
| 146 | public function setIgnoreHiddenFilesAndFolders(bool $bool): FindFiles |
||
| 147 | { |
||
| 148 | $this->ignoreHiddenFilesAndFolders = $bool; |
||
| 149 | $this->resetFileCache(); |
||
| 150 | |||
| 151 | return $this; |
||
| 152 | } |
||
| 153 | |||
| 154 | /** |
||
| 155 | * string is error! |
||
| 156 | * @return array|string |
||
| 157 | */ |
||
| 158 | public function getFlatFileArray() |
||
| 159 | { |
||
| 160 | if ($this->needToFillFileCache) { |
||
| 161 | $myArray = []; |
||
| 162 | if ($this->searchPath) { |
||
| 163 | if (file_exists($this->searchPath)) { |
||
| 164 | if (is_file($this->searchPath)) { |
||
| 165 | $this->flatFileArray = [$this->searchPath]; |
||
| 166 | } else { |
||
| 167 | $multiDimensionalArray = $this->getFileArray($this->searchPath); |
||
| 168 | foreach ($multiDimensionalArray as $folder => $arrayOfFiles) { |
||
| 169 | if (count($arrayOfFiles)) { |
||
| 170 | $this->relevantFolders[$folder] = $folder; |
||
| 171 | } |
||
| 172 | foreach ($arrayOfFiles as $file) { |
||
| 173 | $myArray[$file] = $file; |
||
| 174 | } |
||
| 175 | } |
||
| 176 | // //flatten it! |
||
| 177 | // $this->flatFileArray = new \RecursiveIteratorIterator( |
||
| 178 | // new \RecursiveArrayIterator($multiDimensionalArray) |
||
| 179 | // ); |
||
| 180 | // print_r($this->flatFileArray); |
||
| 181 | } |
||
| 182 | } else { |
||
| 183 | return 'SKIPPED: can not find: ' . $this->searchPath . "\n"; |
||
| 184 | } |
||
| 185 | } |
||
| 186 | $this->flatFileArray = array_values($myArray); |
||
| 187 | $this->needToFillFileCache = false; |
||
| 188 | } |
||
| 189 | |||
| 190 | return $this->flatFileArray; |
||
| 191 | } |
||
| 192 | |||
| 193 | /** |
||
| 194 | * loads all the applicable files |
||
| 195 | * @param string $path (e.g. "." or "/var/www/mysite.co.nz") |
||
| 196 | * @param boolean $runningInnerLoop - is the method calling itself? |
||
| 197 | */ |
||
| 198 | protected function getFileArray($path, $runningInnerLoop = false) |
||
| 199 | { |
||
| 200 | if ($runningInnerLoop || $this->needToFillFileCache) { |
||
| 201 | $dir = opendir($path); |
||
| 202 | if ($dir) { |
||
|
|
|||
| 203 | $keepGoing = true; |
||
| 204 | while ($keepGoing) { |
||
| 205 | $file = readdir($dir); |
||
| 206 | if (! $file) { |
||
| 207 | $keepGoing = false; |
||
| 208 | continue; |
||
| 209 | } |
||
| 210 | $fullPath = $path . '/' . $file; |
||
| 211 | if (($file === '.') || |
||
| 212 | ($file === '..') || |
||
| 213 | ($fullPath === __FILE__) || |
||
| 214 | ($path === '.' && basename(__FILE__) === $file)) { |
||
| 215 | continue; |
||
| 216 | } |
||
| 217 | //ignore hidden files and folders |
||
| 218 | if ($this->ignoreHiddenFilesAndFolders && substr($file, 0, 1) === '.') { |
||
| 219 | continue; |
||
| 220 | } |
||
| 221 | //ignore folders with _manifest_exclude in them! |
||
| 222 | if ($file === '_manifest_exclude') { |
||
| 223 | $this->ignoreFolderArray[] = $path; |
||
| 224 | unset($this->fileArray[$path]); |
||
| 225 | break; |
||
| 226 | } |
||
| 227 | if (filetype($fullPath) === 'dir') { |
||
| 228 | $conditionA = (in_array($file, $this->ignoreFolderArray, true) && |
||
| 229 | ($path === '.' || $path === $this->searchPath)); |
||
| 230 | $conditionB = in_array($path, $this->ignoreFolderArray, true); |
||
| 231 | if ($conditionA || $conditionB) { |
||
| 232 | continue; |
||
| 233 | } |
||
| 234 | if ($this->recursive) { |
||
| 235 | $this->getFileArray($fullPath, $runningInnerLoop = true); //recursive traversing here |
||
| 236 | } |
||
| 237 | } elseif ($this->matchedExtension($file)) { //checks extension if we need to search this file |
||
| 238 | if (filesize($fullPath)) { |
||
| 239 | $this->fileArray[$path][] = $fullPath; //search file data |
||
| 240 | } |
||
| 241 | } |
||
| 242 | } //End of while |
||
| 243 | closedir($dir); |
||
| 244 | } else { |
||
| 245 | user_error('Could not find: ' . $path); |
||
| 246 | } |
||
| 247 | } |
||
| 248 | |||
| 249 | return $this->fileArray; |
||
| 250 | } |
||
| 251 | |||
| 252 | //FIND FILES |
||
| 253 | |||
| 254 | protected function resetFileCache() |
||
| 255 | { |
||
| 256 | $this->fileArray = []; |
||
| 257 | $this->flatFileArray = []; |
||
| 258 | $this->needToFillFileCache = true; |
||
| 259 | //cleanup other data |
||
| 260 | } |
||
| 261 | |||
| 262 | /** |
||
| 263 | * Finds extension of a file |
||
| 264 | * @param string $file |
||
| 265 | */ |
||
| 266 | private function findExtension($file): string |
||
| 267 | { |
||
| 268 | $fileArray = explode('.', $file) ?? []; |
||
| 269 | |||
| 270 | return (string) array_pop($fileArray); |
||
| 271 | } |
||
| 272 | |||
| 273 | /** |
||
| 274 | * Checks if a file extension is one of the extensions we are going to search |
||
| 275 | * @param string $file |
||
| 276 | * @return boolean |
||
| 277 | */ |
||
| 278 | private function matchedExtension($file) |
||
| 289 | } |
||
| 290 | } |
||
| 291 |