PHP 8.2 | PEAR/FileComment: allow for readonly classes

Includes unit test.

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

Author: jrfnl

package.xml

@@ -1077,6 +1077,7 @@ http://pear.php.net/dtd/package-2.0.xsd">
         <file baseinstalldir="PHP/CodeSniffer" name="FileCommentUnitTest.1.inc" role="test" />
         <file baseinstalldir="PHP/CodeSniffer" name="FileCommentUnitTest.2.inc" role="test" />
         <file baseinstalldir="PHP/CodeSniffer" name="FileCommentUnitTest.3.inc" role="test" />
+        <file baseinstalldir="PHP/CodeSniffer" name="FileCommentUnitTest.4.inc" role="test" />
         <file baseinstalldir="PHP/CodeSniffer" name="FileCommentUnitTest.php" role="test" />
         <file baseinstalldir="PHP/CodeSniffer" name="FunctionCommentUnitTest.inc" role="test" />
         <file baseinstalldir="PHP/CodeSniffer" name="FunctionCommentUnitTest.inc.fixed" role="test" />

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

@@ -170,6 +170,7 @@ public function process(File $phpcsFile, $stackPtr)
             T_FINAL,
             T_STATIC,
             T_ABSTRACT,
+            T_READONLY,
             T_CONST,
             T_PROPERTY,
         ];

src/Standards/PEAR/Tests/Commenting/FileCommentUnitTest.4.inc

@@ -0,0 +1,7 @@
+<?php
+/**
+ * This should not be recognized as a file comment, but as a class comment.
+ */
+
+readonly class Foo {
+}

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

@@ -48,9 +48,8 @@ public function getErrorList($testFile='FileCommentUnitTest.inc')
             ];
 
         case 'FileCommentUnitTest.2.inc':
-            return [1 => 1];
-
         case 'FileCommentUnitTest.3.inc':
+        case 'FileCommentUnitTest.4.inc':
             return [1 => 1];
 
         default: