Функции на NEON
***************

<div class=perex>

NEON е лесен за използване език за сериализация на данни. Той се използва в Nette за конфигурационни файлове. [api:Nette\Neon\Neon] - е статичен клас за работа с NEON.

Запознайте се с [формата NEON |format] и [го из |https://ne-on.org] пробвайте.

</div>

Следващите примери използват тези псевдоними:

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


Настройка .[#toc-installation]
------------------------------

Изтеглете и инсталирайте пакета с помощта на [Composer |best-practices:composer]:

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

Можете да проверите за синтактични грешки във файловете `*.neon`, като използвате конзолната команда `neon-lint`:

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


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

Връща `$value`, преобразуван в NEON. Параметърът `$blockMode` може да бъде подаден като true, което ще създаде многоредов изход. Параметърът `$indentation` задава символите, използвани за отстъпите (по подразбиране е tab).

```php
Neon::encode($value); // Връща стойността на $, конвертирана в NEON
Neon::encode($value, true); // Връща стойността на $, конвертирана в многоредов NEON
```

Методът `encode()` ще хвърли `Nette\Neon\Exception` при грешка.

```php
try {
	$neon = Neon::encode($value);
} catch (Nette\Neon\Exception $e) {
	// Обработка на изключения
}
```


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

Преобразува зададения NEON в стойност на PHP.

Връща скалари, масиви, [дата |format#Dates] като обекти DateTimeImmutable и [същности |format#Entities] като обекти [api:Nette\Neon\Entity].

```php
Neon::decode('hello: world'); // Връща масив ['hello' => 'world']
```

Методът `decode()` хвърля `Nette\Neon\Exception` при грешка.

```php
try {
	$value = Neon::decode($neon);
} catch (Nette\Neon\Exception $e) {
	// Обработка на изключения
}
```


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

Конвертира съдържанието на файла от NEON в PHP и премахва всички BOM.

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

Методът `decodeFile()` хвърля `Nette\Neon\Exception` при грешка .


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