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

<div class=perex>

NEON è un linguaggio di serializzazione dei dati amichevole per le persone. In Nette si usa per i file di configurazione. [api:Nette\Neon\Neon] è una classe statica per lavorare con NEON.

Conoscete il [formato NEON|format] e [provatelo |https://fiddle.nette.org/neon/].

</div>

Tutti gli esempi presuppongono che sia definito questo alias:

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


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

Il pacchetto si scarica e si installa con [Composer|best-practices:composer]:

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

Potete verificare gli errori di sintassi nei file `*.neon` con il comando da console `neon-lint`:

```shell
vendor/bin/neon-lint [--debug] <path>
```


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

Restituisce `$value` convertito in NEON. Al parametro `$blockMode` potete passare `true` per creare un output su più righe. Il parametro `$indentation` indica i caratteri usati per l'indentazione (per impostazione predefinita la tabulazione).

```php
Neon::encode($value); // restituisce $value convertito in NEON
Neon::encode($value, true); // restituisce $value convertito in NEON su più righe
```

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 $input): mixed .[method]
--------------------------------------

Converte la stringa NEON indicata in un valore PHP.

Restituisce scalari, array, [date |format#Date] 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 l'eventuale BOM.

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

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


Se state aggiornando a una versione più recente, guardate la pagina [aggiornamento |upgrading].