Konfigurace aplikací
********************
.[perex]
Přehled konfiguračních voleb pro Nette Aplikace.
Application
===========
```neon
application:
# zobrazit "Nette Application" panel v Tracy BlueScreen?
debugger: ... # (bool) výchozí je true
# bude se při chybě volat error-presenter?
catchExceptions: ... # (bool) výchozí je true v produkčním režimu
# název error-presenteru
errorPresenter: Error # (string) výchozí je 'Nette:Error'
# definuje pravidla pro překlad názvu presenteru na třídu
mapping: ...
# chybné odkazy negenerují varování?
# má efekt pouze ve vývojářském režimu
silentLinks: ... # (bool) výchozí je false
```
Protože ve vývojovém režimu se error-presentery standardně nevolají a chybu zobrazí až Tracy, změnou hodnoty `catchExceptions` na `true` můžeme při vývoji ověřit jejich správnou funkčnost.
Volba `silentLinks` určuje, jak se Nette zachová ve vývojářském režimu, když selže generování odkazu (třeba proto, že neexistuje presenter, atd). Výchozí hodnota `false` znamená, že Nette vyhodí `E_USER_WARNING` chybu. Nastavením na `true` dojde k potlačení této chybové hlášky. V produkčním prostředí se `E_USER_WARNING` vyvolá vždy. Toto chování můžeme také ovlivnit nastavením proměnné presenteru [$invalidLinkMode|creating-links#neplatne-odkazy].
[Mapování definuje pravidla |directory-structure#mapování presenterů], podle kterých se z názvu presenteru odvodí název třídy.
Automatická registrace presenterů
---------------------------------
Nette automaticky přidává presentery jako služby do DI kontejneru, což zásadně zrychlí jejich vytváření. Jak Nette presentery dohledává lze konfigurovat:
```neon
application:
# hledat presentery v Composer class map?
scanComposer: ... # (bool) výchozí je true
# jaký řetězec musí obsahovat název třídy a souboru?
scanFilter: ... # (string) výchozí je 'Presenter'
# ve kterých adresářích hledat presentery?
scanDirs: # (string[]|false) výchozí je '%appDir%'
- %vendorDir%/mymodule
```
Adresáře uvedené v `scanDirs` nepřepisují výchozí hodnotu `%appDir%`, ale doplňují ji, `scanDirs` tedy bude obsahovat obě cesty `%appDir%` a `%vendorDir%/mymodule`. Pokud bychom chtěli výchozí adresář vynechat, použijeme [vykřičník |dependency-injection:configuration#Slučování], který hodnotu přepíše:
```neon
application:
scanDirs!:
- %vendorDir%/mymodule
```
Skenování adresářů lze vypnout uvedením hodnoty false. Nedoporučujeme úplně potlačit automatické přidávání presenterů, protože jinak dojde ke snížení výkonu aplikace.
Šablony Latte
=============
Tímto nastavením lze globálně ovlivnit chování Latte v komponentách a presenterech.
```neon
latte:
# přepne Latte do XHTML režimu
xhtml: ... # (bool) výchozí je false
# třída objektu $this->template
templateClass: App\MyTemplateClass # výchozí je Nette\Bridges\ApplicationLatte\Template
```
Dále lze registrovat nové tagy (makra) a to buď uvedením jména třídy, nebo referencí na službu. Jako výchozí je zavolána metoda `install()`, ale to lze změnit tím, že uvedeme jméno jiné metody:
```neon
latte:
# registrace uživatelských Latte značek
macros:
- App\MyLatteMacros::register # statická metoda, classname nebo callable
- @App\MyLatteMacrosFactory # služba s metodou install()
- @App\MyLatteMacrosFactory::register # služba s metodou register()
services:
- App\MyLatteMacrosFactory
```
Routování
=========
Základní nastavení:
```neon
routing:
# zobrazit routovací panel v Tracy Bar?
debugger: ... # (bool) výchozí je true
# serializuje router do DI kontejneru
cache: ... # (bool) výchozí je false
```
Routování obvykle definujeme ve třídě [RouterFactory |routing#Kolekce rout]. Alternativně lze routy definovat také v konfiguraci pomocí dvojic `maska: akce`, ale tento způsob nenabízí tak širokou variabilitu v nastavení:
```neon
routing:
routes:
'detail/<id>': Admin:Home:default
'<presenter>/<action>': Front:Home:default
```
Konstanty
=========
Vytváření PHP konstant.
```neon
constants:
FOOBAR: 'baz'
```
Po nastartování aplikace bude vytvořena konstanta `FOOBAR`.
.[note]
Konstanty by neměly sloužit jako jakési globálně dostupné proměnné. Pro předávání hodnot do objektů využijte [dependency injection |dependency-injection:passing-dependencies].
PHP
===
Nastavení direktiv PHP. Přehled všech direktiv naleznete na [php.net |https://www.php.net/manual/en/ini.list.php].
```neon
php:
date.timezone: Europe/Prague
```
{{maintitle: Konfigurace Nette Application: volby v NEON}}
{{description: Konfigurace Nette Application v NEON: error presenter, mapování a automatická registrace presenterů, šablony Latte, routování, konstanty a nastavení PHP.}}
Konfigurace aplikací
Přehled konfiguračních voleb pro Nette Aplikace.
Application
application:
# zobrazit "Nette Application" panel v Tracy BlueScreen?
debugger: ... # (bool) výchozí je true
# bude se při chybě volat error-presenter?
catchExceptions: ... # (bool) výchozí je true v produkčním režimu
# název error-presenteru
errorPresenter: Error # (string) výchozí je 'Nette:Error'
# definuje pravidla pro překlad názvu presenteru na třídu
mapping: ...
# chybné odkazy negenerují varování?
# má efekt pouze ve vývojářském režimu
silentLinks: ... # (bool) výchozí je false
Protože ve vývojovém režimu se error-presentery standardně nevolají a chybu zobrazí až Tracy, změnou hodnoty
catchExceptions na true můžeme při vývoji ověřit jejich správnou funkčnost.
Volba silentLinks určuje, jak se Nette zachová ve vývojářském režimu, když selže generování odkazu
(třeba proto, že neexistuje presenter, atd). Výchozí hodnota false znamená, že Nette vyhodí
E_USER_WARNING chybu. Nastavením na true dojde k potlačení této chybové hlášky. V produkčním
prostředí se E_USER_WARNING vyvolá vždy. Toto chování můžeme také ovlivnit nastavením proměnné presenteru
$invalidLinkMode.
Mapování definuje
pravidla, podle kterých se z názvu presenteru odvodí název třídy.
Automatická registrace presenterů
Nette automaticky přidává presentery jako služby do DI kontejneru, což zásadně zrychlí jejich vytváření. Jak Nette
presentery dohledává lze konfigurovat:
application:
# hledat presentery v Composer class map?
scanComposer: ... # (bool) výchozí je true
# jaký řetězec musí obsahovat název třídy a souboru?
scanFilter: ... # (string) výchozí je 'Presenter'
# ve kterých adresářích hledat presentery?
scanDirs: # (string[]|false) výchozí je '%appDir%'
- %vendorDir%/mymodule
Adresáře uvedené v scanDirs nepřepisují výchozí hodnotu %appDir%, ale doplňují ji,
scanDirs tedy bude obsahovat obě cesty %appDir% a %vendorDir%/mymodule. Pokud bychom
chtěli výchozí adresář vynechat, použijeme vykřičník, který hodnotu
přepíše:
application:
scanDirs!:
- %vendorDir%/mymodule
Skenování adresářů lze vypnout uvedením hodnoty false. Nedoporučujeme úplně potlačit automatické přidávání
presenterů, protože jinak dojde ke snížení výkonu aplikace.
Šablony Latte
Tímto nastavením lze globálně ovlivnit chování Latte v komponentách a presenterech.
latte:
# přepne Latte do XHTML režimu
xhtml: ... # (bool) výchozí je false
# třída objektu $this->template
templateClass: App\MyTemplateClass # výchozí je Nette\Bridges\ApplicationLatte\Template
Dále lze registrovat nové tagy (makra) a to buď uvedením jména třídy, nebo referencí na službu. Jako výchozí je
zavolána metoda install(), ale to lze změnit tím, že uvedeme jméno jiné metody:
latte:
# registrace uživatelských Latte značek
macros:
- App\MyLatteMacros::register # statická metoda, classname nebo callable
- @App\MyLatteMacrosFactory # služba s metodou install()
- @App\MyLatteMacrosFactory::register # služba s metodou register()
services:
- App\MyLatteMacrosFactory
Routování
Základní nastavení:
routing:
# zobrazit routovací panel v Tracy Bar?
debugger: ... # (bool) výchozí je true
# serializuje router do DI kontejneru
cache: ... # (bool) výchozí je false
Routování obvykle definujeme ve třídě RouterFactory. Alternativně lze routy definovat
také v konfiguraci pomocí dvojic maska: akce, ale tento způsob nenabízí tak širokou variabilitu
v nastavení:
routing:
routes:
'detail/<id>': Admin:Home:default
'<presenter>/<action>': Front:Home:default
Konstanty
Vytváření PHP konstant.
constants:
FOOBAR: 'baz'
Po nastartování aplikace bude vytvořena konstanta FOOBAR.
Konstanty by neměly sloužit jako jakési globálně dostupné proměnné. Pro předávání hodnot do objektů
využijte dependency injection.
PHP
Nastavení direktiv PHP. Přehled všech direktiv naleznete na php.net.
php:
date.timezone: Europe/Prague