Delo z NEON

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

Spoznajte format NEON in ga preizkusite.

Vsi primeri predpostavljajo ustvarjen alias:

use Nette\Neon\Neon;

Namestitev

Knjižnico prenesete in namestite z orodjem Composer:

composer require nette/neon

Napake v sintaksi v datotekah *.neon lahko preverite z ukazom konzole neon-lint:

vendor/bin/neon-lint <pot>

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

Vrne $value, pretvorjeno v NEON. Kot parameter $blockMode lahko predate true, s čimer se ustvari večvrstični izpis. Parameter $indentation določa znake, uporabljene za zamik (privzeto je tabulator).

Neon::encode($value); // Vrne $value, pretvorjeno v NEON
Neon::encode($value, true); // Vrne $value, 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) {
	// obdelava izjeme
}

decode (string $neon): mixed

Pretvori niz iz NEONa v PHP.

Vrne skalarje, polja, datume 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) {
	// obdelava izjeme
}

decodeFile (string $file)mixed

Pretvori vsebino datoteke iz NEONa v PHP in odstrani morebitni BOM.

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

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

različica: 3.4