Funções NEON

NEON é uma linguagem de serialização de dados amigável ao ser humano. É utilizada em Nette para arquivos de configuração. Nette\Neon\Neon é uma classe estática para trabalhar com NEON.

Conheça o formato NEON e experimente-o.

Os exemplos a seguir utilizam estes pseudônimos:

use Nette\Neon\Neon;

Instalação

Baixe e instale o pacote usando o Composer:

composer require nette/neon

Você pode verificar se há erros de sintaxe nos arquivos *.neon usando o comando do console neon-lint:

vendor/bin/neon-lint <path>

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

Retorna $value convertido para NEON. Como o parâmetro $blockMode você pode passar verdadeiro, o que criará uma saída multilinha. O parâmetro $indentation especifica os caracteres usados para indentação (o padrão é tabulação).

Neon::encode($value); // Devolve $value convertido em NEON
Neon::encode($value, true); // Retorna $value convertido em NEON multilinha

O método encode() lança Nette\Neon\Exception sobre erro.

try {
	$neon = Neon::encode($value);
catch (Nette\Neon\Exception $e) {
	// Tratamento de exceções
}

decode(string $neon): mixed

Converte o valor NEON dado para PHP.

Retorna escalares, arrays, data como DateTime Objetos imutáveis, e entidades como Nette\Neon\Entity objetos.

Neon::decode('hello: world'); // Devolve um array ['hello' => 'world']

O método decode() lança Nette\Neon\Exception sobre erro.

try {
	$value = Neon::decode($neon);
} catch (Nette\Neon\Exception $e) {
	// Tratamento de exceções
}

decodeFile(string $file)mixed

Converte o conteúdo do arquivo de NEON para PHP e remove qualquer lista técnica.

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

O método decodeFile() lança Nette\Neon\Exception sobre erro.

versão: 3.4