Nette Documentation Preview

syntax
Configuración del Contenedor DI
*******************************

.[perex]
Visión general de las opciones de configuración del contenedor Nette DI.


Fichero de configuración
========================

El contenedor Nette DI es fácil de controlar usando ficheros de configuración. Normalmente están escritos en [formato NEON|neon:format]. Recomendamos usar [editores con soporte|best-practices:editors-and-tools#ide-editor] para este formato de edición.

<pre>
"decorator .[prism-token prism-atrule]":[#Decorator]: "Decorator .[prism-token prism-comment]"<br>
"di .[prism-token prism-atrule]":[#DI]: "DI Container .[prism-token prism-comment]"<br>
"extensions .[prism-token prism-atrule]":[#Extensions]: "Instalar extensiones DI adicionales .[prism-token prism-comment]"<br>
"includes .[prism-token prism-atrule]":[#Including files]: "Incluir archivos .[prism-token prism-comment]"<br>
"parameters .[prism-token prism-atrule]":[#Parameters]: "Parámetros .[prism-token prism-comment]"<br>
"search .[prism-token prism-atrule]":[#Búsqueda]: "Registro automático de servicios .[prism-token prism-comment]"<br>
"services .[prism-token prism-atrule]":[services]: "Servicios .[prism-token prism-comment]"<br>
</pre>

Si utilizas una cadena que empieza por `@` o tiene `%` en cualquier parte, tienes que escaparla añadiendo otra `@` o `%`. .[nota]


Parámetros .[#toc-parameters]
=============================

Puedes definir parámetros que luego se pueden utilizar como parte de las definiciones de servicio. Esto puede ayudar a separar valores que querrás cambiar más regularmente.

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

Puede hacer referencia al parámetro `foo` mediante `%foo%` en cualquier otro lugar de cualquier archivo de configuración. También se pueden utilizar dentro de cadenas como `'%wwwDir%/images'`.

Los parámetros no necesitan ser sólo cadenas, también pueden ser valores de array:

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

Puedes referirte a una sola clave como `%mailer.user%`.

Si necesitas obtener el valor de algún parámetro en tu código, por ejemplo en tu clase, entonces pásalo a esta clase. Por ejemplo, en el constructor. No existe un objeto de configuración global que pueda consultar a las clases los valores de los parámetros. Esto iría en contra del principio de inyección de dependencias.


Servicios .[#toc-services]
==========================

Ver [capítulo aparte|services].


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

¿Cómo editar masivamente todos los servicios de un determinado tipo? ¿Necesitas llamar a un determinado método para todos los presentadores que heredan de un determinado ancestro común? De ahí surge el decorador.

```neon
decorator:
	# para todos los servicios que son instancias de esta clase o interfaz
	App\UI\BasePresenter:
		setup:
			- setProjectId(10)       # llamar a este método
			- $absoluteUrls = true   # y establecer la variable
```

Decorator también se puede utilizar para establecer [tags|services#Tags] o activar [inject mode|services#Inject Mode].

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


DI
===

Configuración técnica del contenedor DI.

```neon
di:
	# shows DIC in Tracy Bar?
	debugger: ...        # (bool) defaults to true

	# tipos de parámetros que nunca se autocablean (autowire)
	excluded: ...        # (string[])

	# la clase de la que hereda el contenedor DI
	parentClass: ...     # (string) defaults to Nette\DI\Container
```


Exportación de metadatos .[#toc-metadata-export]
------------------------------------------------

La clase contenedor DI también contiene muchos metadatos. Puedes reducirla reduciendo la exportación de metadatos.

```neon
di:
	export:
		# ¿exportar parámetros?
		parameters: false   # (bool) por defecto true

		# ¿etiquetas de exportación y cuáles?
		tags:               # (string[]|bool) por defecto todos
			- event.subscriber

		# exportar datos para autowiring y ¿cuáles?
		types:              # (string[]|bool) por defecto todos
			- Nette\Database\Connection
			- Symfony\Component\Console\Application
```

Si no utilizas el array `$container->getParameters()`, puedes desactivar la exportación de parámetros. Además, puede exportar sólo aquellas etiquetas a través de las cuales obtiene servicios utilizando el método `$container->findByTag(...)`.
Si no llama al método en absoluto, puede desactivar completamente la exportación de etiquetas con `false`.

Puede reducir significativamente los metadatos para [autowiring] especificando las clases que utiliza como parámetro del método `$container->getByType()`.
Y de nuevo, si no llama al método en absoluto (o sólo en [application:bootstrap] para obtener `Nette\Application\Application`), puede desactivar la exportación completamente con `false`.


Extensiones .[#toc-extensions]
==============================

Registro de otras extensiones DI. De esta forma añadimos, por ejemplo, la extensión DI `Dibi\Bridges\Nette\DibiExtension22` bajo el nombre `dibi`:

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

Luego lo configuramos en su sección llamada también `dibi`:

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

También puedes añadir una clase de extensión con parámetros:

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


Inclusión de archivos .[#toc-including-files]
=============================================

Se pueden insertar ficheros de configuración adicionales en la sección `includes`:

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

El nombre `parameters.php` no es una errata, la configuración también se puede escribir en un fichero PHP, que la devuelve como un array:

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

Si elementos con las mismas claves aparecen dentro de ficheros de configuración, serán [sobreescritos o fusionados |#Merging] en el caso de arrays. El fichero incluido posteriormente tiene mayor prioridad que el anterior. El fichero en el que aparece la sección `includes` tiene una prioridad mayor que los ficheros incluidos en él.


Búsqueda .[#toc-search]
=======================

La adición automática de servicios al contenedor DI hace el trabajo extremadamente agradable. Nette añade automáticamente presentadores al contenedor, pero usted puede añadir fácilmente cualquier otra clase.

Basta con especificar en qué directorios (y subdirectorios) deben buscarse las clases:

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

Normalmente, sin embargo, no queremos añadir todas las clases e interfaces, así que podemos filtrarlas:

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

		# filtrado por nombre de archivo (string|string[])
		files:
			- *Factory.php

		# filtrado por nombre de clase (string|string[])
		classes:
			- *Factory
```

O podemos seleccionar clases que hereden o implementen al menos una de las siguientes clases:


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

También se pueden definir reglas negativas, es decir, máscaras de nombres de clases o ancestros y si las cumplen, el servicio no se añadirá al contenedor DI:

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

Se pueden establecer etiquetas para los servicios añadidos:

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


Fusión .[#toc-merging]
======================

Si aparecen elementos con las mismas claves en más archivos de configuración, se sobrescribirán o fusionarán en el caso de las matrices. El fichero incluido más tarde tiene mayor prioridad.

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

Para evitar la fusión de un determinado array utiliza el signo de exclamación justo después del nombre del array:

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

Configuración del Contenedor DI

Visión general de las opciones de configuración del contenedor Nette DI.

Fichero de configuración

El contenedor Nette DI es fácil de controlar usando ficheros de configuración. Normalmente están escritos en formato NEON. Recomendamos usar editores con soporte para este formato de edición.

 decorator: Decorator
di: DI Container
extensions: Instalar extensiones DI adicionales
includes: Incluir archivos
parameters: Parámetros
search: Registro automático de servicios
services: Servicios

Si utilizas una cadena que empieza por @ o tiene % en cualquier parte, tienes que escaparla añadiendo otra @ o %.

Parámetros

Puedes definir parámetros que luego se pueden utilizar como parte de las definiciones de servicio. Esto puede ayudar a separar valores que querrás cambiar más regularmente.

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

Puede hacer referencia al parámetro foo mediante %foo% en cualquier otro lugar de cualquier archivo de configuración. También se pueden utilizar dentro de cadenas como '%wwwDir%/images'.

Los parámetros no necesitan ser sólo cadenas, también pueden ser valores de array:

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

Puedes referirte a una sola clave como %mailer.user%.

Si necesitas obtener el valor de algún parámetro en tu código, por ejemplo en tu clase, entonces pásalo a esta clase. Por ejemplo, en el constructor. No existe un objeto de configuración global que pueda consultar a las clases los valores de los parámetros. Esto iría en contra del principio de inyección de dependencias.

Servicios

Ver capítulo aparte.

Decorador

¿Cómo editar masivamente todos los servicios de un determinado tipo? ¿Necesitas llamar a un determinado método para todos los presentadores que heredan de un determinado ancestro común? De ahí surge el decorador.

decorator:
	# para todos los servicios que son instancias de esta clase o interfaz
	App\UI\BasePresenter:
		setup:
			- setProjectId(10)       # llamar a este método
			- $absoluteUrls = true   # y establecer la variable

Decorator también se puede utilizar para establecer tags o activar inject mode.

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

DI

Configuración técnica del contenedor DI.

di:
	# shows DIC in Tracy Bar?
	debugger: ...        # (bool) defaults to true

	# tipos de parámetros que nunca se autocablean (autowire)
	excluded: ...        # (string[])

	# la clase de la que hereda el contenedor DI
	parentClass: ...     # (string) defaults to Nette\DI\Container

Exportación de metadatos

La clase contenedor DI también contiene muchos metadatos. Puedes reducirla reduciendo la exportación de metadatos.

di:
	export:
		# ¿exportar parámetros?
		parameters: false   # (bool) por defecto true

		# ¿etiquetas de exportación y cuáles?
		tags:               # (string[]|bool) por defecto todos
			- event.subscriber

		# exportar datos para autowiring y ¿cuáles?
		types:              # (string[]|bool) por defecto todos
			- Nette\Database\Connection
			- Symfony\Component\Console\Application

Si no utilizas el array $container->getParameters(), puedes desactivar la exportación de parámetros. Además, puede exportar sólo aquellas etiquetas a través de las cuales obtiene servicios utilizando el método $container->findByTag(...). Si no llama al método en absoluto, puede desactivar completamente la exportación de etiquetas con false.

Puede reducir significativamente los metadatos para autowiring especificando las clases que utiliza como parámetro del método $container->getByType(). Y de nuevo, si no llama al método en absoluto (o sólo en bootstrap para obtener Nette\Application\Application), puede desactivar la exportación completamente con false.

Extensiones

Registro de otras extensiones DI. De esta forma añadimos, por ejemplo, la extensión DI Dibi\Bridges\Nette\DibiExtension22 bajo el nombre dibi:

extensions:
	dibi: Dibi\Bridges\Nette\DibiExtension22

Luego lo configuramos en su sección llamada también dibi:

dibi:
	host: localhost

También puedes añadir una clase de extensión con parámetros:

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

Inclusión de archivos

Se pueden insertar ficheros de configuración adicionales en la sección includes:

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

El nombre parameters.php no es una errata, la configuración también se puede escribir en un fichero PHP, que la devuelve como un array:

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

Si elementos con las mismas claves aparecen dentro de ficheros de configuración, serán sobreescritos o fusionados en el caso de arrays. El fichero incluido posteriormente tiene mayor prioridad que el anterior. El fichero en el que aparece la sección includes tiene una prioridad mayor que los ficheros incluidos en él.

La adición automática de servicios al contenedor DI hace el trabajo extremadamente agradable. Nette añade automáticamente presentadores al contenedor, pero usted puede añadir fácilmente cualquier otra clase.

Basta con especificar en qué directorios (y subdirectorios) deben buscarse las clases:

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

Normalmente, sin embargo, no queremos añadir todas las clases e interfaces, así que podemos filtrarlas:

search:
	-	in: %appDir%/Forms

		# filtrado por nombre de archivo (string|string[])
		files:
			- *Factory.php

		# filtrado por nombre de clase (string|string[])
		classes:
			- *Factory

O podemos seleccionar clases que hereden o implementen al menos una de las siguientes clases:

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

También se pueden definir reglas negativas, es decir, máscaras de nombres de clases o ancestros y si las cumplen, el servicio no se añadirá al contenedor DI:

search:
	-	in: %appDir%
		exclude:
archivos: ...
			classes: ...
			extends: ...
			implements: ...

Se pueden establecer etiquetas para los servicios añadidos:

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

Fusión

Si aparecen elementos con las mismas claves en más archivos de configuración, se sobrescribirán o fusionarán en el caso de las matrices. El fichero incluido más tarde tiene mayor prioridad.

config1.neon config2.neon result
items:
	- 1
	- 2
items:
	- 3
items:
	- 1
	- 2
	- 3

Para evitar la fusión de un determinado array utiliza el signo de exclamación justo después del nombre del array:

config1.neon config2.neon result
items:
	- 1
	- 2
items!:
	- 3
items:
	- 3