Creating Menu Builders as Services

This bundle gives you a really convenient way to create menus by following
a convention and - if needed - injecting the entire container.

However, if you want to, you can instead choose to create a service for your
menu builder. The advantage of this method is that you can inject the exact
dependencies that your menu builder needs, instead of injecting the entire
service container. This can lead to code that is more testable and also potentially
more reusable. The disadvantage is that it needs just a little more setup.

Start by creating a builder for your menu. You can stick as many menus into
a builder as you want, so you may only have one (or just a few) of these
builder classes in your application:

Next, register your menu builder as service and register its createMainMenu method as a menu builder:

1
2
3
4
5
6
7
8
9

# app/config/services.ymlservices:app.menu_builder:class:AppBundle\Menu\MenuBuilderarguments:["@knp_menu.factory"]tags:-{ name:knp_menu.menu_builder, method:createMainMenu, alias:main}# The alias is what is used to retrieve the menu# ...

Note

The menu service must be public as it will be retrieved at runtime to keep
it lazy-loaded.

You can now render the menu directly in a template via the name given in the
alias key above:

1

{{knp_menu_render('main')}}

Suppose now we need to create a second menu for the sidebar. The process
is simple! Start by adding a new method to your builder: