Squiz/BlockComment: update for properties with asymmetric visibility

Prevent false positives for the "block comments must start with ..." error.

Includes tests.

Author: jrfnl

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

@@ -66,7 +66,7 @@ public function process(File $phpcsFile, $stackPtr)
             return;
         }
 
-        // If this is a function/class/interface doc block comment, skip it.
+        // If this is a function/class/interface/enum/property/const doc block comment, skip it.
         // We are only interested in inline doc block comments.
         if ($tokens[$stackPtr]['code'] === T_DOC_COMMENT_OPEN_TAG) {
             $nextToken = $stackPtr;
@@ -80,16 +80,14 @@ public function process(File $phpcsFile, $stackPtr)
                 break;
             } while (true);
 
-            $ignore = [
+            $ignore  = Tokens::$scopeModifiers;
+            $ignore += [
                 T_CLASS     => true,
                 T_INTERFACE => true,
                 T_TRAIT     => true,
                 T_ENUM      => true,
                 T_FUNCTION  => true,
-                T_PUBLIC    => true,
-                T_PRIVATE   => true,
                 T_FINAL     => true,
-                T_PROTECTED => true,
                 T_STATIC    => true,
                 T_ABSTRACT  => true,
                 T_CONST     => true,

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

@@ -314,3 +314,20 @@ class FinalProperties {
      */
     final int $prop = 1;
 }
+
+class AsymVisibility {
+    /**
+     * Comment should be ignored.
+     */
+    public(set) int $prop = 1;
+
+    /**
+     * Comment should be ignored.
+     */
+    protected(set) int $prop = 1;
+
+    /**
+     * Comment should be ignored.
+     */
+    private(set) int $prop = 1;
+}

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

@@ -316,3 +316,20 @@ class FinalProperties {
      */
     final int $prop = 1;
 }
+
+class AsymVisibility {
+    /**
+     * Comment should be ignored.
+     */
+    public(set) int $prop = 1;
+
+    /**
+     * Comment should be ignored.
+     */
+    protected(set) int $prop = 1;
+
+    /**
+     * Comment should be ignored.
+     */
+    private(set) int $prop = 1;
+}