Налаштування програми
*********************

.[perex]
Огляд варіантів конфігурації застосунку Nette.


Додаток .[#toc-application]
===========================

```neon
application:
	# відображає вкладку "Nette Application" на синьому екрані Tracy?
	debugger: ...           # (bool) за замовчуванням true

	# чи буде викликано error-presenter при помилці?
	# має ефект тільки в режимі розробника
	catchExceptions: ...    # (bool) за замовчуванням дорівнює true

	# ім'я презентера помилок
	errorPresenter: Error   # (string|array) за замовчуванням 'Nette:Error'

	# визначає псевдоніми для доповідачів та подій
	aliases: ...

	# визначає правила для перетворення імені ведучого в клас
	mapping: ...

	# чи видають погані посилання попередження?
	# має силу тільки в режимі розробки
	silentLinks: ...        # (bool) за замовчуванням false
```

Починаючи з версії 3.2 `nette/application` можна визначити пару презентувальників помилок:

```neon
application:
	errorPresenter:
		4xx: Error4xx   # для виключення Nette\Application\BadRequestException
		5xx: Error5xx   # для інших винятків
```

Опція `silentLinks` визначає, як Nette поводиться в режимі розробника, коли генерація посилань не вдається (наприклад, через відсутність презентера тощо). Значення за замовчуванням `false` означає, що Nette запускає `E_USER_WARNING`. Встановлення значення `true` пригнічує це повідомлення про помилку. У виробничому середовищі завжди викликається `E_USER_WARNING`. Ми також можемо вплинути на цю поведінку, встановивши змінну презентера [$invalidLinkMode |creating-links#Invalid-Links].

[Псевдоніми спрощують посилання |creating-links#aliases] на часто використовуваних доповідачів.

Карта [mapping визначає правила |modules#Mapping], за якими ім'я класу виводиться з імені ведучого.


Автореєстрація презентерів .[#toc-automatic-registration-of-presenters]
-----------------------------------------------------------------------

Nette автоматично додає презентери як сервіси в контейнер DI, що значно прискорює їхнє створення. Як Nette впізнає презентери, можна налаштувати:

```neon
application:
	# для пошуку презентерів у карті класів Composer?
	scanComposer: ...      # (bool) за замовчуванням true

	# маска, яка має відповідати класу та імені файлу
	scanFilter: ...        # (string) за замовчуванням '*Presenter'

	# у яких каталогах шукати презентери?
	scanDirs:              # (string[]|false) за замовчуванням '%appDir%'
		- %vendorDir%/mymodule
```

Каталоги, перераховані в `scanDirs`, не скасовують значення за замовчуванням `%appDir%`, а доповнюють його, тому `scanDirs` міститиме обидва шляхи `%appDir%` і `%vendorDir%/mymodule`. Щоб перезаписати каталог за замовчуванням, ми використовуємо [знак оклику |dependency-injection:configuration#Merging]:

```neon
application:
	scanDirs!:
		- %vendorDir%/mymodule
```

Сканування каталогу можна відключити, задавши значення `false`. Ми не рекомендуємо повністю пригнічувати автоматичне додавання презентерів, інакше продуктивність програми знизиться.


Latte .[#toc-latte]
===================

Це налаштування глобально впливає на поведінку Latte в компонентах і презентерах.

```neon
latte:
	# відображає вкладку Latte на панелі Tracy для основного шаблону (true) або для всіх компонентів (all)?
	debugger: ...        # (true|false|'all') за замовчуванням true

	# генерує шаблони з declare(strict_types=1)
	strictTypes: ...     # (bool) за замовчуванням false

	# вмикає [режим строгого |latte:develop#strict mode]синтаксичного аналізу
	strictParsing: ...   # (bool) за замовчуванням false

	# включає [перевірку згенерованого коду |latte:develop#Checking Generated Code]
	phpLinter: ...       # (string) за замовчуванням null

	# встановлює локаль
	locale: cs_CZ        # (string) за замовчуванням null

	# клас $this->template
	templateClass: App\MyTemplateClass # за замовчуванням Nette\Bridges\ApplicationLatte\DefaultTemplate
```

Якщо ви використовуєте Latte версії 3, ви можете додати нове [розширення |latte:creating-extension], використовуючи:

```neon
latte:
	расширения:
		- Latte\Essential\TranslatorExtension(@Nette\Localization\Translator)
```

/--comment











\--


Маршрутизація .[#toc-routing]
=============================

Основні налаштування:

```neon
routing:
	# відображає вкладку Routing на панелі Tracy?
	debugger: ...   # (bool) за замовчуванням true

	# здійснювати серіалізацію маршрутів у DI-контейнері?
	cache: ...      # (bool) за замовчуванням false
```

Маршрути зазвичай визначаються в класі RouterFactory. Альтернативно, прості правила маршрутизації можна визначити в конфігурації за допомогою пар `маска: действие`:

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


Константи .[#toc-constants]
===========================

Створення констант PHP:

```neon
constants:
	Foobar: 'baz'
```

Константа `Foobar` буде створена після запуску.

.[note]
Константи не повинні слугувати як глобально доступні змінні. Для передачі значень об'єктам використовуйте [dependency injection |dependency-injection:passing-dependencies].


PHP
===

Ви можете встановлювати директиви PHP. Огляд усіх директив можна знайти на сайті [php.net |https://www.php.net/manual/ru/ini.list.php].

```neon
php:
	date.timezone: Europe/Prague
```


Послуги з проведення розслідувань .[#toc-di-services]
=====================================================

Ці сервіси додаються до контейнера DI:

| Назва | Тип | Опис
|----------------------------------------------------------
| `application.application` | [api:Nette\Application\Application] | [повний запуск програми |how-it-works#Nette Application]
| `application.linkGenerator` | [api:Nette\Application\LinkGenerator] | [LinkGenerator |creating-links#LinkGenerator]
| `application.presenterFactory` | [api:Nette\Application\PresenterFactory] | фабрика ведучих
| `application.###` | [api:Nette\Application\UI\Presenter] | індивідуальні ведучі
| `latte.latteFactory` | [api:Nette\Bridges\ApplicationLatte\LatteFactory] | фабрика для `Latte\Engine`
| `latte.templateFactory` | [api:Nette\Application\UI\TemplateFactory] | фабрика для [`$this->template` |templates]