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
.