Lucrul cu NEON
NEON este un limbaj ușor de înțeles pentru serializarea datelor. Este utilizat în Nette pentru fișierele de configurare. Nette\Neon\Neon este o clasă statică pentru lucrul cu NEON.
Familiarizați-vă cu formatul NEON și încercați-l.
Toate exemplele presupun crearea unui alias:
use Nette\Neon\Neon;
Instalare
Descărcați și instalați biblioteca folosind Composer:
composer require nette/neon
Puteți verifica erorile de sintaxă în fișierele *.neon
folosind comanda de consolă
neon-lint
:
vendor/bin/neon-lint <cale>
encode (mixed $value, bool $blockMode=false,
string $indentation="\t"
): string
Returnează $value
convertită în NEON. Ca parametru $blockMode
, puteți transmite true, ceea ce va
crea o ieșire pe mai multe linii. Parametrul $indentation
specifică caracterele utilizate pentru indentare
(implicit este tabulatorul).
Neon::encode($value); // Returnează $value convertită în NEON
Neon::encode($value, true); // Returnează $value convertită în NEON pe mai multe linii
Metoda encode()
aruncă Nette\Neon\Exception
în caz de eroare.
try {
$neon = Neon::encode($value);
} catch (Nette\Neon\Exception $e) {
// procesarea excepției
}
decode (string $neon): mixed
Convertește un șir din NEON în PHP.
Returnează scalari, array-uri, date ca obiecte DateTimeImmutable și entități ca obiecte Nette\Neon\Entity.
Neon::decode('hello: world'); // Returnează array-ul ['hello' => 'world']
Metoda decode()
aruncă Nette\Neon\Exception
în caz de eroare.
try {
$value = Neon::decode($neon);
} catch (Nette\Neon\Exception $e) {
// procesarea excepției
}
decodeFile (string $file): mixed
Convertește conținutul unui fișier din NEON în PHP și elimină eventualul BOM.
Neon::decodeFile('config.neon');
Metoda decodeFile()
aruncă Nette\Neon\Exception
în caz de eroare.