Funciones NEON
**************

<div class=perex>

NEON es un lenguaje de serialización de datos amigable. Se utiliza en Nette para los archivos de configuración. [api:Nette\Neon\Neon] es una clase estática para trabajar con NEON.

Conozca el [formato NEON |format] y [pruébelo |https://ne-on.org].

</div>

Los siguientes ejemplos utilizan estos alias:

```php
use Nette\Neon\Neon;
```


Instalación .[#toc-installation]
--------------------------------

Descargue e instale el paquete utilizando [Composer |best-practices:composer]:

```shell
composer require nette/neon
```

Puede comprobar si hay errores de sintaxis en los archivos `*.neon` utilizando el comando de consola `neon-lint`:

```shell
vendor/bin/neon-lint <path>
```


encode(mixed $value, bool $blockMode=false, string $indentation="\t"): string .[method]
---------------------------------------------------------------------------------------

Devuelve `$value` convertido a NEON. Como parámetro `$blockMode` puede pasar true, que creará una salida multilínea. El parámetro `$indentation` especifica los caracteres utilizados para la sangría (por defecto es tabulador).

```php
Neon::encode($value); // Returns $value converted to NEON
Neon::encode($value, true); // Returns $value converted to multiline NEON
```

El método `encode()` lanza `Nette\Neon\Exception` en caso de error.

```php
try {
	$neon = Neon::encode($value);
} catch (Nette\Neon\Exception $e) {
	// Exception handling
}
```


decode(string $neon): mixed .[method]
-------------------------------------

Convierte el NEON dado a un valor PHP.

Devuelve escalares, matrices, [fecha |format#dates] como objetos DateTimeImmutable y [entidades |format#Entities] como objetos [api:Nette\Neon\Entity].

```php
Neon::decode('hello: world'); // Returns an array ['hello' => 'world']
```

El método `decode()` lanza `Nette\Neon\Exception` en caso de error.

```php
try {
	$value = Neon::decode($neon);
} catch (Nette\Neon\Exception $e) {
	// Exception handling
}
```


decodeFile(string $file): mixed .[method]
-----------------------------------------

Convierte el contenido del fichero de NEON a PHP y elimina cualquier BOM.

```php
Neon::decodeFile('config.neon');
```

El método `decodeFile()` lanza `Nette\Neon\Exception` en caso de error.


{{leftbar: utils:@left-menu}}