Nette NEON
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.