add tokenIsPhpstanComment() function

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.
  *