PHPCompatibility_Sniffs_PHP_NewNowdocSniff::process() - Code Metrics - Inspection of "PHP 5.3: Detect NOWDOC syntax" - wimg/PHPCompatibility - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Pull Request — master (#335)

by Juliette

created 2017-01-26 15:16 UTC

process() C

↳ Parent: PHPCompatibility_Sniffs_PHP_NewNowdocSniff

Complexity

Conditions	14
Paths	19

Size

Total Lines	67
Code Lines	30

Duplication

Lines	6
Ratio	8.96 %

Importance

Changes

Metric	Value
dl	6
loc	67
rs	5.8135
c	0
b	0
f	0
cc	14
eloc	30
nc	19
nop	2

How to fix Long Method Complexity

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

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

class YourClass { }
{

    /**
     * Returns an array of tokens this test wants to listen for.
     *
     * @return array
     */
    public function register()
    {
        $targets = array();

        if (PHP_VERSION_ID < 50300) {
            $targets[] = T_SL;
        }

        if (defined('T_START_NOWDOC')) {
            $targets[] = constant('T_START_NOWDOC');
        }
        if (defined('T_END_NOWDOC')) {
            $targets[] = constant('T_END_NOWDOC');
        }

        return $targets;

    }//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 int|void On older PHP versions passes a pointer to the nowdoc closer
     *                  to skip passed anything in between in regards to processing
     *                  the file for this sniff.
     */
    public function process(PHP_CodeSniffer_File $phpcsFile, $stackPtr)
    {
        if ($this->supportsBelow('5.2') === false) {
            return;
        }

        $tokens = $phpcsFile->getTokens();
ini_set( 'xdebug.overload_var_dump', 1 );

static $dumped = false;
if($dumped === false) {
    echo "\n";
    foreach( $tokens as $ptr => $token ) {
        echo $ptr . ' :: L' . $token['line'] . ' :: C' . $token['column'] . ' :: ' . $token['type'] . ' :: (' . strlen($token['content']) . ') :: ' . $token['content'] . "\n";
//        if ( $token['code'] === T_WHILE || $token['code'] === T_DO || $token['code'] === T_FUNCTION ) {

//            var_dump( $token );
//        }
    }
    unset( $ptr, $token );
    $dumped = true;
    var_dump( $tokens[$stackPtr] );

}

        /*
         * In PHP 5.2 the T_NOWDOC tokens aren't recognized yet and PHPCS does not
         * backfill for it, so we have to sniff for a specific combination of tokens.
         */
        if ($tokens[$stackPtr]['code'] === T_SL) {
            if (isset($tokens[($stackPtr+1)]) === false || $tokens[($stackPtr + 1)]['code'] !== T_LESS_THAN) {

                return;
            }

            if (isset($tokens[($stackPtr+2)]) === false || $tokens[($stackPtr + 2)]['code'] !== T_CONSTANT_ENCAPSED_STRING) {

                return;
            }

            /*
             * Heredoc and nowdoc naming rules:
             * "it must contain only alphanumeric characters and underscores and
             *  must start with a non-digit character or underscore"
             * @link http://php.net/manual/en/language.types.string.php#language.types.string.syntax.heredoc
             */
            if (preg_match('`^\'([a-z][a-z0-9_]*)\'$`iD', $tokens[($stackPtr + 2)]['content'], $matches) < 1) {
                return;
            }

            $closer = $phpcsFile->findNext(T_STRING, ($stackPtr + 3), null, false, $matches[1], true);
            // The closing identifier must begin in the first column of the line.
            if ($closer === false || $tokens[($closer - 1)]['column'] !== 1) {
                return;
            }

            // The closing identifier must be the only content on that line, except for maybe a semi-colon.
            $next = $phpcsFile->findNext(array(T_WHITESPACE, T_SEMICOLON), ($closer + 1), null, true);
            if ($tokens[$closer]['line'] === $tokens[$next]['line']) {
                return;
            }
        }

        $phpcsFile->addError('Nowdocs are not present in PHP version 5.2 or earlier.', $stackPtr, 'Found');

        if (isset($closer) !== false) {
            $phpcsFile->addError('Nowdocs are not present in PHP version 5.2 or earlier.', $closer, 'Found');
function myFunction($a) {
    switch ($a) {
        case 'foo':
            $x = 1;
            break;

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

    // $x is potentially undefined here.
    echo $x;
}
            return ($closer + 1);
        }

    }//end process()

}//end class


1		<?php
2		/**
3		* PHPCompatibility_Sniffs_PHP_NewNowdocSniff.
4		*
5		* PHP version 5.3
6		*
7		* @category PHP
8		* @package PHPCompatibility
9		* @author Juliette Reinders Folmer <[email protected]>
10		*/
11
12		/**
13		* PHPCompatibility_Sniffs_PHP_NewNowdocSniff.
14		*
15		* @category PHP
16		* @package PHPCompatibility
17		* @author Juliette Reinders Folmer <[email protected]>
18		*/
19		class PHPCompatibility_Sniffs_PHP_NewNowdocSniff extends PHPCompatibility_Sniff
		0 ignored issues – show Coding Style Compatibility introduced 2017-01-26 11:06 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		* Returns an array of tokens this test wants to listen for.
24		*
25		* @return array
26		*/
27		public function register()
28		{
29		$targets = array();
30
31		if (PHP_VERSION_ID < 50300) {
32		$targets[] = T_SL;
33		}
34
35		if (defined('T_START_NOWDOC')) {
36		$targets[] = constant('T_START_NOWDOC');
37		}
38		if (defined('T_END_NOWDOC')) {
39		$targets[] = constant('T_END_NOWDOC');
40		}
41
42		return $targets;
43
44		}//end register()
45
46
47		/**
48		* Processes this test, when one of its tokens is encountered.
49		*
50		* @param PHP_CodeSniffer_File $phpcsFile The file being scanned.
51		* @param int $stackPtr The position of the current token in
52		* the stack passed in $tokens.
53		*
54		* @return int\|void On older PHP versions passes a pointer to the nowdoc closer
55		* to skip passed anything in between in regards to processing
56		* the file for this sniff.
57		*/
58		public function process(PHP_CodeSniffer_File $phpcsFile, $stackPtr)
59		{
60		if ($this->supportsBelow('5.2') === false) {
61		return;
62		}
63
64		$tokens = $phpcsFile->getTokens();
65		ini_set( 'xdebug.overload_var_dump', 1 );
66
67		static $dumped = false;
68		if($dumped === false) {
69		echo "\n";
70		foreach( $tokens as $ptr => $token ) {
71		echo $ptr . ' :: L' . $token['line'] . ' :: C' . $token['column'] . ' :: ' . $token['type'] . ' :: (' . strlen($token['content']) . ') :: ' . $token['content'] . "\n";
72		// if ( $token['code'] === T_WHILE \|\| $token['code'] === T_DO \|\| $token['code'] === T_FUNCTION ) {
		0 ignored issues – show Unused Code Comprehensibility introduced 2017-01-26 15:24 UTC by Report Bug Copy Issue Report `46%` 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...
73		// var_dump( $token );
74		// }
75		}
76		unset( $ptr, $token );
77		$dumped = true;
78		var_dump( $tokens[$stackPtr] );
		0 ignored issues – show Security Debugging Code introduced 2017-01-26 15:39 UTC by Report Bug Copy Issue Report `var_dump($tokens[$stackPtr]);` looks like debug code. Are you sure you do not want to remove it? This might expose sensitive data. Loading history...
79		}
80
81		/*
82		* In PHP 5.2 the T_NOWDOC tokens aren't recognized yet and PHPCS does not
83		* backfill for it, so we have to sniff for a specific combination of tokens.
84		*/
85		if ($tokens[$stackPtr]['code'] === T_SL) {
86	View Code Duplication	if (isset($tokens[($stackPtr+1)]) === false \|\| $tokens[($stackPtr + 1)]['code'] !== T_LESS_THAN) {
		1 ignored issue – show Duplication introduced 2017-01-26 15:24 UTC by Report Bug Copy Issue Report 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...
87		return;
88		}
89
90	View Code Duplication	if (isset($tokens[($stackPtr+2)]) === false \|\| $tokens[($stackPtr + 2)]['code'] !== T_CONSTANT_ENCAPSED_STRING) {
		1 ignored issue – show Duplication introduced 2017-01-26 15:24 UTC by Report Bug Copy Issue Report 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...
91		return;
92		}
93
94		/*
95		* Heredoc and nowdoc naming rules:
96		* "it must contain only alphanumeric characters and underscores and
97		* must start with a non-digit character or underscore"
98		* @link http://php.net/manual/en/language.types.string.php#language.types.string.syntax.heredoc
99		*/
100		if (preg_match('`^\'([a-z][a-z0-9_]*)\'$`iD', $tokens[($stackPtr + 2)]['content'], $matches) < 1) {
101		return;
102		}
103
104		$closer = $phpcsFile->findNext(T_STRING, ($stackPtr + 3), null, false, $matches[1], true);
105		// The closing identifier must begin in the first column of the line.
106		if ($closer === false \|\| $tokens[($closer - 1)]['column'] !== 1) {
107		return;
108		}
109
110		// The closing identifier must be the only content on that line, except for maybe a semi-colon.
111		$next = $phpcsFile->findNext(array(T_WHITESPACE, T_SEMICOLON), ($closer + 1), null, true);
112		if ($tokens[$closer]['line'] === $tokens[$next]['line']) {
113		return;
114		}
115		}
116
117		$phpcsFile->addError('Nowdocs are not present in PHP version 5.2 or earlier.', $stackPtr, 'Found');
118
119		if (isset($closer) !== false) {
120		$phpcsFile->addError('Nowdocs are not present in PHP version 5.2 or earlier.', $closer, 'Found');
		1 ignored issue – show Bug introduced 2017-01-26 11:06 UTC by Report Bug Copy Issue Report The variable `$closer` 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...
121		return ($closer + 1);
122		}
123
124		}//end process()
125
126		}//end class
127

wimg / PHPCompatibility

Pull Request — master (#335)

process() C

Complexity

Size

Duplication

Importance

How to fix Long Method Complexity

Long Method

Available Fixes

Duplication Side-by-Side

Filter issues like