PHPCompatibility_Sniffs_PHP_NewInterfacesSniff::process() - Code Metrics - Inspection of "Merge pull request #231 from jrfnl/feature/various..." - wimg/PHPCompatibility - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( 1947a4...42d661 )

by Juliette

created 2016-09-17 20:56 UTC

process() C

↳ Parent: PHPCompatibility_Sniffs_PHP_NewInterfacesSniff

Complexity

Conditions	11
Paths	23

Size

Total Lines	44
Code Lines	26

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
dl	0
loc	44
rs	5.2653
c	0
b	0
f	0
cc	11
eloc	26
nc	23
nop	2

How to fix Complexity

<?php
/**
 * PHPCompatibility_Sniffs_PHP_NewInterfacesSniff.
 *
 * PHP version 5.5
 *
 * @category  PHP
 * @package   PHPCompatibility
 * @author    Juliette Reinders Folmer <[email protected]>
 */

/**
 * PHPCompatibility_Sniffs_PHP_NewInterfacesSniff.
 *
 * @category  PHP
 * @package   PHPCompatibility
 * @author    Juliette Reinders Folmer <[email protected]>
 */
class PHPCompatibility_Sniffs_PHP_NewInterfacesSniff extends PHPCompatibility_Sniff
namespace YourVendor;

class YourClass { }
{

    /**
     * A list of new interfaces, not present in older versions.
     *
     * The array lists : version number with false (not present) or true (present).
     * If's sufficient to list the first version where the interface appears.
     *
     * @var array(string => array(string => int|string|null))
     */
    protected $newInterfaces = array(
                                'Countable' => array(
                                    '5.0' => false,
                                    '5.1' => true
                                ),
                                'OuterIterator' => array(
                                    '5.0' => false,
                                    '5.1' => true
                                ),
                                'RecursiveIterator' => array(
                                    '5.0' => false,
                                    '5.1' => true
                                ),
                                'SeekableIterator' => array(
                                    '5.0' => false,
                                    '5.1' => true
                                ),
                                'Serializable' => array(
                                    '5.0' => false,
                                    '5.1' => true,
                                ),
                                'SplObserver' => array(
                                    '5.0' => false,
                                    '5.1' => true
                                ),
                                'SplSubject' => array(
                                    '5.0' => false,
                                    '5.1' => true
                                ),

                                'JsonSerializable' => array(
                                    '5.3' => false,
                                    '5.4' => true
                                ),
                                'SessionHandlerInterface' => array(
                                    '5.3' => false,
                                    '5.4' => true
                                ),

                               );

    /**
     * A list of methods which cannot be used in combination with particular interfaces.
     *
     * @var array(string => array(string => string))
     */
    protected $unsupportedMethods = array(
                                     'Serializable' => array(
                                         '__sleep'  => 'http://php.net/serializable',
                                         '__wakeup' => 'http://php.net/serializable',
                                     ),
                                    );

    /**
     * Returns an array of tokens this test wants to listen for.
     *
     * @return array
     */
    public function register()
    {
        // Handle case-insensitivity of class names.
        $keys = array_keys( $this->newInterfaces );
        $keys = array_map( 'strtolower', $keys );
        $this->newInterfaces = array_combine( $keys, $this->newInterfaces );

        $keys = array_keys( $this->unsupportedMethods );
        $keys = array_map( 'strtolower', $keys );
        $this->unsupportedMethods = array_combine( $keys, $this->unsupportedMethods );

        return array(T_CLASS);

    }//end register()


    /**
     * Processes this test, when one of its tokens is encountered.
     *
     * @param PHP_CodeSniffer_File $phpcsFile The file being scanned.
     * @param int                  $stackPtr  The position of the current token in
     *                                        the stack passed in $tokens.
     *
     * @return void
     */
    public function process(PHP_CodeSniffer_File $phpcsFile, $stackPtr)
    {
        $interfaces = $this->findImplementedInterfaceNames($phpcsFile, $stackPtr);

        if (is_array($interfaces) === false || $interfaces === array()) {
            return;
        }

        $tokens       = $phpcsFile->getTokens();
        $checkMethods = false;

        if(isset($tokens[$stackPtr]['scope_closer'])) {
            $checkMethods = true;
            $scopeCloser = $tokens[$stackPtr]['scope_closer'];
        }

        foreach ($interfaces as $interface) {
            $lcInterface = strtolower($interface);
            if (isset($this->newInterfaces[$lcInterface]) === true) {
                $this->addError($phpcsFile, $stackPtr, $interface);
            }

            if ($checkMethods === true && isset($this->unsupportedMethods[$lcInterface]) === true) {
                $nextFunc = $stackPtr;
                while (($nextFunc = $phpcsFile->findNext(T_FUNCTION, ($nextFunc + 1), $scopeCloser)) !== false) {
function myFunction($a) {
    switch ($a) {
        case 'foo':
            $x = 1;
            break;

        case 'bar':
            $x = 2;
            break;
    }

    // $x is potentially undefined here.
    echo $x;
}
                    $funcName = strtolower($phpcsFile->getDeclarationName($nextFunc));
                    if (is_string($funcName) === false) {
                        continue;
                    }

                    if (isset($this->unsupportedMethods[$lcInterface][$funcName]) === true) {
                        $error = 'Classes that implement interface %s do not support the method %s(). See %s';
                        $data  = array(
                            $interface,
                            $funcName,
                            $this->unsupportedMethods[$lcInterface][$funcName],
                        );
                        $phpcsFile->addError($error, $nextFunc, 'UnsupportedMethod', $data);
                    }
                }
            }
        }

    }//end process()


    /**
     * Generates the error or warning for this sniff.
     *
     * @param PHP_CodeSniffer_File $phpcsFile The file being scanned.
     * @param int                  $stackPtr  The position of the function
     *                                        in the token array.
     * @param string               $interface The name of the interface.
     *
     * @return void
     */
    protected function addError($phpcsFile, $stackPtr, $interface)

    {
        $interfaceLc = strtolower($interface);
        $error       = '';

        $isError = false;
        foreach ($this->newInterfaces[$interfaceLc] as $version => $present) {
            if ($this->supportsBelow($version)) {
                if ($present === false) {
                    $isError = true;
                    $error .= 'not present in PHP version ' . $version . ' or earlier';
                }
            }
        }

        if (strlen($error) > 0) {
            $error = 'The built-in interface ' . $interface . ' is ' . $error;

            if ($isError === true) {
                $phpcsFile->addError($error, $stackPtr);
            } else {
                $phpcsFile->addWarning($error, $stackPtr);
            }
        }

    }//end addError()

}//end class


1		<?php
2		/**
3		* PHPCompatibility_Sniffs_PHP_NewInterfacesSniff.
4		*
5		* PHP version 5.5
6		*
7		* @category PHP
8		* @package PHPCompatibility
9		* @author Juliette Reinders Folmer <[email protected]>
10		*/
11
12		/**
13		* PHPCompatibility_Sniffs_PHP_NewInterfacesSniff.
14		*
15		* @category PHP
16		* @package PHPCompatibility
17		* @author Juliette Reinders Folmer <[email protected]>
18		*/
19		class PHPCompatibility_Sniffs_PHP_NewInterfacesSniff extends PHPCompatibility_Sniff
		0 ignored issues – show Coding Style Compatibility introduced 2016-08-04 22:56 UTC by Report Bug Copy Issue Report PSR1 recommends that each class must be in a namespace of at least one level to avoid collisions. You can fix this by adding a namespace to your class: namespace YourVendor; class YourClass { } When choosing a vendor namespace, try to pick something that is not too generic to avoid conflicts with other libraries. Loading history...
20		{
21
22		/**
23		* A list of new interfaces, not present in older versions.
24		*
25		* The array lists : version number with false (not present) or true (present).
26		* If's sufficient to list the first version where the interface appears.
27		*
28		* @var array(string => array(string => int\|string\|null))
29		*/
30		protected $newInterfaces = array(
31		'Countable' => array(
32		'5.0' => false,
33		'5.1' => true
34		),
35		'OuterIterator' => array(
36		'5.0' => false,
37		'5.1' => true
38		),
39		'RecursiveIterator' => array(
40		'5.0' => false,
41		'5.1' => true
42		),
43		'SeekableIterator' => array(
44		'5.0' => false,
45		'5.1' => true
46		),
47		'Serializable' => array(
48		'5.0' => false,
49		'5.1' => true,
50		),
51		'SplObserver' => array(
52		'5.0' => false,
53		'5.1' => true
54		),
55		'SplSubject' => array(
56		'5.0' => false,
57		'5.1' => true
58		),
59
60		'JsonSerializable' => array(
61		'5.3' => false,
62		'5.4' => true
63		),
64		'SessionHandlerInterface' => array(
65		'5.3' => false,
66		'5.4' => true
67		),
68
69		);
70
71		/**
72		* A list of methods which cannot be used in combination with particular interfaces.
73		*
74		* @var array(string => array(string => string))
75		*/
76		protected $unsupportedMethods = array(
77		'Serializable' => array(
78		'__sleep' => 'http://php.net/serializable',
79		'__wakeup' => 'http://php.net/serializable',
80		),
81		);
82
83		/**
84		* Returns an array of tokens this test wants to listen for.
85		*
86		* @return array
87		*/
88		public function register()
89		{
90		// Handle case-insensitivity of class names.
91		$keys = array_keys( $this->newInterfaces );
92		$keys = array_map( 'strtolower', $keys );
93		$this->newInterfaces = array_combine( $keys, $this->newInterfaces );
94
95		$keys = array_keys( $this->unsupportedMethods );
96		$keys = array_map( 'strtolower', $keys );
97		$this->unsupportedMethods = array_combine( $keys, $this->unsupportedMethods );
98
99		return array(T_CLASS);
100
101		}//end register()
102
103
104		/**
105		* Processes this test, when one of its tokens is encountered.
106		*
107		* @param PHP_CodeSniffer_File $phpcsFile The file being scanned.
108		* @param int $stackPtr The position of the current token in
109		* the stack passed in $tokens.
110		*
111		* @return void
112		*/
113		public function process(PHP_CodeSniffer_File $phpcsFile, $stackPtr)
114		{
115		$interfaces = $this->findImplementedInterfaceNames($phpcsFile, $stackPtr);
116
117		if (is_array($interfaces) === false \|\| $interfaces === array()) {
118		return;
119		}
120
121		$tokens = $phpcsFile->getTokens();
122		$checkMethods = false;
123
124		if(isset($tokens[$stackPtr]['scope_closer'])) {
125		$checkMethods = true;
126		$scopeCloser = $tokens[$stackPtr]['scope_closer'];
127		}
128
129		foreach ($interfaces as $interface) {
130		$lcInterface = strtolower($interface);
131		if (isset($this->newInterfaces[$lcInterface]) === true) {
132		$this->addError($phpcsFile, $stackPtr, $interface);
133		}
134
135		if ($checkMethods === true && isset($this->unsupportedMethods[$lcInterface]) === true) {
136		$nextFunc = $stackPtr;
137		while (($nextFunc = $phpcsFile->findNext(T_FUNCTION, ($nextFunc + 1), $scopeCloser)) !== false) {
		0 ignored issues – show Bug introduced 2016-08-04 08:07 UTC by Report Bug Copy Issue Report The variable `$scopeCloser` does not seem to be defined for all execution paths leading up to this point. If you define a variable conditionally, it can happen that it is not defined for all execution paths. Let’s take a look at an example: function myFunction($a) { switch ($a) { case 'foo': $x = 1; break; case 'bar': $x = 2; break; } // $x is potentially undefined here. echo $x; } In the above example, the variable `$x` is defined if you pass “foo” or “bar” as argument for `$a`. However, since the `switch` statement has no default case statement, if you pass any other value, the variable `$x` would be undefined. Available Fixes Check for existence of the variable explicitly: function myFunction($a) { switch ($a) { case 'foo': $x = 1; break; case 'bar': $x = 2; break; } if (isset($x)) { // Make sure it's always set. echo $x; } } Define a default value for the variable: function myFunction($a) { $x = ''; // Set a default which gets overridden for certain paths. switch ($a) { case 'foo': $x = 1; break; case 'bar': $x = 2; break; } echo $x; } Add a value for the missing path: function myFunction($a) { switch ($a) { case 'foo': $x = 1; break; case 'bar': $x = 2; break; // We add support for the missing case. default: $x = ''; break; } echo $x; } Loading history...
138		$funcName = strtolower($phpcsFile->getDeclarationName($nextFunc));
139		if (is_string($funcName) === false) {
140		continue;
141		}
142
143		if (isset($this->unsupportedMethods[$lcInterface][$funcName]) === true) {
144		$error = 'Classes that implement interface %s do not support the method %s(). See %s';
145		$data = array(
146		$interface,
147		$funcName,
148		$this->unsupportedMethods[$lcInterface][$funcName],
149		);
150		$phpcsFile->addError($error, $nextFunc, 'UnsupportedMethod', $data);
151		}
152		}
153		}
154		}
155
156		}//end process()
157
158
159		/**
160		* Generates the error or warning for this sniff.
161		*
162		* @param PHP_CodeSniffer_File $phpcsFile The file being scanned.
163		* @param int $stackPtr The position of the function
164		* in the token array.
165		* @param string $interface The name of the interface.
166		*
167		* @return void
168		*/
169	View Code Duplication	protected function addError($phpcsFile, $stackPtr, $interface)
		0 ignored issues – show Duplication introduced 2016-09-15 01:12 UTC by Report Bug Copy Issue Report This method seems to be duplicated in 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...
170		{
171		$interfaceLc = strtolower($interface);
172		$error = '';
173
174		$isError = false;
175		foreach ($this->newInterfaces[$interfaceLc] as $version => $present) {
176		if ($this->supportsBelow($version)) {
177		if ($present === false) {
178		$isError = true;
179		$error .= 'not present in PHP version ' . $version . ' or earlier';
180		}
181		}
182		}
183
184		if (strlen($error) > 0) {
185		$error = 'The built-in interface ' . $interface . ' is ' . $error;
186
187		if ($isError === true) {
188		$phpcsFile->addError($error, $stackPtr);
189		} else {
190		$phpcsFile->addWarning($error, $stackPtr);
191		}
192		}
193
194		}//end addError()
195
196		}//end class
197

wimg / PHPCompatibility

Push — master ( 1947a4...42d661 )

process() C

Complexity

Size

Duplication

Importance

How to fix Complexity

Long Method

Available Fixes

Duplication Side-by-Side

Filter issues like