@@ -30,28 +30,17 @@ Creating Routes as Attributes
3030PHP attributes allow you to define routes next to the code of the
3131:doc: `controllers </controller >` associated to those routes.
3232
33- You need to add a bit of configuration to your project before using them. If your
33+ You don't need to add any configuration to your project before using them. If your
3434project uses :ref: `Symfony Flex <symfony-flex >`, this file is already created for you.
35- Otherwise, create the following file manually:
3635
3736.. code-block :: yaml
3837
39- # config/routes/attributes .yaml
38+ # config/routes.yaml
4039 controllers :
41- resource :
42- path : ../../src/Controller/
43- namespace : App\Controller
44- type : attribute
40+ resource : routing.controllers
4541
46- kernel :
47- resource : App\Kernel
48- type : attribute
49-
50- This configuration tells Symfony to look for routes defined as attributes on
51- classes declared in the ``App\Controller `` namespace and stored in the
52- ``src/Controller/ `` directory which follows the PSR-4 standard. The kernel can
53- act as a controller too, which is especially useful for small applications that
54- use Symfony as a microframework.
42+ This configuration tells Symfony to enables auto-registration of ``#[Route] `` attribute of controllers,
43+ independently of where they are located in the app.
5544
5645Suppose you want to define a route for the ``/blog `` URL in your application. To
5746do so, create a :doc: `controller class </controller >` like the following:
@@ -89,7 +78,10 @@ the ``list()`` method of the ``BlogController`` class.
8978.. warning ::
9079
9180 If you define multiple PHP classes in the same file, Symfony only loads the
92- routes of the first class, ignoring all the other routes.
81+ routes of the first class, ignoring all the other routes.The route attribute
82+ is always wins over route with yaml, xml or PHP file and Symfony will always
83+ load the route attribute.
84+
9385
9486The route name (``blog_list ``) is not important for now, but it will be
9587essential later when :ref: `generating URLs <routing-generating-urls >`. You only
0 commit comments