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.

Version: 3.4