NEON ile Çalışma

NEON, verilerin serileştirilmesi için insan tarafından okunabilir bir dildir. Nette'de yapılandırma dosyaları için kullanılır. Nette\Neon\Neon, NEON ile çalışmak için statik bir sınıftır.

NEON biçimiyle tanışın ve onu deneyin.

Tüm örnekler, bir takma adın oluşturulduğunu varsayar:

use Nette\Neon\Neon;

Kurulum

Kütüphaneyi Composer aracını kullanarak indirip kurun:

composer require nette/neon

*.neon dosyalarındaki sözdizimi hatalarını konsol komutu neon-lint ile kontrol edebilirsiniz:

vendor/bin/neon-lint <path>

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

NEON'a dönüştürülmüş $value değerini döndürür. $blockMode parametresi olarak true iletebilirsiniz, bu da çok satırlı bir çıktı oluşturur. $indentation parametresi, girinti için kullanılan karakterleri belirtir (varsayılan sekmedir).

Neon::encode($value); // NEON'a dönüştürülmüş $value değerini döndürür
Neon::encode($value, true); // Çok satırlı NEON'a dönüştürülmüş $value değerini döndürür

encode() metodu bir hata durumunda Nette\Neon\Exception fırlatır.

try {
	$neon = Neon::encode($value);
} catch (Nette\Neon\Exception $e) {
	// istisna işleme
}

decode (string $neon): mixed

Bir dizeyi NEON'dan PHP'ye dönüştürür.

Skalerleri, dizileri, tarihleri DateTimeImmutable nesneleri olarak ve varlıkları Nette\Neon\Entity nesneleri olarak döndürür.

Neon::decode('hello: world'); // ['hello' => 'world'] dizisini döndürür

decode() metodu bir hata durumunda Nette\Neon\Exception fırlatır.

try {
	$value = Neon::decode($neon);
} catch (Nette\Neon\Exception $e) {
	// istisna işleme
}

decodeFile (string $file)mixed

Bir dosyanın içeriğini NEON'dan PHP'ye dönüştürür ve varsa BOM'u kaldırır.

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

decodeFile() metodu bir hata durumunda Nette\Neon\Exception fırlatır.

versiyon: 3.4