Nette NEON
**********

<div class=perex>

NEON è un linguaggio leggibile dall'uomo per la serializzazione dei dati. Viene utilizzato in Nette per i file di configurazione. [api:Nette\Neon\Neon] è una classe statica per lavorare con NEON.

Scopri il [formato NEON|format] e [provalo |https://ne-on.org].

</div>

Tutti gli esempi presuppongono la creazione di un alias:

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


Installazione
-------------

Scarica e installa la libreria utilizzando [Composer|best-practices:composer]:

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

Puoi controllare gli errori di sintassi nei file `*.neon` utilizzando il comando da console `neon-lint`:

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


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

Restituisce `$value` convertito in NEON. Come parametro `$blockMode`, puoi passare `true`, creando così un output multilinea. Il parametro `$indentation` specifica i caratteri utilizzati per l'indentazione (il predefinito è il tabulatore).

```php
Neon::encode($value); // Restituisce $value convertito in NEON
Neon::encode($value, true); // Restituisce $value convertito in NEON multilinea
```

Il metodo `encode()` lancia `Nette\Neon\Exception` in caso di errore.

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


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

Converte una stringa da NEON a PHP.

Restituisce scalari, array, [date |format#Data] come oggetti DateTimeImmutable ed [entità |format#Entità] come oggetti [api:Nette\Neon\Entity].

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

Il metodo `decode()` lancia `Nette\Neon\Exception` in caso di errore.

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


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

Converte il contenuto di un file da NEON a PHP e rimuove eventuali BOM.

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

Il metodo `decodeFile()` lancia `Nette\Neon\Exception` in caso di errore.


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