Feat: Change phpdoc order so that @throws is after @return

Author: OndraM

ecs.php

@@ -337,8 +337,6 @@
             PhpdocNoEmptyReturnFixer::class,
             // `@package` and `@subpackage` annotations should be omitted from PHPDoc.
             PhpdocNoPackageFixer::class,
-            // Annotations in PHPDoc should be ordered.
-            PhpdocOrderFixer::class,
             // The type of `@return` annotations of methods returning a reference to itself must the configured one.
             PhpdocReturnSelfReferenceFixer::class,
             // Scalar types should always be written in the same form.
@@ -502,6 +500,8 @@
     ])
     // All items of the given PHPDoc tags must be left-aligned.
     ->withConfiguredRule(PhpdocAlignFixer::class, ['align' => 'left'])
+    // Annotations in PHPDoc should be ordered in defined sequence.
+    ->withConfiguredRule(PhpdocOrderFixer::class, ['order' => ['param', 'return', 'throws']])
     // Order phpdoc tags by value.
     ->withConfiguredRule(PhpdocOrderByValueFixer::class, ['annotations' => ['covers', 'group', 'throws']])
     // Calls to `PHPUnit\Framework\TestCase` static methods must all be of the same type (`$this->...`)

tests/Integration/Fixtures/Basic.correct.php.inc

@@ -83,8 +83,8 @@ class Basic
      * It tests PhpdocAlignFixer, NoSuperfluousPhpdocTagsFixer and possibly other Phpdoc rules.
      * @param int|float $second Second parameter does have a comment, unlike the first one.
      * @param string|null $third Third parameter is optional and has a default value.
-     * @throws \Exception
      * @return mixed There is also information about return type.
+     * @throws \Exception
      */
     public function veryWellDocumented(string $first, int|float $second, ?string $third = '3rd'): mixed
     {