Lavorare con NEON

Tutti gli esempi presuppongono la creazione di un alias:

use Nette\Neon\Neon;

Installazione

Scarica e installa la libreria utilizzando Composer:

composer require nette/neon

Puoi controllare gli errori di sintassi nei file *.neon utilizzando il comando da console neon-lint:

vendor/bin/neon-lint <percorso>

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

Restituisce $value convertito in NEON. Come parametro $blockMode, puoi passare true, creando così un output multilinea. Il parametro $indentation specifica i caratteri utilizzati per l'indentazione (il predefinito è il tabulatore).

Neon::encode($value); // Restituisce $value convertito in NEON
Neon::encode($value, true); // Restituisce $value convertito in NEON multilinea

Il metodo encode() lancia Nette\Neon\Exception in caso di errore.

try {
	$neon = Neon::encode($value);
} catch (Nette\Neon\Exception $e) {
	// gestione dell'eccezione
}

decode (string $neon): mixed

Converte una stringa da NEON a PHP.

Restituisce scalari, array, date come oggetti DateTimeImmutable ed entità come oggetti Nette\Neon\Entity.

Neon::decode('hello: world'); // Restituisce l'array ['hello' => 'world']

Il metodo decode() lancia Nette\Neon\Exception in caso di errore.

try {
	$value = Neon::decode($neon);
} catch (Nette\Neon\Exception $e) {
	// gestione dell'eccezione
}

decodeFile (string $file): mixed

Converte il contenuto di un file da NEON a PHP e rimuove eventuali BOM.

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

Il metodo decodeFile() lancia Nette\Neon\Exception in caso di errore.