Squiz/DocCommentAlignment: add support for final classes and final properties

If a class or property used the `final` keyword, the docblock would not be recognized as one which needed examining.

Fixed now.

Includes tests.

Author: jrfnl

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

@@ -72,6 +72,7 @@ public function process(File $phpcsFile, $stackPtr)
             T_PROTECTED => true,
             T_STATIC    => true,
             T_ABSTRACT  => true,
+            T_FINAL     => true,
             T_PROPERTY  => true,
             T_OBJECT    => true,
             T_PROTOTYPE => true,

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

@@ -101,3 +101,16 @@ enum Suits: string
  * Example with no errors.
  **************************************************************************/
 function example() {}
+
+/**
+  *  Some info about the class here.
+    */
+final class FinalClassWithFinalProp
+{
+    /**
+   *Some info about the property here.
+    *
+     *  @var int
+      */
+    final $property = 10;
+}

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

@@ -101,3 +101,16 @@ enum Suits: string
  * Example with no errors.
  **************************************************************************/
 function example() {}
+
+/**
+ *  Some info about the class here.
+ */
+final class FinalClassWithFinalProp
+{
+    /**
+     * Some info about the property here.
+     *
+     * @var int
+     */
+    final $property = 10;
+}

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

@@ -56,6 +56,13 @@ public function getErrorList($testFile='')
             $errors[91] = 1;
             $errors[95] = 1;
             $errors[96] = 1;
+
+            $errors[106] = 1;
+            $errors[107] = 1;
+            $errors[111] = 2;
+            $errors[112] = 1;
+            $errors[113] = 1;
+            $errors[114] = 1;
         }
 
         return $errors;