Configuration du conteneur DI
*****************************

.[perex]
Aperçu des options de configuration pour le conteneur Nette DI.


Fichier de configuration
========================

Le conteneur Nette DI est facilement contrôlé à l'aide de fichiers de configuration. Ceux-ci sont généralement écrits au [format NEON |neon:format]. Pour l'édition, nous recommandons des [éditeurs avec support |best-practices:editors-and-tools#Éditeur IDE] pour ce format.

<pre>
"decorator .[prism-token prism-atrule]":[#Decorator]: 	"Décorateur .[prism-token prism-comment]"<br>
"di .[prism-token prism-atrule]":[#DI]: 			"Conteneur DI .[prism-token prism-comment]"<br>
"extensions .[prism-token prism-atrule]":[#Extensions]: 	"Installation d'extensions DI supplémentaires .[prism-token prism-comment]"<br>
"includes .[prism-token prism-atrule]":[#Inclusion de fichiers]: 	"Inclusion de fichiers .[prism-token prism-comment]"<br>
"parameters .[prism-token prism-atrule]":[#Paramètres]: 	"Paramètres .[prism-token prism-comment]"<br>
"search .[prism-token prism-atrule]":[#Search]: 		"Enregistrement automatique des services .[prism-token prism-comment]"<br>
"services .[prism-token prism-atrule]":[services]: 		"Services .[prism-token prism-comment]"
</pre>

.[note]
Pour écrire une chaîne contenant le caractère `%`, vous devez l'échapper en le doublant en `%%`.


Paramètres
==========

Dans la configuration, vous pouvez définir des paramètres qui peuvent ensuite être utilisés dans le cadre des définitions de service. Cela peut clarifier la configuration ou unifier et isoler les valeurs qui changeront.

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

Nous nous référons au paramètre `dsn` n'importe où dans la configuration en écrivant `%dsn%`. Les paramètres peuvent également être utilisés à l'intérieur de chaînes comme `'%wwwDir%/images'`.

Les paramètres ne doivent pas nécessairement être des chaînes ou des nombres, ils peuvent également contenir des tableaux :

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

Nous nous référons à une clé spécifique comme `%mailer.user%`.

Si vous avez besoin de connaître la valeur d'un paramètre dans votre code, par exemple dans une classe, passez-le à cette classe. Par exemple, dans le constructeur. Il n'existe pas d'objet global représentant la configuration que les classes interrogeraient pour les valeurs des paramètres. Cela violerait le principe d'injection de dépendances.


Services
========

Voir le [chapitre séparé |services].


Decorator
=========

Comment modifier en masse tous les services d'un certain type ? Par exemple, appeler une certaine méthode sur tous les presenters qui héritent d'un ancêtre commun spécifique ? C'est là qu'intervient le décorateur.

```neon
decorator:
	# pour tous les services qui sont des instances de cette classe ou interface
	App\Presentation\BasePresenter:
		setup:
			- setProjectId(10)       # appelle cette méthode
			- $absoluteUrls = true   # et définit la variable
```

Le décorateur peut également être utilisé pour définir des [tags |services#Tags] ou activer le mode [inject |services#Mode Inject].

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


DI
===

Paramètres techniques du conteneur DI.

```neon
di:
	# afficher le DIC dans la barre Tracy ?
	debugger: ...        # (bool) par défaut est true

	# types de paramètres à ne jamais autowirer
	excluded: ...        # (string[])

	# autoriser la création paresseuse de services ?
	lazy: ...            # (bool) par défaut est false

	# classe dont hérite le conteneur DI
	parentClass: ...     # (string) par défaut est Nette\DI\Container
```


Services paresseux .{data-version:3.2.4}
----------------------------------------

Le paramètre `lazy: true` active la création paresseuse (différée) des services. Cela signifie que les services ne sont pas réellement créés au moment où nous les demandons au conteneur DI, mais seulement au moment de leur première utilisation. Cela peut accélérer le démarrage de l'application et réduire l'empreinte mémoire, car seuls les services réellement nécessaires dans la requête donnée sont créés.

Pour un service spécifique, la création paresseuse peut être [modifiée |services#Services Lazy].

.[note]
Les objets paresseux ne peuvent être utilisés que pour les classes utilisateur, pas pour les classes PHP internes. Nécessite PHP 8.4 ou plus récent.


Exportation des métadonnées
---------------------------

La classe du conteneur DI contient également beaucoup de métadonnées. Vous pouvez la réduire en réduisant l'exportation des métadonnées.

```neon
di:
	export:
		# exporter les paramètres ?
		parameters: false   # (bool) par défaut est true

		# exporter les tags et lesquels ?
		tags:               # (string[]|bool) par défaut tous
			- event.subscriber

		# exporter les données pour l'autowiring et lesquelles ?
		types:              # (string[]|bool) par défaut toutes
			- Nette\Database\Connection
			- Symfony\Component\Console\Application
```

Si vous n'utilisez pas le tableau `$container->getParameters()`, vous pouvez désactiver l'exportation des paramètres. De plus, vous pouvez exporter uniquement les tags via lesquels vous obtenez des services avec la méthode `$container->findByTag(...)`. Si vous n'appelez pas du tout la méthode, vous pouvez désactiver complètement l'exportation des tags en utilisant `false`.

Vous pouvez réduire considérablement les métadonnées pour l'[autowiring |autowiring] en listant les classes que vous utilisez comme paramètre de la méthode `$container->getByType()`. Et encore une fois, si vous n'appelez pas du tout la méthode (ou seulement dans le [bootstrap |application:bootstrapping] pour obtenir `Nette\Application\Application`), vous pouvez désactiver complètement l'exportation en utilisant `false`.


Extensions
==========

Enregistrement d'extensions DI supplémentaires. De cette manière, nous ajoutons par exemple l'extension DI `Dibi\Bridges\Nette\DibiExtension22` sous le nom `dibi`

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

Ensuite, nous la configurons dans la section `dibi` :

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

Une classe avec des paramètres peut également être ajoutée comme extension :

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


Inclusion de fichiers
=====================

Nous pouvons inclure d'autres fichiers de configuration dans la section `includes` :

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

Le nom `parameters.php` n'est pas une faute de frappe, la configuration peut également être écrite dans un fichier PHP qui la renvoie sous forme de tableau :

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

Si des éléments avec les mêmes clés apparaissent dans les fichiers de configuration, ils seront écrasés ou, dans le cas de [tableaux fusionnés |#Fusion]. Le fichier inclus plus tard a une priorité plus élevée que le précédent. Le fichier dans lequel la section `includes` est listée a une priorité plus élevée que les fichiers qu'il inclut.


Search
======

L'ajout automatique de services au conteneur DI rend le travail extrêmement agréable. Nette ajoute automatiquement les presenters au conteneur, mais il est facile d'ajouter également d'autres classes.

Il suffit d'indiquer dans quels répertoires (et sous-répertoires) les classes doivent être recherchées :

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

Cependant, nous ne voulons généralement pas ajouter absolument toutes les classes et interfaces, nous pouvons donc les filtrer :

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

		# filtrage par nom de fichier (string|string[])
		files:
			- *Factory.php

		# filtrage par nom de classe (string|string[])
		classes:
			- *Factory
```

Ou nous pouvons sélectionner des classes qui héritent ou implémentent au moins une des classes listées :


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

Il est également possible de définir des règles d'exclusion, c'est-à-dire des masques de nom de classe ou des ancêtres héréditaires, qui, s'ils correspondent, empêchent l'ajout du service au conteneur DI :

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

Des tags peuvent être définis pour tous les services :

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


Fusion
======

Si des éléments avec les mêmes clés apparaissent dans plusieurs fichiers de configuration, ils seront écrasés ou, dans le cas de tableaux, fusionnés. Le fichier inclus plus tard a une priorité plus élevée que le précédent.

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

Pour les tableaux, la fusion peut être empêchée en ajoutant un point d'exclamation après le nom de la clé :

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

{{maintitle: Configuration de l'injection de dépendances}}