add tokenIsPhpstanComment() function

Author: jonathan1055

coder_sniffer/Drupal/Sniffs/Commenting/FunctionCommentSniff.php

@@ -97,9 +97,7 @@ public function process(File $phpcsFile, $stackPtr)
 
             // If there is a phpstan-ignore inline comment disregard it and continue searching backwards
             // to find the function comment.
-            if ($tokens[$commentEnd]['code'] === T_COMMENT
-                && preg_match('/\@phpstan-ignore/', $tokens[$commentEnd]['content']) === 1
-            ) {
+            if ($this->tokenIsPhpstanComment($tokens[$commentEnd]) === true) {
                 $functionCodeStart = $commentEnd;
                 continue;
             }
@@ -191,6 +189,20 @@ public function process(File $phpcsFile, $stackPtr)
     }//end process()
 
 
+    /**
+     * Determine if a token is a '@phpstan-' control comment.
+     *
+     * @param array $token The token to be checked.
+     *
+     * @return bool True if the token contains a @phpstan comment.
+     */
+    public static function tokenIsPhpstanComment($token)
+    {
+        return ($token['code'] === T_COMMENT && strpos($token['content'], ' @phpstan-') !== false);
+
+    }//end tokenIsPhpstanComment()
+
+
     /**
      * Process the return comment of this function comment.
      *