Allow using enums as a token type

[greg0ire]

Enums allow to avoid having to come up with values to assign for each name (unless you use a backed enum), and will provide more type safety.

There is a small performance impact:

PHPBench (1.2.7) running benchmarks... #standwithukraine
with configuration file: /home/greg/dev/doctrine-lexer/phpbench.json
with PHP version 8.1.12, xdebug ❌, opcache ❌
comparing [actual vs. original]

\Doctrine\Lexer\Benchmark\LexerBench

    benchLexer..............................I0 - [Mo10.680μs vs. Mo10.611μs] +0.65% (±0.00%)

Subjects: 1, Assertions: 0, Failures: 0, Errors: 0
+------------+------------+-----+--------+-----+---------------+-----------------+--------------+
| benchmark  | subject    | set | revs   | its | mem_peak      | mode            | rstdev       |
+------------+------------+-----+--------+-----+---------------+-----------------+--------------+
| LexerBench | benchLexer |     | 100000 | 1   | 1.723mb 0.00% | 10.680μs +0.65% | ±0.00% 0.00% |
+------------+------------+-----+--------+-----+---------------+-----------------+--------------+

[derrabus]

Suggested change

	if ($token instanceof UnitEnum) {
	$className = get_class($token);
	} else {
	$className = static::class;
	}
	if ($token instanceof UnitEnum) {
	return $token::class . '::' . $token->name;
	}
	$className = static::class;

[greg0ire]

Dynamic class names are not allowed in compile-time ::class fetch

This is about return $token::class . '::' . $token->name;, I will revert to using get_class.

[greg0ire]

Pausing this as I discovered a BC-break that affects ORM and possibly more… I think I have to make the switch from array to Token opt-in somehow.