PHP 8.2 | Squiz/FileComment: allow for readonly classes

Includes unit test.

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

Author: jrfnl

package.xml

@@ -1719,6 +1719,7 @@ http://pear.php.net/dtd/package-2.0.xsd">
         <file baseinstalldir="PHP/CodeSniffer" name="FileCommentUnitTest.7.inc" role="test" />
         <file baseinstalldir="PHP/CodeSniffer" name="FileCommentUnitTest.8.inc" role="test" />
         <file baseinstalldir="PHP/CodeSniffer" name="FileCommentUnitTest.9.inc" role="test" />
+        <file baseinstalldir="PHP/CodeSniffer" name="FileCommentUnitTest.10.inc" role="test" />
         <file baseinstalldir="PHP/CodeSniffer" name="FileCommentUnitTest.1.js" role="test" />
         <file baseinstalldir="PHP/CodeSniffer" name="FileCommentUnitTest.1.js.fixed" role="test" />
         <file baseinstalldir="PHP/CodeSniffer" name="FileCommentUnitTest.2.js" role="test" />

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

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

src/Standards/Squiz/Tests/Commenting/FileCommentUnitTest.10.inc

@@ -0,0 +1,12 @@
+<?php
+/**
+ * This should not be recognized as a file comment, but as a class comment.
+ *
+ * @package    Package
+ * @subpackage Subpackage
+ * @author     Squiz Pty Ltd <products@squiz.net>
+ * @copyright  2010-2014 Squiz Pty Ltd (ABN 77 084 670 600)
+ */
+
+readonly class Foo {
+}

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

@@ -46,6 +46,7 @@ public function getErrorList($testFile='FileCommentUnitTest.inc')
         case 'FileCommentUnitTest.6.inc':
         case 'FileCommentUnitTest.7.inc':
         case 'FileCommentUnitTest.9.inc':
+        case 'FileCommentUnitTest.10.inc':
             return [1 => 1];
 
         case 'FileCommentUnitTest.5.inc':