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.