Funcțiile NEON
NEON este un limbaj de serializare a datelor ușor de utilizat. Acesta este utilizat în Nette pentru fișierele de configurare. Nette\Neon\Neon este o clasă statică pentru lucrul cu NEON.
Faceți cunoștință cu formatul NEON și încercați-l.
Următoarele exemple utilizează aceste pseudonime:
use Nette\Neon\Neon;
Instalare
Descărcați și instalați pachetul folosind Composer:
composer require nette/neon
Puteți verifica dacă există erori de sintaxă în fișierele *.neon
utilizând comanda de consolă
neon-lint
:
vendor/bin/neon-lint <path>
encode (mixed $value, bool $blockMode=false,
string $indentation="\t"
): string
Returnează $value
convertit în NEON. Ca parametru $blockMode
puteți trece true, care va crea
o ieșire multiliniară. Parametrul $indentation
specifică caracterele utilizate pentru indentare (valoarea
implicită este tab).
Neon::encode($value); // Returnează $valoare convertită în NEON
Neon::encode($value, true); // Returnează $valoare convertită în NEON multiliniar
Metoda encode()
aruncă Nette\Neon\Exception
în caz de eroare.
try {
$neon = Neon::encode($value);
} catch (Nette\Neon\Exception $e) {
// Tratarea excepțiilor
}
decode (string $neon): mixed
Convertește NEON dat în valoare PHP.
Returnează scalari, array-uri, date ca obiecte DateTimeImmutable și entități ca obiecte Nette\Neon\Entity.
Neon::decode('hello: world'); // Returnează o matrice ['hello' => 'world']
Metoda decode()
aruncă Nette\Neon\Exception
în caz de eroare.
try {
$value = Neon::decode($neon);
} catch (Nette\Neon\Exception $e) {
// Tratarea excepțiilor
}
decodeFile (string $file): mixed
Convertește conținutul fișierului din NEON în PHP și elimină orice BOM.
Neon::decodeFile('config.neon');
Metoda decodeFile()
aruncă Nette\Neon\Exception
în caz de eroare.