Skip to content

Commit 1dd5bd3

Browse files
committed
docs: replace auto-routing with "Auto Routing (Legacy)"
1 parent debbc5a commit 1dd5bd3

7 files changed

Lines changed: 14 additions & 14 deletions

File tree

user_guide_src/source/cli/cli_controllers.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ works exactly like a normal route definition:
4242
For more information, see the :ref:`Routes <command-line-only-routes>` page.
4343

4444
.. warning:: If you enable :ref:`auto-routing-legacy` and place the command file in **app/Controllers**,
45-
anyone could access the command with the help of auto-routing via HTTP.
45+
anyone could access the command with the help of :ref:`auto-routing-legacy` via HTTP.
4646

4747
Run via CLI
4848
===========

user_guide_src/source/incoming/filters.rst

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -67,11 +67,11 @@ Configuring Filters
6767
Once you've created your filters, you need to configure when they get run. This is done in **app/Config/Filters.php**.
6868
This file contains four properties that allow you to configure exactly when the filters run.
6969

70-
.. Note:: The safest way to apply filters is to :ref:`disable auto-routing <use-defined-routes-only>`, and :ref:`set filters to routes <applying-filters>`.
70+
.. Note:: The safest way to apply filters is to :ref:`disable Auto Routing (Legacy) <use-defined-routes-only>`, and :ref:`set filters to routes <applying-filters>`.
7171

7272
.. Warning:: It is recommended that you should always add ``*`` at the end of a URI in the filter settings.
7373
Because a controller method might be accessible by different URLs than you think.
74-
For example, when auto-routing is enabled, if you have ``Blog::index``,
74+
For example, when :ref:`auto-routing-legacy` is enabled, if you have ``Blog::index``,
7575
it can be accessible with ``blog``, ``blog/index``, and ``blog/index/1``, etc.
7676

7777
$aliases
@@ -127,8 +127,8 @@ specify the method name in lowercase. It's value would be an array of filters to
127127
In addition to the standard HTTP methods, this also supports one special case: 'cli'. The 'cli' method would apply to
128128
all requests that were run from the command line.
129129

130-
.. Warning:: If you use ``$methods`` filters, you should :ref:`disable auto-routing <use-defined-routes-only>`
131-
because auto-routing permits any HTTP method to access a controller.
130+
.. Warning:: If you use ``$methods`` filters, you should :ref:`disable Auto Routing (Legacy) <use-defined-routes-only>`
131+
because :ref:`auto-routing-legacy` permits any HTTP method to access a controller.
132132
Accessing the controller with a method you don't expect could bypass the filter.
133133

134134
$filters

user_guide_src/source/incoming/routing.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -386,8 +386,8 @@ The value for the filter can be a string or an array of strings:
386386
See :doc:`Controller filters <filters>` for more information on setting up filters.
387387

388388
.. Warning:: If you set filters to routes in **app/Config/Routes.php**
389-
(not in **app/Config/Filters.php**), it is recommended to disable auto-routing.
390-
When auto-routing is enabled, it may be possible that a controller can be accessed
389+
(not in **app/Config/Filters.php**), it is recommended to disable Auto Routing (Legacy).
390+
When :ref:`auto-routing-legacy` is enabled, it may be possible that a controller can be accessed
391391
via a different URL than the configured route,
392392
in which case the filter you specified to the route will not be applied.
393393
See :ref:`use-defined-routes-only` to disable auto-routing.

user_guide_src/source/installation/upgrade_415.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -56,8 +56,8 @@ If you want the same behavior as the previous version, set the CSRF filter like
5656

5757
Protecting **GET** method needs only when you use ``form_open()`` auto-generation of CSRF field.
5858

59-
.. Warning:: In general, if you use ``$methods`` filters, you should :ref:`disable auto-routing <use-defined-routes-only>`
60-
because auto-routing permits any HTTP method to access a controller.
59+
.. Warning:: In general, if you use ``$methods`` filters, you should :ref:`disable Auto Routing (Legacy) <use-defined-routes-only>`
60+
because :ref:`auto-routing-legacy` permits any HTTP method to access a controller.
6161
Accessing the controller with a method you don't expect could bypass the filter.
6262

6363
CURLRequest header change

user_guide_src/source/libraries/security.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -147,8 +147,8 @@ It is also possible to enable the CSRF filter only for specific methods:
147147

148148
.. literalinclude:: security/009.php
149149

150-
.. Warning:: If you use ``$methods`` filters, you should :ref:`disable auto-routing <use-defined-routes-only>`
151-
because auto-routing permits any HTTP method to access a controller.
150+
.. Warning:: If you use ``$methods`` filters, you should :ref:`disable Auto Routing (Legacy) <use-defined-routes-only>`
151+
because :ref:`auto-routing-legacy` permits any HTTP method to access a controller.
152152
Accessing the controller with a method you don't expect could bypass the filter.
153153

154154
HTML Forms

user_guide_src/source/libraries/throttler.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -73,8 +73,8 @@ Next, we assign it to all POST requests made on the site:
7373

7474
.. literalinclude:: throttler/004.php
7575

76-
.. Warning:: If you use ``$methods`` filters, you should :ref:`disable auto-routing <use-defined-routes-only>`
77-
because auto-routing permits any HTTP method to access a controller.
76+
.. Warning:: If you use ``$methods`` filters, you should :ref:`disable Auto Routing (Legacy) <use-defined-routes-only>`
77+
because :ref:`auto-routing-legacy` permits any HTTP method to access a controller.
7878
Accessing the controller with a method you don't expect could bypass the filter.
7979

8080
And that's all there is to it. Now all POST requests made on the site will have to be rate limited.

user_guide_src/source/tutorial/create_news_items.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Open the **app/Config/Filters.php** file and update the ``$methods`` property li
2222
It configures the CSRF filter to be enabled for all **POST** requests.
2323
You can read more about the CSRF protection in :doc:`Security </libraries/security>` library.
2424

25-
.. Warning:: In general, if you use ``$methods`` filters, you should :ref:`disable Auto Routing (Legacy) <use-defined-routes-only>`
25+
.. Warning:: In general, if you use ``$methods`` filters, you should :ref:`disable Auto Routing (Legacy) <use-defined-routes-only>`
2626
because :ref:`auto-routing-legacy` permits any HTTP method to access a controller.
2727
Accessing the controller with a method you don't expect could bypass the filter.
2828

0 commit comments

Comments
 (0)