bypassed keywords are configurable

Author: dg

readme.md

@@ -40,6 +40,12 @@ preferably right after `vendor/autoload.php` is loaded.
 
 Note that final internal PHP classes like `Closure` cannot be mocked.
 
+The removal of `readonly` keywords can be disabled using the parameter:
+
+```php
+DG\BypassFinals::enable(bypassReadOnly: false);
+```
+
 You can choose to only bypass keywords in specific files or directories:
 
 ```php

src/BypassFinals.php

@@ -28,16 +28,17 @@ class BypassFinals
 	private static $cacheDir;
 
 	/** @var array */
-	private static $tokens = [
-		T_FINAL => 'final',
-	];
+	private static $tokens = [];
 
 
-	public static function enable(): void
+	public static function enable(bool $bypassReadOnly = true, bool $bypassFinal = true): void
 	{
-		if (PHP_VERSION_ID >= 80100) {
+		if ($bypassReadOnly && PHP_VERSION_ID >= 80100) {
 			self::$tokens[T_READONLY] = 'readonly';
 		}
+		if ($bypassFinal) {
+			self::$tokens[T_FINAL] = 'final';
+		}
 
 		$wrapper = stream_get_meta_data(fopen(__FILE__, 'r'))['wrapper_data'] ?? null;
 		if ($wrapper instanceof self) {

tests/BypassFinals/BypassFinals.no-readonly.phpt

@@ -0,0 +1,21 @@
+<?php
+
+/** @phpVersion 8.2 */
+
+declare(strict_types=1);
+
+use Tester\Assert;
+
+require __DIR__ . '/../../vendor/autoload.php';
+
+Tester\Environment::setup();
+
+
+DG\BypassFinals::enable(bypassReadOnly: false);
+
+require __DIR__ . '/fixtures/final.readonly.class.php';
+
+$rc = new ReflectionClass('FinalReadonlyClass');
+Assert::true($rc->isReadOnly());
+Assert::false($rc->isFinal());
+Assert::true($rc->getProperty('foo')->isReadOnly());

tests/BypassFinals/BypassFinals.readonly+final.phpt

@@ -19,5 +19,6 @@ $rc = new ReflectionClass('FinalReadonlyClass');
 Assert::false($rc->isReadOnly());
 Assert::false($rc->isFinal());
 Assert::false($rc->getMethod('finalMethod')->isFinal());
+Assert::false($rc->getProperty('foo')->isReadOnly());
 Assert::same(123, FinalReadonlyClass::FINAL);
 Assert::same(456, (new FinalReadonlyClass)->final());

tests/BypassFinals/fixtures/final.readonly.class.php

@@ -4,6 +4,7 @@
 final readonly class FinalReadonlyClass
 {
 	const FINAL = 123;
+	public readonly int $foo;
 
 	final function finalMethod()
 	{