Работа с 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 определя знаците, използвани за индентация (по подразбиране е табулатор).

Neon::encode($value); // Връща $value, преобразувано в NEON
Neon::encode($value, true); // Връща $value, преобразувано в многоредов 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.