Функции на NEON

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

use Nette\Neon\Neon;

Настройка

Изтеглете и инсталирайте пакета с помощта на Composer:

composer require nette/neon

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

vendor/bin/neon-lint <path>

encode (mixed $value, bool $blockMode=false, string $indentation="\t"): string

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

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

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

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

decode (string $neon): mixed

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

Връща скалари, масиви, дата като обекти DateTimeImmutable и същности като обекти Nette\Neon\Entity.

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

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

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

decodeFile (string $file): mixed

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

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

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