Nette NEON

NEON è un linguaggio di serializzazione dei dati amichevole per le persone. In Nette si usa per i file di configurazione. Nette\Neon\Neon è una classe statica per lavorare con NEON.

Conoscete il formato NEON e provatelo.

Tutti gli esempi presuppongono che sia definito questo alias:

use Nette\Neon\Neon;

Installazione

Il pacchetto si scarica e si installa con Composer:

composer require nette/neon

Potete verificare gli errori di sintassi nei file *.neon con il comando da console neon-lint:

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

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

Restituisce $value convertito in NEON. Al parametro $blockMode potete passare true per creare un output su più righe. Il parametro $indentation indica i caratteri usati per l'indentazione (per impostazione predefinita la tabulazione).

Neon::encode($value); // restituisce $value convertito in NEON
Neon::encode($value, true); // restituisce $value convertito in NEON su più righe

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 $input): mixed

Converte la stringa NEON indicata in un valore 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 l'eventuale BOM.

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

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

Se state aggiornando a una versione più recente, guardate la pagina aggiornamento.

versione: 3.x