PHP 8.2 | Tokenizer/PHP: allow for true in union types

Previously, `false` and `null` were already allowed in union types. As of PHP 8.2, `true` has been added to the supported types in PHP and can also be used in union types.
Also see: https://3v4l.org/ZpfID

This commit adjusts the Tokenizer to correctly retokenize the `T_BITWISE_OR` character to `T_UNION_TYPE` when `true` is included in a union type.

Includes unit tests.

Refs:
* https://wiki.php.net/rfc/true-type

Author: jrfnl

src/Tokenizers/PHP.php

@@ -2767,6 +2767,7 @@ protected function processAdditional()
                     T_PARENT               => T_PARENT,
                     T_STATIC               => T_STATIC,
                     T_FALSE                => T_FALSE,
+                    T_TRUE                 => T_TRUE,
                     T_NULL                 => T_NULL,
                 ];
 

tests/Core/Tokenizer/BitwiseOrTest.inc

@@ -129,6 +129,15 @@ $obj->fn($something | $else);
 /* testTypeUnionNonArrowFunctionDeclaration */
 function &fn(int|false $something) {}
 
+/* testTypeUnionPHP82TrueFirst */
+function trueTypeParam(true|null $param) {}
+
+/* testTypeUnionPHP82TrueMiddle */
+function trueTypeReturn($param): array|true|null {}
+
+/* testTypeUnionPHP82TrueLast */
+$closure = function ($param): array|true {}
+
 /* testLiveCoding */
 // Intentional parse error. This has to be the last test in the file.
 return function( type|

tests/Core/Tokenizer/BitwiseOrTest.php

@@ -130,6 +130,9 @@ public function dataTypeUnion()
             ['/* testTypeUnionArrowParam */'],
             ['/* testTypeUnionArrowReturnType */'],
             ['/* testTypeUnionNonArrowFunctionDeclaration */'],
+            ['/* testTypeUnionPHP82TrueFirst */'],
+            ['/* testTypeUnionPHP82TrueMiddle */'],
+            ['/* testTypeUnionPHP82TrueLast */'],
         ];
 
     }//end dataTypeUnion()