Configuring Application
Overview of configuration options for the Nette Application.
Application
As of nette/application
version 3.2 it is possible to define a pair of error-presenters:
Option silentLinks
determines how Nette behaves in developer mode when link generation fails (for example, because
there is no presenter, etc). The default value false
means that Nette triggers E_USER_WARNING
. Setting
to true
suppresses this error message. In a production environment, E_USER_WARNING
is always invoked. We
can also influence this behavior by setting the presenter variable $invalidLinkMode.
Aliases simplify referencing frequently used presenters.
The mapping defines the rules by which the class name is derived from the presenter name.
Automatic Registration of Presenters
Nette automatically adds presenters as services to the DI container, which significantly speeds up their creation. How Nette finds out presenters can be configured:
The directories listed in scanDirs
do not override the default value %appDir%
, but complement it, so
scanDirs
will contain both paths %appDir%
and %vendorDir%/mymodule
. If we want to overwrite
the default directory, we use exclamation
mark:
Directory scanning can be turned off by setting false. We do not recommend completely suppressing the automatic addition of presenters, otherwise application performance will be reduced.
Latte
This setting globally affects the behavior of Latte in components and presenters.
If you are using Latte version 3, you can add new extension using:
If you are using Latte version 2, you can register new tags either by entering the class name or by referring to the service.
Method install()
is called by default, but this can be changed by specifying the name of another method:
Routing
Basic settings:
Router is usually defined in the RouterFactory
class. Alternatively, routs can also be defined in the configuration using mask: action
pairs, but this method does
not offer such a wide variation in settings:
Constants
Creating PHP constants.
The Foobar
constant will created after startup.
Constants should not serve as globally available variables. To pass values to objects, use dependency injection.
PHP
You can set PHP directives. An overview of all directives can be found at php.net.
DI Services
These services are added to the DI container:
Name | Type | Description |
---|---|---|
application.application |
Nette\Application\Application | full application launcher |
application.linkGenerator |
Nette\Application\LinkGenerator | LinkGenerator |
application.presenterFactory |
Nette\Application\PresenterFactory | presenter factory |
application.### |
Nette\Application\UI\Presenter | individual presenters |
latte.latteFactory |
Nette\Bridges\ApplicationLatte\LatteFactory | factory for Latte\Engine |
latte.templateFactory |
Nette\Application\UI\TemplateFactory | factory for $this->template |