docs: add docs

Author: kenjis

user_guide_src/source/changelogs/v4.3.0.rst

@@ -208,6 +208,9 @@ Commands
 - Added ``spark filter:check`` command to check the filters for a route. See :ref:`Controller Filters <spark-filter-check>` for the details.
 - Added ``spark make:cell`` command to create a new Cell file and its view. See :ref:`generating-cell-via-command` for the details.
 - Now ``spark routes`` command shows route names. See :ref:`URI Routing <routing-spark-routes>`.
+- Now ``spark routes`` command can sort the output by Handler.
+  See :ref:`routing-spark-routes-sort-by-handler`.
+
 - Help information for a spark command can now be accessed using the ``--help`` option (e.g. ``php spark serve --help``)
 - Added methods ``CLI::promptByMultipleKeys()`` to support multiple value in input, unlike ``promptByKey()``. See :ref:`prompt-by-multiple-keys` for details.
 - HTTP/3 is now considered a valid protocol.

user_guide_src/source/incoming/routing.rst

@@ -804,6 +804,9 @@ Since v4.3.0, the *Name* column shows the route name. ``»`` indicates the name
 
 .. important:: The system is not perfect. If you use Custom Placeholders, *Filters* might not be correct. If you want to check filters for a route, you can use :ref:`spark filter:check <spark-filter-check>` command.
 
+Auto Routing (Improved)
+-----------------------
+
 When you use Auto Routing (Improved), the output is like the following:
 
 .. code-block:: none
@@ -818,6 +821,9 @@ The *Method* will be like ``GET(auto)``.
 
 ``/..`` in the *Route* column indicates one segment. ``[/..]`` indicates it is optional.
 
+Auto Routing (Legacy)
+---------------------
+
 When you use Auto Routing (Legacy), the output is like the following:
 
 .. code-block:: none
@@ -833,3 +839,14 @@ The *Method* will be ``auto``.
 ``[/...]`` in the *Route* column indicates any number of segments.
 
 .. note:: When auto-routing is enabled, if you have the route ``home``, it can be also accessd by ``Home``, or maybe by ``hOme``, ``hoMe``, ``HOME``, etc. But the command shows only ``home``.
+
+.. _routing-spark-routes-sort-by-handler:
+
+Sort by Handler
+---------------
+
+.. versionadded:: 4.3.0
+
+You can sort the routes by *Handler*::
+
+    > php spark routes -h