Funkcije NEON

NEON je človeku prijazen jezik za serializacijo podatkov. V Nette se uporablja za konfiguracijske datoteke. Nette\Neon\Neon je statični razred za delo z NEON.

Spoznajte format NEON in ga preizkusite.

Naslednji primeri uporabljajo te vzdevke:

use Nette\Neon\Neon;

.

Prenesite in namestite paket s programom Composer:

composer require nette/neon

S konzolnim ukazom neon-lint lahko preverite, ali so v datotekah *.neon skladenjske napake:

vendor/bin/neon-lint <path>

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

Vrne $value, pretvorjeno v NEON. Kot parameter $blockMode lahko posredujete true, kar bo ustvarilo večvrstični izpis. Parameter $indentation določa znake, ki se uporabljajo za odtiskovanje (privzeto je tabulator).

Neon::encode($value); // Vrne $vrednost pretvorjeno v NEON
Neon::encode($value, true); // Vrača $vrednost, pretvorjeno v večvrstični NEON

Metoda encode() ob napaki vrže Nette\Neon\Exception.

try {
	$neon = Neon::encode($value);
} catch (Nette\Neon\Exception $e) {
	// Ravnanje z izjemami
}

decode (string $neon): mixed

Pretvori podano vrednost NEON v vrednost PHP.

Vrne skalarje, polja, datum kot objekte DateTimeImmutable in entitete kot objekte Nette\Neon\Entity.

Neon::decode('hello: world'); // Vrne polje ['hello' => 'world']

Metoda decode() ob napaki vrže Nette\Neon\Exception.

try {
	$value = Neon::decode($neon);
} catch (Nette\Neon\Exception $e) {
	// Ravnanje z izjemami
}

decodeFile (string $file)mixed

Pretvori vsebino datoteke iz NEON v PHP in odstrani vse BOM.

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

Metoda decodeFile() ob napaki vrže Nette\Neon\Exception.

različica: 3.4