PHP 8.2 | PEAR/ClassComment: allow for readonly classes

Includes improving the accuracy of the tokens to skip over.

Includes unit test.

Ref:
* https://wiki.php.net/rfc/readonly_classes

Author: jrfnl

src/Standards/PEAR/Sniffs/Commenting/ClassCommentSniff.php

@@ -10,7 +10,6 @@
 namespace PHP_CodeSniffer\Standards\PEAR\Sniffs\Commenting;
 
 use PHP_CodeSniffer\Files\File;
-use PHP_CodeSniffer\Util\Tokens;
 
 class ClassCommentSniff extends FileCommentSniff
 {
@@ -48,8 +47,12 @@ public function process(File $phpcsFile, $stackPtr)
         $type      = strtolower($tokens[$stackPtr]['content']);
         $errorData = [$type];
 
-        $find = Tokens::$methodPrefixes;
-        $find[T_WHITESPACE] = T_WHITESPACE;
+        $find = [
+            T_ABSTRACT   => T_ABSTRACT,
+            T_FINAL      => T_FINAL,
+            T_READONLY   => T_READONLY,
+            T_WHITESPACE => T_WHITESPACE,
+        ];
 
         for ($commentEnd = ($stackPtr - 1); $commentEnd >= 0; $commentEnd--) {
             if (isset($find[$tokens[$commentEnd]['code']]) === true) {

src/Standards/PEAR/Tests/Commenting/ClassCommentUnitTest.inc

@@ -143,3 +143,21 @@ enum Empty_Enum_Doc
 class TodoController extends AbstractController implements MustBeLoggedInInterface
 {
 }
+
+/**
+ * Docblock
+ *
+ * @category  PHP
+ * @package   PHP_CodeSniffer
+ * @author    Greg Sherwood <gsherwood@squiz.net>
+ * @license   https://github.com/squizlabs/PHP_CodeSniffer/blob/master/licence.txt BSD Licence
+ * @link      http://pear.php.net/package/PHP_CodeSniffer
+ */
+abstract readonly class AbstractReadonlyWithDocblock {}
+
+/*
+ * Docblock
+ */
+readonly class ReadonlyWrongStyle {}
+
+readonly final class ReadonlyFinalWithoutDocblock {}

src/Standards/PEAR/Tests/Commenting/ClassCommentUnitTest.php

@@ -45,6 +45,8 @@ public function getErrorList()
             106 => 5,
             116 => 5,
             126 => 5,
+            161 => 1,
+            163 => 1,
         ];
 
     }//end getErrorList()