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

<div class=perex>

NEON este un limbaj ușor de înțeles pentru serializarea datelor. Este utilizat în Nette pentru fișierele de configurare. [api:Nette\Neon\Neon] este o clasă statică pentru lucrul cu NEON.

Familiarizați-vă cu [formatul NEON|format] și [încercați-l |https://ne-on.org].

</div>

Toate exemplele presupun crearea unui alias:

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


Instalare
---------

Descărcați și instalați biblioteca folosind [Composer|best-practices:composer]:

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

Puteți verifica erorile de sintaxă în fișierele `*.neon` folosind comanda de consolă `neon-lint`:

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


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

Returnează `$value` convertită în NEON. Ca parametru `$blockMode`, puteți transmite true, ceea ce va crea o ieșire pe mai multe linii. Parametrul `$indentation` specifică caracterele utilizate pentru indentare (implicit este tabulatorul).

```php
Neon::encode($value); // Returnează $value convertită în NEON
Neon::encode($value, true); // Returnează $value convertită în NEON pe mai multe linii
```

Metoda `encode()` aruncă `Nette\Neon\Exception` în caz de eroare.

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


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

Convertește un șir din NEON în PHP.

Returnează scalari, array-uri, [date |format#Dată] ca obiecte DateTimeImmutable și [entități |format#Entități] ca obiecte [api:Nette\Neon\Entity].

```php
Neon::decode('hello: world'); // Returnează array-ul ['hello' => 'world']
```

Metoda `decode()` aruncă `Nette\Neon\Exception` în caz de eroare.

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


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

Convertește conținutul unui fișier din NEON în PHP și elimină eventualul BOM.

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

Metoda `decodeFile()` aruncă `Nette\Neon\Exception` în caz de eroare.


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