Add order option to phpdoc_order

[paulbalandan]

Description
In the past, we are stuck with the default ordering of ['param', 'throws', 'return']. Now that the fixer is configurable, this proposes to change the ordering to ['param', 'return', 'throws'].

$ vendor/bin/php-cs-fixer describe phpdoc_order
Description of phpdoc_order rule.
Annotations in PHPDoc should be ordered in defined sequence.

Fixer is configurable using following option:
* order (string[]): sequence in which annotations in PHPDoc should be ordered; defaults to ['param', 'throws', 'return']

Fixing examples:
 * Example #1. Fixing with the default configuration.
   ---------- begin diff ----------
   --- Original
   +++ New
   @@ -1,10 +1,10 @@
    <?php
    /**
     * Hello there!
     *
   - * @throws Exception|RuntimeException foo
     * @custom Test!
   - * @return int  Return the number of changes.
     * @param string $foo
     * @param bool   $bar Bar
   + * @throws Exception|RuntimeException foo
   + * @return int  Return the number of changes.
     */

   ----------- end diff -----------

 * Example #2. Fixing with configuration: ['order' => ['param', 'throws', 'return']].
   ---------- begin diff ----------
   --- Original
   +++ New
   @@ -1,10 +1,10 @@
    <?php
    /**
     * Hello there!
     *
   - * @throws Exception|RuntimeException foo
     * @custom Test!
   - * @return int  Return the number of changes.
     * @param string $foo
     * @param bool   $bar Bar
   + * @throws Exception|RuntimeException foo
   + * @return int  Return the number of changes.
     */

   ----------- end diff -----------

 * Example #3. Fixing with configuration: ['order' => ['param', 'return', 'throws']].
   ---------- begin diff ----------
   --- Original
   +++ New
   @@ -1,10 +1,10 @@
    <?php
    /**
     * Hello there!
     *
   - * @throws Exception|RuntimeException foo
     * @custom Test!
   - * @return int  Return the number of changes.
     * @param string $foo
     * @param bool   $bar Bar
   + * @return int  Return the number of changes.
   + * @throws Exception|RuntimeException foo
     */

   ----------- end diff -----------

 * Example #4. Fixing with configuration: ['order' => ['param', 'custom', 'throws', 'return']].
   ---------- begin diff ----------
   --- Original
   +++ New
   @@ -1,10 +1,10 @@
    <?php
    /**
     * Hello there!
     *
   + * @param string $foo
   + * @param bool   $bar Bar
   + * @custom Test!
     * @throws Exception|RuntimeException foo
   - * @custom Test!
     * @return int  Return the number of changes.
   - * @param string $foo
   - * @param bool   $bar Bar
     */

   ----------- end diff -----------

Checklist:

• Securely signed commits
• Component(s) with PHPDoc blocks, only if necessary or adds value
• Unit testing, with >80% coverage
• User guide updated
• Conforms to style guide

[kenjis]

I like this order.

[MGatner]

YES! Always thought this was the superior ordering 😎