Revisions::getRevisions() - Code Metrics - Inspection of "refactor html_* functions into Ui class member usi..." - splitbrain/dokuwiki - Measure and Improve Code Quality continuously with Scrutinizer

Failed Conditions

Pull Request — master (#3198)

unknown

created 2020-08-19 10:17 UTC

Revisions::getRevisions() C

↳ Parent: Revisions

Complexity

Conditions	11
Paths	144

Size

Total Lines

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
cc	11
dl	0
loc	62
rs	6.389
c	0
b	0
f	0
nc	144
nop	2

How to fix Long Method Complexity

<?php

namespace dokuwiki\Ui;

use dokuwiki\ChangeLog\PageChangeLog;
use dokuwiki\ChangeLog\MediaChangeLog;
use dokuwiki\Extension\Event;
use dokuwiki\Form\Form;

/**
 * DokuWiki Revisions Interface
 *
 * @package dokuwiki\Ui
 */
class Revisions extends Ui
{
    protected $first;
    protected $media_id;

    /** 
     * Revisions Ui constructor
     *
     * @param int $first  skip the first n changelog lines
     * @param bool|string $media_id  id of media, or false for current page
     */
    public function __construct($first = 0, $media_id = false)
    {
        $this->first    = $first;
        $this->media_id = $media_id;
    }

    /**
     * Display list of old revisions
     *
     * @author Andreas Gohr <[email protected]>
     * @author Ben Coburn <[email protected]>
     * @author Kate Arzamastseva <[email protected]>
     * @author Satoshi Sahara <[email protected]>
     *
     * @triggers HTMLFORM_REVISIONS_OUTPUT
     * @return void
     */
    public function show()
    {
        global $ID;

        if ($this->media_id) {
            return $this->showMediaRevisions($this->media_id);
/**
 * @return array|string
 */
function returnsDifferentValues($x) {
    if ($x) {
        return 'foo';
    }

    return array();
}

$x = returnsDifferentValues($y);
if (is_array($x)) {
    // $x is an array.
}
        } else {
            return $this->showPageRevisions($ID);
        }
    }

    /**
     * Display a list of Media Revisions in the MediaManager
     *
     * @param string $id  media id
     * @return void
     */
    protected function showMediaRevisions($id)
    {
        global $lang;

        // get revisions, and set correct pagenation parameters (first, hasNext)
        $first   = $this->first;
        $hasNext = false;
        $revisions = $this->getRevisions($first, $hasNext);

        // create the form
        $form = new Form([
                'id' => 'page__revisions', // must not be "media__revisions"
                'action' => media_managerURL(['image' => $id], '&'),
                'class'  => 'changes',
        ]);
        $form->setHiddenField('mediado', 'diff'); // required for media revisions
        $form->addTagOpen('div')->addClass('no');

        // start listing
        $form->addTagOpen('ul');
        foreach ($revisions as $info) {
            $rev = $info['date'];
            $class = ($info['type'] === DOKU_CHANGE_TYPE_MINOR_EDIT) ? 'minor' : '';
            $form->addTagOpen('li')->addClass($class);
            $form->addTagOpen('div')->addClass('li');

            if (isset($info['current'])) {
               $form->addCheckbox('rev2[]')->val('current');
            } elseif (file_exists(mediaFN($id, $rev))) {
                $form->addCheckbox('rev2[]')->val($rev);
            } else {
                $form->addCheckbox('')->val($rev)->attr('disabled','disabled');
            }
            $form->addHTML(' ');

            $objRevInfo = $this->getObjRevInfo($info);
            $html = implode(' ', [
                $objRevInfo->editDate(),          // edit date and time
                $objRevInfo->difflink(),          // link to diffview icon
                $objRevInfo->itemName(),          // name of page or media
                '<div>',
                $objRevInfo->editSummary(),       // edit summary
                $objRevInfo->editor(),            // editor info
                html_sizechange($info['sizechange']), // size change indicator
                $objRevInfo->currentIndicator(),  // current indicator (only when k=1)
                '</div>',
            ]);
            $form->addHTML($html);

            $form->addTagClose('div');
            $form->addTagClose('li');
        }
        $form->addTagClose('ul');  // end of revision list

        // show button for diff view
        $form->addButton('do[diff]', $lang['diff2'])->attr('type', 'submit');

        $form->addTagClose('div'); // close div class=no

        // print form that might be modified by HTMLFORM_REVISIONS_OUTPUT event handlers
        print $form->toHTML('revisions');

        // provide navigation for pagenated revision list (of pages and/or media files)
        print $this->htmlNavigation($id, $first, $hasNext);
    }

    /**
     * Display a list of Page Revisions
     *
     * @return void
     */
    protected function showPageRevisions($id)
    {
        global $lang;

        // get revisions, and set correct pagenation parameters (first, hasNext)
        $first   = $this->first;
        $hasNext = false;
        $revisions = $this->getRevisions($first, $hasNext);

        // print intro
        print p_locale_xhtml('revisions');

        // create the form
        $form = new Form([
                'id' => 'page__revisions',
                'class' => 'changes',
        ]);
        $form->addTagOpen('div')->addClass('no');

        // start listing
        $form->addTagOpen('ul');
        foreach ($revisions as $info) {
            $rev = $info['date'];
            $class = ($info['type'] === DOKU_CHANGE_TYPE_MINOR_EDIT) ? 'minor' : '';
            $form->addTagOpen('li')->addClass($class);
            $form->addTagOpen('div')->addClass('li');

            if (page_exists($id, $rev)) {
                $form->addCheckbox('rev2[]')->val($rev);
            } else {
                $form->addCheckbox('')->val($rev)->attr('disabled','disabled');
            }
            $form->addHTML(' ');

            $objRevInfo = $this->getObjRevInfo($info);
            $html = implode(' ', [
                $objRevInfo->editDate(),          // edit date and time
                $objRevInfo->difflink(),          // link to diffview icon
                $objRevInfo->itemName(),          // name of page or media
                $objRevInfo->editSummary(),       // edit summary
                $objRevInfo->editor(),            // editor info
                html_sizechange($info['sizechange']), // size change indicator
                $objRevInfo->currentIndicator(),  // current indicator (only when k=1)
            ]);
            $form->addHTML($html);
            $form->addTagClose('div');
            $form->addTagClose('li');
        }
        $form->addTagClose('ul');  // end of revision list

        // show button for diff view
        $form->addButton('do[diff]', $lang['diff2'])->attr('type', 'submit');

        $form->addTagClose('div'); // close div class=no

        // print form that might be modified by HTMLFORM_REVISIONS_OUTPUT event handlers
        print $form->toHTML('revisions');

        // provide navigation for pagenated revision list (of pages and/or media files)
        print $this->htmlNavigation($id, $first, $hasNext);
    }


    /**
     * Get revisions, and set correct pagenation parameters (first, hasNext)
     *
     * @param int  $first
     * @param bool $hasNext
     * @return array  revisions to be shown in a pagenated list
     */
    protected function getRevisions(&$first, &$hasNext)
    {
        global $INFO, $conf;

        if ($this->media_id) {
            $changelog = new MediaChangeLog($this->media_id);
/**
 * @return array|string
 */
function returnsDifferentValues($x) {
    if ($x) {
        return 'foo';
    }

    return array();
}

$x = returnsDifferentValues($y);
if (is_array($x)) {
    // $x is an array.
}
        } else {
            $changelog = new PageChangeLog($INFO['id']);
        }

        $revisions = [];

        /* we need to get one additional log entry to be able to
         * decide if this is the last page or is there another one.
         * see also Ui\Recent::getRecents()
         */
        $revlist = $changelog->getRevisions($first, $conf['recent'] +1);
        if (count($revlist) == 0 && $first != 0) {
            $first = 0;
            $revlist = $changelog->getRevisions($first, $conf['recent'] +1);
        }
        $exists = ($this->media_id) ? file_exists(mediaFN($this->media_id)) : $INFO['exists'];
/**
 * @return array|string
 */
function returnsDifferentValues($x) {
    if ($x) {
        return 'foo';
    }

    return array();
}

$x = returnsDifferentValues($y);
if (is_array($x)) {
    // $x is an array.
}
        if ($first === 0 && $exists) {
            // add current page or media as revision[0]
            if ($this->media_id) {
                $rev = filemtime(fullpath(mediaFN($this->media_id)));
/**
 * @return array|string
 */
function returnsDifferentValues($x) {
    if ($x) {
        return 'foo';
    }

    return array();
}

$x = returnsDifferentValues($y);
if (is_array($x)) {
    // $x is an array.
}
                $revisions[] = $changelog->getRevisionInfo($rev) + array(
                        'media' => true,
                        'current' => true,
                );
            } else {
                $revisions[] = array(
                        'date' => $INFO['lastmod'],
                        'ip'   => null,
                        'type' => $INFO['meta']['last_change']['type'],
                        'id'   => $INFO['id'],
                        'user' => $INFO['editor'],
                        'sum'  => $INFO['sum'],
                        'extra' => null,
                        'sizechange' => $INFO['meta']['last_change']['sizechange'],
                        'current' => true,
                );
            }
        }

        // decide if this is the last page or is there another one
        $hasNext = false;
        if (count($revlist) > $conf['recent']) {
            $hasNext = true;
            array_pop($revlist); // remove one additional log entry
        }

        // append each revison info array to the revisions
        foreach ($revlist as $rev) {
            if ($this->media_id) {
                $revisions[] = $changelog->getRevisionInfo($rev) + array('media' => true);
            } else {
                $revisions[] = $changelog->getRevisionInfo($rev);
            }
        }
        return $revisions;
    }

    /**
     * Navigation buttons for Pagenation (prev/next)
     *
     * @param string $id  page id or media id
     * @param int  $first
     * @param bool $hasNext
     * @return array  html
     */
    protected function htmlNavigation($id, $first, $hasNext)
    {
        global $conf;

        $html = '<div class="pagenav">';
        $last = $first + $conf['recent'];
        if ($first > 0) {
            $first = max($first - $conf['recent'], 0);
            $html.= '<div class="pagenav-prev">';
            if ($this->media_id) {
                $html.= html_btn('newer', $id, "p", media_managerURL(['first' => $first], '&', false, true));
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
            } else {
                $html.= html_btn('newer', $id, "p" ,['do' => 'revisions', 'first' => $first]);
            }
            $html.= '</div>';
        }
        if ($hasNext) {
            $html.= '<div class="pagenav-next">';
            if ($this->media_id) {
                $html.= html_btn('older', $id, "n", media_managerURL(['first' => $last], '&', false, true));
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
            } else {
                $html.= html_btn('older', $id, "n", ['do' => 'revisions', 'first' => $last]);
            }
            $html.= '</div>';
        }
        $html.= '</div>';
        return $html;
    }

    /**
     * Returns instance of objRevInfo
     *
     * @param array $info  Revision info structure of a page or media file
     * @return objRevInfo object (anonymous class)
     */
    protected function getObjRevInfo(array $info)
    {
        return new class ($info) // anonymous class (objRevInfo)
        {
            protected $info;

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

            // current indicator
            public function currentIndicator()
            {
                global $lang;
                return ($this->info['current']) ? '('.$lang['current'].')' : '';
            }

            // edit date and time of the page or media file
            public function editDate()
            {
                return '<span class="date">'. dformat($this->info['date']) .'</span>';
            }

            // edit summary
            public function editSummary()
            {
                return '<span class="sum">'.' – '. hsc($this->info['sum']).'</span>';
            }

            // editor of the page or media file
            public function editor()
            {
                // slightly different with display of Ui\Recent, i.e. external edit
                global $lang;
                $html = '<span class="user">';
                if (!$this->info['user'] && !$this->info['ip']) {
                    $html.= '('.$lang['external_edit'].')';
                } elseif ($this->info['user']) {
                    $html.= '<bdi>'. editorinfo($this->info['user']) .'</bdi>';
                    if (auth_ismanager()) $html.= ' <bdo dir="ltr">('. $this->info['ip'] .')</bdo>';
                } else {
                    $html.= '<bdo dir="ltr">'. $this->info['ip'] .'</bdo>';
                }
                $html.= '</span>';
                return $html;
            }

            // name of the page or media file
            public function itemName()
            {
                // slightly different with display of Ui\Recent, i.e. revison may not exists
                $id = $this->info['id'];
                $rev = $this->info['date'];

                if (isset($this->info['media'])) {
                    // media file revision
                    if (isset($this->info['current'])) {
                        $href = media_managerURL(['image'=> $id, 'tab_details'=> 'view'], '&');
                        $html = '<a href="'.$href.'" class="wikilink1">'.$id.'</a>';
                    } elseif (file_exists(mediaFN($id, $rev))) {
                        $href = media_managerURL(['image'=> $id, 'tab_details'=> 'view', 'rev'=> $rev], '&');
                        $html = '<a href="'.$href.'" class="wikilink1">'.$id.'</a>';
                    } else {
                        $html = $id;
                    }
                    return $html;
                } else {
                    // page revision
                    $display_name = useHeading('navigation') ? hsc(p_get_first_heading($id)) : $id;
                    if (!$display_name) $display_name = $id;
                    if ($this->info['current'] || page_exists($id, $rev)) {
                        $href = wl($id, "rev=$rev", false, '&');
                        $html = '<a href="'.$href.'" class="wikilink1">'.$display_name.'</a>';
                    } else {
                        $html = $display_name;
                    }
                    return $html;
                }
            }

            // icon difflink
            public function difflink()
            {
                global $lang;
                $id = $this->info['id'];
                $rev = $this->info['date'];

                if (isset($this->info['media'])) {
                    // media file revision
                    if (isset($this->info['current']) || !file_exists(mediaFN($id, $rev))) {
                        $html = '<img src="'.DOKU_BASE.'lib/images/blank.gif" width="15" height="11" alt="" />';
                    } else {
                        $href = media_managerURL(['image'=> $id, 'rev'=> $rev, 'mediado'=>'diff'], '&');
                        $html = '<a href="'.$href.'" class="diff_link">'
                              . '<img src="'.DOKU_BASE.'lib/images/diff.png" width="15" height="11"'
                              . ' title="'. $lang['diff'] .'" alt="'.$lang['diff'] .'" />'
                              . '</a> ';
                    }
                    return $html;
                } else {
                    // page revision
                    if ($this->info['current'] || !page_exists($id, $rev)) {
                        $html = '<img src="'.DOKU_BASE.'lib/images/blank.gif" width="15" height="11" alt="" />';
                    } else {
                        $href = wl($id, "rev=$rev,do=diff", false, '&');
                        $html = '<a href="'.$href.'" class="diff_link">'
                              . '<img src="'.DOKU_BASE.'lib/images/diff.png" width="15" height="11"'
                              . ' title="'.$lang['diff'].'" alt="'.$lang['diff'].'" />'
                              . '</a>';
                    }
                    return $html;
                }
            }

            // size change
            public function sizeChange()
            {
                $class = 'sizechange';
                $value = filesize_h(abs($this->info['sizechange']));
                if ($this->info['sizechange'] > 0) {
                    $class .= ' positive';
                    $value = '+' . $value;
                } elseif ($this->info['sizechange'] < 0) {
                    $class .= ' negative';
                    $value = '-' . $value;
                } else {
                    $value = '±' . $value;
                }
                return '<span class="'.$class.'">'.$value.'</span>';
            }
        }; // end of anonymous class (objRevInfo)
    }

}


1			<?php
2
3			namespace dokuwiki\Ui;
4
5			use dokuwiki\ChangeLog\PageChangeLog;
6			use dokuwiki\ChangeLog\MediaChangeLog;
7			use dokuwiki\Extension\Event;
8			use dokuwiki\Form\Form;
9
10			/**
11			* DokuWiki Revisions Interface
12			*
13			* @package dokuwiki\Ui
14			*/
15			class Revisions extends Ui
16			{
17			protected $first;
18			protected $media_id;
19
20			/**
21			* Revisions Ui constructor
22			*
23			* @param int $first skip the first n changelog lines
24			* @param bool\|string $media_id id of media, or false for current page
25			*/
26			public function __construct($first = 0, $media_id = false)
27			{
28			$this->first = $first;
29			$this->media_id = $media_id;
30			}
31
32			/**
33			* Display list of old revisions
34			*
35			* @author Andreas Gohr <[email protected]>
36			* @author Ben Coburn <[email protected]>
37			* @author Kate Arzamastseva <[email protected]>
38			* @author Satoshi Sahara <[email protected]>
39			*
40			* @triggers HTMLFORM_REVISIONS_OUTPUT
41			* @return void
42			*/
43			public function show()
44			{
45			global $ID;
46
47			if ($this->media_id) {
48			return $this->showMediaRevisions($this->media_id);
			0 ignored issues – show Bug introduced 2020-08-18 10:46 UTC by Report Bug Copy Issue Report It seems like `$this->media_id` can also be of type `boolean`; however, `dokuwiki\Ui\Revisions::showMediaRevisions()` does only seem to accept `string`, maybe add an additional type check? If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check: /** * @return array\|string */ function returnsDifferentValues($x) { if ($x) { return 'foo'; } return array(); } $x = returnsDifferentValues($y); if (is_array($x)) { // $x is an array. } If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue. Loading history...
49			} else {
50			return $this->showPageRevisions($ID);
51			}
52			}
53
54			/**
55			* Display a list of Media Revisions in the MediaManager
56			*
57			* @param string $id media id
58			* @return void
59			*/
60			protected function showMediaRevisions($id)
61			{
62			global $lang;
63
64			// get revisions, and set correct pagenation parameters (first, hasNext)
65			$first = $this->first;
66			$hasNext = false;
67			$revisions = $this->getRevisions($first, $hasNext);
68
69			// create the form
70			$form = new Form([
71			'id' => 'page__revisions', // must not be "media__revisions"
72			'action' => media_managerURL(['image' => $id], '&'),
73			'class' => 'changes',
74			]);
75			$form->setHiddenField('mediado', 'diff'); // required for media revisions
76			$form->addTagOpen('div')->addClass('no');
77
78			// start listing
79			$form->addTagOpen('ul');
80			foreach ($revisions as $info) {
81			$rev = $info['date'];
82			$class = ($info['type'] === DOKU_CHANGE_TYPE_MINOR_EDIT) ? 'minor' : '';
83			$form->addTagOpen('li')->addClass($class);
84			$form->addTagOpen('div')->addClass('li');
85
86			if (isset($info['current'])) {
87			$form->addCheckbox('rev2[]')->val('current');
88			} elseif (file_exists(mediaFN($id, $rev))) {
89			$form->addCheckbox('rev2[]')->val($rev);
90			} else {
91			$form->addCheckbox('')->val($rev)->attr('disabled','disabled');
92			}
93			$form->addHTML(' ');
94
95			$objRevInfo = $this->getObjRevInfo($info);
96			$html = implode(' ', [
97			$objRevInfo->editDate(), // edit date and time
98			$objRevInfo->difflink(), // link to diffview icon
99			$objRevInfo->itemName(), // name of page or media
100			'<div>',
101			$objRevInfo->editSummary(), // edit summary
102			$objRevInfo->editor(), // editor info
103			html_sizechange($info['sizechange']), // size change indicator
104			$objRevInfo->currentIndicator(), // current indicator (only when k=1)
105			'</div>',
106			]);
107			$form->addHTML($html);
108
109			$form->addTagClose('div');
110			$form->addTagClose('li');
111			}
112			$form->addTagClose('ul'); // end of revision list
113
114			// show button for diff view
115			$form->addButton('do[diff]', $lang['diff2'])->attr('type', 'submit');
116
117			$form->addTagClose('div'); // close div class=no
118
119			// print form that might be modified by HTMLFORM_REVISIONS_OUTPUT event handlers
120			print $form->toHTML('revisions');
121
122			// provide navigation for pagenated revision list (of pages and/or media files)
123			print $this->htmlNavigation($id, $first, $hasNext);
124			}
125
126			/**
127			* Display a list of Page Revisions
128			*
129			* @return void
130			*/
131			protected function showPageRevisions($id)
132			{
133			global $lang;
134
135			// get revisions, and set correct pagenation parameters (first, hasNext)
136			$first = $this->first;
137			$hasNext = false;
138			$revisions = $this->getRevisions($first, $hasNext);
139
140			// print intro
141			print p_locale_xhtml('revisions');
142
143			// create the form
144			$form = new Form([
145			'id' => 'page__revisions',
146			'class' => 'changes',
147			]);
148			$form->addTagOpen('div')->addClass('no');
149
150			// start listing
151			$form->addTagOpen('ul');
152			foreach ($revisions as $info) {
153			$rev = $info['date'];
154			$class = ($info['type'] === DOKU_CHANGE_TYPE_MINOR_EDIT) ? 'minor' : '';
155			$form->addTagOpen('li')->addClass($class);
156			$form->addTagOpen('div')->addClass('li');
157
158			if (page_exists($id, $rev)) {
159			$form->addCheckbox('rev2[]')->val($rev);
160			} else {
161			$form->addCheckbox('')->val($rev)->attr('disabled','disabled');
162			}
163			$form->addHTML(' ');
164
165			$objRevInfo = $this->getObjRevInfo($info);
166			$html = implode(' ', [
167			$objRevInfo->editDate(), // edit date and time
168			$objRevInfo->difflink(), // link to diffview icon
169			$objRevInfo->itemName(), // name of page or media
170			$objRevInfo->editSummary(), // edit summary
171			$objRevInfo->editor(), // editor info
172			html_sizechange($info['sizechange']), // size change indicator
173			$objRevInfo->currentIndicator(), // current indicator (only when k=1)
174			]);
175			$form->addHTML($html);
176			$form->addTagClose('div');
177			$form->addTagClose('li');
178			}
179			$form->addTagClose('ul'); // end of revision list
180
181			// show button for diff view
182			$form->addButton('do[diff]', $lang['diff2'])->attr('type', 'submit');
183
184			$form->addTagClose('div'); // close div class=no
185
186			// print form that might be modified by HTMLFORM_REVISIONS_OUTPUT event handlers
187			print $form->toHTML('revisions');
188
189			// provide navigation for pagenated revision list (of pages and/or media files)
190			print $this->htmlNavigation($id, $first, $hasNext);
191			}
192
193
194			/**
195			* Get revisions, and set correct pagenation parameters (first, hasNext)
196			*
197			* @param int $first
198			* @param bool $hasNext
199			* @return array revisions to be shown in a pagenated list
200			*/
201			protected function getRevisions(&$first, &$hasNext)
202			{
203			global $INFO, $conf;
204
205			if ($this->media_id) {
206			$changelog = new MediaChangeLog($this->media_id);
			0 ignored issues – show Bug introduced 2020-08-18 10:46 UTC by Report Bug Copy Issue Report It seems like `$this->media_id` can also be of type `boolean`; however, `dokuwiki\ChangeLog\ChangeLog::__construct()` does only seem to accept `string`, maybe add an additional type check? If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check: /** * @return array\|string */ function returnsDifferentValues($x) { if ($x) { return 'foo'; } return array(); } $x = returnsDifferentValues($y); if (is_array($x)) { // $x is an array. } If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue. Loading history...
207			} else {
208			$changelog = new PageChangeLog($INFO['id']);
209			}
210
211			$revisions = [];
212
213			/* we need to get one additional log entry to be able to
214			* decide if this is the last page or is there another one.
215			* see also Ui\Recent::getRecents()
216			*/
217			$revlist = $changelog->getRevisions($first, $conf['recent'] +1);
218			if (count($revlist) == 0 && $first != 0) {
219			$first = 0;
220			$revlist = $changelog->getRevisions($first, $conf['recent'] +1);
221			}
222			$exists = ($this->media_id) ? file_exists(mediaFN($this->media_id)) : $INFO['exists'];
			0 ignored issues – show Bug introduced 2020-08-18 10:46 UTC by Report Bug Copy Issue Report It seems like `$this->media_id` can also be of type `boolean`; however, `mediaFN()` does only seem to accept `string`, maybe add an additional type check? If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check: /** * @return array\|string */ function returnsDifferentValues($x) { if ($x) { return 'foo'; } return array(); } $x = returnsDifferentValues($y); if (is_array($x)) { // $x is an array. } If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue. Loading history...
223			if ($first === 0 && $exists) {
224			// add current page or media as revision[0]
225			if ($this->media_id) {
226			$rev = filemtime(fullpath(mediaFN($this->media_id)));
			0 ignored issues – show Bug introduced 2020-08-18 10:46 UTC by Report Bug Copy Issue Report It seems like `$this->media_id` can also be of type `boolean`; however, `mediaFN()` does only seem to accept `string`, maybe add an additional type check? If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check: /** * @return array\|string */ function returnsDifferentValues($x) { if ($x) { return 'foo'; } return array(); } $x = returnsDifferentValues($y); if (is_array($x)) { // $x is an array. } If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue. Loading history...
227			$revisions[] = $changelog->getRevisionInfo($rev) + array(
228			'media' => true,
229			'current' => true,
230			);
231			} else {
232			$revisions[] = array(
233			'date' => $INFO['lastmod'],
234			'ip' => null,
235			'type' => $INFO['meta']['last_change']['type'],
236			'id' => $INFO['id'],
237			'user' => $INFO['editor'],
238			'sum' => $INFO['sum'],
239			'extra' => null,
240			'sizechange' => $INFO['meta']['last_change']['sizechange'],
241			'current' => true,
242			);
243			}
244			}
245
246			// decide if this is the last page or is there another one
247			$hasNext = false;
248			if (count($revlist) > $conf['recent']) {
249			$hasNext = true;
250			array_pop($revlist); // remove one additional log entry
251			}
252
253			// append each revison info array to the revisions
254			foreach ($revlist as $rev) {
255			if ($this->media_id) {
256			$revisions[] = $changelog->getRevisionInfo($rev) + array('media' => true);
257			} else {
258			$revisions[] = $changelog->getRevisionInfo($rev);
259			}
260			}
261			return $revisions;
262			}
263
264			/**
265			* Navigation buttons for Pagenation (prev/next)
266			*
267			* @param string $id page id or media id
268			* @param int $first
269			* @param bool $hasNext
270			* @return array html
271			*/
272			protected function htmlNavigation($id, $first, $hasNext)
273			{
274			global $conf;
275
276			$html = '<div class="pagenav">';
277			$last = $first + $conf['recent'];
278			if ($first > 0) {
279			$first = max($first - $conf['recent'], 0);
280			$html.= '<div class="pagenav-prev">';
281			if ($this->media_id) {
282			$html.= html_btn('newer', $id, "p", media_managerURL(['first' => $first], '&', false, true));
			0 ignored issues – show Documentation introduced 2020-08-18 10:46 UTC by Report Bug Copy Issue Report `media_managerURL(array('...rst), '&', false, true)` is of type `string\|array`, but the function expects a `array<integer,string>`. It seems like the type of the argument is not accepted by the function/method which you are calling. In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug. We suggest to add an explicit type cast like in the following example: function acceptsInteger($int) { } $x = '123'; // string "123" // Instead of acceptsInteger($x); // we recommend to use acceptsInteger((integer) $x); Loading history...
283			} else {
284			$html.= html_btn('newer', $id, "p" ,['do' => 'revisions', 'first' => $first]);
285			}
286			$html.= '</div>';
287			}
288			if ($hasNext) {
289			$html.= '<div class="pagenav-next">';
290			if ($this->media_id) {
291			$html.= html_btn('older', $id, "n", media_managerURL(['first' => $last], '&', false, true));
			0 ignored issues – show Documentation introduced 2020-08-18 10:46 UTC by Report Bug Copy Issue Report `media_managerURL(array('...ast), '&', false, true)` is of type `string\|array`, but the function expects a `array<integer,string>`. It seems like the type of the argument is not accepted by the function/method which you are calling. In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug. We suggest to add an explicit type cast like in the following example: function acceptsInteger($int) { } $x = '123'; // string "123" // Instead of acceptsInteger($x); // we recommend to use acceptsInteger((integer) $x); Loading history...
292			} else {
293			$html.= html_btn('older', $id, "n", ['do' => 'revisions', 'first' => $last]);
294			}
295			$html.= '</div>';
296			}
297			$html.= '</div>';
298			return $html;
299			}
300
301			/**
302			* Returns instance of objRevInfo
303			*
304			* @param array $info Revision info structure of a page or media file
305			* @return objRevInfo object (anonymous class)
306			*/
307			protected function getObjRevInfo(array $info)
308			{
309			return new class ($info) // anonymous class (objRevInfo)
310			{
311			protected $info;
312
313			public function __construct(array $info)
314			{
315			$this->info = $info;
316			}
317
318			// current indicator
319			public function currentIndicator()
320			{
321			global $lang;
322			return ($this->info['current']) ? '('.$lang['current'].')' : '';
323			}
324
325			// edit date and time of the page or media file
326			public function editDate()
327			{
328			return '<span class="date">'. dformat($this->info['date']) .'</span>';
329			}
330
331			// edit summary
332			public function editSummary()
333			{
334			return '<span class="sum">'.' – '. hsc($this->info['sum']).'</span>';
335			}
336
337			// editor of the page or media file
338			public function editor()
339			{
340			// slightly different with display of Ui\Recent, i.e. external edit
341			global $lang;
342			$html = '<span class="user">';
343			if (!$this->info['user'] && !$this->info['ip']) {
344			$html.= '('.$lang['external_edit'].')';
345			} elseif ($this->info['user']) {
346			$html.= '<bdi>'. editorinfo($this->info['user']) .'</bdi>';
347			if (auth_ismanager()) $html.= ' <bdo dir="ltr">('. $this->info['ip'] .')</bdo>';
348			} else {
349			$html.= '<bdo dir="ltr">'. $this->info['ip'] .'</bdo>';
350			}
351			$html.= '</span>';
352			return $html;
353			}
354
355			// name of the page or media file
356			public function itemName()
357			{
358			// slightly different with display of Ui\Recent, i.e. revison may not exists
359			$id = $this->info['id'];
360			$rev = $this->info['date'];
361
362			if (isset($this->info['media'])) {
363			// media file revision
364			if (isset($this->info['current'])) {
365			$href = media_managerURL(['image'=> $id, 'tab_details'=> 'view'], '&');
366			$html = '<a href="'.$href.'" class="wikilink1">'.$id.'</a>';
367			} elseif (file_exists(mediaFN($id, $rev))) {
368			$href = media_managerURL(['image'=> $id, 'tab_details'=> 'view', 'rev'=> $rev], '&');
369			$html = '<a href="'.$href.'" class="wikilink1">'.$id.'</a>';
370			} else {
371			$html = $id;
372			}
373			return $html;
374			} else {
375			// page revision
376			$display_name = useHeading('navigation') ? hsc(p_get_first_heading($id)) : $id;
377			if (!$display_name) $display_name = $id;
378			if ($this->info['current'] \|\| page_exists($id, $rev)) {
379			$href = wl($id, "rev=$rev", false, '&');
380			$html = '<a href="'.$href.'" class="wikilink1">'.$display_name.'</a>';
381			} else {
382			$html = $display_name;
383			}
384			return $html;
385			}
386			}
387
388			// icon difflink
389			public function difflink()
390			{
391			global $lang;
392			$id = $this->info['id'];
393			$rev = $this->info['date'];
394
395			if (isset($this->info['media'])) {
396			// media file revision
397			if (isset($this->info['current']) \|\| !file_exists(mediaFN($id, $rev))) {
398			$html = '<img src="'.DOKU_BASE.'lib/images/blank.gif" width="15" height="11" alt="" />';
399			} else {
400			$href = media_managerURL(['image'=> $id, 'rev'=> $rev, 'mediado'=>'diff'], '&');
401			$html = '<a href="'.$href.'" class="diff_link">'
402			. '<img src="'.DOKU_BASE.'lib/images/diff.png" width="15" height="11"'
403			. ' title="'. $lang['diff'] .'" alt="'.$lang['diff'] .'" />'
404			. '</a> ';
405			}
406			return $html;
407			} else {
408			// page revision
409			if ($this->info['current'] \|\| !page_exists($id, $rev)) {
410			$html = '<img src="'.DOKU_BASE.'lib/images/blank.gif" width="15" height="11" alt="" />';
411			} else {
412			$href = wl($id, "rev=$rev,do=diff", false, '&');
413			$html = '<a href="'.$href.'" class="diff_link">'
414			. '<img src="'.DOKU_BASE.'lib/images/diff.png" width="15" height="11"'
415			. ' title="'.$lang['diff'].'" alt="'.$lang['diff'].'" />'
416			. '</a>';
417			}
418			return $html;
419			}
420			}
421
422			// size change
423			public function sizeChange()
424			{
425			$class = 'sizechange';
426			$value = filesize_h(abs($this->info['sizechange']));
427			if ($this->info['sizechange'] > 0) {
428			$class .= ' positive';
429			$value = '+' . $value;
430			} elseif ($this->info['sizechange'] < 0) {
431			$class .= ' negative';
432			$value = '-' . $value;
433			} else {
434			$value = '±' . $value;
435			}
436			return '<span class="'.$class.'">'.$value.'</span>';
437			}
438			}; // end of anonymous class (objRevInfo)
439			}
440
441			}
442

splitbrain / dokuwiki

Pull Request — master (#3198)

Revisions::getRevisions() C

Complexity

Size

Duplication

Importance

How to fix Long Method Complexity

Long Method

Duplication Side-by-Side

Filter issues like