Tokenizer::createTokenMap(): stabilize code for parenthesis owners

_I didn't dare to make this change while JS/CSS were still supported, but this should be a safe change now._

For all PHP parenthesis owners, the open parenthesis MUST be the next non-empty token.
There is only one exception to this rule and that is the `T_FUNCTION` keyword where a `T_STRING` function name and potentially a `&` for return by reference are also allowed between.

If the parenthesis owner is not the next valid token, the token should not be marked as a parenthesis owner, not get the other parenthesis keys.

Now, while for valid code the above should always be true. For invalid code and a few edge cases, such as anonymous classes without parentheses, it is currently possible for the tokenizer to walk too far and identify a completely unrelated arbitrary open parenthesis as the parenthesis belonging to a parenthesis owner.

The change in this commit should prevent that.

Author: jrfnl

src/Tokenizers/Tokenizer.php

@@ -628,35 +628,43 @@ private function createTokenMap()
         $curlyOpeners    = [];
         $this->numTokens = count($this->tokens);
 
-        $openers   = [];
-        $openOwner = null;
+        $openers = [];
 
         for ($i = 0; $i < $this->numTokens; $i++) {
             /*
                 Parenthesis mapping.
             */
 
             if (isset(Tokens::$parenthesisOpeners[$this->tokens[$i]['code']]) === true) {
-                $this->tokens[$i]['parenthesis_opener'] = null;
-                $this->tokens[$i]['parenthesis_closer'] = null;
-                $this->tokens[$i]['parenthesis_owner']  = $i;
-                $openOwner = $i;
+                // Find the next non-empty token.
+                $find = Tokens::$emptyTokens;
+                if ($this->tokens[$i]['code'] === T_FUNCTION) {
+                    $find[T_STRING]      = T_STRING;
+                    $find[T_BITWISE_AND] = T_BITWISE_AND;
+                }
 
-                if (PHP_CODESNIFFER_VERBOSITY > 1) {
-                    StatusWriter::write("=> Found parenthesis owner at $i", (count($openers) + 1));
+                for ($j = ($i + 1); isset($this->tokens[$j], $find[$this->tokens[$j]['code']]) === true; $j++);
+                if ($j < $this->numTokens && $this->tokens[$j]['code'] === T_OPEN_PARENTHESIS) {
+                    $openers[] = $j;
+                    $this->tokens[$i]['parenthesis_opener'] = $j;
+                    $this->tokens[$i]['parenthesis_closer'] = null;
+                    $this->tokens[$i]['parenthesis_owner']  = $i;
+
+                    $this->tokens[$j]['parenthesis_opener'] = $j;
+                    $this->tokens[$j]['parenthesis_owner']  = $i;
+
+                    if (PHP_CODESNIFFER_VERBOSITY > 1) {
+                        StatusWriter::write("=> Found parenthesis owner at $i", (count($openers) + 1));
+                        StatusWriter::write("=> Found parenthesis opener at $j for $i", count($openers));
+                    }
+
+                    $i = $j;
                 }
             } else if ($this->tokens[$i]['code'] === T_OPEN_PARENTHESIS) {
                 $openers[] = $i;
                 $this->tokens[$i]['parenthesis_opener'] = $i;
-                if ($openOwner !== null) {
-                    if (PHP_CODESNIFFER_VERBOSITY > 1) {
-                        StatusWriter::write("=> Found parenthesis opener at $i for $openOwner", count($openers));
-                    }
 
-                    $this->tokens[$openOwner]['parenthesis_opener'] = $i;
-                    $this->tokens[$i]['parenthesis_owner']          = $openOwner;
-                    $openOwner = null;
-                } else if (PHP_CODESNIFFER_VERBOSITY > 1) {
+                if (PHP_CODESNIFFER_VERBOSITY > 1) {
                     StatusWriter::write("=> Found unowned parenthesis opener at $i", count($openers));
                 }
             } else if ($this->tokens[$i]['code'] === T_CLOSE_PARENTHESIS) {