SysUtility::truncateHtml()   F
last analyzed

Complexity

Conditions 19
Paths 194

Size

Total Lines 89
Code Lines 47

Duplication

Lines 0
Ratio 0 %

Importance

Changes 3
Bugs 0 Features 0
Metric Value
cc 19
eloc 47
c 3
b 0
f 0
nc 194
nop 5
dl 0
loc 89
rs 3.7333

How to fix   Long Method    Complexity   

Long Method

Small methods make your code easier to understand, in particular if combined with a good name. Besides, if your method is small, finding a good name is usually much easier.

For example, if you find yourself adding comments to a method's body, this is usually a good sign to extract the commented part to a new method, and use the comment as a starting point when coming up with a good name for this new method.

Commonly applied refactorings include:

1
<?php declare(strict_types=1);
2
3
namespace XoopsModules\Publisher\Common;
4
5
/*
6
 Utility Class Definition
7
8
 You may not change or alter any portion of this comment or credits of
9
 supporting developers from this source code or any supporting source code
10
 which is considered copyrighted (c) material of the original comment or credit
11
 authors.
12
13
 This program is distributed in the hope that it will be useful, but
14
 WITHOUT ANY WARRANTY; without even the implied warranty of
15
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
16
 */
17
18
/**
19
 * @license      https://www.fsf.org/copyleft/gpl.html GNU public license
20
 * @copyright    https://xoops.org 2000-2020 &copy; XOOPS Project
21
 * @author       ZySpec <[email protected]>
22
 * @author       Mamba <[email protected]>
23
 */
24
25
use XoopsModules\Publisher\Helper;
26
27
/**
28
 * Class SysUtility
29
 */
30
class SysUtility
31
{
32
    use VersionChecks;
0 ignored issues
show
introduced by
The trait XoopsModules\Publisher\Common\VersionChecks requires some properties which are not provided by XoopsModules\Publisher\Common\SysUtility: $tag_name, $prerelease
Loading history...
33
34
    //checkVerXoops, checkVerPhp Traits
35
36
    use ServerStats;
37
38
    // getServerStats Trait
39
40
    use FilesManagement;
41
42
    // Files Management Trait
43
44
    use ModuleStats;
0 ignored issues
show
Bug introduced by
The trait XoopsModules\Publisher\Common\ModuleStats requires the property $moduleStats which is not provided by XoopsModules\Publisher\Common\SysUtility.
Loading history...
45
46
    // ModuleStats Trait
47
48
    /**
49
     * truncateHtml can truncate a string up to a number of characters while preserving whole words and HTML tags
50
     * www.gsdesign.ro/blog/cut-html-string-without-breaking-the-tags
51
     * www.cakephp.org
52
     *
53
     * @param string $text         String to truncate.
54
     * @param int    $length       Length of returned string, including ellipsis.
55
     * @param string $ending       Ending to be appended to the trimmed string.
56
     * @param bool   $exact        If false, $text will not be cut mid-word
57
     * @param bool   $considerHtml If true, HTML tags would be handled correctly
58
     *
59
     * @return string Trimmed string.
60
     */
61
    public static function truncateHtml($text, $length = 100, $ending = '...', $exact = false, $considerHtml = true)
62
    {
63
        if ($considerHtml) {
64
            // if the plain text is shorter than the maximum length, return the whole text
65
            if (mb_strlen(\preg_replace('/<.*?' . '>/', '', $text)) <= $length) {
66
                return $text;
67
            }
68
            // splits all html-tags to scanable lines
69
            \preg_match_all('/(<.+?' . '>)?([^<>]*)/s', $text, $lines, \PREG_SET_ORDER);
70
            $totalLength = mb_strlen($ending);
71
            $openTags    = [];
72
            $truncate    = '';
73
            foreach ($lines as $lineMatchings) {
74
                // if there is any html-tag in this line, handle it and add it (uncounted) to the output
75
                if (!empty($lineMatchings[1])) {
76
                    // if it's an "empty element" with or without xhtml-conform closing slash
77
                    if (\preg_match('/^<(\s*.+?\/\s*|\s*(img|br|input|hr|area|base|basefont|col|frame|isindex|link|meta|param)(\s.+?)?)>$/is', $lineMatchings[1])) {
78
                        // do nothing
79
                        // if tag is a closing tag
80
                    } elseif (\preg_match('/^<\s*\/(\S+?)\s*>$/s', $lineMatchings[1], $tagMatchings)) {
81
                        // delete tag from $openTags list
82
                        $pos = \array_search($tagMatchings[1], $openTags, true);
83
                        if (false !== $pos) {
84
                            unset($openTags[$pos]);
85
                        }
86
                        // if tag is an opening tag
87
                    } elseif (\preg_match('/^<\s*([^\s>!]+).*?' . '>$/s', $lineMatchings[1], $tagMatchings)) {
88
                        // add tag to the beginning of $openTags list
89
                        \array_unshift($openTags, \mb_strtolower($tagMatchings[1]));
90
                    }
91
                    // add html-tag to $truncate'd text
92
                    $truncate .= $lineMatchings[1];
93
                }
94
                // calculate the length of the plain text part of the line; handle entities as one character
95
                $content_length = mb_strlen(\preg_replace('/&[0-9a-z]{2,8};|&#\d{1,7};|[0-9a-f]{1,6};/i', ' ', $lineMatchings[2]));
96
                if ($totalLength + $content_length > $length) {
97
                    // the number of characters which are left
98
                    $left           = $length - $totalLength;
99
                    $entitiesLength = 0;
100
                    // search for html entities
101
                    if (\preg_match_all('/&[0-9a-z]{2,8};|&#\d{1,7};|[0-9a-f]{1,6};/i', $lineMatchings[2], $entities, \PREG_OFFSET_CAPTURE)) {
102
                        // calculate the real length of all entities in the legal range
103
                        foreach ($entities[0] as $entity) {
104
                            if ($left >= $entity[1] + 1 - $entitiesLength) {
105
                                $left--;
106
                                $entitiesLength += mb_strlen($entity[0]);
107
                            } else {
108
                                // no more characters left
109
                                break;
110
                            }
111
                        }
112
                    }
113
                    $truncate .= mb_substr($lineMatchings[2], 0, $left + $entitiesLength);
114
                    // maximum lenght is reached, so get off the loop
115
                    break;
116
                }
117
                $truncate    .= $lineMatchings[2];
118
                $totalLength += $content_length;
119
120
                // if the maximum length is reached, get off the loop
121
                if ($totalLength >= $length) {
122
                    break;
123
                }
124
            }
125
        } else {
126
            if (mb_strlen($text) <= $length) {
127
                return $text;
128
            }
129
            $truncate = mb_substr($text, 0, $length - mb_strlen($ending));
130
        }
131
        // if the words shouldn't be cut in the middle...
132
        if (!$exact) {
133
            // ...search the last occurance of a space...
134
            $spacepos = (int)mb_strrpos($truncate, ' ');
135
            if (isset($spacepos)) {
136
                // ...and cut the text in this position
137
                $truncate = mb_substr($truncate, 0, $spacepos);
138
            }
139
        }
140
        // add the defined ending to the text
141
        $truncate .= $ending;
142
        if ($considerHtml) {
143
            // close all unclosed html-tags
144
            foreach ($openTags as $tag) {
0 ignored issues
show
Comprehensibility Best Practice introduced by
The variable $openTags does not seem to be defined for all execution paths leading up to this point.
Loading history...
145
                $truncate .= '</' . $tag . '>';
146
            }
147
        }
148
149
        return $truncate;
150
    }
151
152
    /**
153
     * @param null|Helper $helper
154
     * @param array|null  $options
155
     * @return \XoopsFormDhtmlTextArea|\XoopsFormEditor
156
     */
157
    public static function getEditor($helper = null, $options = null)
158
    {
159
        /** @var Helper $helper */
160
        if (null === $options) {
161
            $options           = [];
162
            $options['name']   = 'Editor';
163
            $options['value']  = 'Editor';
164
            $options['rows']   = 10;
165
            $options['cols']   = '100%';
166
            $options['width']  = '100%';
167
            $options['height'] = '400px';
168
        }
169
170
        if (null === $helper) {
171
            $helper = Helper::getInstance();
172
        }
173
174
        $isAdmin = $helper->isUserAdmin();
175
176
        if (\class_exists('XoopsFormEditor')) {
177
            if ($isAdmin) {
178
                $descEditor = new \XoopsFormEditor(\ucfirst($options['name']), $helper->getConfig('editorAdmin'), $options, $nohtml = false, $onfailure = 'textarea');
179
            } else {
180
                $descEditor = new \XoopsFormEditor(\ucfirst($options['name']), $helper->getConfig('editorUser'), $options, $nohtml = false, $onfailure = 'textarea');
181
            }
182
        } else {
183
            $descEditor = new \XoopsFormDhtmlTextArea(\ucfirst($options['name']), $options['name'], $options['value'], '100%', '100%');
0 ignored issues
show
Bug introduced by
'100%' of type string is incompatible with the type integer expected by parameter $cols of XoopsFormDhtmlTextArea::__construct(). ( Ignorable by Annotation )

If this is a false-positive, you can also ignore this issue in your code via the ignore-type  annotation

183
            $descEditor = new \XoopsFormDhtmlTextArea(\ucfirst($options['name']), $options['name'], $options['value'], '100%', /** @scrutinizer ignore-type */ '100%');
Loading history...
Bug introduced by
'100%' of type string is incompatible with the type integer expected by parameter $rows of XoopsFormDhtmlTextArea::__construct(). ( Ignorable by Annotation )

If this is a false-positive, you can also ignore this issue in your code via the ignore-type  annotation

183
            $descEditor = new \XoopsFormDhtmlTextArea(\ucfirst($options['name']), $options['name'], $options['value'], /** @scrutinizer ignore-type */ '100%', '100%');
Loading history...
184
        }
185
186
        //        $form->addElement($descEditor);
187
188
        return $descEditor;
189
    }
190
191
    public static function fieldExists(string $fieldname, string $table): bool
192
    {
193
        global $xoopsDB;
194
        $result = $xoopsDB->queryF("SHOW COLUMNS FROM   $table LIKE '$fieldname'");
195
196
        return ($xoopsDB->getRowsNum($result) > 0);
197
    }
198
199
    /**
200
     * @param array|string $tableName
201
     * @param int          $id_field
202
     * @param int          $id
203
     *
204
     * @return mixed
205
     */
206
    public static function cloneRecord($tableName, $id_field, $id)
207
    {
208
        //        $new_id = false;
209
        $table = $GLOBALS['xoopsDB']->prefix($tableName);
210
        // copy content of the record you wish to clone
211
        $sql    = "SELECT * FROM $table WHERE $idField='" . $id . "' ";
0 ignored issues
show
Comprehensibility Best Practice introduced by
The variable $idField seems to be never defined.
Loading history...
212
        $result = $GLOBALS['xoopsDB']->query($sql);
213
        if ($result instanceof \mysqli_result) {
214
            $tempTable = $GLOBALS['xoopsDB']->fetchArray($result, \MYSQLI_ASSOC);
215
        }
216
        if (!$tempTable) {
0 ignored issues
show
Comprehensibility Best Practice introduced by
The variable $tempTable does not seem to be defined for all execution paths leading up to this point.
Loading history...
217
            trigger_error($GLOBALS['xoopsDB']->error());
218
        }
219
        // set the auto-incremented id's value to blank.
220
        unset($tempTable[$id_field]);
221
        // insert cloned copy of the original  record
222
        $sql    = "INSERT INTO $table (" . \implode(', ', \array_keys($tempTable)) . ") VALUES ('" . \implode("', '", \array_values($tempTable)) . "')";
223
        $result = $GLOBALS['xoopsDB']->queryF($sql);
224
        if (!$result) {
225
            trigger_error($GLOBALS['xoopsDB']->error());
226
        }
227
        // Return the new id
228
        $new_id = $GLOBALS['xoopsDB']->getInsertId();
229
230
        return $new_id;
231
    }
232
233
    /**
234
     * Function responsible for checking if a directory exists, we can also write in and create an index.html file
235
     *
236
     * @param string $folder The full path of the directory to check
237
     */
238
    public static function prepareFolder($folder): void
239
    {
240
        try {
241
            if (!@\mkdir($folder) && !\is_dir($folder)) {
242
                throw new \RuntimeException(\sprintf('Unable to create the %s directory', $folder));
243
            }
244
            file_put_contents($folder . '/index.html', '<script>history.go(-1);</script>');
245
        } catch (\Throwable $e) {
246
            echo 'Caught exception: ', $e->getMessage(), "\n", '<br>';
247
        }
248
    }
249
250
    /**
251
     * @param string $tablename
252
     *
253
     * @return bool
254
     */
255
    public static function tableExists($tablename)
256
    {
257
        $result = $GLOBALS['xoopsDB']->queryF("SHOW TABLES LIKE '$tablename'");
258
259
        return $GLOBALS['xoopsDB']->getRowsNum($result) > 0;
260
    }
261
}
262