FilesManagement   C
last analyzed

Complexity

Total Complexity 56

Size/Duplication

Total Lines 218
Duplicated Lines 0 %

Importance

Changes 0
Metric Value
eloc 83
c 0
b 0
f 0
dl 0
loc 218
rs 5.5199
wmc 56

7 Methods

Rating   Name   Duplication   Size   Complexity  
A copyFile() 0 3 1
A createFolder() 0 11 6
B deleteDirectory() 0 33 9
B rrmdir() 0 28 10
B rmove() 0 28 11
B recurseCopy() 0 21 8
B rcopy() 0 25 11

How to fix   Complexity   

Complex Class

Complex classes like FilesManagement 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 FilesManagement, and based on these observations, apply Extract Interface, too.

1
<?php declare(strict_types=1);
2
3
namespace XoopsModules\Marquee\Common;
4
5
/*
6
 You may not change or alter any portion of this comment or credits
7
 of supporting developers from this source code or any supporting source code
8
 which is considered copyrighted (c) material of the original comment or credit authors.
9
10
 This program is distributed in the hope that it will be useful,
11
 but WITHOUT ANY WARRANTY; without even the implied warranty of
12
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
13
 */
14
15
/**
16
 * @copyright   XOOPS Project (https://xoops.org)
17
 * @license     GNU GPL 2.0 or later (https://www.gnu.org/licenses/gpl-2.0.html)
18
 * @author      mamba <[email protected]>
19
 */
20
trait FilesManagement
21
{
22
    /**
23
     * Function responsible for checking if a directory exists, we can also write in and create an index.html file
24
     *
25
     * @param string $folder The full path of the directory to check
26
     *
27
     * @throws \RuntimeException
28
     */
29
    public static function createFolder($folder): void
30
    {
31
        try {
32
            if (!\is_dir($folder)) {
33
                if (!\is_dir($folder) && !\mkdir($folder) && !\is_dir($folder)) {
34
                    throw new \RuntimeException(\sprintf('Unable to create the %s directory', $folder));
35
                }
36
                file_put_contents($folder . '/index.html', '<script>history.go(-1);</script>');
37
            }
38
        } catch (\RuntimeException $e) {
39
            echo 'Caught exception: ', $e->getMessage(), "\n", '<br>';
40
        }
41
    }
42
43
    /**
44
     * @param $file
45
     * @param $folder
46
     * @return bool
47
     */
48
    public static function copyFile(string $file, string $folder): bool
49
    {
50
        return \copy($file, $folder);
51
    }
52
53
    /**
54
     * @param $src
55
     * @param $dst
56
     */
57
    public static function recurseCopy($src, $dst): void
58
    {
59
        $dir = \opendir($src);
60
        //        @mkdir($dst);
61
        try {
62
            if (!\mkdir($dst) && !\is_dir($dst)) {
63
                throw new \RuntimeException('The directory ' . $dst . ' could not be created.');
64
            }
65
        } catch (\RuntimeException $e) {
66
            echo 'Caught exception: ', $e->getMessage(), "<br>\n";
67
        }
68
        while (false !== ($file = \readdir($dir))) {
69
            if (('.' !== $file) && ('..' !== $file)) {
70
                if (\is_dir($src . '/' . $file)) {
71
                    self::recurseCopy($src . '/' . $file, $dst . '/' . $file);
72
                } else {
73
                    \copy($src . '/' . $file, $dst . '/' . $file);
74
                }
75
            }
76
        }
77
        \closedir($dir);
78
    }
79
80
    /**
81
     * Remove files and (sub)directories
82
     *
83
     * @param string $src source directory to delete
84
     *
85
     * @return bool true on success
86
     * @uses \Xmf\Module\Helper::isUserAdmin()
87
     *
88
     * @uses \Xmf\Module\Helper::getHelper()
89
     */
90
    public static function deleteDirectory($src)
91
    {
92
        // Only continue if user is a 'global' Admin
93
        if (!($GLOBALS['xoopsUser'] instanceof \XoopsUser) || !$GLOBALS['xoopsUser']->isAdmin()) {
94
            return false;
95
        }
96
        $success = true;
97
        // remove old files
98
        $dirInfo = new \SplFileInfo($src);
99
        // validate is a directory
100
        if ($dirInfo->isDir()) {
101
            $fileList = \array_diff(\scandir($src, \SCANDIR_SORT_NONE), ['..', '.']);
102
            foreach ($fileList as $k => $v) {
103
                $fileInfo = new \SplFileInfo("{$src}/{$v}");
104
                if ($fileInfo->isDir()) {
105
                    // recursively handle subdirectories
106
                    if (!$success = self::deleteDirectory($fileInfo->getRealPath())) {
107
                        break;
108
                    }
109
                } elseif (!($success = \unlink($fileInfo->getRealPath()))) {
110
                    break;
111
                }
112
            }
113
            // now delete this (sub)directory if all the files are gone
114
            if ($success) {
115
                $success = \rmdir($dirInfo->getRealPath());
116
            }
117
        } else {
118
            // input is not a valid directory
119
            $success = false;
120
        }
121
122
        return $success;
123
    }
124
125
    /**
126
     * Recursively remove directory
127
     *
128
     * @todo currently won't remove directories with hidden files, should it?
129
     *
130
     * @param string $src directory to remove (delete)
131
     *
132
     * @return bool true on success
133
     */
134
    public static function rrmdir($src)
135
    {
136
        // Only continue if user is a 'global' Admin
137
        if (!($GLOBALS['xoopsUser'] instanceof \XoopsUser) || !$GLOBALS['xoopsUser']->isAdmin()) {
138
            return false;
139
        }
140
        // If source is not a directory stop processing
141
        if (!\is_dir($src)) {
142
            return false;
143
        }
144
        $success = true;
0 ignored issues
show
Unused Code introduced by
The assignment to $success is dead and can be removed.
Loading history...
145
        // Open the source directory to read in files
146
        $iterator = new \DirectoryIterator($src);
147
        foreach ($iterator as $fObj) {
148
            if (null !== $fObj && $fObj->isFile()) {
149
                $filename = $fObj->getPathname();
150
                $fObj     = null; // clear this iterator object to close the file
0 ignored issues
show
Unused Code introduced by
The assignment to $fObj is dead and can be removed.
Loading history...
151
                if (!\unlink($filename)) {
152
                    return false; // couldn't delete the file
153
                }
154
            } elseif (!$fObj->isDot() && $fObj->isDir()) {
155
                // Try recursively on directory
156
                self::rrmdir($fObj->getPathname());
157
            }
158
        }
159
        $iterator = null;   // clear iterator Obj to close file/directory
0 ignored issues
show
Unused Code introduced by
The assignment to $iterator is dead and can be removed.
Loading history...
160
161
        return \rmdir($src); // remove the directory & return results
162
    }
163
164
    /**
165
     * Recursively move files from one directory to another
166
     *
167
     * @param string $src  - Source of files being moved
168
     * @param string $dest - Destination of files being moved
169
     *
170
     * @return bool true on success
171
     */
172
    public static function rmove($src, $dest)
173
    {
174
        // Only continue if user is a 'global' Admin
175
        if (!($GLOBALS['xoopsUser'] instanceof \XoopsUser) || !$GLOBALS['xoopsUser']->isAdmin()) {
176
            return false;
177
        }
178
        // If source is not a directory stop processing
179
        if (!\is_dir($src)) {
180
            return false;
181
        }
182
        // If the destination directory does not exist and could not be created stop processing
183
        if (!\is_dir($dest) && !\mkdir($dest) && !\is_dir($dest)) {
184
            return false;
185
        }
186
        // Open the source directory to read in files
187
        $iterator = new \DirectoryIterator($src);
188
        foreach ($iterator as $fObj) {
189
            if ($fObj->isFile()) {
190
                \rename($fObj->getPathname(), "{$dest}/" . $fObj->getFilename());
191
            } elseif (!$fObj->isDot() && $fObj->isDir()) {
192
                // Try recursively on directory
193
                self::rmove($fObj->getPathname(), "{$dest}/" . $fObj->getFilename());
194
                //                rmdir($fObj->getPath()); // now delete the directory
195
            }
196
        }
197
        $iterator = null;   // clear iterator Obj to close file/directory
0 ignored issues
show
Unused Code introduced by
The assignment to $iterator is dead and can be removed.
Loading history...
198
199
        return \rmdir($src); // remove the directory & return results
200
    }
201
202
    /**
203
     * Recursively copy directories and files from one directory to another
204
     *
205
     * @param string $src  - Source of files being moved
206
     * @param string $dest - Destination of files being moved
207
     *
208
     * @return bool true on success
209
     * @uses \Xmf\Module\Helper::isUserAdmin()
210
     *
211
     * @uses \Xmf\Module\Helper::getHelper()
212
     */
213
    public static function rcopy($src, $dest)
214
    {
215
        // Only continue if user is a 'global' Admin
216
        if (!($GLOBALS['xoopsUser'] instanceof \XoopsUser) || !$GLOBALS['xoopsUser']->isAdmin()) {
217
            return false;
218
        }
219
        // If source is not a directory stop processing
220
        if (!\is_dir($src)) {
221
            return false;
222
        }
223
        // If the destination directory does not exist and could not be created stop processing
224
        if (!\is_dir($dest) && !\mkdir($dest) && !\is_dir($dest)) {
225
            return false;
226
        }
227
        // Open the source directory to read in files
228
        $iterator = new \DirectoryIterator($src);
229
        foreach ($iterator as $fObj) {
230
            if ($fObj->isFile()) {
231
                \copy($fObj->getPathname(), "{$dest}/" . $fObj->getFilename());
232
            } elseif (!$fObj->isDot() && $fObj->isDir()) {
233
                self::rcopy($fObj->getPathname(), "{$dest}/" . $fObj->getFilename());
234
            }
235
        }
236
237
        return true;
238
    }
239
}
240