docs: add user guide

Author: kenjis

user_guide_src/source/changelogs/v4.6.0.rst

@@ -43,6 +43,13 @@ The following breaking changes have been made accordingly:
 - ``TestException`` now extends ``CodeIgniter\Exceptions\LogicException``
   instead of ``CodeIgniter\Exceptions\CriticalError``.
 
+Filters Changes
+---------------
+
+The ``Filters`` class has been changed to allow multiple runs of the same filter
+with different arguments in before or after. See
+:ref:`Upgrading Guide <upgrade-460-filters-changes>` for details.
+
 .. _v460-interface-changes:
 
 Interface Changes
@@ -106,6 +113,9 @@ The following new Exception interfaces have been added:
 Commands
 ========
 
+- The ``spark routes`` and ``spark filter:check`` commands now display filter
+  arguments.
+
 Testing
 =======
 
@@ -138,6 +148,9 @@ Helpers and Functions
 Others
 ======
 
+- **Filters:** Now you can execute a filter more than once with the different
+  arguments in before or after.
+
 ***************
 Message Changes
 ***************
@@ -176,6 +189,11 @@ The following changes have been made accordingly:
 Deprecations
 ************
 
+- **Filters:**
+    - The properties ``$arguments`` and ``$argumentsClass`` of ``Filters`` have
+      been deprecated. No longer used.
+    - The ``Filters::getArguments()`` method has been deprecated. No longer used.
+
 **********
 Bugs Fixed
 **********

user_guide_src/source/incoming/filters.rst

@@ -226,6 +226,9 @@ will be passed in ``$arguments`` to the ``group`` filter's ``before()`` methods.
 When the URI matches ``admin/users/*'``, the array ``['users.manage']``
 will be passed in ``$arguments`` to the ``permission`` filter's ``before()`` methods.
 
+.. note:: Prior to v4.6.0, the same filter cannot be run multiple times with
+    different arguments.
+
 .. _filter-execution-order:
 
 Filter Execution Order

user_guide_src/source/incoming/routing.rst

@@ -589,7 +589,8 @@ The ``filter`` option passed to the outer ``group()`` are merged with the inner
 The above code runs ``myfilter1:config`` for the route ``admin``, and ``myfilter1:config``
 and ``myfilter2:region`` for the route ``admin/users/list``.
 
-.. note:: The same filter cannot be run multiple times with different arguments.
+.. note:: Prior to v4.6.0, the same filter cannot be run multiple times with
+    different arguments.
 
 Any other overlapping options passed to the inner ``group()`` will overwrite their values.
 

user_guide_src/source/installation/upgrade_460.rst

@@ -54,6 +54,24 @@ See :ref:`ChangeLog <v460-removed-deprecated-items>` for details.
 Breaking Enhancements
 *********************
 
+.. _upgrade-460-filters-changes:
+
+Filters Changes
+===============
+
+The ``Filters`` class has been changed to allow multiple runs of the same filter
+with different arguments in before or after.
+
+If you are extending ``Filters``, you will need to modify it to conform to the
+following changes:
+
+- The structure of the array properties ``$filters`` and ``$filtersClasses`` have
+  been changed.
+- The properties ``$arguments`` and ``$argumentsClass`` are no longer used.
+- ``Filters`` has been changed so that the same filter class is not instantiated
+  multiple times. If a filter class is used both before and after, the same instance
+  is used.
+
 *************
 Project Files
 *************