Alkalmazások konfigurálása

A Nette alkalmazások konfigurációs lehetőségeinek áttekintése.

Application

application:
	# megjelenjen a "Nette Application" panel a Tracy BlueScreen-en?
	debugger: ...           # (bool) alapértelmezett: true

	# hiba esetén meghívódjon az error-presenter?
	# csak fejlesztői módban van hatása
	catchExceptions: ...    # (bool) alapértelmezett: true

	# az error-presenter neve
	errorPresenter: Error   # (string|array) alapértelmezett: 'Nette:Error'

	# aliasokat definiál presenterekhez és akciókhoz
	aliases: ...

	# szabályokat definiál a presenter nevének osztályra való fordításához
	mapping: ...

	# a hibás linkek nem generálnak figyelmeztetést?
	# csak fejlesztői módban van hatása
	silentLinks: ...        # (bool) alapértelmezett: false

A nette/application 3.2-es verziójától kezdve definiálható egy error-presenter pár:

application:
	errorPresenter:
		4xx: Error4xx   # Nette\Application\BadRequestException kivételhez
		5xx: Error5xx   # egyéb kivételekhez

A silentLinks opció meghatározza, hogyan viselkedik a Nette fejlesztői módban, ha a link generálása sikertelen (például mert nem létezik a presenter stb.). Az alapértelmezett false érték azt jelenti, hogy a Nette E_USER_WARNING hibát dob. true-ra állítva ez a hibaüzenet elnyomásra kerül. Éles környezetben az E_USER_WARNING mindig kiváltódik. Ezt a viselkedést a presenter $invalidLinkMode változójának beállításával is befolyásolhatjuk.

Az Aliasok egyszerűsítik a hivatkozást a gyakran használt presenterekre.

A Mapping definiálja a szabályokat, amelyek alapján a presenter nevéből levezetődik az osztály neve.

Presenterek automatikus regisztrációja

A Nette automatikusan hozzáadja a presentereket szolgáltatásként a DI konténerhez, ami jelentősen felgyorsítja azok létrehozását. A Nette presenterek felkutatásának módja konfigurálható:

application:
	# keresse a presentereket a Composer class map-ben?
	scanComposer: ...      # (bool) alapértelmezett: true

	# maszk, amelynek meg kell felelnie az osztály és a fájl nevének
	scanFilter: ...        # (string) alapértelmezett: '*Presenter'

	# mely könyvtárakban keresse a presentereket?
	scanDirs:              # (string[]|false) alapértelmezett: '%appDir%'
		- %vendorDir%/mymodule

A scanDirs-ben megadott könyvtárak nem írják felül az alapértelmezett %appDir% értéket, hanem kiegészítik azt, így a scanDirs mindkét utat tartalmazni fogja: %appDir% és %vendorDir%/mymodule. Ha az alapértelmezett könyvtárat ki szeretnénk hagyni, használjuk a felkiáltójelet, amely felülírja az értéket:

application:
	scanDirs!:
		- %vendorDir%/mymodule

A könyvtárak szkennelése kikapcsolható a false érték megadásával. Nem javasoljuk a presenterek automatikus hozzáadásának teljes elnyomását, mert ez csökkenti az alkalmazás teljesítményét.

Latte sablonok

Ezzel a beállítással globálisan befolyásolható a Latte viselkedése a komponensekben és presenterekben.

latte:
	# megjelenjen a Latte panel a Tracy Bar-ban a fő sablonhoz (true) vagy az összes komponenshez (all)?
	debugger: ...        # (true|false|'all') alapértelmezett: true

	# generál sablonokat declare(strict_types=1) fejléccel
	strictTypes: ...     # (bool) alapértelmezett: false

	# bekapcsolja a [szigorú parser |latte:develop#striktní režim] módot
	strictParsing: ...   # (bool) alapértelmezett: false

	# aktiválja a [generált kód ellenőrzését |latte:develop#Kontrola vygenerovaného kódu]
	phpLinter: ...       # (string) alapértelmezett: null

	# beállítja a locale-t
	locale: cs_CZ        # (string) alapértelmezett: null

	# a $this->template objektum osztálya
	templateClass: App\MyTemplateClass # alapértelmezett: Nette\Bridges\ApplicationLatte\DefaultTemplate

Ha a Latte 3-as verzióját használja, új bővítményeket adhat hozzá a következőkkel:

latte:
	extensions:
		- Latte\Essential\TranslatorExtension(@Nette\Localization\Translator)

Ha a Latte 2-es verzióját használja, új tag-eket regisztrálhat akár az osztálynév megadásával, akár egy szolgáltatásra való hivatkozással. Alapértelmezés szerint az install() metódus hívódik meg, de ezt meg lehet változtatni egy másik metódus nevének megadásával:

latte:
	# egyéni Latte tag-ek regisztrálása
	macros:
		- App\MyLatteMacros::register         # statikus metódus, classname vagy callable
		- @App\MyLatteMacrosFactory           # szolgáltatás install() metódussal
		- @App\MyLatteMacrosFactory::register # szolgáltatás register() metódussal

services:
	- App\MyLatteMacrosFactory

Routing

Alapbeállítások:

routing:
	# megjelenjen a routing panel a Tracy Bar-ban?
	debugger: ...   # (bool) alapértelmezett: true

	# szerializálja a routert a DI konténerbe
	cache: ...      # (bool) alapértelmezett: false

A routingot általában a RouterFactory osztályban definiáljuk. Alternatívaként a route-okat a konfigurációban is definiálhatjuk maszk: akció párokkal, de ez a módszer nem kínál olyan széleskörű beállítási lehetőségeket:

routing:
	routes:
		'detail/<id>': Admin:Home:default
		'<presenter>/<action>': Front:Home:default

Konstansok

PHP konstansok létrehozása.

constants:
	Foobar: 'baz'

Az alkalmazás indítása után létrejön a Foobar konstans.

A konstansok nem szolgálhatnak valamiféle globálisan elérhető változóként. Értékek objektumokba való átadásához használja a dependency injectiont.

PHP

PHP direktívák beállítása. Az összes direktíva áttekintése megtalálható a php.net oldalon.

php:
	date.timezone: Europe/Prague

DI szolgáltatások

Ezek a szolgáltatások kerülnek hozzáadásra a DI konténerhez: