Completed
Push — master ( 720064...d5ad83 )
by Michael
02:05
created

onupdate.php ➔ xoops_module_pre_update_xxxx()   A

Complexity

Conditions 4
Paths 6

Size

Total Lines 19
Code Lines 10

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 4
eloc 10
nc 6
nop 1
dl 0
loc 19
rs 9.2
c 0
b 0
f 0
1
<?php
0 ignored issues
show
Coding Style Compatibility introduced by
For compatibility and reusability of your code, PSR1 recommends that a file should introduce either new symbols (like classes, functions, etc.) or have side-effects (like outputting something, or including other files), but not both at the same time. The first symbol is defined on line 35 and the first side effect is on line 27.

The PSR-1: Basic Coding Standard recommends that a file should either introduce new symbols, that is classes, functions, constants or similar, or have side effects. Side effects are anything that executes logic, like for example printing output, changing ini settings or writing to a file.

The idea behind this recommendation is that merely auto-loading a class should not change the state of an application. It also promotes a cleaner style of programming and makes your code less prone to errors, because the logic is not spread out all over the place.

To learn more about the PSR-1, please see the PHP-FIG site on the PSR-1.

Loading history...
2
/*
3
 You may not change or alter any portion of this comment or credits
4
 of supporting developers from this source code or any supporting source code
5
 which is considered copyrighted (c) material of the original comment or credit authors.
6
7
 This program is distributed in the hope that it will be useful,
8
 but WITHOUT ANY WARRANTY; without even the implied warranty of
9
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
10
*/
11
12
/**
13
 * Contact module
14
 *
15
 * @copyright   The XOOPS Project http://sourceforge.net/projects/xoops/
16
 * @license     http://www.fsf.org/copyleft/gpl.html GNU public license
17
 * @author      Kazumi Ono (aka Onokazu)
18
 * @author      Trabis <[email protected]>
19
 * @author      Hossein Azizabadi (AKA Voltan)
20
 * @param XoopsModule $module
21
 * @param $version
22
 */
23
24
if ((!defined('XOOPS_ROOT_PATH')) || !($GLOBALS['xoopsUser'] instanceof XoopsUser)
0 ignored issues
show
Bug introduced by
The class XoopsUser does not exist. Did you forget a USE statement, or did you not list all dependencies?

This error could be the result of:

1. Missing dependencies

PHP Analyzer uses your composer.json file (if available) to determine the dependencies of your project and to determine all the available classes and functions. It expects the composer.json to be in the root folder of your repository.

Are you sure this class is defined by one of your dependencies, or did you maybe not list a dependency in either the require or require-dev section?

2. Missing use statement

PHP does not complain about undefined classes in ìnstanceof checks. For example, the following PHP code will work perfectly fine:

if ($x instanceof DoesNotExist) {
    // Do something.
}

If you have not tested against this specific condition, such errors might go unnoticed.

Loading history...
25
    || !$GLOBALS['xoopsUser']->IsAdmin()
26
) {
27
    exit('Restricted access' . PHP_EOL);
28
}
29
30
/**
31
 * @param string $tablename
32
 *
33
 * @return bool
34
 */
35
function tableExists($tablename)
0 ignored issues
show
Coding Style introduced by
tableExists uses the super-global variable $GLOBALS which is generally not recommended.

Instead of super-globals, we recommend to explicitly inject the dependencies of your class. This makes your code less dependent on global state and it becomes generally more testable:

// Bad
class Router
{
    public function generate($path)
    {
        return $_SERVER['HOST'].$path;
    }
}

// Better
class Router
{
    private $host;

    public function __construct($host)
    {
        $this->host = $host;
    }

    public function generate($path)
    {
        return $this->host.$path;
    }
}

class Controller
{
    public function myAction(Request $request)
    {
        // Instead of
        $page = isset($_GET['page']) ? intval($_GET['page']) : 1;

        // Better (assuming you use the Symfony2 request)
        $page = $request->query->get('page', 1);
    }
}
Loading history...
36
{
37
    $result = $GLOBALS['xoopsDB']->queryF("SHOW TABLES LIKE '$tablename'");
38
39
    return ($GLOBALS['xoopsDB']->getRowsNum($result) > 0) ? true : false;
40
}
41
42
/**
43
 *
44
 * Prepares system prior to attempting to install module
45
 * @param XoopsModule $module {@link XoopsModule}
46
 *
47
 * @return bool true if ready to install, false if not
48
 */
49
function xoops_module_pre_update_xxxx(XoopsModule $module)
50
{
51
    $moduleDirName = basename(dirname(__DIR__));
52
    $classUtility     = ucfirst($moduleDirName) . 'Utility';
53
    if (!class_exists($classUtility)) {
54
        xoops_load('utility', $moduleDirName);
55
    }
56
    //check for minimum XOOPS version
57
    if (!$classUtility::checkVerXoops($module)) {
58
        return false;
59
    }
60
61
    // check for minimum PHP version
62
    if (!$classUtility::checkVerPhp($module)) {
63
        return false;
64
    }
65
66
    return true;
67
}
68
69
/**
70
 *
71
 * Performs tasks required during update of the module
72
 * @param XoopsModule $module {@link XoopsModule}
73
 * @param null        $previousVersion
74
 *
75
 * @return bool true if update successful, false if not
76
 */
77
function xoops_module_update_contact(XoopsModule $module, $previousVersion = null)
0 ignored issues
show
Coding Style introduced by
xoops_module_update_contact uses the super-global variable $GLOBALS which is generally not recommended.

Instead of super-globals, we recommend to explicitly inject the dependencies of your class. This makes your code less dependent on global state and it becomes generally more testable:

// Bad
class Router
{
    public function generate($path)
    {
        return $_SERVER['HOST'].$path;
    }
}

// Better
class Router
{
    private $host;

    public function __construct($host)
    {
        $this->host = $host;
    }

    public function generate($path)
    {
        return $this->host.$path;
    }
}

class Controller
{
    public function myAction(Request $request)
    {
        // Instead of
        $page = isset($_GET['page']) ? intval($_GET['page']) : 1;

        // Better (assuming you use the Symfony2 request)
        $page = $request->query->get('page', 1);
    }
}
Loading history...
78
{
79
    $moduleDirName = basename(dirname(__DIR__));
80
    $capsDirName   = strtoupper($moduleDirName);
0 ignored issues
show
Unused Code introduced by
$capsDirName is not used, you could remove the assignment.

This check looks for variable assignements that are either overwritten by other assignments or where the variable is not used subsequently.

$myVar = 'Value';
$higher = false;

if (rand(1, 6) > 3) {
    $higher = true;
} else {
    $higher = false;
}

Both the $myVar assignment in line 1 and the $higher assignment in line 2 are dead. The first because $myVar is never used and the second because $higher is always overwritten for every possible time line.

Loading history...
81
82
    $xoopsDB = XoopsDatabaseFactory::getDatabaseConnection();
83
84
    if ($previousVersion < 180) {
85
        $sql = 'CREATE TABLE ' . $xoopsDB->prefix('contact') . ' (
86
        contact_id int(10) unsigned NOT NULL auto_increment,
87
        contact_uid int(10) NOT NULL,
88
        contact_cid int(10) NOT NULL,
89
        contact_create int(10) NOT NULL,
90
        contact_subject varchar(255) NOT NULL,
91
        contact_name varchar(255) NOT NULL,
92
        contact_mail varchar(255) NOT NULL,
93
        contact_url varchar(255) NOT NULL,
94
        contact_icq varchar(255) NOT NULL,
95
        contact_company varchar(255) NOT NULL,
96
        contact_location varchar(255) NOT NULL,
97
        contact_department varchar(60) NOT NULL,
98
        contact_ip varchar(20) NOT NULL,
99
        contact_phone varchar(20) NOT NULL,
100
        contact_message text NOT NULL,
101
        contact_address text NOT NULL,
102
        contact_reply tinyint(1) NOT NULL,
103
        PRIMARY KEY  (contact_id)
104
        ) ENGINE=MyISAM;';
105
        $xoopsDB->query($sql);
106
    }
107
108
    if ($previousVersion < 181) {
109
        // Add contact_platform
110
        $sql = 'ALTER TABLE `' . $xoopsDB->prefix('contact') . "` ADD `contact_platform` ENUM('Android','Ios','Web') NOT NULL DEFAULT 'Web'";
111
        $xoopsDB->query($sql);
112
        // Add contact_type
113
        $sql = 'ALTER TABLE `' . $xoopsDB->prefix('contact') . "` ADD `contact_type` ENUM('Contact','Phone','Mail') NOT NULL DEFAULT 'Contact'";
114
        $xoopsDB->query($sql);
115
        // Add index contact_uid
116
        $sql = 'ALTER TABLE `' . $xoopsDB->prefix('contact') . '` ADD INDEX `contact_uid` ( `contact_uid` )';
117
        $xoopsDB->query($sql);
118
        // Add index contact_cid
119
        $sql = 'ALTER TABLE `' . $xoopsDB->prefix('contact') . '` ADD INDEX `contact_cid` ( `contact_cid` )';
120
        $xoopsDB->query($sql);
121
        // Add index contact_create
122
        $sql = 'ALTER TABLE `' . $xoopsDB->prefix('contact') . '` ADD INDEX `contact_create` ( `contact_create` )';
123
        $xoopsDB->query($sql);
124
        // Add index contact_mail
125
        $sql = 'ALTER TABLE `' . $xoopsDB->prefix('contact') . '` ADD INDEX `contact_mail` ( `contact_mail` )';
126
        $xoopsDB->query($sql);
127
        // Add index contact_phone
128
        $sql = 'ALTER TABLE `' . $xoopsDB->prefix('contact') . '` ADD INDEX `contact_phone` ( `contact_phone` )';
129
        $xoopsDB->query($sql);
130
        // Add index contact_platform
131
        $sql = 'ALTER TABLE `' . $xoopsDB->prefix('contact') . '` ADD INDEX `contact_platform` ( `contact_platform` )';
132
        $xoopsDB->query($sql);
133
        // Add index contact_type
134
        $sql = 'ALTER TABLE `' . $xoopsDB->prefix('contact') . '` ADD INDEX `contact_type` ( `contact_type` )';
135
        $xoopsDB->query($sql);
136
    }
137
138
    if ($previousVersion < 226) {
139
140
        require_once __DIR__ . '/config.php';
141
        $configurator = new ContentConfigurator();
142
        $classUtility    = ucfirst($moduleDirName) . 'Utility';
143
        if (!class_exists($classUtility)) {
144
            xoops_load('utility', $moduleDirName);
145
        }
146
147
        //delete old HTML templates
148
        if (count($configurator->templateFolders) > 0) {
149
            foreach ($configurator->templateFolders as $folder) {
150
                $templateFolder = $GLOBALS['xoops']->path('modules/' . $moduleDirName . $folder);
151
                if (is_dir($templateFolder)) {
152
                    $templateList = array_diff(scandir($templateFolder), array('..', '.'));
153
                    foreach ($templateList as $k => $v) {
154
                        $fileInfo = new SplFileInfo($templateFolder . $v);
155
                        if ($fileInfo->getExtension() === 'html' && $fileInfo->getFilename() !== 'index.html') {
156
                            if (file_exists($templateFolder . $v)) {
157
                                unlink($templateFolder . $v);
158
                            }
159
                        }
160
                    }
161
                }
162
            }
163
        }
164
165
        //  ---  DELETE OLD FILES ---------------
166
        if (count($configurator->oldFiles) > 0) {
167
            //    foreach (array_keys($GLOBALS['uploadFolders']) as $i) {
0 ignored issues
show
Unused Code Comprehensibility introduced by
67% of this comment could be valid code. Did you maybe forget this after debugging?

Sometimes obsolete code just ends up commented out instead of removed. In this case it is better to remove the code once you have checked you do not need it.

The code might also have been commented out for debugging purposes. In this case it is vital that someone uncomments it again or your project may behave in very unexpected ways in production.

This check looks for comments that seem to be mostly valid code and reports them.

Loading history...
168
            foreach (array_keys($configurator->oldFiles) as $i) {
169
                $tempFile = $GLOBALS['xoops']->path('modules/' . $moduleDirName . $configurator->oldFiles[$i]);
170
                if (is_file($tempFile)) {
171
                    unlink($tempFile);
172
                }
173
            }
174
        }
175
176
        //  ---  DELETE OLD FOLDERS ---------------
177
        xoops_load('XoopsFile');
178
        if (count($configurator->oldFolders) > 0) {
179
            //    foreach (array_keys($GLOBALS['uploadFolders']) as $i) {
0 ignored issues
show
Unused Code Comprehensibility introduced by
67% of this comment could be valid code. Did you maybe forget this after debugging?

Sometimes obsolete code just ends up commented out instead of removed. In this case it is better to remove the code once you have checked you do not need it.

The code might also have been commented out for debugging purposes. In this case it is vital that someone uncomments it again or your project may behave in very unexpected ways in production.

This check looks for comments that seem to be mostly valid code and reports them.

Loading history...
180
            foreach (array_keys($configurator->oldFolders) as $i) {
181
                $tempFolder = $GLOBALS['xoops']->path('modules/' . $moduleDirName . $configurator->oldFolders[$i]);
182
                /* @var $folderHandler XoopsObjectHandler */
183
                $folderHandler = XoopsFile::getHandler('folder', $tempFolder);
184
                $folderHandler->delete($tempFolder);
185
            }
186
        }
187
188
        //  ---  CREATE FOLDERS ---------------
189 View Code Duplication
        if (count($configurator->uploadFolders) > 0) {
0 ignored issues
show
Duplication introduced by
This code seems to be duplicated across your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
190
            //    foreach (array_keys($GLOBALS['uploadFolders']) as $i) {
0 ignored issues
show
Unused Code Comprehensibility introduced by
67% of this comment could be valid code. Did you maybe forget this after debugging?

Sometimes obsolete code just ends up commented out instead of removed. In this case it is better to remove the code once you have checked you do not need it.

The code might also have been commented out for debugging purposes. In this case it is vital that someone uncomments it again or your project may behave in very unexpected ways in production.

This check looks for comments that seem to be mostly valid code and reports them.

Loading history...
191
            foreach (array_keys($configurator->uploadFolders) as $i) {
192
                $classUtility::createFolder($configurator->uploadFolders[$i]);
193
            }
194
        }
195
196
        //  ---  COPY blank.png FILES ---------------
197 View Code Duplication
        if (count($configurator->blankFiles) > 0) {
0 ignored issues
show
Duplication introduced by
This code seems to be duplicated across your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
198
            $file = __DIR__ . '/../assets/images/blank.png';
199
            foreach (array_keys($configurator->blankFiles) as $i) {
200
                $dest = $configurator->blankFiles[$i] . '/blank.png';
201
                $classUtility::copyFile($file, $dest);
202
            }
203
        }
204
205
        //delete .html entries from the tpl table
206
        $sql = 'DELETE FROM ' . $GLOBALS['xoopsDB']->prefix('tplfile') . " WHERE `tpl_module` = '" . $module->getVar('dirname', 'n') . '\' AND `tpl_file` LIKE \'%.html%\'';
207
        $GLOBALS['xoopsDB']->queryF($sql);
208
209
        /** @var XoopsGroupPermHandler $gpermHandler */
210
        $gpermHandler = xoops_getHandler('groupperm');
211
        return $gpermHandler->deleteByModule($module->getVar('mid'), 'item_read');
212
213
    }
214
}
215