PHP 8.4 | Squiz/VariableComment: add support for final properties

If a property uses the `final` modifier keyword, the property docblock (providing there is one) would never be found, leading to false positives.

Fixed now.

Includes tests.

Author: jrfnl

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

@@ -36,6 +36,7 @@ public function processMemberVar(File $phpcsFile, $stackPtr)
             T_VAR                    => T_VAR,
             T_STATIC                 => T_STATIC,
             T_READONLY               => T_READONLY,
+            T_FINAL                  => T_FINAL,
             T_WHITESPACE             => T_WHITESPACE,
             T_STRING                 => T_STRING,
             T_NAME_QUALIFIED         => T_NAME_QUALIFIED,

src/Standards/Squiz/Tests/Commenting/VariableCommentUnitTest.inc

@@ -478,3 +478,10 @@ class DNFTypes
      */
     private (\Iterator&namespace\Countable)|false|null $variableName;
 }
+
+class PHP84FinalProperties {
+    /**
+     * @var integer
+     */
+    final int $hasDocblock;
+}

src/Standards/Squiz/Tests/Commenting/VariableCommentUnitTest.inc.fixed

@@ -478,3 +478,10 @@ class DNFTypes
      */
     private (\Iterator&namespace\Countable)|false|null $variableName;
 }
+
+class PHP84FinalProperties {
+    /**
+     * @var integer
+     */
+    final int $hasDocblock;
+}