Funzioni NEON

NEON è un linguaggio di serializzazione dei dati facile da usare. Viene utilizzato in Nette per i file di configurazione. Nette\Neon\Neon è una classe statica per lavorare con NEON.

Conoscete il formato NEON e provatelo.

I seguenti esempi utilizzano questi alias:

use Nette\Neon\Neon;

Installazione

Scaricare e installare il pacchetto utilizzando Composer:

composer require nette/neon

È possibile verificare la presenza di errori di sintassi nei file *.neon usando il comando di console neon-lint:

vendor/bin/neon-lint <path>

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

Restituisce $value convertito in NEON. Come parametro $blockMode si può passare true, che creerà un output multilinea. Il parametro $indentation specifica i caratteri utilizzati per l'indentazione (l'impostazione predefinita è tab).

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 delle eccezioni
}

decode(string $neon): mixed

Converte il NEON dato in un valore PHP.

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

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

Il metodo decode() lancia Nette\Neon\Exception un errore.

try {
	$value = Neon::decode($neon);
} catch (Nette\Neon\Exception $e) {
	// Gestione delle eccezioni
}

decodeFile(string $file)mixed

Converte il contenuto del file da NEON a PHP e rimuove qualsiasi BOM.

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

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

versione: 3.4