Fix: Preserve parameter order when inserting missing @param annotations (#44)

When multiple missing parameters need to be inserted before an existing
parameter (or at the end of a docblock), they were being inserted in
reverse order due to how addContentBefore() works - each call inserts
before the same position, resulting in a LIFO order.

The fix reverses the pendingInserts array before iterating, so the
parameters are inserted in the correct signature order.

Example: For a method like:
  function foo(string $a, bool $b, string $c)

This was causing cascading issues with other sniffs like
DocBlockParamAllowDefaultValue and DocBlockParamTypeMismatch,
which would detect type mismatches due to the wrong parameter order.

Author: dereuromark

PhpCollective/Sniffs/Commenting/DocBlockParamSniff.php

@@ -345,7 +345,9 @@ protected function canAddMissingParams(File $phpcsFile, int $docBlockStartIndex,
                             }
                         }
 
-                        foreach ($pendingInserts as $pendingParam) {
+                        // Reverse the array since addContentBefore inserts before the same position
+                        // multiple times, which would reverse the order
+                        foreach (array_reverse($pendingInserts) as $pendingParam) {
                             $paramLine = $indent . '* @param ' . $pendingParam['type'] . ' ' . $pendingParam['variable'] . "\n";
                             $phpcsFile->fixer->addContentBefore($insertBeforeIndex, $paramLine);
                         }
@@ -398,7 +400,9 @@ protected function canAddMissingParams(File $phpcsFile, int $docBlockStartIndex,
                 }
 
                 if ($insertBeforeIndex !== null) {
-                    foreach ($pendingInserts as $pendingParam) {
+                    // Reverse the array since addContentBefore inserts before the same position
+                    // multiple times, which would reverse the order
+                    foreach (array_reverse($pendingInserts) as $pendingParam) {
                         $paramLine = $indent . '* @param ' . $pendingParam['type'] . ' ' . $pendingParam['variable'] . "\n";
                         $phpcsFile->fixer->addContentBefore($insertBeforeIndex, $paramLine);
                     }