feat: Add statement_indentation config not_for_comments

doc/rules/whitespace/statement_indentation.rst

@@ -7,6 +7,15 @@ Each statement must be indented.
 Configuration
 -------------
 
+``not_for_comments``
+~~~~~~~~~~~~~~~~~~~~
+
+Leave commented lines alone.
+
+Allowed types: ``bool``
+
+Default value: ``false``
+
 ``stick_comment_to_next_continuous_control_statement``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -85,6 +94,25 @@ With configuration: ``['stick_comment_to_next_continuous_control_statement' => t
    +    // this is treated as comment of `elseif(3)` block, as it is a comment in the final block
     }
 
+Example #4
+~~~~~~~~~~
+
+With configuration: ``['not_for_comments' => true]``.
+
+.. code-block:: diff
+
+   --- Original
+   +++ New
+    <?php
+    if ($foo) {
+    // Comment stays where it is
+   -echo "foo"; // Code is indented
+   +    echo "foo"; // Code is indented
+            // Comment stays where it is
+    } else {
+        $aaa = 1;
+    }
+
 Rule sets
 ---------
 

src/Fixer/Whitespace/StatementIndentationFixer.php

@@ -89,6 +89,18 @@
 ',
                     ['stick_comment_to_next_continuous_control_statement' => true]
                 ),
+                new CodeSample(
+                    '<?php
+if ($foo) {
+// Comment stays where it is
+echo "foo"; // Code is indented
+        // Comment stays where it is
+} else {
+    $aaa = 1;
+}
+',
+                    ['not_for_comments' => true]
+                ),
             ]
         );
     }
@@ -116,6 +128,10 @@
                 ->setAllowedTypes(['bool'])
                 ->setDefault(false)
                 ->getOption(),
+            (new FixerOptionBuilder('not_for_comments', 'Leave commented lines alone.'))
+                ->setAllowedTypes(['bool'])
+                ->setDefault(false)
+                ->getOption(),
         ]);
     }
 
@@ -437,6 +453,13 @@
                             }
                         }
 
+                        if (true === $this->configuration['not_for_comments']) {
+                            $lineIsCommented = $tokens[$firstNonWhitespaceTokenIndex]->isGivenKind([T_COMMENT]);
+                            if ($lineIsCommented) {
+                                continue;
+                            }
+                        }
+
                         $endIndex = $scopes[$currentScope]['end_index'];
 
                         if (!$scopes[$currentScope]['end_index_inclusive']) {