Nette NEON

Alle Beispiele setzen voraus, dass folgender Alias definiert ist:

use Nette\Neon\Neon;

Installation

Das Paket laden und installieren Sie mit Composer:

composer require nette/neon

Auf Syntaxfehler in *.neon-Dateien können Sie mit dem Konsolenbefehl neon-lint prüfen:

vendor/bin/neon-lint [--debug] <path>

encode (mixed $value, bool $blockMode=false, string $indentation="\t"): string

Gibt $value in NEON umgewandelt zurück. Dem Parameter $blockMode können Sie true übergeben, um eine mehrzeilige Ausgabe zu erzeugen. Der Parameter $indentation gibt die Zeichen an, die zur Einrückung verwendet werden (Standard ist der Tabulator).

Neon::encode($value); // Gibt $value in NEON umgewandelt zurück
Neon::encode($value, true); // Gibt $value in mehrzeiliges NEON umgewandelt zurück

Die Methode encode() wirft im Fehlerfall eine Nette\Neon\Exception.

try {
	$neon = Neon::encode($value);
} catch (Nette\Neon\Exception $e) {
	// Behandlung der Exception
}

decode (string $input): mixed

Wandelt den angegebenen NEON-String in einen PHP-Wert um.

Gibt Skalare, Arrays, Datumsangaben als DateTimeImmutable-Objekte und Entities als Objekte vom Typ Nette\Neon\Entity zurück.

Neon::decode('hello: world'); // Gibt das Array ['hello' => 'world'] zurück

Die Methode decode() wirft im Fehlerfall eine Nette\Neon\Exception.

try {
	$value = Neon::decode($neon);
} catch (Nette\Neon\Exception $e) {
	// Behandlung der Exception
}

decodeFile (string $file): mixed

Wandelt den Inhalt einer Datei von NEON nach PHP um und entfernt ein eventuelles BOM.

Neon::decodeFile('config.neon');

Die Methode decodeFile() wirft im Fehlerfall eine Nette\Neon\Exception.

Wenn Sie auf eine neuere Version aktualisieren, sehen Sie sich die Seite Upgrade an.