docs: make discoverFilters() deprecated

system/Filters/Filters.php

@@ -125,6 +125,8 @@ public function __construct($config, RequestInterface $request, ResponseInterfac
  *
  * Sample :
  * $filters->aliases['custom-auth'] = \Acme\Blob\Filters\BlobAuth::class;
+ *
+ * @deprecated 4.4.2 Use Registrar instead.
  */
  private function discoverFilters(): void
  {

user_guide_src/source/changelogs/v4.4.2.rst

@@ -29,6 +29,10 @@ Changes
 Deprecations
 ************
 
+- **Filters:** The Auto-Discovery for Filters and ``Filters::discoverFilters()``
+ is deprecated. Use :ref:`registrars` instead. See :ref:`modules-filters` for
+ details.
+
 Bugs Fixed
 **********
 

user_guide_src/source/general/modules.rst

@@ -160,9 +160,18 @@ the **Modules** config file, described above.
 When working with modules, it can be a problem if the routes in the application contain wildcards.
 In that case, see :ref:`routing-priority`.
 
+.. _modules-filters:
+
 Filters
 =======
 
+.. deprecated:: 4.4.2
+
+.. note:: This feature is deprecated. Use :ref:`registrars` instead like the
+ following:
+
+ .. literalinclude:: modules/015.php
+
 By default, :doc:`filters <../incoming/filters>` are automatically scanned for within modules.
 It can be turned off in the **Modules** config file, described above.
 

user_guide_src/source/general/modules/015.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace CodeIgniter\Shield\Config;
+
+use CodeIgniter\Shield\Filters\SessionAuth;
+use CodeIgniter\Shield\Filters\TokenAuth;
+
+class Registrar
+{
+ /**
+ * Registers the Shield filters.
+ */
+ public static function Filters(): array
+ {
+ return [
+ 'aliases' => [
+ 'session' => SessionAuth::class,
+ 'tokens' => TokenAuth::class,
+ ],
+ ];
+ }
+}