Nette NEON

Wszystkie przykłady zakładają zdefiniowany alias:

use Nette\Neon\Neon;

Instalacja

Pobierz i zainstaluj pakiet za pomocą Composera:

composer require nette/neon

Błędy składniowe w plikach *.neon możesz sprawdzić poleceniem konsolowym neon-lint:

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

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

Zwraca $value przekonwertowane na NEON. Parametrowi $blockMode możesz przekazać true, żeby utworzyć wyjście wieloliniowe. Parametr $indentation podaje znaki używane do wcięć (domyślnie tabulator).

Neon::encode($value); // Zwraca $value przekonwertowane na NEON
Neon::encode($value, true); // Zwraca $value przekonwertowane na wieloliniowy NEON

Metoda encode() rzuca przy błędzie Nette\Neon\Exception.

try {
	$neon = Neon::encode($value);
} catch (Nette\Neon\Exception $e) {
	// Obsługa wyjątku
}

decode (string $input): mixed

Konwertuje podany ciąg NEON na wartość PHP.

Zwraca skalary, tablice, daty jako obiekty DateTimeImmutable oraz encje jako obiekty Nette\Neon\Entity.

Neon::decode('hello: world'); // Zwraca tablicę ['hello' => 'world']

Metoda decode() rzuca przy błędzie Nette\Neon\Exception.

try {
	$value = Neon::decode($neon);
} catch (Nette\Neon\Exception $e) {
	// Obsługa wyjątku
}

decodeFile (string $file): mixed

Konwertuje zawartość pliku z NEON-a na PHP i usuwa ewentualny BOM.

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

Metoda decodeFile() rzuca przy błędzie Nette\Neon\Exception.

Jeśli aktualizujesz do nowszej wersji, zajrzyj na stronę aktualizacji.