docs: add docs

Author: kenjis

user_guide_src/source/changelogs/v4.4.0.rst

@@ -88,7 +88,10 @@ Others
   the ``Content-Disposition: inline`` header to display the file in the browser.
   See :ref:`open-file-in-browser` for details.
 - **View:** Added optional 2nd parameter ``$saveData`` on ``renderSection()`` to prevent from auto cleans the data after displaying. See :ref:`View Layouts <creating-a-layout>` for details.
-- **Auto Routing (Improved)**: Now you can use URI without a method name like
+- **Auto Routing (Improved):** Now you can pass arguments to the the default
+  controller that is omitted in the URI.
+  See :ref:`controller-default-controller-fallback` for details.
+- **Auto Routing (Improved):** Now you can use URI without a method name like
   ``product/15`` where ``15`` is an arbitrary number.
   See :ref:`controller-default-method-fallback` for details.
 - **Filters:** Now you can use Filter Arguments with :ref:`$filters property <filters-filters-filter-arguments>`.

user_guide_src/source/incoming/controllers.rst

@@ -274,6 +274,44 @@ Your method will be passed URI segments 3 and 4 (``'sandals'`` and ``'123'``):
 
 .. literalinclude:: controllers/022.php
 
+.. _controller-default-controller-fallback:
+
+Default Controller Fallback
+===========================
+
+.. versionadded:: 4.4.0
+
+If the controller corresponding to the URI segment of the controller name
+does not exist, and if the default controller (``Home`` by default) exists in
+the directory, the remaining URI segments are passed to the default controller
+for execution.
+
+For example, when you have the following default controller ``Home`` in the
+**app/Controllers/News** directory:
+
+.. literalinclude:: controllers/025.php
+
+Load the following URL::
+
+    example.com/index.php/news/list
+
+The ``News\Home`` controller will be found, and the ``getList()`` method will be
+executed.
+
+.. note:: If there is ``App\Controllers\News`` controller, it takes precedence.
+    The URI segments are searched sequentially and the first controller found
+    is used.
+
+Load the following URL::
+
+    example.com/index.php/news/101
+
+The default ``getIndex()`` method will be passed URI segments 2 (``'101'``):
+
+.. note:: If there are more parameters in the URI than the method parameters,
+    Auto Routing (Improved) does not execute the method, and it results in 404
+    Not Found.
+
 .. _controller-default-method-fallback:
 
 Default Method Fallback
@@ -282,8 +320,8 @@ Default Method Fallback
 .. versionadded:: 4.4.0
 
 If the controller method corresponding to the URI segment of the method name
-does not exist, and if the default method is defined, the URI segments are
-passed to the default method for execution.
+does not exist, and if the default method is defined, the remaining URI segments
+are passed to the default method for execution.
 
 .. literalinclude:: controllers/024.php
 

user_guide_src/source/incoming/controllers/025.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace App\Controllers\News;
+
+use App\Controllers\BaseController;
+
+class Home extends BaseController
+{
+    public function getList()
+    {
+        // ...
+    }
+
+    public function getIndex($id = null)
+    {
+        // ...
+    }
+}