PHPCompatibility_Sniffs_PHP_NewNowdocSniff::register() - 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 14:16 UTC

register() A

↳ Parent: PHPCompatibility_Sniffs_PHP_NewNowdocSniff

Complexity

Conditions	4
Paths	8

Size

Total Lines	18
Code Lines	9

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
dl	0
loc	18
rs	9.2
c	0
b	0
f	0
cc	4
eloc	9
nc	8
nop	0

<?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();

        /*
         * 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]['type'] === 'T_SL') {
            if (isset($tokens[($stackPtr+1)]) === false || $tokens[($stackPtr+1)]['type'] !== 'T_LESS_THAN') {

                return;
            }

            if (isset($tokens[($stackPtr+2)]) === false || $tokens[($stackPtr+2)]['type'] !== '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
66		/*
67		* In PHP 5.2 the T_NOWDOC tokens aren't recognized yet and PHPCS does not
68		* backfill for it, so we have to sniff for a specific combination of tokens.
69		*/
70		if ($tokens[$stackPtr]['type'] === 'T_SL') {
71	View Code Duplication	if (isset($tokens[($stackPtr+1)]) === false \|\| $tokens[($stackPtr+1)]['type'] !== 'T_LESS_THAN') {
		1 ignored issue – show Duplication introduced 2017-01-26 11:06 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...
72		return;
73		}
74
75	View Code Duplication	if (isset($tokens[($stackPtr+2)]) === false \|\| $tokens[($stackPtr+2)]['type'] !== 'T_CONSTANT_ENCAPSED_STRING') {
		1 ignored issue – show Duplication introduced 2017-01-26 11:06 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...
76		return;
77		}
78
79		/*
80		* Heredoc and nowdoc naming rules:
81		* "it must contain only alphanumeric characters and underscores and
82		* must start with a non-digit character or underscore"
83		* @link http://php.net/manual/en/language.types.string.php#language.types.string.syntax.heredoc
84		*/
85		if (preg_match('`^\'([a-z][a-z0-9_]*)\'$`iD', $tokens[($stackPtr+2)]['content'], $matches) < 1) {
86		return;
87		}
88
89		$closer = $phpcsFile->findNext(T_STRING, ($stackPtr + 3), null, false, $matches[1], true);
90		// The closing identifier must begin in the first column of the line.
91		if ($closer === false \|\| $tokens[($closer - 1)]['column'] !== 1) {
92		return;
93		}
94
95		// The closing identifier must be the only content on that line, except for maybe a semi-colon.
96		$next = $phpcsFile->findNext(array(T_WHITESPACE, T_SEMICOLON), ($closer + 1), null, true);
97		if ($tokens[$closer]['line'] === $tokens[$next]['line']) {
98		return;
99		}
100		}
101
102		$phpcsFile->addError('Nowdocs are not present in PHP version 5.2 or earlier.', $stackPtr, 'Found');
103
104		if (isset($closer) !== false) {
105		$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...
106		return ($closer + 1);
107		}
108
109		}//end process()
110
111		}//end class
112

wimg / PHPCompatibility

Pull Request — master (#335)

register() A

Complexity

Size

Duplication

Importance

Available Fixes

Duplication Side-by-Side

Filter issues like