Konfiguracja kontenera DI
*************************

.[perex]
Przegląd opcji konfiguracyjnych kontenera Nette DI.


Plik konfiguracyjny
===================

Kontener Nette DI jest łatwy w użyciu dzięki plikom konfiguracyjnym. Zazwyczaj są one zapisane w [formacie NEON |neon:format]. Do edycji zalecane są [edytory z obsługą |best-practices:editors-and-tools#IDE-Editor] tego formatu.

<pre>
"decorator .[prism-token prism-atrule]":[#Decorator]: 	"dekorator .[prism-token prism-comment]"<br>
"di .[prism-token prism-atrule]":[#DI]: 			"kontener DI .[prism-token prism-comment]"<br>
"extensions .[prism-token prism-atrule]":[#Extensions]: 	"zainstaluj inne rozszerzenia DI .[prism-token prism-comment]"<br>
"includes .[prism-token prism-atrule]":[#Including files]: 	"wstawianie plików .[prism-token prism-comment]"<br>
"parameters .[prism-token prism-atrule]":[#Parameters]: 	"parametry .[prism-token prism-comment]"<br>
"search .[prism-token prism-atrule]":[#Search]: 		"automatyczna rejestracja serwisu .[prism-token prism-comment]"<br>
"services .[prism-token prism-atrule]":[services]: 		"serwisy .[prism-token prism-comment]"
</pre>

Aby wprowadzić ciąg zawierający znak `%`, musíte jej escapovat zdvojením na `%%`. .[note]


Parametry .[#toc-parameters]
============================

W konfiguracji można zdefiniować parametry, które następnie mogą być wykorzystane jako część definicji usług. Może to uczynić konfigurację bardziej przejrzystą lub ujednolicić i wyizolować wartości, które będą zmieniane.

```neon
parameters:
	dsn: 'mysql:host=127.0.0.1;dbname=test'
	user: root
	password: secret
```

Do parametru `dsn` można się odwołać w dowolnym miejscu konfiguracji, pisząc `%dsn%`. Parametry mogą być również używane wewnątrz łańcuchów, np. `'%wwwDir%/images'`.

Parametry nie muszą być ciągami znaków lub liczbami, mogą również zawierać pola:

```neon
parameters:
	mailer:
		host: smtp.example.com
		secure: ssl
		user: franta@gmail.com
	languages: [cs, en, de]
```

Określony klucz określamy jako `%mailer.user%`.

Jeśli potrzebujesz uzyskać wartość dowolnego parametru w swoim kodzie, na przykład klasy, przekaż ją do tej klasy. Na przykład w konstruktorze. Nie ma globalnego obiektu reprezentującego konfigurację, którą klasy odpytywałyby o wartości parametrów. Byłoby to naruszenie zasady wtrysku zależności.


Usługi
======

Patrz [osobny rozdział |services].


Dekorator .[#toc-decorator]
===========================

Jak masowo edytować wszystkie usługi danego typu? Na przykład wywołaj określoną metodę na wszystkich prezenterach, które dziedziczą po określonym wspólnym przodku? Do tego właśnie służy dekorator.

```neon
decorator:
	# dla wszystkich usług, które są instancjami tej klasy lub interfejsu
	App\Presentation\BasePresenter:
		setup:
			- setProjectId(10)     # wywołaj tę metodę
			- $absoluteUrls = true # i ustawić zmienną
```

Dekorator może być również użyty do ustawienia [tagów |services#Tags] lub włączenia trybu [iniekcji |services#Inject-Mode].

```neon
decorator:
	InjectableInterface:
		tags: [mytag: 1]
		inject: true
```


DI
===

Ustawienia techniczne kontenera DI.

```neon
di:
	# pokazać DIC w Tracy Bar?
	debugger: ...        # (bool) domyślnie jest true

	# typy parametrów, które nigdy nie są autowire
	excluded: ...        # (string[])

	# włączyć leniwe tworzenie usług?
	lazy: ...            # (bool) domyślnie false

	# klasa, po której dziedziczy kontener DI
	parentClass: ...     # (string) default to Nette\DI\Container
```


Lazy Services .[#toc-lazy-services]
-----------------------------------

Ustawienie `lazy: true` umożliwia leniwe (odroczone) tworzenie usług. Oznacza to, że usługi nie są faktycznie tworzone, gdy są wymagane z kontenera DI, ale tylko przy ich pierwszym użyciu. Może to przyspieszyć uruchamianie aplikacji i zmniejszyć zużycie pamięci, ponieważ tworzone są tylko usługi wymagane dla konkretnego żądania.

Dla konkretnej usługi można [dostosować |services#Lazy Services] leniwe tworzenie.

.[note]
Leniwe obiekty mogą być używane tylko dla klas zdefiniowanych przez użytkownika, a nie dla wewnętrznych klas PHP. Wymaga PHP 8.4 lub nowszego.


Eksport metadanych .[#toc-metadata-export]
------------------------------------------

Klasa kontenera DI zawiera również wiele metadanych. Możesz go zmniejszyć, zmniejszając eksport metadanych.

```neon
di:
	export:
		# parametry eksportu?
		parameters: false   # (bool) domyślnie jest true

		# eksportować tagi i jakie?
		tags:               # (string[]|bool) domyślnie wszystkie
			- event.subscriber

		# eksportować dane autowiringowe i jakie?
		types:              # (string[]|bool) default to all
			- Nette\Database\Connection
			- Symfony\Component\Console\Application
```

Jeśli nie używasz pola `$container->getParameters()`, możesz wyłączyć eksport parametrów. Można również wyeksportować tylko te tagi, za pośrednictwem których uzyskuje się usługi metodą `$container->findByTag(...)`.
Jeśli w ogóle nie wywołujesz metody, możesz całkowicie wyłączyć eksport tagów za pomocą `false`.

Możesz znacznie zmniejszyć metadane dla [autowiring |autowiring], określając klasy, których używasz jako parametr metody `$container->getByType()`.
I znowu, jeśli nie wywołujesz metody w ogóle (lub tylko w [bootstrapie |application:bootstrap], aby uzyskać `Nette\Application\Application`), możesz całkowicie wyłączyć eksport za pomocą `false`.


Przedłużenie .[#toc-extensions]
===============================

Zarejestruj więcej rozszerzeń DI. W ten sposób dodajemy np. rozszerzenie DI `Dibi\Bridges\Nette\DibiExtension22` pod nazwą `dibi`

```neon
extensions:
	dibi: Dibi\Bridges\Nette\DibiExtension22
```

Następnie konfigurujemy go w sekcji `dibi`:

```neon
dibi:
	host: localhost
```

Jako rozszerzenie możesz również dodać klasę, która ma parametry:

```neon
extensions:
	application: Nette\Bridges\ApplicationDI\ApplicationExtension(%debugMode%, %appDir%, %tempDir%/cache)
```


Wstawianie plików .[#toc-including-files]
=========================================

Dodatkowe pliki konfiguracyjne można przesłać w sekcji `includes`:

```neon
includes:
	- parameters.php
	- services.neon
	- presenters.neon
```

Nazwa `parameters.php` nie jest literówką, konfiguracja może być również zapisana w pliku PHP, który zwraca ją jako tablicę:

```php
<?php
return [
	'database' => [
		'main' => [
			'dsn' => 'sqlite::memory:',
		],
	],
];
```

Jeśli w plikach konfiguracyjnych pojawią się elementy o takich samych kluczach, zostaną one nadpisane, lub [scalone |#Slučování] w przypadku [pól |#Slučování]. Plik wstawiony później ma wyższy priorytet niż poprzedni. Plik, w którym wymieniona jest sekcja `includes` ma wyższy priorytet niż pliki wstawione do niego.


Szukaj .[#toc-search]
=====================

Automatyczne dodawanie usług do kontenera DI czyni pracę niezwykle wygodną. Nette automatycznie dodaje prezenterów do kontenera, ale możesz łatwo dodać dowolne inne klasy.

Wystarczy określić, w których katalogach (i podkatalogach) szukać klas:

```neon
search:
	-	in: %appDir%/Forms
	-	in: %appDir%/Model
```

Zazwyczaj nie chcemy dodawać wszystkich klas i interfejsów, więc możemy je filtrować:

```neon
search:
	-	in: %appDir%/Forms

		# filter by filename (string|string[])
		files:
			- *Factory.php

		# filter by class name (string|string[])
		classes:
			- *Factory
```

Możemy też wybrać klasy, które dziedziczą lub implementują przynajmniej jedną z wymienionych klas:


```neon
search:
	-	in: %appDir%
		extends:
			- App\*Form
		implements:
			- App\*FormInterface
```

Można również zdefiniować reguły wykluczenia, czyli maski nazw klas lub dziedziczonych przodków, które jeśli będą pasować, usługa nie zostanie dodana do kontenera DI:

```neon
search:
	-	in: %appDir%
		exclude:
pliki: ...
			classes: ...
			extends: ...
			implements: ...
```

Wszystkie usługi mogą być oznakowane:

```neon
search:
	-	in: %appDir%
		tags: ...
```


Łączenie .[#toc-merging]
========================

Jeśli elementy o tych samych kluczach pojawią się w wielu plikach konfiguracyjnych, zostaną nadpisane lub, w przypadku tablic, scalone. Plik wstawiony później ma wyższy priorytet niż poprzedni.

<table class=table>
<tr>
	<th width=33%>config1.neon</th>
	<th width=33%>config2.neon</th>
	<th>Wynik</th>
</tr>
<tr>
	<td>
```neon
items:
	- 1
	- 2
```
	</td>
	<td>
```neon
items:
	- 3
```
	</td>
	<td>
```neon
items:
	- 1
	- 2
	- 3
```
	</td>
</tr>
</table>

W przypadku pól można zapobiec scalaniu, umieszczając wykrzyknik po nazwie klucza:

<table class=table>
<tr>
	<th width=33%>config1.neon</th>
	<th width=33%>config2.neon</th>
	<th>Wynik</th>
</tr>
<tr>
	<td>
```neon
items:
	- 1
	- 2
```
	</td>
	<td>
```neon
items!:
	- 3
```
	</td>
	<td>
```neon
items:
	- 3
```
	</td>
</tr>
</table>