NEON-Funktionen
NEON ist eine menschenfreundliche Sprache zur Serialisierung von Daten. Sie wird in Nette für Konfigurationsdateien verwendet. Nette\Neon\Neon ist eine statische Klasse für die Arbeit mit NEON.
Lernen Sie das NEON-Format kennen und probieren Sie es aus.
Die folgenden Beispiele verwenden diese Aliasnamen:
use Nette\Neon\Neon;
Installation
Laden Sie das Paket herunter und installieren Sie es mit Composer:
composer require nette/neon
Mit dem Konsolenbefehl neon-lint können Sie die Dateien von *.neon auf Syntaxfehler
überprüfen:
vendor/bin/neon-lint <path>
encode (mixed $value, bool $blockMode=false,
string $indentation="\t"): string
Gibt $value in NEON konvertiert zurück. Als Parameter $blockMode können Sie true übergeben, was
eine mehrzeilige Ausgabe erzeugt. Der Parameter $indentation gibt die für die Einrückung verwendeten Zeichen an
(Standard ist tab).
Neon::encode($value); // Liefert $value umgewandelt in NEON
Neon::encode($value, true); // Gibt $value umgewandelt in mehrzeiliges NEON zurück
Die Methode encode() löst im Fehlerfall Nette\Neon\Exception aus.
try {
$neon = Neon::encode($value);
} catch (Nette\Neon\Exception $e) {
// Behandlung von Ausnahmen
}
decode (string $neon): mixed
Konvertiert den angegebenen NEON-Wert in einen PHP-Wert.
Gibt Skalare, Arrays, Datum als DateTimeImmutable Objekte und Entitäten als Nette\Neon\Entity Objekte zurück.
Neon::decode('hello: world'); // Liefert ein Array ['hello' => 'world']
Die Methode decode() löst im Fehlerfall Nette\Neon\Exception aus.
try {
$value = Neon::decode($neon);
} catch (Nette\Neon\Exception $e) {
// Behandlung von Ausnahmen
}
decodeFile (string $file): mixed
Konvertiert den Inhalt der Datei von NEON nach PHP und entfernt alle BOM.
Neon::decodeFile('config.neon');
Die Methode decodeFile() löst im Fehlerfall Nette\Neon\Exception aus.
